home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / fish / 771-780 / ff777 / sizer / sizer.doc < prev    next >
Text File  |  1992-12-06  |  7KB  |  191 lines
  1.  
  2.  
  3.                               S I Z E R    D O C
  4.  
  5.  
  6.                                  Gérard CORNU
  7.  
  8.                                      ;-)
  9.  
  10.                             (0.36 ßeta,  14-Nov-92)
  11.  
  12.  
  13.    Sizer is ©1992 Gérard Cornu, but freely redistributable. When re-
  14.    distributing don't forget to include this unmodified doc file. And 
  15.    don't charge more than the cost of an AmigaLib disk from Fred FISH. 
  16.  
  17.    This program cannot be used for commercial purposes, or included on 
  18.    magazine's cover disks without the written permission of the author.
  19.                                                                        
  20.    Peter Miles (see end of file*) is obviously granted permission to 
  21.    include it in any ICPUG Amiga library disk ;-).
  22.  
  23.    Fred Fish is obviously allowed to include it in its unique 
  24.    AmigaLibDisk library.
  25.  
  26.    Thierry Colin ("Amiga DP", french Amiga ONLY PD magazine) is also 
  27.    authorised to include it in the french PD collection "DPAT" (Domaine 
  28.    Public Amiga Toulouse).
  29.  
  30.  
  31. What is sizer ?
  32. ~~~~~~~~~~~~~~~
  33.  
  34.       Sizer is a quick and small  CLI  utility for getting the size of
  35.       any devices, directories or 'assigns'. It accepts any number
  36.       of arguments. (Well, it's supposed to!) 
  37.       
  38.       I have been using it in 2.04 only but it doesn't use (as yet...)
  39.       any 2.04 features, so this beta version should also work in 1.3.
  40.        
  41.  
  42. How to use it?
  43. ~~~~~~~~~~~~~~
  44.  
  45.       As I said earlier it's a CLI (Shell) thingy. 
  46.  
  47.       The format has changed:
  48.       ~~~~~~~~~~~~~~~~~~~~~~~
  49.          sizer [-v] {< device | directory | assign >}
  50.  
  51.       The -v option is for displaying the filenames being sized. 
  52.  
  53.       This gives much slower results, obviously.
  54.  
  55.       examples:
  56.  
  57.          sizer dh0:
  58.  
  59.          sizer -v MyDirectory
  60.          
  61.          sizer tools/mytooldir
  62.  
  63.          sizer ram:  sys:c  another_device:   etc...
  64.  
  65.       Don't use the '/' at the end of a directory name, but on the 
  66.       other hand, you MUST use ':' at the end of a device or assigned 
  67.       directory.
  68.  
  69.       To break Sizer, just press 'CTRL C'. If sizer is sizing verbosly, 
  70.       with the -v option, you have to hold the CTRL key and keep hitting 
  71.       the C key repeatedly, till it finally decides to break, it will,
  72.       if you insist enough!
  73.  
  74.       It is best used with a directory utility. Even better with one
  75.       which accepts multiple arguments.  'Pity  DirWork don't, at least
  76.       not in version 1.62, the one I currently use. SID 2.0 very probably
  77.       has already got such a thing, with the 'bytes' button. 
  78.       
  79.       I shall give you the settings I have used to configure it with 
  80.       DirWork 1.62:
  81.  
  82.       - Go in the configuration editor (1st top left menu).
  83.  
  84.       - Click on an unused button (in the top bank).
  85.  
  86.       - and fill the following boxes:
  87.  
  88.             Button text:   Size  (or whatever name you fancy!)
  89.  
  90.             Function:      u     (lower case)
  91.  
  92.             Selection:     B     (Upper case)
  93.  
  94.             SpecialOp:     ,     (comma)
  95.  
  96.             Option:        p     (lower case)
  97.  
  98.             Arguments:     (full path and name for sizer, plus -v if you
  99.                            like slowliness!.
  100.                            Dont use 'Run >NIL:' or even 'Run' on its own)
  101.  
  102.       - Click on 'Quit and use'
  103.  
  104.       - Once back to DirWork, save the new configuration.
  105.  
  106.       - That's it!
  107.  
  108.       - Now pick any dir in one of the file lists, then click
  109.         on the 'Size' button. A  window  should  open and 'sizer' will
  110.         display something like this:
  111.  
  112.                Total number of files                 17
  113.                Total number of directories            1
  114.                Total number of bytes in files    101108
  115.                Total number of blocks used          207
  116.  
  117.                                Total occupied:   105984 bytes, 103K
  118.  
  119.       I wont explain the 1st line, for the second one, it includes
  120.       all the sub-directories and sub-sub-sub... directories if any.
  121.  
  122.       The 3rd line tells you the total number of bytes of all the files
  123.       and the 4th the total number of blocks all the files, directories,
  124.       subdirectories, sub-sub...directories occupy on their respective 
  125.       device.
  126.  
  127.       Suppose you have 'sized' a directory containing 10 files with
  128.       a size of 256 bytes each. The 3rd line will tell you 2560 bytes,
  129.       but the 4th will say 20 blocks, 10 for the files themselves, plus 
  130.       1 block for the 'File Header' for each file, which gives a total 
  131.       of 20 blocks. Suppose the  device on which those files are kept 
  132.       have a block  size  of  512  bytes, the total occupied will 
  133.       be 10240 bytes. 
  134.       
  135.       For each item it scans, 'sizer' looks at the block size of the 
  136.       containing device and calculate the occupied size accordingly. 
  137.       BTW, using sizer, I discovered that the  block  size  of the Ram:
  138.       device is actually 1024 bytes (with KickStart 37.175). Most other
  139.       devices, hard disks, floppies have a block size of 512 bytes, but
  140.       I heard (read!?) one might be able to change the block size with 
  141.       the new FastFileSystem......?!?!
  142.  
  143.  
  144.  
  145. Credits!
  146. ~~~~~~~~
  147.  
  148.       This little utility was written with GREAT help from an article by
  149.       Paul OVERAA published by Amiga Format in the december 1990 issue,
  150.       page 209+.
  151.  
  152.       It was written for myself, to help me file all the stuff I got
  153.       from the great Peter MILES ¤
  154.       
  155.  
  156.  
  157.   |~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|
  158.   |  Send any bug report, compliment ;-), chocolates, freely distributable |
  159.   |  software, 1Gb hard disks, A3 48 bits colour scanners, brand new       |
  160.   |  AMIGA 4000, etc...                                                    |
  161.   |                                                                        |
  162.   |  OR SIMPLY A POST CARD to:                                             |
  163.   |                                                                        |
  164.   |                       Gérard CORNU                                     |
  165.   |                       11 avenue Edouard Aynard                         | 
  166.   |                       69130 ECULLY                                     |
  167.   |                                                                        |
  168.   |                       FRANCE.                                          |
  169.   |                                                                        |
  170.   |                                                                        |
  171.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  172.   
  173.  
  174.  
  175.                           Have plenty of nice days!
  176.  
  177.   
  178.   
  179.     ¤ Peter Miles: ICPUG Amiga library organiser.
  180.  
  181.       ICPUG is the one and only Independent Commodore Products Users Group.
  182.  
  183.       To become a member of this brilliant club contact:
  184.  
  185.       Jack COHEN, ICPUG Membership secretary, P.O. Box 1309,
  186.       LONDON, N3 2UT, ENGLAND, EUROPE.
  187.         
  188.  
  189.  
  190.  
  191.