Bila Vrana/BILA_VRANA.iso/005A/DIRTO603.ZIP/DIRTOTAL.DOC

Text File | 1996-02-25 | 19KB | 397 lines

DIRTOTAL.DOC                         1                         Revised: 02/25/96

The DIRTOTAL.EXE program is another directory-listing program.   It  produces  a
text file with the  results  of  your  search  and  is  primarily  designed  for
inventory purposes.  It includes these features:

  * Can search an entire drive or part of a drive.
  * Can search multiple drives.
  * Can look for individual files or all files.
  * Can select based on attributes, date, or size.
  * Can extract information for archive files (ZIP, LZH, etc).
  * Can look for duplicate file names.
  * Can produce a couple of different report formats; see the "Syntax" section
    for examples.
  * Works on a CD-ROM and network drives.

DIRTOTAL goes through all directories on a given drive (or on  multiple  drives)
and writes out the names and space used for all files on that drive.   You  will
also see directory totals and such.  (You can suppress the individual file names
listing if you want.)

Alternatively, you can have the utility restrict the search to just those  files
within a given subdirectory and its child subdirectories.  For example,  if  you
had a directory structure like this:

        +-- DOS
        +-- TC -+-- KERMIT
        |       +-- BANYAN
        +-- 123

If you  pass  in  just  the  drive  designation,  you  will  get  files  in  all
subdirectories.  If you  pass  in  "C:\TC",  you'll  get  all  files  in  C:\TC,
C:\TC\KERMIT, and C:\TC\BANYAN.

DIRTOTAL then tries to total up the space used by subdirectory as  well  as  for
the entire disk.  The routine  also  presents  subtotals  for  directories  with
children.  For networked and CD-ROM discs, it will typically present  the  wrong
results when it comes to total disk space and total free space but the file  and
directory totals will all be correct.

DIRTOTAL creates an output file in the default directory on the C: drive  called
"DRIVE#s.DIR" (where "s" is the letter of the drive you scanned) which  contains
the file listings and total size reports.  If  you  restrict  the  output  to  a
specific subdirectory and its children, the file name  created  will  be  called
"DRIVE#sx.DIR", where "x" is the first  letter  of  the  restriction  ("DIRTOTAL
C:\TC" would create a file called "DRIVE#CT.DIR").  If you ask for more than one
drive at a time (e.g. "DIRTOTAL C: D: E:"), the file name will put the number of
drives scanned in place of the drive letter (so "DIRTOTAL C: D:  E:  \TC"  would
create a file called "DRIVE#3T.DIR").

The DIRTOTAL.EXE program was originally written in order to find  out  how  much
space the various files took on a CD-ROM disc.  However, it works fine on  large
disk drives and network drives.

Win95 notice:  As with most DOS-based utilities, this program doesn't understand
the weird subdirectories that are possible under Windows 95.  The  program  will
skip parts of your drive when you exceed subdirectory length limits.


DIRTOTAL.DOC                         2                         Revised: 02/25/96

Note:  When examining  the  output  report,  you  may  find  some  weirdly-named
eight-character file names (typically beginning with "A" or "B")  in  your  root
directory.  Typically, these will show up if you run DIRTOTAL on your  C  drive.
These files are temporary ISAM files created by the routine.  They  are  deleted
once the program is run.


Specifying parameters:

Parameters for this program can be set in the following ways.  The last  setting
encountered always wins:
  - Read from an *.INI file (see BRUCEINI.DOC file),
  - Through the use of an environmental variable (SET DIRTOTAL=whatever), or
  - From the command line (see "Syntax" below)


Syntax:

    DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
        [ drive: ] ... [drive:]\path[\filespec] ]
      [ /NORMAL | /WIDE | /THIN | /SPLIT ] [ /DUPS ] [ /CHILD ]
      [ /NL ] [ /-HEADERS ] [ /-FOOTERS ] [ /CLUSTERS | /-CLUSTERS ]
      [ /S { GT | GE | LT | LE | EQ | NE } value ]
      [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ] [ /ATTR=attr ]
      [ /Frptfile ] [ /Z | /-Z ] [ /Iinitfile | /-I ] [ /Ox | /O-x ]
      [ /SUB1 | /-SUB1 ] [ /SUB2 | /-SUB2 ] [ /+DIR | /-DIR ] [ /n ]
      [ /BEEP | /-BEEP ] [ /Tdrive: | /Tdrive:\path ] [ /Q ] [ /? ]

where:

"drive" is the letter of the drive you want to scan ("C", "D", "L", etc).  If no
drive is specified, the routine presumes you want all files  from  your  default
drive.  You can specify multiple drives if you want.

"filespec" restricts the listing to files that meet some file specification. The
restriction can include wildcards.  For example, "DIRTOTAL C:\*.BAS".  Note that
you can put a space between the drive and the path/filespec but not  within  the
path/filespec (don't try "DIRTOTAL C:  \TC *.BAS" but  "DIRTOTAL  C:  \TC\*.BAS"
and "DIRTOTAL C:\TC\*.BAS" are fine).  (One quirk:  If you specify  a  filespec,
the program will not show parent subdirectory totals for  parent  subdirectories
that are empty.)

"path" restricts the listing to a subdirectory and its children.


DIRTOTAL.DOC                         3                         Revised: 02/25/96

"/NORMAL" is typically the default report format.  It produces a report which is
80-characters wide and has the complete file name listed on each line like this:

C:\ACD.IDX                                      09/26/93 00:34:50        575  a
C:\AUTOEXEC.BAT                                 08/20/93 00:08:42        845  a
C:\BOOT.CPS                                     05/06/93 18:56:28      1,024h
C:\CHKLIST.CPS                                  05/20/93 22:23:06        135  a
C:\CMOS.CPS                                     05/06/93 18:56:28         48

Note the last four characters show any special attributes set for the file:
        a = archive bit set (the file hasn't been backed up yet)
        h = hidden bit set
        s = system file bit set
        r = read-only file bit set

"/WIDE" produces a 126-character wide report with  all  of  the  information  in
fixed columns.  This is fine for compressed printing or subsequent processing by
some other program.  The field positions are as follows:

        cols  1- 65 path (including drive)
             67- 78 filename (or ZIP name)
             80- 91 ZIP member name (if any)
             93-100 file creation date
            102-109 file creation time
            111-121 file size in bytes
            123-126 attributes

This option invokes /Z although you can specify /-Z if you want to override  it.
This option is primarily designed for people who  need  a  complete  catalog  of
everything in a CD-ROM and programs like CATDISK choke if you exceed 4000  files
per disc.

"/THIN" produces a smaller report.  The directory  name  is  printed  separately
from the file name.  It automatically invokes the /CHILD option and  produces  a
report similar to this:

C:\
  ACD.IDX                   09/26/93 00:34:50         575   a
  AUTOEXEC.BAT              08/20/93 00:08:42         845   a
  BOOT.CPS                  05/06/93 18:56:28       1,024 h
  CHKLIST.CPS               05/20/93 22:23:06         135   a

"/SPLIT" creates the results file with the filename in a fixed field within  the
file.  If the subdirectory name doesn't fit, it's truncated.  The  /WIDE  option
is better if your subdirectory names exceed 35 characters (if /Z is not used) or
22 characters (if /Z is used) unless you're particular about having 80-character
or less reports.  A sample of the output with /Z:

D:\CLONE22\           PB22OBJ.LZH  ADDMATI.OBJ  05/01/93 11:14:58        124
D:\CLONE22\           PB22OBJ.LZH  ADDMATL.OBJ  05/01/93 11:14:58        132
D:\CLONE22\           PB22OBJ.LZH  ALLEXTME.OBJ 05/01/93 11:14:58        110
D:\CLONE22\           PB22OBJ.LZH  ALTKEY.OBJ   05/01/93 11:11:54      1,282


DIRTOTAL.DOC                         4                         Revised: 02/25/96

"/DUPS" produces a report which shows all files with the same file names on your
disk.  By default, it produces a report that's a modifie