home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / PASCAL / DU111 / DU.TXT < prev   
Text File  |  1991-10-29  |  5KB  |  126 lines
  1.  
  2. 1. Overview.
  3.  
  4.   DU is a small UNIX-like utility to show how much space is occupied by a 
  5. directory tree.
  6.   It can show how much space is occupied by the entire directory tree or by 
  7. any number of filespecs, optionally excluding any number of filespecs, it 
  8. can show the size of every file, just the directory totals, or just the 
  9. grand total.
  10.   Starting with v1.09 DU is supposed to accept the (all too few) Unix-du- 
  11. options.
  12.  
  13. 2. Basic syntax.
  14.  
  15.   Arguments may be options, filespecs or directory names.  The directory 
  16. names separate the other arguments into global and local arguments:
  17.  
  18.   du {global arguments} {base directory {local arguments} }
  19.  
  20.   DU searches through each directory for the files specified before the 
  21. first directory name (global arguments) and those between this and the next 
  22. directory name (local).  If no directory name is specified, . (the current 
  23. directory) is used.
  24.   Later options override earlier, eg. a local /0 overrides a global /1.
  25.   If any include filespecs are specified, the directory table will not be 
  26. counted in the directory size.  Exclude filespecs don't matter.
  27.   Both / and \ may be used in paths, and both / and - as switch character.  
  28. DU will generally figure out what you mean.  If it doesn't you'll get an 
  29. error message.
  30.  
  31. 3. Command line options.
  32.  
  33.   Option a (du /a or du -a) will list the file sizes as well as the 
  34. directory totals.
  35.   Option d will show DU's interpretation of the arguments.
  36.   Option h (or ?) will display a short help screen.
  37.   Option i will include the following filespecs; refer to part 4.
  38.   Option n will not include subirectories in the directory size.
  39.   Option s will skip the directory totals and display only the sum.  This 
  40. is exactly the same as -0.
  41.   Option w will show the percentage of space wasted due to too-large 
  42. clusters.
  43.   Option z will suppress 0k files and directories.
  44.   Option 0..65535 shows directories down to the specified level.  
  45. Directories deeper are counted but not listed.
  46.   Option x will exclude the following filespecs, refer to part 4.
  47.  
  48. 4. Filespecs.
  49.  
  50.   Standard Unix DU always counts all the files.  This version, however, 
  51. allows you to count only some files or all except some files.
  52.   If you don't specify an include filespec, * (which matches everything) 
  53. will be used.
  54.   If you do specify one or more filespecs, only files matching one (or 
  55. more) of the specs are counted.
  56.   You can exclude files as well, and include files again.
  57.   The filespecs aren't limited by the normal brainless DOS rules. * and ? 
  58. work, but match . as well as normal chars.  You can also match a list, like 
  59. [a-cx], which matches a, b, c and x.  Note that it isn't completely Unix- 
  60. ish either.
  61.  
  62. 4. Examples.
  63.  
  64.   These are examples of the options I use. Sorry, you won't find examples 
  65. of every last option here.  As you can see, I use both / and - as switch 
  66. characters.
  67.  
  68.   du -1 / shows how much each directory subtree takes, counting all the 
  69. directories but showing only those directly below the root.
  70.  
  71.   du -az *asm* -x ?asm.*
  72. displays the size and path of every file whose name contains ASM anywhere 
  73. except in the 2..4 position, and how much space these files occupy in each 
  74. directory.  Empty directories are not shown.  RM.ASM and OBJ2ASM.COM is 
  75. listed, TASM.EXE isn't.
  76.  
  77.   du -zn *.obj
  78. shows how much space is occupied by .obj files in each directory that 
  79. contains at least one (0k directories aren't shown).  .obj files in 
  80. subdirectories aren't counted in the directory size.
  81.  
  82.   du -as *.bak *.bk[!1-9] *.old
  83. shows all the backup files in the directory tree, ie. files with a file 
  84. type of BAK, BK!, BK1, BK2, BK3, BK4, BK5, BK6, BK7, BK8, BK9 or OLD.
  85.  
  86.   du /x *.bak *.bk[!1-9]
  87. shows the directory totals excluding any backup files.
  88.  
  89.   du *gif* -x *gif*.exe /i vgif*
  90. searches for files containing 'gif' anywhere in the name or extension, 
  91. except files containing 'gif' in the name and with an extension of 'exe', 
  92. but including files whose name starts with 'vgif'.  Pretty far-fetched. 
  93.  
  94.   du /s *.zip *.arc *.arj *.lzh *.gif *.jpg *.pcx *.bmp
  95. finds out how much of your precious hard disk is wasted on archives or 
  96. pretty pictures.
  97.  
  98. 6. Bugs
  99.  
  100.   The root directory doesn't exist, according do Mess-DOS' own FindFirst 
  101. function.  My workaround is to search for a directory called 'dirname' 
  102. first, and if that doesn't work to search for anything called 
  103. 'dirname\*.*'.  This should work for everything except completely empty 
  104. drives.
  105.   The directory table size is only an estimate, and sometimes too low.
  106.   DU does some checking for cluster sizes, not much.  JOIN, SUBST and many 
  107. networks will fool it; in those cases it assumes either 1k or the cluster 
  108. size of the default drive.
  109.   The 'wasted space' percentage is incorrect on Stacker volumes, as Stacker 
  110. will use the 'wasted' space for something.
  111.   DU often says that more space is wasted that Norton FS does.  This is 
  112. because DU counts the directory table as well as the files.
  113.   You can't start filespecs with /, to avoid clashes with options.
  114.  
  115. 7. Send me a card?
  116.  
  117.   If you like or use DU or any of my other utilities, please send me a 
  118. postcard at the following address:
  119. Arnt Gulbrandsen
  120. Postboks 1036
  121. N-7801 Namsos
  122. Norway
  123.  
  124.   If you have any questions / comments, send them to me at the above 
  125. address or by email to agulbra@siri.unit.no.
  126.