home *** CD-ROM | disk | FTP | other *** search
/ Windows NT Super Tune-Up Kit / PIE-WindowsNTSuperTuneUpKit-1997.iso / DISK_UTL / DIRSIZ24 / DIRSIZE.TXT < prev    next >
Text File  |  1996-06-13  |  15KB  |  411 lines
  1. DIRSIZE v2.4
  2. ============
  3.  
  4. Copyright 1993-1996 Simon A Carter
  5.  
  6. The Directory Size Lister with the Lot:
  7.  
  8.     *  Summary statistics for multi-level directories. This is
  9.        very useful for finding the complete size of applications
  10.        before deletion or backup.
  11.     *  Support for Windows 95 long filenames.
  12.     *  For the drive, displays cluster size, free space, used
  13.        space and capacity.
  14.     *  For the files examined, displays used space and wasted
  15.        space.
  16.     *  Rounds up file sizes to the cluster size for the most
  17.        accurate size information.
  18.     *  Future proof - directory sizes up to 99 GB are catered for.
  19.     *  Output can be redirected to a file or to the printer.
  20.     *  The characters used to draw the directory tree can be
  21.        changed from DOS extended ASCII characters to standard
  22.        ASCII characters.
  23.     *  Continuous progress indicator while accumulating file
  24.        information.
  25.  
  26.  
  27. PRIVATE use of DirSize is FREE. Please register your usage by
  28. sending email to launch@ozemail.com.au, with your name and
  29. address.
  30.  
  31. Paid registration is required for use in a business, commercial,
  32. government or institutional environment. This costs $AUS 20. This
  33. covers my costs of sending the registered version to you. Please
  34. see the end of this file for more information.
  35.  
  36.  
  37. What will DirSize do for ME ?
  38. =============================
  39.  
  40. DirSize shows a graphical tree of the directories on your hard
  41. disk. The tree starts from the current directory, or from the
  42. directory that you specify. The left column displays the disk
  43. space used by each directory. Directories that contain further sub-
  44. directories display summary statistics in square brackets after
  45. the directory name. This is very useful for determining the
  46. complete size of an application, for example, if you were hunting
  47. for an application to remove to make way for a new one.
  48. Alternatively, DirSize can be used to find the total size of an
  49. application before a backup or copy is made.
  50.  
  51. DirSize automatically detects and displays Windows 95 long
  52. filenames. Of course, it will still run under any older version of
  53. DOS.
  54.  
  55.  
  56. Installation
  57. ============
  58.  
  59. Just copy DIRSIZE.EXE to a directory in your path, for example, to
  60. C:\DOS. To find out the directories in your path, type
  61.  
  62.    c:\> path    [Enter]
  63.  
  64.  
  65. How to use DirSize
  66. ==================
  67.  
  68. Typing
  69.  
  70.    dirsize    [Enter]
  71.  
  72. on its own will display usage information, as well as running
  73. dirsize on the current directory.
  74.  
  75. Usage:
  76.    dirsize [/C<+|->] [initial path]
  77.  
  78. The initial path is optional - if you leave it out, DirSize will
  79. start its display from the current directory. Directory names with
  80. special characters such as spaces can be entered normally i.e.
  81. quotes are not required e.g.
  82.  
  83.    c:\> dirsize Program Files    [Enter]
  84.  
  85. When DirSize detects that its output is being redirected, it
  86. automatically selects portable characters to draw lines, such as
  87. +, - and |. It does this because the output may be sent to a
  88. device or another computer that does not understand DOS's line
  89. drawing characters. When DirSize's output goes to the screen, it
  90. uses the DOS line drawing characters. You can override the default
  91. behaviour in either case using the optional /C parameter:
  92.  
  93.    /C+   forces DirSize to use DOS's graphical line drawing
  94.          characters even if it detects that its output is being
  95.          redirected.
  96.    /C-   forces DirSize to use portable text line drawing
  97.          characters even if it detects that its output is not
  98.          being redirected. This is useful if the result is going
  99.          to be used on another computer, for example, on a Unix
  100.          machine or a Macintosh.
  101.  
  102.  
  103. Redirecting Output
  104. ------------------
  105.  
  106. DirSize's output can be redirected to any device. For example, to
  107. save DirSize's output to the file output.txt, you can type:
  108.  
  109.    c:\> dirsize > output.txt    [Enter]
  110.  
  111. To add DirSize output to an existing file exists.txt, type
  112.  
  113.    c:\> dirsize >> exists.txt    [Enter]
  114.  
  115. To send DirSize's output to the printer, type
  116.  
  117.    c:\> dirsize > prn    [Enter]
  118.  
  119. To run DirSize on your entire D: drive, type
  120.  
  121.    c:\> dirsize d:\    [Enter]
  122.  
  123. To view a convenient page-by-page display of DirSize's output,
  124. type
  125.  
  126.    c:\> dirsize | more    [Enter]
  127.  
  128.  
  129. DirSize Example
  130. ---------------
  131.  
  132. The output below was generated from running DirSize in the Program
  133. Files directory (in a DOS shell under Windows 95):
  134.  
  135.    c:\> dirsize Program Files    [Enter]
  136.    
  137.                 0   C:\Program files   [113,082,368]
  138.         1,277,952   |--Accessories   [1,769,472]
  139.           491,520   |  +--HyperTerminal
  140.                 0   |--Common Files   [16,121,856]
  141.                 0   |  +--Microsoft Shared   [16,121,856]
  142.           557,056   |     |--Artgalry
  143.           819,200   |     |--Equation
  144.         1,998,848   |     |--Grphflt
  145.         2,260,992   |     |--Msgraph5
  146.           458,752   |     |--MSinfo
  147.         1,540,096   |     |--MSquery
  148.         1,671,168   |     |--Orgchart
  149.         2,850,816   |     |--Proof
  150.         1,998,848   |     |--Textconv
  151.         1,376,256   |     |--VBA
  152.           589,824   |     +--Wordart
  153.           655,360   |--Font Assistant
  154.         3,014,656   |--Games
  155.            65,536   |--Help Assistant
  156.         5,242,880   |--JOBINT
  157.           851,968   |--Launch
  158.           786,432   |--LVIEWPRO
  159.            65,536   |--Microsoft Exchange
  160.         6,651,904   |--Norton AntiVirus   [7,208,960]
  161.           557,056   |  +--System
  162.         2,293,760   |--Norton Commander
  163.                 0   |  +--Indexing
  164.         8,978,432   |--Norton Utilities   [14,942,208]
  165.         5,963,776   |  +--System
  166.        11,272,192   |--PAINTER3   [15,564,800]
  167.           557,056   |  |--MOVIES
  168.           589,824   |  |--NOZZLES
  169.           720,896   |  |--SESSIONS
  170.           819,200   |  |--SUPPLIES
  171.         1,605,632   |  +--TUTORIAL
  172.           655,360   |--Plus!   [2,293,760]
  173.         1,146,880   |  |--Setup
  174.           491,520   |  +--System
  175.           262,144   |--Resource Kit
  176.         5,570,560   |--RESUMEW   [9,895,936]
  177.           753,664   |  |--LETTERS   [1,015,808]
  178.           262,144   |  |  +--MRG_LET
  179.         3,309,568   |  +--RESUMES
  180.         1,736,704   |--Symantec
  181.         1,212,416   |--The Microsoft Network
  182.         1,802,240   |--Type twister
  183.           688,128   |--UltraEdit
  184.         2,129,920   |--VendInfo
  185.         4,161,536   |--Visio   [20,381,696]
  186.         2,719,744   |  |--Add-ons
  187.           393,216   |  |--Drawings
  188.         3,014,656   |  |--Help
  189.                 0   |  |--Stencils   [4,816,896]
  190.         4,816,896   |  |  +--Standard
  191.            98,304   |  |--System   [4,554,752]
  192.           360,448   |  |  |--Custom
  193.         2,129,920   |  |  |--Filter32
  194.         1,277,952   |  |  |--Setup32
  195.           688,128   |  |  +--Spelling
  196.                 0   |  +--Template   [720,896]
  197.           458,752   |     |--Standard
  198.           262,144   |     +--Wizards
  199.           262,144   |--winhack
  200.         2,523,136   |--WINRES
  201.         1,310,720   +--WinZip
  202.    
  203.    Files examined:
  204.         Used space:    113,082,368 bytes
  205.       Wasted space:     19,348,332 bytes (17% of used)
  206.    
  207.    Drive C:
  208.       Cluster size:         32,768 bytes
  209.         Free space:    139,886,592 bytes (12% of capacity)
  210.         Used space:    947,847,168 bytes
  211.           Capacity:  1,087,733,760 bytes
  212.  
  213.  
  214. Note how all sizes shown (except the wasted space) are integral
  215. (whole) multiples of the drive's cluster size.
  216.  
  217.  
  218. What is the "Cluster Size" ?
  219. ============================
  220.  
  221. When your computer places files on a disk (both hard disks and
  222. floppy disks), it must use an integral number of allocation units.
  223. The size of the allocation units varies depending on the total
  224. capacity of the disk. This means that if a file is smaller than
  225. one complete allocation unit, it does not fill the entire
  226. allocation unit. For example, lets say we have a file that is 300
  227. bytes long. On a floppy disk with an allocation unit of 512 bytes,
  228. the file will only occupy the first 300 bytes, but since one
  229. entire allocation unit must be used, the remaining 212 bytes are
  230. wasted. A file 513 bytes long will occupy 2 allocation units, with
  231. 511 bytes wasted. An allocation unit is called a CLUSTER. Floppy
  232. drives typically use a cluster size of 512 bytes or 1,024 bytes,
  233. so not much space is wasted. Hard disks range from 2,048 bytes
  234. (for a 106 MB drive) to 32,768 bytes (for a 1.04 GB drive) and
  235. even 65,535 bytes, which means that a great deal of space is
  236. wasted. The cluster size gets bigger with bigger disks for two
  237. reasons:
  238.  
  239.    1)    A DOS limitation that sets an absolute upper maximum on
  240.          the total number of clusters on a drive (65535).
  241.    2)    The overhead of managing a large number of clusters
  242.          consumes a lot of disk space that cannot be used for
  243.          anything else.
  244.  
  245. The DOS DIR command always shows you the size actually in use by
  246. the file - it does not include the extra 'wasted' space at the end
  247. of the cluster. This wasted space is sometimes referred to as
  248. 'slack' space.
  249.  
  250.  
  251. Directories use up clusters too
  252. -------------------------------
  253.  
  254. Each directory takes up a minimum of one cluster. To reduce the
  255. amount of disk space used by directories, remove directories that
  256. do not contain any files.
  257.  
  258.  
  259. Lost clusters
  260. -------------
  261.  
  262. Clusters can become orphaned when DOS is unable to complete
  263. changes to the disk, for example, when you are forced to reboot
  264. your machine or when the power is turned off accidentally. These
  265. clusters cannot be used until they are identified and reclaimed.
  266. Use the DOS CHKDSK command to reclaim lost clusters. Lost clusters
  267. are considered to be used.
  268.  
  269.  
  270. Reducing wasted space
  271. =====================
  272.  
  273.  
  274. What about Disk Compression ?
  275. -----------------------------
  276.  
  277. Disk compression programs like Stacker and DoubleSpace are able to
  278. make use of the wasted space because they take on the
  279. responsibility of storing the files themselves. By doing so, they
  280. overcome DOS's integral cluster size limitation.
  281.  
  282.  
  283. What about archives ?
  284. ---------------------
  285.  
  286. Storing collections of files in a compressed or uncompressed
  287. archive saves space, because by grouping all of the files into one
  288. large file, only a small amount of space is wasted. The archive
  289. program uses its own format to store the files without wasting
  290. space.
  291.  
  292.  
  293. Partitions
  294. ----------
  295.  
  296. Partitions subdivide a physical disk drive into a number of
  297. logical drives. For example, a 500 MB hard disk could be
  298. partitioned into two 250MB partitions, C: and D:. The advantage of
  299. doing this is that the cluster size can be smaller, and hence the
  300. amount of wasted space will be smaller. The disadvantage is that
  301. it takes time to set up (since you have to move ALL of your data
  302. off the hard disk in order to partition it), and you have to
  303. remember which drive your programs are on, and manage space across
  304. two drives instead of one. For more information on partitions, see
  305. the DOS FDISK command.
  306.  
  307.  
  308. Release Information
  309. ===================
  310.  
  311. Date       Version   Changes Made
  312. 13-June-96 2.4       Increased stack limit to 64K, and reduced
  313.                      stack usage. This means that you can list
  314.                      directories that are more than 20 times
  315.                      deeper than before. Appreciably faster (11
  316.                      seconds compared to 14 for a complete display
  317.                      of a 1.1 Gb drive).
  318.                      Now only shows usage information if /?, ? or
  319.                      -h given as first parameter.
  320.                      Email and address changes.
  321. 27-May-96  2.3       Documentation update.
  322. 8-May-96   2.2       Shows usage information if no parameters are
  323.                      provided.
  324.                      Fixed bug in long filename functions that
  325.                      prevented them from working under some
  326.                      circumstances.
  327.                      Fixed bug in file size rounding up function,
  328.                      which made files that were an integral number
  329.                      of clusters long one extra cluster long.
  330.                      Documentation update.
  331. 28-April-  2.1       First release.
  332. 96
  333. 3-July-93  1.0       First created and used.
  334.  
  335.  
  336. Registration
  337. ============
  338.  
  339. PRIVATE use of DirSize is FREE. Please register your usage of
  340. DirSize by sending email to launch@ozemail.com.au, with your name
  341. and address, and any relevant comments.
  342.  
  343. Paid registration is required for use in a business, commercial,
  344. government or institutional environment. This costs $AUS 20, and
  345. covers my costs of sending the registered version to you.
  346.  
  347. Order form
  348. ----------
  349.  
  350.  
  351.     Personal details
  352.     ----------------
  353.     
  354.            Name: ____________________________________________
  355.         Company: ____________________________________________
  356.         Address: ____________________________________________
  357.                  ____________________________________________
  358.                  ____________________________________________
  359.                  ____________________________________________
  360.           Phone: ____________________________________________
  361.             Fax: ____________________________________________
  362.  
  363.  
  364.     For Visa, MasterCard or Bank Card
  365.     ---------------------------------
  366.     (Sorry, I currently do not accept American Express)
  367.     
  368.     Card Number: ____ ____ ____ ____
  369.     Expiry Date: ____/______
  370.     
  371.     
  372.       Signature: ________________________________
  373.     
  374.            Date: ____________
  375.     
  376.     Please note that these orders are processed by Omnivision
  377.     Technologies, a licensed distributor.
  378.     
  379.     
  380.     Cheques
  381.     -------
  382.     I accept bank cheques, personal cheques drawn on an Australian
  383.     bank, and foreign cheques that include an additional $AUS 12
  384.     to cover my bank's foreign cheque charge. Please make cheques
  385.     payable to Simon Carter.
  386.     
  387.     
  388.     Postal money orders
  389.     -------------------
  390.     I accept postal money orders in Australian dollars.
  391.  
  392.  
  393. Contact Information
  394. ===================
  395.  
  396. I am always happy to hear your comments! If you use and like
  397. DirSize, or have any suggestions for improvements, please drop me
  398. a line!
  399.  
  400.      email: launch@ozemail.com.au
  401.        Fax: +61-3 9800 3078  Any time.
  402.      Voice: +61-3 9729-8836  After hours number. Please leave a
  403.             contact name, number and time, and I will try to
  404.             get back to you within 24 hours.
  405.       Mail: Simon Carter
  406.             Crystal Software
  407.             2/9 Woodbine Court
  408.             Wantirna
  409.             Victoria 3152
  410.             AUSTRALIA.
  411.