home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DP Tool Club 19
/
CD_ASCQ_19_010295.iso
/
vrac
/
dirtot15.zip
/
DIRTOT.DOC
next >
Wrap
Text File
|
1994-07-24
|
61KB
|
1,379 lines
/---------------------------------------------------------------\
| |
| DIRTOT - Directory Totals |
| Version 1.5 07-24-94 |
| Copyright (C) Quincunx Software 1992-94 |
| All rights reserved |
| |
\---------------------------------------------------------------/
CONTENTS
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 1
NEW FEATURES IN THIS VERSION . . . . . . . . . . . . . . . . 2
INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . 2
OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . . 3
PRINTING . . . . . . . . . . . . . . . . . . . . . . . . . . 4
INITIALIZATION FILE . . . . . . . . . . . . . . . . . . . . . 4
COMMAND LINE OPTIONS . . . . . . . . . . . . . . . . . . . . 5
SETTINGS . . . . . . . . . . . . . . . . . . . . . . . . . . 5
AUTOMATIC REPORT FORMATTING . . . . . . . . . . . . . . . . . 12
OTHER FEATURES . . . . . . . . . . . . . . . . . . . . . . . 13
QUESTIONS AND ANSWERS . . . . . . . . . . . . . . . . . . . . 13
TIPS AND TECHNIQUES . . . . . . . . . . . . . . . . . . . . . 17
ERROR MESSAGES . . . . . . . . . . . . . . . . . . . . . . . 18
SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . 21
ABOUT QUINCUNX SOFTWARE . . . . . . . . . . . . . . . . . . . 22
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
REGISTRATION FORM . . . . . . . . . . . . . . . . . . . . . . 24
DIRTOT Page 1
/---------------------------------------------------------------\
| |
| INTRODUCTION |
| |
\---------------------------------------------------------------/
DIRTOT (pronounced der-tote) provides a view of the space used on
your hard disk that you may never have seen before. It lists the
total space used by each subdirectory PLUS ALL SUBDIRECTORY
LEVELS BELOW IT. It answers questions like "How much space does
my word processor and all its files use?" or "What program is
using all my disk space?". It can help you find places to free
up space for new programs.
DIRTOT has a customizable report format and numerous options.
Its listing can be displayed on the screen, printed, or stored in
a file.
Suppose you have the following subdirectory structure. With any
of several utilities you can find out how much space the files in
EACH subdirectory use. (It may take 8 separate commands to do
so):
\C600 0
\C600\BIN 1996054
\C600\BINB 374879
\C600\HELP 2054723
\C600\INCLUDE 119121
\C600\INCLUDE\SYS 4327
\C600\INIT 19217
\C600\LIB 1234894
Then with a calculator you can add them up to find that 5803215
bytes are used by the compiler and its associated files. With
DIRTOT you give one command:
dirtot \c600
COMPUADD325 4:12p 07-04-94 30,236,672 Free
C:\C600 2 Levels
Directory Total Alloc Total Used Used Dirs Files Latest
------------ ----------- ----------- --------- ---- ----- --------
C600 6,234,112 5,803,215 0 7 88 07-04-94
├─BIN 2,088,960 1,996,054 1,996,054 21 11-16-93
├─BINB 393,216 374,879 374,879 4 06-14-90
├─HELP 2,088,960 2,054,723 2,054,723 10 08-29-90
├─INCLUDE 319,488 123,448 119,121 1 35 07-31-90
│ └─SYS 40,960 4,327 4,327 5 09-27-89
├─INIT 24,576 19,217 19,217 3 07-04-94
└─LIB 1,318,912 1,234,894 1,234,894 15 02-10-92
DIRTOT 1.5 Shareware (C) 1992-94 Quincunx Software All rights reserved
DIRTOT Page 2
The first line of the heading shows the Volume ID of the disk
drive, the time and date the listing was created, and the number
of bytes free on the disk. The second heading line shows the
complete specification of the path you entered on the command
line, and the maximum number of levels of subdirectories in that
path. (In the example C600 is level 0, INCLUDE is at level 1,
and SYS is at level 2.)
The columns show the Directory names in a tree format, the Total
space Allocated in clusters to each subdirectory plus all levels
below it, the Total space Used by each subdirectory plus all
levels below it, the space Used by each subdirectory
independently, the total number of subDirectories below each
directory, the total number of Files in each subdirectory plus
all levels below it, and the date of the Latest file in each.
In the first line you see that directory C600 and all its
subdirectories were allocated 6,234,112 bytes, although they
actually used 5,803,215 bytes. (The remaining bytes are used in
system overhead.) Directory C600 by itself used no space at all.
There are 7 subdirectories below this point, and a total of 88
files in the entire structure. The most recently changed file in
this subdirectory structure was changed on 07-04-94.
/---------------------------------------------------------------\
| |
| NEW FEATURES IN THIS VERSION |
| |
\---------------------------------------------------------------/
- Customizable report format
- Automatic report formatting
- 5 sort orders
- Reports total space allocated by clusters
- Reports date of most recent file
- Reports total space needing backup
- Default settings stored in initialization file
- Expanded capacity, over 10,000 subdirectories per drive
- Press Esc to cancel at any time
- Will not send non-printable characters in directory and
volume names to the printer
/---------------------------------------------------------------\
| |
| INSTALLATION |
| |
\---------------------------------------------------------------/
A runnable copy of DIRTOT consists of two files, DIRTOT.EXE and
DIRTOT.INI. It can be run from wherever it is, or you can copy
it to your hard disk. We recommend that you put it in a
DIRTOT Page 3
subdirectory with other utilities and which is in the DOS PATH.
For example,
copy dirtot.exe c:\utility
copy dirtot.ini c:\utility
DIRTOT requires any PC running DOS 3.0 or later. It has no
special memory or display requirements.
/---------------------------------------------------------------\
| |
| OPERATION |
| |
\---------------------------------------------------------------/
The command
dirtot
alone will produce a full report of all subdirectories on the
current drive. It will pause after each screen; you can press
any key to continue.
You can specify the drive:
dirtot d:
or you can specify a particular subdirectory:
dirtot c:\wp51
You can also produce multiple reports from a single command:
dirtot \c600 d:\borlandc c:\windows wp51 e:
DIRTOT has numerous options to customize its output. (See the
next section for details.) Type your options anywhere on the
command line. For a brief listing:
dirtot \c600 /b
For a listing of the first level, indented 4 spaces, in
kilobytes, sorted by total size, of all subdirectories on drive
D:
dirtot /l1 /i4 /nk /st d:
Or use the equivalent command:
dirtot /l1i4nkst d:
DIRTOT Page 4
/---------------------------------------------------------------\
| |
| PRINTING |
| |
\---------------------------------------------------------------/
To send the output to the printer, use the DOS redirection
feature:
dirtot c: >prn
DIRTOT detects that its output is not going to the screen, so it
does NOT pause after each screen full.
Be sure to set your printer for a fixed pitch font so the columns
will be aligned.
You can also send the output to a file this way, then later
incorporate the file into some other report:
dirtot c: >c:\wp\reports\c_totals.txt
/---------------------------------------------------------------\
| |
| INITIALIZATION FILE |
| |
\---------------------------------------------------------------/
DIRTOT reads its default settings from the text file DIRTOT.INI.
You can edit this file to set normal operation to your
preferences, then use command line options for temporary changes.
DIRTOT searches for its .INI file in the current directory first,
then in the directory where DIRTOT.EXE is located. If DIRTOT.INI
is not found in either location a warning message is displayed
and operation continues using internal default settings.
You may use any text editor to change DIRTOT.INI. For example,
to use the editor which comes with DOS version 5 and later,
change to the directory containing DIRTOT.INI and enter the
command:
edit dirtot.ini
The initialization file format consists of key words followed by
an equal sign (=) followed by the value. Key words may be in
upper, lower or mixed case. White space is ignored, and
everything on the line after a semicolon (;) is a comment.
Example:
Indent = 2 ; columns to indent each level
DIRTOT Page 5
Three types of values are supported:
On/Off - these are true/false values. You may enter ON, TRUE,
or a non-zero number, or OFF, FALSE, or 0.
Example: Commas = On
Numbers - these are groups of decimal digits.
Example: MaxLevel = 31
Strings - these are groups of any characters enclosed in quotes.
Example: Format = "NC%TDFB"
Most settings can be done from either the initialization file or
the command line. The command line takes precedence.
/---------------------------------------------------------------\
| |
| COMMAND LINE OPTIONS |
| |
\---------------------------------------------------------------/
Command line options are used to adjust the settings for only one
run. You can use the command line to experiment and find your
preferences, then edit the .INI file to retain your preferences
for later runs.
Command line options may be preceded by a dash (-) or a
slash (/), may be entered in upper or lower case, and multiple
options may be combined in one string. Options may appear
anywhere on the command line.
The initialization file determines the value of options which are
not explicitly set on the command line.
On/Off options are turned Off by following the option letter with
a dash or minus (-). For example, commas are normally On. To
turn commas Off:
dirtot -c-
/---------------------------------------------------------------\
| |
| SETTINGS |
| |
\---------------------------------------------------------------/
The values of settings indicated below are those originally in
the initialization file when it was distributed. Your settings
may differ. The first line of each setting is shown in the
following format:
DIRTOT Page 6
Initialization Command Description
file line
entry option
-------------- ------- ----------------------------------
Ascii = Off -a use standard ASCII characters
This setting substitutes the plain characters '+', '-', '|',
and '\' for the extended graphic characters in the tree
list. Also a '?' is substituted for any extended characters
in directory names. Its main use is for printing a report
on a printer that does not support the extended characters.
C600
+-BIN
+-BINB
+-HELP
+-INCLUDE
| \-SYS
+-INIT
+-LIB
\-SOURCE
+-DOC
\-STARTUP
\-DOS
Brief = Off -b Brief output
This setting produces a report with no headings and no
copyright notice.
Commas = On -c include Commas in numbers
The 'c' setting causes numbers to be displayed with
thousands separators. (This setting may be overridden by
Automatic Report Formatting. See that section for details.)
DIRTOT Page 7
Format = "NCTUDFL" -fxxx report Format
Enter a list from the following letters:
N - directory Name in tree format
C - total cluster space alloCated for this directory
and all children
T - Total space used by this directory and all
children
A - cluster space Allocated for this directory
U - space Used by this directory
D - number of child Directories
F - number of Files in this directory and all children
L - date of Latest file in this directory and all
children
B - total space needing Backup (archive bit set) in
this directory and all children
E - Extended directory name
% - after C, T, F - percent of previous level
after B - percent of Total space used
This setting allows you to totally customize DIRTOT's
output. Some examples:
dirtot /fntf \c600
Directory Total Used Files
--------- ----------- -----
C600 5,803,186 88
├─BIN 1,996,054 21
├─BINB 374,879 4
├─HELP 2,054,723 10
├─INCLUDE 123,448 35
│ └─SYS 4,327 5
├─INIT 19,188 3
└─LIB 1,234,894 15
dirtot /fcabn \c600
Total Alloc Allocated Backup Directory
----------- --------- ------ ---------
6,234,112 0 23,020 C600
2,088,960 2,088,960 3,832 ├─BIN
393,216 393,216 0 ├─BINB
2,088,960 2,088,960 0 ├─HELP
319,488 278,528 0 ├─INCLUDE
40,960 40,960 0 │ └─SYS
24,576 24,576 19,188 ├─INIT
1,318,912 1,318,912 0 └─LIB
DIRTOT Page 8
dirtot /fncatudflb \c600
Directory Tot Alloc Allocated Tot Used Used Dirs Files Latest Backup
--------- --------- --------- --------- --------- ---- ----- -------- ------
C600 6,234,112 0 5,803,186 0 7 88 07-13-94 23,020
├─BIN 2,088,960 2,088,960 1,996,054 1,996,054 21 11-16-93 3,832
├─BINB 393,216 393,216 374,879 374,879 4 06-14-90 0
├─HELP 2,088,960 2,088,960 2,054,723 2,054,723 10 08-29-90 0
├─INCLUDE 319,488 278,528 123,448 119,121 1 35 07-31-90 0
│ └─SYS 40,960 40,960 4,327 4,327 5 09-27-89 0
├─INIT 24,576 24,576 19,188 19,188 3 07-13-94 19,188
└─LIB 1,318,912 1,318,912 1,234,894 1,234,894 15 02-10-92 0
Use the following to squeeze the maximum data from DIRTOT.
Depending on your disk layout, it may not fit on your
screen:
dirtot /fnc%at%udf%lb% \c600
Directory TotAlc % Alloc TotUsd % Used D Fi % Latest Bac %
--------- ------ --- ------ ------ --- ------ - -- --- -------- --- ---
C600 6,088K 0 5,667K 0 7 88 07-13-94 22K <1
├─BIN 2,040K 34 2,040K 1,949K 34 1,949K 21 24 11-16-93 4K <1
├─BINB 384K 6 384K 366K 6 366K 4 5 06-14-90 0 0
├─HELP 2,040K 34 2,040K 2,007K 35 2,007K 10 11 08-29-90 0 0
├─INCLUDE 312K 5 272K 121K 2 116K 1 35 40 07-31-90 0 0
│ └─SYS 40K 13 40K 4K 4 4K 5 14 09-27-89 0 0
├─INIT 24K <1 24K 19K <1 19K 3 3 07-13-94 19K 100
└─LIB 1,288K 21 1,288K 1,206K 21 1,206K 15 17 02-10-92 0 0
For a style different from the tree format, use 'e' instead
of 'n':
dirtot /feu \c600
Directory Used
------------------- ---------
C:\C600 0
C:\C600\BIN 1,996,054
C:\C600\BINB 374,879
C:\C600\HELP 2,054,723
C:\C600\INCLUDE 119,121
C:\C600\INCLUDE\SYS 4,327
C:\C600\INIT 19,188
C:\C600\LIB 1,234,894
DIRTOT Page 9
For import into another application you may wish to turn off
the headings and commas:
dirtot /bc-feu \c600
C:\C600 0
C:\C600\BIN 1996054
C:\C600\BINB 374879
C:\C600\HELP 2054723
C:\C600\INCLUDE 119121
C:\C600\INCLUDE\SYS 4327
C:\C600\INIT 19188
C:\C600\LIB 1234894
When entered on the command line, the -f option cannot be
directly followed by other options. Example:
-fncatudfbi4l2 *** INVALID ***
-fncatudfb -i4l2 OK
See also the section on Automatic Report Formatting.
HeadPerPage = On -h Heading on each screen or page
This setting displays column headings at the top of each
screen or page. If it is set to off, the column headings
will still appear once at the beginning of the report.
Indent = 2 -i## columns to Indent each level
Enter a number from 0 to 12. This setting controls the
appearance of the directory tree listing. Example:
dirtot -i4 \c600
C600
├───BIN
├───BINB
├───HELP
├───INCLUDE
│ └───SYS
├───INIT
├───LIB
└───SOURCE
├───DOC
└───STARTUP
└───DOS
(This setting may be overridden by Automatic Report
Formatting. See that section for details.)
DIRTOT Page 10
MaxLevel = 31 -l## maximum Levels to show
Enter a number from 0 to 31. This setting limits the number
of directory tree levels displayed. Note that all lower
levels are scanned and counted regardless of this setting.
Zero shows only one line about the topmost level. One shows
only the first level subdirectories, two shows two levels of
subdirectories, etc.
NumberFormat = " " -nx Number format
Enter the letter K or M, or blank in the .INI file or - on
the command line. This setting causes numbers to be
displayed in Kilobytes (1024 bytes) rounded to the nearest
kilobyte, or in Megabytes (1,048,576 bytes) rounded to the
nearest one-tenth megabyte. For example 119,121 shows as
116K or .1M. (This setting may be overridden by Automatic
Report Formatting. See that section for details.)
Pause = On -p Pause each screen full
When the listing appears on the screen, DIRTOT pauses after
each screen for you to press a key. Turning this setting
off causes the output to scroll continuously. (If the
output is redirected to the printer or a file DIRTOT does
not pause regardless of this setting.)
Quiet = Off -q Quiet mode
This setting eliminates the "Totaling..." and "Printing..."
displays and the beep in error messages.
Sort = "N" -sx Sort order
Enter N, C, T, or L, or blank in the .INI file or - on the
command line. This setting causes each level of
subdirectories to be sorted by either directory Name
(ascending), total space alloCated (descending), Total space
used (descending), Latest date (descending), or not to be
sorted at all (blank or -).
DIRTOT Page 11
Branches = On -t Tree branches
Turning this setting off removes the connecting lines in the
tree display:
C600
BIN
BINB
HELP
INCLUDE
SYS
INIT
LIB
SOURCE
DOC
STARTUP
DOS
;Columns = 80 -w Wide printer (132 columns)
When printing a report DIRTOT assumes your printer is 80
columns wide. This setting lets it know that the printer
can handle wider output. DIRTOT does not send any printer
control codes. This setting makes no difference unless your
report width exceeds 80 characters.
This setting is normally disabled (commented out) in the
.INI file, in which case DIRTOT uses the current screen
width. It can be used in special situations where DIRTOT
cannot correctly determine the number of columns on your
screen, or if you want to specify the width of a printer
page.
;Rows = 25 (n/a) rows per screen or page
This setting is normally disabled (commented out) in the
.INI file, in which case DIRTOT uses the current screen
height for display, or 60 lines for printing. It can be
used in special situations where DIRTOT cannot correctly
determine the number of rows on your screen, or if you want
to specify the number of lines per printer page.
Path = "" (n/a) drives or directories to report
You normally specify the drives and/or directories to report
on the command line. If you do not specify any, DIRTOT
reports on the current drive. Use this setting if you want
DIRTOT to always report on a certain list of drives and/or
directories (when you don't put any on the command line).
You may enter multiple drives/directories separated by
spaces, commas, or semicolons. Examples:
DIRTOT Page 12
path = "C:,D:,E:"
Path="D:\FRED"
PATH = "\c600 d:\borlandc c:\windows wp51 e:"
(n/a) -z display debug output
This option causes the display of internal information only
useful to the author.
(n/a) -? show Help info
This displays a help screen listing the command line
options.
/---------------------------------------------------------------\
| |
| AUTOMATIC REPORT FORMATTING |
| |
\---------------------------------------------------------------/
DIRTOT automatically adjusts the width of its report to fit on
the screen. To accomplish this while still providing as close as
possible to the specific formatting features you requested,
DIRTOT goes through a sequence of steps, in order, until the
report fits. These steps include reducing the number of levels
that are shown fully indented, reducing the number of characters
each level is indented, shrinking the titles of some columns,
reducing the space between columns, showing numbers in Kilobytes,
removing commas, and showing numbers in Megabytes.
Note that this automatic formatting will sometimes override your
settings for Indent, Number format, and Commas.
Since DOS provides no mechanism for determining the width of the
printer, DIRTOT formats for the screen width even when you direct
the output to a printer. You can adjust this by using the /w
command line option or the Columns initialization file setting.
DIRTOT Page 13
/---------------------------------------------------------------\
| |
| OTHER FEATURES |
| |
\---------------------------------------------------------------/
DIRTOT indicates subdirectories with Hidden or System attributes
by displaying their names in lower case.
DIRTOT replaces unprintable control characters in directory or
volume names with a question mark (?). If the Ascii setting is
turned on, any extended characters will also be replaced.
DIRTOT adapts to the number of rows and columns on your screen.
It will pause after every 25, 43, 50, or other number of lines.
It will display a wider report if your screen shows more columns.
DIRTOT provides National Language Support. If you have set up
DOS 3.0 or later for a specific country (by including COUNTRY= in
your CONFIG.SYS file), the time, date, thousands separator and
decimal separator will adapt to your country's standards.
/---------------------------------------------------------------\
| |
| QUESTIONS AND ANSWERS |
| |
\---------------------------------------------------------------/
Why do DIRTOT and CHKDSK report different amounts of space used
on the disk?
CHKDSK counts the unused space at the end of each file - the
rest of the "Allocation Unit" or "Cluster", and counts
hidden files separately. DIRTOT can count the allocated
space and/or the actual space each file uses, as reported in
a directory listing. If you add CHKDSK's amounts for hidden
and user files it should match DIRTOT's amount for Total
Allocated.
Some versions of CHKDSK may report one more file, because
they count the volume ID as a hidden file.
Why do DIRTOT and DIR report different numbers of files in a
subdirectory?
DIR counts the '.' and '..' DOS housekeeping files, but
ignores any Hidden files. DIRTOT ignores the '.' and '..'
files, and counts any Hidden files.
Why do some numbers show as 0K and others as just plain 0?
Numbers in Kilobytes and Megabytes, and percents, are
rounded to the nearest value, but its often important to
DIRTOT Page 14
know whether you have a very small number or exactly zero.
0K means the actual value is between 1 and 511 inclusive.
.0M means the actual value is between 1 and 52,428
inclusive. <1 (less than one) is used in percent displays
when the actual value is between 0% and 0.5% exclusive.
Just plain 0 means the actual value is exactly zero.
Why does DIRTOT take so long to display its results?
In order to come up with its totals DIRTOT must read the
entire directory structure of your hard disk. The final
grand total appears on the very first line, and the width of
the output is unknown until the deepest subdirectory has
been scanned. Quincunx Software has done its best to
minimize this time. Since the vast majority of the time is
spent in DOS waiting for the disk, we believe DIRTOT is as
fast as or faster than any other utility that reads the
entire directory structure.
My disk has 19 levels of subdirectories on it. How are you going
to handle that?
The listing expands in width until it fills the screen, then
additional levels of subdirectories are shown in a column
with a level number:
Directory Total Alloc Total Used Files
------------------ ----------- ----------- -----
DIRECTOR.001 0 0 0
└─A 0 0 0
└─B 0 0 0
└─C 0 0 0
└─D 0 0 0
└─E 0 0 0
└─F 0 0 0
7> G 0 0 0
8> H 0 0 0
9> I 0 0 0
10> J 0 0 0
11> K 0 0 0
12> L 0 0 0
13> M 0 0 0
14> N 0 0 0
15> O 0 0 0
16> P 0 0 0
17> Q 0 0 0
18> R 0 0 0
19> S 0 0 0
Exactly when this happens depends on the settings for report
format, indent and number format.
DIRTOT Page 15
Just what does the percent column mean? Shouldn't it add up to
100%?
There are two types of percent columns. First, the easy
one: Percent Backup is the Backup column (number of bytes
needing backup) divided by the Total Used column IN THAT
SAME REPORT LINE. In the example below the BIN directory
has 3,832 bytes needing backup out of 1,996,054 used,
equaling 0.19%, shown as "<1", less than one percent. In
the INIT directory all 19,190 bytes need backup, 100% of
that directory. But for the overall C600 directory
structure, less than one percent need backup. (The Total
Used column need not be reported to get percent Backup, the
figures are still available internally.)
Directory Total Used Backup %
--------- ----------- ------ ---
C600 5,803,188 23,022 <1
├─BIN 1,996,054 3,832 <1
├─BINB 374,879 0 0
├─HELP 2,054,723 0 0
├─INCLUDE 123,448 0 0
│ └─SYS 4,327 0 0
├─INIT 19,190 19,190 100
└─LIB 1,234,894 0 0
The second type of percent applies to Total Allocated, Total
Used, or Files. The percent column indicates PERCENT OF THE
PREVIOUS DIRECTORY LEVEL TOTAL. In the example below the
SYS directory uses 4% of the space used by INCLUDE and SYS,
and INCLUDE and SYS uses 2% of the space used by the whole
C600 structure. The BIN directory contains 34% of the space
used by the C600 structure. The first line of the report
will never show anything for these percents, since there is
no previous level to reference.
Directory Total Used %
--------- ----------- ---
C600 5,803,188
├─BIN 1,996,054 34
├─BINB 374,879 6
├─HELP 2,054,723 35
├─INCLUDE 123,448 2
│ └─SYS 4,327 4
├─INIT 19,190 <1
└─LIB 1,234,894 21
The only occasion when things would add up to 100% is if the
previous level contained no files and you added the percents
for just one level. From above that would be
BIN+BINB+HELP+INCLUDE+INIT+LIB, but it still won't quite add
up because the figures are rounded.
DIRTOT Page 16
I set Indent to 8 but the report is only indenting 2. What's
wrong?
Automatic Report Formatting is overriding your setting in
order to fit everything across the page. To produce an
indent of 8 you will have to give up one (or more) columns
or use a wider display or printer. The same thing can
happen with Number format and Commas.
DIRTOT Page 17
/---------------------------------------------------------------\
| |
| TIPS AND TECHNIQUES |
| |
\---------------------------------------------------------------/
To produce the briefest possible listing of the space in use on
several drives use the Brief, max Level 0, and Megabyte options
with a report Format of Name and Total used (or total alloCated
if you prefer):
dirtot /blnmfnt c: d: e:
C:\ 127.7M
D:\ 114.1M
E:\ 23.4M
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
To get a good picture of the space used by the various major
programs on your system, use the Level 1 option, the Sort by
Total used option, and a report format including Percent:
dirtot /l1st /fnt% c:\
Directory Total Used %
-------------- ----------- ---
C:\ 205,625,443
├─BC4 43,870,703 21
├─WINDOWS 22,236,026 11
├─ZAPP 9,304,432 5
├─DOS 6,085,019 3
├─C600 5,803,188 3
├─WP51 3,672,475 2
├─UTILITY 2,336,327 1
.
.
.
├─DIRTOT 797,437 <1
├─TEST 107,414 <1
└─TEMP 0 0
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
You can cancel DIRTOT at any time by pressing "Esc". The report
will say "*** Cancelled" at the end.
DIRTOT Page 18
/---------------------------------------------------------------\
| |
| ERROR MESSAGES |
| |
\---------------------------------------------------------------/
INITIALIZATION FILE ERRORS:
*** INI file DIRTOT.INI line ##: ...
...File not found
DIRTOT could not find its initialization file in either the
current directory or the directory where DIRTOT.EXE is
located. This is a warning only. DIRTOT will run with its
default and command line settings.
It is also possible that another program has opened the .INI
file in a non-shared mode.
...Invalid TRUE/FALSE value
The entry on the line indicated must be set to either
"TRUE", "ON", a non-zero number, or "FALSE", "OFF", 0.
...Unknown symbol
The first word on the line indicated was not found in
DIRTOT's table of .INI file entries. It was either
misspelled or a comment indicator (;) is missing.
...Error reading file
A disk error occurred while reading the .INI file.
...Section not found
...Invalid type
...Out of memory
...Section too large
...Unknown error code
These last five error messages should not occur in this
program. Please report these problems to Quincunx Software.
SETTINGS ERRORS:
*** Unknown option 'x'
You entered a command line option which DIRTOT did not
recognize, or combined options in a single string in an
invalid manner.
*** No report format specified
DIRTOT Page 19
The "Format" entry in the .INI file or the command line
option 'F' were followed by a blank string.
*** Invalid format character 'x'
The "Format" entry in the .INI file or the command line
option 'F' contained an invalid character.
*** Indent must be 0 to 12
The "Indent" entry in the .INI file or the command line
option 'I' specified an invalid value.
*** Maxlevel must be 0 to 31
The "MaxLevel" entry in the .INI file or the command line
option 'L' specified an invalid value.
*** Number format must be 'K', 'M' or none
The "NumberFormat" entry in the .INI file or the command
line option 'N' specified an invalid value.
*** Sort order must be 'N', 'T', 'C', 'L' or none
The "Sort" entry in the .INI file or the command line option
'S' specified an invalid value.
*** Percent must follow 'C', 'T', 'F' or 'B'
The percent format specifier in the report format setting
can only immediately follow one of the indicated columns.
RUN TIME ERRORS:
*** Path xxx not found
A subdirectory you entered on the command line does not
exist. Maybe you misspelled it. Try again.
If you are running on a network or under a multitasking
system there is a slight chance that another program or user
removed a directory between the time that DIRTOT first
detected it and then went back to scan it.
*** Invalid drive x:
The drive portion of an entry on the command line is not
valid.
DIRTOT Page 20
*** Internal storage full, complete path not scanned
There is no more conventional memory available to store
subdirectories. DIRTOT will report what it has, but it did
not cover your entire disk.
DIRTOT has room to store over 10000 subdirectories, so to
get this message you either must have a VERY large disk or
are running DIRTOT with limited available memory. If you
actually have more than 10000 subdirectories, let Quincunx
Software know so we can consider producing an expanded
version.
*** More than #### subdirs, complete directory not scanned
where #### is a number on the order of one thousand. One
directory contained more than that many subdirectories at
the next level. DIRTOT will report the rest of the disk
correctly. Let Quincunx Software know so we can consider
producing an expanded version.
*** Only 32 levels supported
A subdirectory structure exists which contains more than 32
levels of directories. This is not normally possible under
DOS. Please report this problem to Quincunx Software.
DIRTOT Page 21
/---------------------------------------------------------------\
| |
| SUPPORT |
| |
\---------------------------------------------------------------/
The policy of Quincunx Software is to provide a reasonable amount
of free support to all users, registered or not. You can reach
us by:
U.S. Mail:
Quincunx Software
8178 Aldgwen Rd.
Barneveld, WI 53507
BBS:
Leave a message to Tom Caswick on the Madison PC User's
Group BBS at 1-608-233-0286
Voice phone:
1-608-924-5841 (10 am to 6 pm Central time, Monday through
Friday)
All calls are screened by answering machine. If you say you
are calling about DIRTOT we will probably answer
immediately. If you don't leave a message you will probably
never reach us.
/---------------------------------------------------------------\
| |
| REGISTRATION |
| |
\---------------------------------------------------------------/
DIRTOT is distributed as Shareware. You are encouraged to give
copies to your friends, co-workers, and user groups, and upload
copies to Bulletin Board Systems. We strongly recommend that you
distribute the original authenticity verified ZIP file. All
copies must be unaltered and include at least the files
DIRTOT.EXE, DIRTOT.INI, and DIRTOT.DOC. The author, Quincunx
Software, retains all other rights to the program.
Non-registered users of this software are granted a limited
license to make an evaluation copy for trial use on a private,
non-commercial basis, for the express purpose of determining
whether DIRTOT is suitable for their needs. At the end of this
trial period, you must either register your copy or discontinue
using DIRTOT.
DIRTOT Page 22
Should you decide to use DIRTOT, or keep it on your hard disk for
future use, you are obligated to pay a registration fee of $10.00
(Ten U.S. Dollars). Send payment in check or money order to:
Quincunx Software
8178 Aldgwen Rd.
Barneveld, WI 53507
Whether you register or not, please notify Quincunx Software of
any problems you encounter using DIRTOT, and of any improvements
you would like to see.
Quantity discounts and site licenses are available. Call or
write for information.
Companies and organizations that provide software duplication
services may include DIRTOT in their catalog and provide copies
for a reasonable duplication fee, provided the purchaser is
notified that no portion of the fee goes to the Shareware author
and that the purchaser is still obligated to register.
Quincunx Software hereby disclaims all warranties relating to
this software, whether express or implied, including without
limitation any implied warranties of merchantability or fitness
for a particular purpose. Quincunx Software will not be liable
for any special, incidental, consequential, indirect or similar
damages due to loss of data or any other reason, even if Quincunx
Software or an agent of Quincunx Software has been advised of the
possibility of such damages. In no event shall Quincunx
Software's liability for any damages ever exceed the price paid
for the license to use this software, regardless of the form of
the claim.
/---------------------------------------------------------------\
| |
| ABOUT QUINCUNX SOFTWARE |
| |
\---------------------------------------------------------------/
Quincunx Software was founded in 1983. We have provided
consulting and contract programming services to numerous large
and small companies, including IBM, Citicorp, and Sears. We have
special expertise in C programming, communication, and the
S.W.I.F.T. international electronic funds transfer network.
Tom Caswick, owner and president of Quincunx Software, has over
19 years of experience programming a wide range of computers,
from mainframes to microcontrollers.
DIRTOT is Quincunx Software's first Shareware product. It was
originally released in April 1992.
DIRTOT Page 23
/---------------------------------------------------------------\
| |
| INDEX |
| |
\---------------------------------------------------------------/
.0M . . . . . . . . . . . . . . . . . . . . . . . . 14
'..' . . . . . . . . . . . . . . . . . . . . . . . 13
'.' . . . . . . . . . . . . . . . . . . . . . . . . 13
<1 . . . . . . . . . . . . . . . . . . . 8, 14, 15, 17
0K . . . . . . . . . . . . . . . . . . . . . . . . 13
Allocation Unit . . . . . . . . . . . . . . . . . . 13
Archive . . . . . . . . . . . . . . . . . . . . . . . 7
ASCII . . . . . . . . . . . . . . . . . . . . . . 6, 13
Attributes . . . . . . . . . . . . . . . . . . . 7, 13
Automatic report formatting . . . . 2, 6, 9, 10, 12, 16
Backup . . . . . . . . . . . . . . . . . . . . . . . 7
BBS . . . . . . . . . . . . . . . . . . . . . . . . 21
Beep . . . . . . . . . . . . . . . . . . . . . . . 10
Brief . . . . . . . . . . . . . . . . . . . . . . 6, 17
Cancel . . . . . . . . . . . . . . . . . . . . . 2, 17
Child directories . . . . . . . . . . . . . . . . . . 7
CHKDSK . . . . . . . . . . . . . . . . . . . . . . 13
Cluster . . . . . . . . . . . . . . . . . . . 2, 7, 13
Columns . . . . . . . . . . . . . . . . . . 2, 9, 11-13
Command line . . . . . . . . . . . . 2-6, 9-12, 18, 19
Commas . . . . . . . . . . . . . . . . . . . 6, 11, 12
CONFIG.SYS . . . . . . . . . . . . . . . . . . . . 13
Default . . . . . . . . . . . . . . . . . . . 2, 4, 18
DIR . . . . . . . . . . . . . . . . . . . . . . . . 13
Disclaimer . . . . . . . . . . . . . . . . . . . . 22
DOS . . . . . . . . . . . . . . . . . . 3, 4, 12-14, 20
Error messages . . . . . . . . . . . . . . 10, 18, 19
Esc . . . . . . . . . . . . . . . . . . . . . . . 2, 17
Hard disk . . . . . . . . . . . . . . . . 1, 2, 14, 22
Heading . . . . . . . . . . . . . . . . . . . . 2, 6, 9
Hidden . . . . . . . . . . . . . . . . . . . . . . 13
Import . . . . . . . . . . . . . . . . . . . . . . . 9
Indent . . . . . . . . . . . . . . . 9, 12, 14, 16, 19
Initialization file . . . . . . 2, 4, 5, 10-12, 18, 21
Latest date . . . . . . . . . . . . . . . . . 2, 7, 10
Levels . . . . . . . . . . . . . . . 2, 3, 5, 7, 9, 10
License . . . . . . . . . . . . . . . . . . . . 21, 22
Lines . . . . . . . . . . . . . . . . . . . . . 11, 13
Memory . . . . . . . . . . . . . . . . . . . 3, 18, 20
National Language Support . . . . . . . . . . . . . 13
Number format . . . . . . . . . . . . 6, 10, 12-14, 19
Number of files . . . . . . . . . . . . . . . 2, 7, 13
Options . . . . . . . . . . . . . . 3-6, 9, 12, 13, 18
Path . . . . . . . . . . . . . . . . 2, 3, 11, 19, 20
Pause . . . . . . . . . . . . . . . . . . . . 4, 10, 13
Percent . . . . . . . . . . . . . . . . . 7, 14, 15, 19
Printing . . . . . . . . . . . . . . . 2, 4, 6, 10-13
Question mark . . . . . . . . . . . . . . . . . . . 13
DIRTOT Page 24
Quiet . . . . . . . . . . . . . . . . . . . . . . . 10
Quincunx Software . . . . . . . . . . 1, 14, 18, 20-22
Redirection . . . . . . . . . . . . . . . . . . . 4, 10
Registration . . . . . . . . . . . . . . . . . . . 21
Report format . . . . . . . . . . . 1, 2, 7, 14, 17, 18
Rows . . . . . . . . . . . . . . . . . . . . . 11, 13
Screen width . . . . . . . . . . . . . . . . . . 11-14
Semicolon . . . . . . . . . . . . . . . . . . . . 4, 11
Shareware . . . . . . . . . . . . . . . . . . . . . 21
Sort . . . . . . . . . . . . . . . . . . 2, 10, 17, 19
Space allocated . . . . . . . . . . . 2, 7, 10, 13, 17
Space free . . . . . . . . . . . . . . . . . . . 1, 2
Space used . . . . . . . . . . . . 1, 2, 7, 10, 13, 17
Support . . . . . . . . . . . . . . . . . . . . . . 21
System . . . . . . . . . . . . . . . . . 2, 13, 17, 19
Thousands separator . . . . . . . . . . . . . . . 6, 13
Tree branches . . . . . . . . . . . . . 2, 6, 7, 9, 11
Unprintable characters . . . . . . . . . . . . . 2, 13
Volume ID . . . . . . . . . . . . . . . . . . . . 2, 13
DIRTOT REGISTRATION FORM
Quincunx Software
8178 Aldgwen Rd.
Barneveld, WI 53507
608-924-5841
Name: _______________________________________________________
Company: _______________________________________________________
Address: _______________________________________________________
_______________________________________________________
City: ________________________ State: _____ Zip: __________
Country: _______________________________________________________
Phone: _______________________________________________________
Please register DIRTOT Version 1.5 in the above name.
_______ copies at $10.00 per copy. Amount enclosed _____________
Suggested enhancements:
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________