home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / DISK_UTL / DIRTOT10.ZIP / DIRTOT.DOC next >
Text File  |  1992-05-14  |  27KB  |  650 lines
  1.  
  2.  
  3.  
  4.      /---------------------------------------------------------------\
  5.      |                                                               |
  6.      |                   DIRTOT - Directory Totals                   |
  7.      |                     Version 1.0  05-14-92                     |
  8.      |              Copyright (C) Quincunx Software 1992             |
  9.      |                      All rights reserved                      |
  10.      |                                                               |
  11.      \---------------------------------------------------------------/
  12.  
  13.      DIRTOT provides a view of the space used on your hard disk that
  14.      you may never have seen before.  It lists the total space used by
  15.      each subdirectory PLUS ALL SUBDIRECTORY LEVELS BELOW IT.  It
  16.      answers questions like "How much space does my compiler and all
  17.      its files use?" or "What program is using all my disk space?". 
  18.      It can help you find places to free up space for new programs.
  19.  
  20.      DIRTOT has 3 display formats and 11 customization options.  Its
  21.      listing can be displayed on the screen, printed, or stored in a
  22.      file.
  23.  
  24.      Suppose you have the following subdirectory structure:
  25.  
  26.      \C600
  27.      \C600\BIN
  28.      \C600\BINB
  29.      \C600\HELP
  30.      \C600\INCLUDE
  31.      \C600\INCLUDE\SYS
  32.      \C600\INIT
  33.      \C600\LIB
  34.      \C600\SOURCE
  35.      \C600\SOURCE\DOC
  36.      \C600\SOURCE\STARTUP
  37.      \C600\SOURCE\STARTUP\DOS
  38.  
  39.      With any of several utilities you can find out how much space the
  40.      files in EACH subdirectory use.  (It may take 12 separate
  41.      commands to do so):
  42.  
  43.      \C600                                 0
  44.      \C600\BIN                       2141260
  45.      \C600\BINB                       562718
  46.      \C600\HELP                      2054723
  47.      \C600\INCLUDE                    119121
  48.      \C600\INCLUDE\SYS                  4327
  49.      \C600\INIT                         9607
  50.      \C600\LIB                       1234894
  51.      \C600\SOURCE                          0
  52.      \C600\SOURCE\DOC                   8819
  53.      \C600\SOURCE\STARTUP                  0
  54.      \C600\SOURCE\STARTUP\DOS          35830
  55.  
  56.      Then with a calculator you can add them up to find that 6171299
  57.      bytes are used by the compiler and its associated files.  With
  58.      DIRTOT you give one command:
  59.  
  60.           dirtot \c600
  61.  
  62.  
  63.      COMPUADD325         5:19p 04-19-92          13,172,736 Free
  64.      C:\C600                                            3 Levels
  65.      Directory           Total        Used         Dirs   Files 
  66.      ------------------  -----------  -----------  -----  ------
  67.      C600                  6,171,299            0     11      94
  68.      ├─BIN                 2,141,260    2,141,260             19
  69.      ├─BINB                  562,718      562,718              7
  70.      ├─HELP                2,054,723    2,054,723             10
  71.      ├─INCLUDE               123,448      119,121      1      35
  72.      │ └─SYS                   4,327        4,327              5
  73.      ├─INIT                    9,607        9,607              3
  74.      ├─LIB                 1,234,894    1,234,894             15
  75.      └─SOURCE                 44,649            0      3       5
  76.        ├─DOC                   8,819        8,819              2
  77.        └─STARTUP              35,830            0      1       3
  78.          └─DOS                35,830       35,830              3
  79.  
  80.      The first line of the heading shows the Volume ID of the disk
  81.      drive, the time and date the listing was created, and the number
  82.      of bytes free on the disk.  The second heading line shows the
  83.      complete specification of the path you entered on the command
  84.      line, and the maximum number of levels of subdirectories in that
  85.      path.  (In the example C600 is level 0, SOURCE is at level 1,
  86.      STARTUP is at level 2, and DOS is at level 3.)
  87.  
  88.      The columns show the Directory names in a tree format, the Total
  89.      space used by each subdirectory plus all levels below it, the
  90.      space Used by each subdirectory independently, the total number
  91.      of subdirectories below each directory, and the total number of
  92.      Files in each subdirectory plus all levels below it.
  93.  
  94.      In the first line of the Total column you see that directory C600
  95.      and all its subdirectories used 6,171,299 bytes.  Directory C600
  96.      by itself used no space at all.  There are 11 subdirectories
  97.      below this point, and a total of 94 files in the entire
  98.      structure.
  99.  
  100.  
  101.      /---------------------------------------------------------------\
  102.      |                                                               |
  103.      |                          INSTALLATION                         |
  104.      |                                                               |
  105.      \---------------------------------------------------------------/
  106.  
  107.      DIRTOT consists of a single file, DIRTOT.EXE.  It can be run from
  108.      wherever it is, or you can copy it to your hard disk.  We
  109.      recommend that you put it in a subdirectory with other utilities
  110.      and which is in the DOS PATH.
  111.  
  112.      DIRTOT requires any PC running DOS 2.0 or later.  It has no
  113.      special memory or display requirements.
  114.  
  115.  
  116.      /---------------------------------------------------------------\
  117.      |                                                               |
  118.      |                           OPERATION                           |
  119.      |                                                               |
  120.      \---------------------------------------------------------------/
  121.  
  122.      The command
  123.  
  124.           dirtot
  125.  
  126.      alone will produce a full report of all subdirectories on the
  127.      current drive.  It will pause after each screen; you can press
  128.      any key to continue.
  129.  
  130.      You can specify the drive:
  131.  
  132.           dirtot d:
  133.  
  134.      or you can specify a particular subdirectory:
  135.  
  136.           dirtot c:\wp51
  137.  
  138.      You can also produce multiple reports from a single command:
  139.  
  140.           dirtot \c600 d:\borlandc c:\windows wp51 e:
  141.  
  142.      DIRTOT has numerous options to customize its output.  (See the
  143.      next section for details.)  Type your options anywhere on the
  144.      command line.  For a brief listing:
  145.  
  146.           dirtot \c600 /b
  147.  
  148.      For a listing of the first level, indented 4 spaces, in
  149.      kilobytes, sorted by size, of all subdirectories on drive D:
  150.  
  151.           dirtot /l1 /i4 /k /s d:
  152.  
  153.      Or use the equivalent command:
  154.  
  155.           dirtot /l1i4ks d:
  156.  
  157.  
  158.      /---------------------------------------------------------------\
  159.      |                                                               |
  160.      |                            PRINTING                           |
  161.      |                                                               |
  162.      \---------------------------------------------------------------/
  163.  
  164.      To send the output to the printer, use the DOS redirection
  165.      feature:
  166.  
  167.           dirtot c: >prn
  168.  
  169.      DIRTOT detects that its output is not going to the screen, so it
  170.      does NOT pause after each screen.  Instead, it prints a heading
  171.      every 58 lines.
  172.  
  173.  
  174.      /---------------------------------------------------------------\
  175.      |                                                               |
  176.      |                      COMMAND LINE OPTIONS                     |
  177.      |                                                               |
  178.      \---------------------------------------------------------------/
  179.  
  180.      Command line options may be preceded by a dash (-) or a
  181.      slash (/), may be entered in upper or lower case, and several
  182.      options may be combined.  Options may appear anywhere on the
  183.      command line.
  184.  
  185.       -a  use standard ASCII characters
  186.  
  187.           This option substitutes the plain characters '+', '-', '|',
  188.           and '\' for the extended graphic characters in the tree
  189.           list.  Its main use is for printing a report on a printer
  190.           that does not support the extended characters.
  191.  
  192.                C600         
  193.                +-BIN        
  194.                +-BINB       
  195.                +-HELP       
  196.                +-INCLUDE    
  197.                | \-SYS      
  198.                +-INIT       
  199.                +-LIB        
  200.                \-SOURCE     
  201.                  +-DOC      
  202.                  \-STARTUP  
  203.                    \-DOS    
  204.  
  205.       -b  Brief output
  206.  
  207.           This option produces a report of just the subdirectories and
  208.           total space used - no headings, no directory or file counts. 
  209.           The Brief option overrides the Percent option.
  210.  
  211.                C600                  6,171,297
  212.                ├─BIN                 2,141,260
  213.                ├─BINB                  562,718
  214.                ├─HELP                2,054,723
  215.                ├─INCLUDE               123,448
  216.                │ └─SYS                   4,327
  217.                ├─INIT                    9,605
  218.                ├─LIB                 1,234,894
  219.                └─SOURCE                 44,649
  220.                  ├─DOC                   8,819
  221.                  └─STARTUP              35,830
  222.                    └─DOS                35,830
  223.  
  224.       -c  no Commas
  225.  
  226.           This option causes numbers to be displayed without thousands
  227.           separators.
  228.  
  229.  
  230.       -h  show Help info
  231.  
  232.           This displays a help screen listing the options.  Same as -?
  233.  
  234.       -i## columns to Indent each level
  235.  
  236.           Put a number from 0 to 12 in place of the "##".  This option
  237.           controls the appearance of the tree listing.  If you do not
  238.           use this option the listing is indented 2 spaces.  Example:
  239.  
  240.                dirtot -i4 \c600
  241.  
  242.                C600                        
  243.                ├───BIN                     
  244.                ├───BINB                    
  245.                ├───HELP                    
  246.                ├───INCLUDE                 
  247.                │   └───SYS                 
  248.                ├───INIT                    
  249.                ├───LIB                     
  250.                └───SOURCE                  
  251.                    ├───DOC                 
  252.                    └───STARTUP             
  253.                        └───DOS             
  254.  
  255.       -k  show numbers in Kilobytes
  256.  
  257.           This option causes the Free space, Total used, and space
  258.           Used to be displayed in kilobytes (1024 bytes) rounded to
  259.           the nearest kilobyte.  For example 119,121 shows as 116K. 
  260.           (See also -m)
  261.  
  262.       -l## maximum Levels to show
  263.  
  264.           Put a number from 0 to 32 in place of the "##".  This option
  265.           limits the number of directory tree levels displayed.  Note
  266.           that all lower levels are scanned and counted regardless of
  267.           this setting.  If you do not use this option up to 32 levels
  268.           are shown.
  269.  
  270.           Zero shows only one line about the topmost level.  One shows
  271.           only the first level subdirectories, two shows two levels of
  272.           subdirectories, etc.
  273.  
  274.       -m  show numbers in Megabytes
  275.  
  276.           This option causes the Free space, Total used, and space
  277.           Used to be displayed in megabytes (1,048,576 bytes) rounded
  278.           to the nearest one-tenth megabyte.  For example 119,121
  279.           shows as .1M.  (See also -k)
  280.  
  281.       -n  No pause each screen full
  282.  
  283.           Normally, when the listing appears on the screen, DIRTOT
  284.           pauses after each screen for you to press a key.  This
  285.           option causes the output to scroll continuously.  (If the
  286.  
  287.  
  288.           output is redirected to the printer or a file DIRTOT does
  289.           not pause regardless of this option.)
  290.  
  291.       -p  show Percent of parent level
  292.  
  293.           This option produces a listing showing Total used, percent
  294.           of total used, total Files, and percent of total files. 
  295.           Percents are OF THE PREVIOUS LEVEL and are rounded to the
  296.           nearest percent.
  297.  
  298.                COMPUADD325     0:42a 04-22-92    10,485,760 Free
  299.                C:\C600                                  3 Levels
  300.                Directory           Total         %   Files    %
  301.                ------------------  -----------  ---  ------  ---
  302.                C600                  6,171,258           94     
  303.                ├─BIN                 2,141,260   35      19   20
  304.                ├─BINB                  562,718    9       7    7
  305.                ├─HELP                2,054,723   33      10   11
  306.                ├─INCLUDE               123,448    2      35   37
  307.                │ └─SYS                   4,327    4       5   14
  308.                ├─INIT                    9,566    0       3    3
  309.                ├─LIB                 1,234,894   20      15   16
  310.                └─SOURCE                 44,649    1       5    5
  311.                  ├─DOC                   8,819   20       2   40
  312.                  └─STARTUP              35,830   80       3   60
  313.                    └─DOS                35,830  100       3  100
  314.  
  315.       -q  Quiet mode
  316.  
  317.           This option turns off the "Totaling..." display, the
  318.           copyright notice, and the beep in error messages.
  319.  
  320.       -s  sort by Size descending
  321.  
  322.           Normally each level of subdirectories is sorted by name. 
  323.           This option causes the subdirectories occupying the most
  324.           space to appear at the top of the list.
  325.  
  326.       -t  no Tree branches
  327.  
  328.           This option turns off the connecting lines in the tree
  329.           display:
  330.  
  331.                C600          
  332.                  BIN         
  333.                  BINB        
  334.                  HELP        
  335.                  INCLUDE     
  336.                    SYS       
  337.                  INIT        
  338.                  LIB         
  339.                  SOURCE      
  340.                    DOC       
  341.                    STARTUP   
  342.                      DOS     
  343.  
  344.  
  345.       -w  Wide printer (132 columns)
  346.  
  347.           When printing a report DIRTOT assumes your printer is 80
  348.           columns wide.  This option lets it know that the printer can
  349.           handle wider output.  DIRTOT does not send any printer
  350.           control codes.  This option makes no difference unless you
  351.           have more than 13 levels of subdirectories.
  352.  
  353.       -?  show Help info
  354.  
  355.           This displays a help screen listing the options.  Same as -h
  356.  
  357.  
  358.      /---------------------------------------------------------------\
  359.      |                                                               |
  360.      |                         OTHER FEATURES                        |
  361.      |                                                               |
  362.      \---------------------------------------------------------------/
  363.  
  364.      DIRTOT indicates subdirectories with Hidden or System attributes
  365.      by displaying their names in lower case.
  366.  
  367.      DIRTOT adapts to the number of rows and columns on your screen. 
  368.      It will pause after every 25, 43, 50, or other number of lines. 
  369.      It will display a wider report if your screen shows more columns
  370.      and you have more than 13 levels of subdirectories.  If you use
  371.      DIRTOT in 40 column mode the brief display format will be used
  372.      automatically - its the only one that fits.
  373.  
  374.      DIRTOT provides National Language Support.  If you have set up
  375.      DOS 3.0 or later for a specific country (by including COUNTRY= in
  376.      your CONFIG.SYS file), the time, date, thousands separator and
  377.      decimal separator will adapt to your country's standards.
  378.  
  379.  
  380.      /---------------------------------------------------------------\
  381.      |                                                               |
  382.      |                     QUESTIONS AND ANSWERS                     |
  383.      |                                                               |
  384.      \---------------------------------------------------------------/
  385.  
  386.      Why do DIRTOT and CHKDSK report different amounts of space used
  387.      on the disk?
  388.  
  389.           CHKDSK counts the unused space at the end of each file - the
  390.           rest of the "Allocation Unit" or "Cluster".  DIRTOT counts
  391.           the actual space each file uses, as reported in a directory
  392.           listing.
  393.  
  394.           CHKDSK may also report one more file, because it counts the
  395.           volume ID as a hidden file.
  396.  
  397.  
  398.      Why do DIRTOT and DIR report different numbers of files in a
  399.      subdirectory?
  400.  
  401.           DIR counts the '.' and '..' DOS housekeeping files, but
  402.           ignores any Hidden files.  DIRTOT ignores the '.' and '..'
  403.           files, and counts any Hidden files.
  404.  
  405.      Why do some numbers show as 0K and others as just plain 0?
  406.  
  407.           0K means the actual value is between 1 and 511 inclusive. 
  408.           .0M means the actual value is between 1 and 52,428
  409.           inclusive.  0 means the actual value is exactly zero.
  410.  
  411.      Why does DIRTOT take so long to display its results?
  412.  
  413.           In order to come up with its totals DIRTOT must read the
  414.           entire directory structure of your hard disk.  The final
  415.           grand total appears on the very first line, and the width of
  416.           the output is unknown until the deepest subdirectory has
  417.           been scanned.  Quincunx Software has done its best to
  418.           minimize this time.  Since the vast majority of the time is
  419.           spent in DOS waiting for the disk, we believe DIRTOT is as
  420.           fast as or faster than any other utility that reads the
  421.           entire directory structure.
  422.  
  423.      My disk has 19 levels of subdirectories on it.  How are you going
  424.      to handle that?
  425.  
  426.           The listing expands in width until it fills the screen, then
  427.           additional levels of subdirectories are shown in a column
  428.           with a level number:
  429.  
  430.           Directory                               Total       
  431.           --------------------------------------  ----------- 
  432.           A                                         1,052,672 
  433.           └─B                                       1,052,672 
  434.             └─C                                     1,052,672 
  435.               └─D                                   1,052,672 
  436.                 └─E                                 1,052,672 
  437.                   └─F                               1,052,672 
  438.                     └─G                             1,052,672 
  439.                       └─H                           1,052,672 
  440.                         └─I                         1,052,672 
  441.                           └─J                       1,052,672 
  442.                             └─K                     1,052,672 
  443.                               └─L                   1,052,672 
  444.                                 └─M                 1,052,672 
  445.                                   └─N               1,052,672 
  446.                                 14> O               1,052,672 
  447.                                 15> P               1,052,672 
  448.                                 16> Q               1,052,672 
  449.                                 17> R               1,052,672 
  450.                                 18> SSSSSSSS.SSS    1,052,672 
  451.                                 19> T                       0 
  452.       
  453.           Exactly when this happens depends on the settings for indent
  454.           and number format.  The default settings trip at level 14,
  455.  
  456.  
  457.           but if you set indent to 1 and number format to Kilobytes
  458.           (/i1k) all 32 levels that DOS allows will be shown in tree
  459.           format.
  460.  
  461.  
  462.      /---------------------------------------------------------------\
  463.      |                                                               |
  464.      |                         ERROR MESSAGES                        |
  465.      |                                                               |
  466.      \---------------------------------------------------------------/
  467.  
  468.      *** Path not found
  469.  
  470.           A subdirectory you entered on the command line does not
  471.           exist.  Maybe you misspelled it.  Try again.
  472.  
  473.           If you are running on a network or under a multitasking
  474.           system there is a slight chance that another program or user
  475.           removed a directory between the time that DIRTOT first
  476.           detected it and then went back to scan it.
  477.  
  478.      *** Internal storage full, complete path not scanned
  479.  
  480.           The memory that DIRTOT allocated to store subdirectories is
  481.           full.  It will report what it has, but it did not cover your
  482.           entire disk.
  483.  
  484.           DIRTOT has room to store over 1500 subdirectories, so to get
  485.           this message you either must have a VERY large disk or are
  486.           running DIRTOT with less than 85K of memory available.  If
  487.           you actually have more than 1500 subdirectories, let
  488.           Quincunx Software know so we can consider producing an
  489.           expanded version.
  490.  
  491.      *** Error allocating memory
  492.  
  493.           An internal error occurred.  Report this to Quincunx
  494.           Software.
  495.  
  496.  
  497.      /---------------------------------------------------------------\
  498.      |                                                               |
  499.      |                      TIPS AND TECHNIQUES                      |
  500.      |                                                               |
  501.      \---------------------------------------------------------------/
  502.  
  503.      To produce the briefest possible listing of the space in use on
  504.      several drives use the Brief, max Level 0, and Megabyte options:
  505.  
  506.           dirtot /blm c: d: e:
  507.  
  508.           C:\           127.7M
  509.  
  510.           D:\           114.1M
  511.  
  512.           E:\            23.4M
  513.  
  514.  
  515.      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  516.  
  517.      To get a good picture of the space used by the various major
  518.      programs on your system, use the Level 1 and Percent options:
  519.  
  520.           dirtot /l1p c:\
  521.  
  522.      If you prefer to see the largest first, include the Sort by size
  523.      option:
  524.  
  525.           dirtot /l1ps c:\
  526.  
  527.      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  528.  
  529.      You can cancel DIRTOT's output at any time by pressing Ctrl+C or
  530.      Ctrl+Break.
  531.  
  532.      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  533.  
  534.      If you find a set of options that you want to use frequently,
  535.      create a one line batch file.  For example: 
  536.  
  537.           copy con dt.bat
  538.           dirtot /l1 /i4 /k /p /q %1
  539.           ^Z
  540.  
  541.      Then whenever you type
  542.  
  543.           dt
  544.  
  545.      you will get DIRTOT with your favorite options.  (The ^Z is
  546.      produced by pressing Ctrl+Z and then Enter.)
  547.  
  548.  
  549.      /---------------------------------------------------------------\
  550.      |                                                               |
  551.      |                          REGISTRATION                         |
  552.      |                                                               |
  553.      \---------------------------------------------------------------/
  554.  
  555.      DIRTOT is distributed as Shareware.  You are encouraged to give
  556.      copies to your friends, co-workers, and user groups, and upload
  557.      copies to Bulletin Board Systems.  All copies must be unaltered
  558.      and include the files DIRTOT.EXE and DIRTOT.DOC.  The author,
  559.      Quincunx Software, retains all other rights to the program.
  560.  
  561.      Non-registered users of this software are granted a limited
  562.      license to make an evaluation copy for trial use on a private,
  563.      non-commercial basis, for the express purpose of determining
  564.      whether DIRTOT is suitable for their needs.  At the end of this
  565.      trial period, you must either register your copy or discontinue
  566.      using DIRTOT.
  567.  
  568.      Should you decide to use DIRTOT, or keep it on your hard disk for
  569.      future use, you are obligated to pay a registration fee of $9.00
  570.      (Nine U.S. Dollars).  Send payment in check or money order to:
  571.  
  572.  
  573.                              Quincunx Software
  574.                               8178 Allgwen Rd.
  575.                             Barneveld, WI 53507
  576.  
  577.      Whether you register or not, please notify Quincunx Software of
  578.      any problems you encounter using DIRTOT, and of any improvements
  579.      you would like to see.
  580.  
  581.      Quantity discounts and site licenses are available.  Write for
  582.      information.
  583.  
  584.      Companies and organizations that provide software duplication
  585.      services may include DIRTOT in their catalog and provide copies
  586.      for a reasonable duplication fee, provided the purchaser is
  587.      notified that no portion of the fee goes to the Shareware author
  588.      and that the purchaser is still obligated to register.
  589.  
  590.      Quincunx Software hereby disclaims all warranties relating to
  591.      this software, whether express or implied, including without
  592.      limitation any implied warranties of merchantability or fitness
  593.      for a particular purpose.  Quincunx Software will not be liable
  594.      for any special, incidental, consequential, indirect or similar
  595.      damages due to loss of data or any other reason, even if Quincunx
  596.      Software or an agent of Quincunx Software has been advised of the
  597.      possibility of such damages.  In no event shall Quincunx
  598.      Software's liability for any damages ever exceed the price paid
  599.      for the license to use this software, regardless of the form of
  600.      the claim.
  601.  
  602.  
  603.                           DIRTOT REGISTRATION FORM
  604.  
  605.                              Quincunx Software
  606.                               8178 Allgwen Rd.
  607.                             Barneveld, WI 53507
  608.  
  609.  
  610.      Name:     _______________________________________________________
  611.  
  612.      Company:  _______________________________________________________
  613.  
  614.      Address:  _______________________________________________________
  615.  
  616.                _______________________________________________________
  617.  
  618.      City:     ________________________  State: _____  Zip: __________
  619.  
  620.      Country:  _______________________________________________________
  621.  
  622.      Phone:    _______________________________________________________
  623.  
  624.  
  625.      Please register DIRTOT Version 1.0 in the above name.
  626.  
  627.      ________ copies at $9.00 per copy.  Amount enclosed _____________
  628.  
  629.  
  630.      Suggested enhancements:
  631.  
  632.      _________________________________________________________________
  633.  
  634.      _________________________________________________________________
  635.  
  636.      _________________________________________________________________
  637.  
  638.      _________________________________________________________________
  639.  
  640.      _________________________________________________________________
  641.  
  642.      _________________________________________________________________
  643.  
  644.      _________________________________________________________________
  645.  
  646.      _________________________________________________________________
  647.  
  648.  
  649.      Thank you for your support.
  650.