home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / usage11.zip / USAGE11.DOC < prev    next >
Text File  |  1995-03-31  |  6KB  |  149 lines
  1. 03-31-95 3:28pm
  2.  
  3.  
  4.                          **The USAGE Utility**
  5.                               Version 1.10
  6.  
  7. BY: Reed R. Mangino
  8. email: tornado@esu.edu
  9.  
  10. IMPORTANT:
  11.   USAGE and everything contained therein is FREEWARE.  Do with it
  12.   what you like.  I happen to think it is a handy little utility, but
  13.   then again I have a type A personality! :)  If you have any comments
  14.   about USAGE, please drop me a line at my email address.
  15.  
  16.   If USAGE blows up your computer or harms any fury little animals I
  17.   cannot be held responsible!  What the heck do I know, I'm just a poor
  18.   college kid!
  19.  
  20. USEAGE10.ZIP should contain the following:
  21.   FILE_ID  . DIZ      671   Quick description of USAGE
  22.   USEDOS16 . EXE   35,038   16-bit DOS executable
  23.   USEOS2   . EXE   23,756   32-bit OS/2 executable
  24.   USAGE10  . DOC    5,907   This file
  25. **  If any of these files are missing or their sizes have changed please
  26. **  do not use any of the executables!  Email me and I will see that you
  27. **  get a valid copy.
  28.  
  29. OS/2 USERS:
  30.   USAGE knows all about long filenames and non-DOS directories!
  31.   USEOS2.EXE does NOT count extended attributes.  On my HPFS drive
  32.   (300meg) USEOS2.EXE was off by a whopping 11 bytes! :)
  33.  
  34. PURPOSE:
  35.   USAGE.EXE is a utility that displays the amount of disk space
  36.   that your directories are utilizing.  Run USAGE from any directory
  37.   and each immediate sub directory will be displayed along with the
  38.   total amount of disk space used by that directory AND the percentage
  39.   of that usage.
  40.  
  41.   NOTE: USAGE.EXE counts ALL files: HIDDEN, SYSTEM, READONLY, ARCHIVE
  42.  
  43.   If the output from USAGE scrolls off the screen, pipe the output
  44.   to MORE.  For example:
  45.                 C:\USAGE | MORE <return>
  46.  
  47. INSTALLATION:
  48.   Nothing special has to be performed to start using USAGE.  Just throw
  49. the desired executable into a directory in your PATH and off you go.
  50.  
  51. IMPORTANT: You CAN rename any of the executables to any name you like.
  52.   So you could rename USEDOS16.EXE to USAGE.EXE to save some
  53.   keystrokes.  Just remember which operating system the executable is
  54.   for.
  55.  
  56. QUICK EXAMPLE:
  57.   A quick example should show you EXACTLY what USAGE does!  I have
  58.   renamed USEDOS16.EXE to USAGE.EXE for these examples.  It is assumed
  59.   that USAGE.EXE is in the PATH.
  60.  
  61. D:\USAGE<return>
  62. YIELDS:
  63.  
  64. Directory               Total Usage  % Usage
  65. ---------               -----------  -------
  66. D:\                         262563     0.12%
  67.  DISKS                    14319069     6.51%
  68.  PC                        3792334     1.73%
  69.  GAMES                    68749014    31.28%
  70.  BP                       15383497     7.00%
  71.  PCTOOLS                   5807884     2.64%
  72.  MISC                     20033756     9.11%
  73.  DELETE                     117788     0.05%
  74.  ZDBENCH                   3000981     1.37%
  75.  TEMP                       202223     0.09%
  76.  TC                        8338258     3.79%
  77.  WGT                       4773091     2.17%
  78.  WATCOM                   75014603    34.13%
  79.                         -----------
  80. TOTAL:                   219795061
  81.  
  82.   You can read this as:  The root dir of D:\ contains 262563 bytes that
  83. account for 0.12% of the total files located below (and including) the
  84. root directory.  You can see that the contents of the WATCOM directory
  85. makes up for 34.13% of the disk usage.
  86.  
  87.   Now that we know that the GAMES directory is taking up 68 megs of
  88. disk space, lets see what individual game is the largest.
  89.  
  90.   Just change the current directory to D:\GAMES and invoke USAGE as
  91. above.
  92.  
  93. D:\GAMES\USAGE<return>
  94. YEILDS:
  95.  
  96. Directory               Total Usage  % Usage
  97. ---------               -----------  -------
  98. D:\GAMES                         0     0.00%
  99.  DOOM2                    22543025    32.79%
  100.  HOCKEY                    9709227    14.12%
  101.  CM                        3235985     4.71%
  102.  MOON                      3819020     5.56%
  103.  LINKS                     7406525    10.77%
  104.  HEXX                       611244     0.89%
  105.  HTIC                     12329165    17.93%
  106.  DESCENT                   7170379    10.43%
  107.  MYST                      1924444     2.80%
  108.                         -----------
  109. TOTAL:                    68749014
  110.  
  111.   OUCH, DoomII takes up 22 megs!  Well I still love the game, so I'll
  112. keep it.
  113.  
  114. REMEMBER:  As long as USAGE.EXE is in your path you can see the stats
  115.   for any directory on your drive.
  116.  
  117. --------------------------------------------------------------------------
  118. PERSONAL STUFF:
  119.  
  120.   Man you must be bored! :)  I wrote this program to refresh my C++
  121. skills.  The fact that I bought a new multi-platform compiler didn't
  122. hurt things either!
  123.  
  124.   The USAGE idea interested me because I have seen directory traversal
  125. code that was over 100 lines long (no recursion of course).  Even the
  126. recursive routines were a bit clumsy.  So I set out to write a tight
  127. directory traversal.  What I came up with was All_Dirs(char *path).
  128. All_Dirs is a stunning 7 lines of C code!  Of course, it took me about
  129. 2 days to get it there! :)
  130.  
  131.   There's not much to say about me other than I love to program and
  132. mess with my computer.  I have a Pentium-60 and I finally got my new
  133. "bug free" CPU!  Thanks INTEL! :)
  134.  
  135.   I am currently in my senior year at East Stroudsburg University,
  136. located in East Stroudsburg, PA, USA.  I am studying Computer Science
  137. and I would be loving life if it weren't for all these darn math
  138. classes.
  139.  
  140.   Drop me a line if you have comments about USAGE.  BTW, if you like
  141. USAGE, go get DELEX from ftp:\\garbo.uwasa.fi or ftp:\\oak.oakland.edu.
  142. If you work with ZIP files at all, DELEX will make your life much
  143. easier.  It is THE deletion exception for DOS!
  144.  
  145. YO!
  146. --------------------------------------------------------------------------
  147. CHANGES FROM 1.00
  148.   A function was created to separate long numbers by commas for
  149. readability purposes.