home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / utils / dabutil.zip / DABUTIL.DOC < prev    next >
Text File  |  1988-07-15  |  16KB  |  449 lines
  1. DABUTIL Version 1.1 Documentation, Copyright 1988 by Don Branson          page 1
  2.  
  3.  
  4.  - - - - - - - - - - - - - - LD (List Directories) - - - - - - - - - - - - - -
  5.      List all directories on the current drive,
  6.      starting with the root directory.
  7.  
  8.      Format:
  9.  
  10.             ld [d:] [-s]
  11.  
  12.            Where 'd:' is an optional drive letter which can be specified
  13.            to list the directories of a drive other than the current
  14.            drive. Hidden directories will be displayed.
  15.  
  16.            Use -s to print a summary of each directory. The summary includes
  17.            a count of the files in the directory (not including subdirectories)
  18.            and a sum of the file sizes in the directory.
  19.  
  20.      Examples:
  21.      
  22.                    ld
  23.            
  24.            will list all directories in the current drive.
  25.              
  26.                    ld a:
  27.              
  28.            will list all directories in drive A
  29.  
  30.                    ld -s
  31.            
  32.            will list all directories in the current drive, and shows
  33.            the total number of files, and the sum of their file sizes.
  34.            The count and sum do not include subdirectory entries or
  35.            volume labels, but do include hidden files.
  36.  
  37.  
  38.  - - - - - - - - - - - - - - - - FF (Find Files) - - - - - - - - - - - - - - -
  39.      List all occurrences of a file, the directories they are found in, and 
  40.      some information about each occurrence.
  41.  
  42.  
  43.      Format:
  44.  
  45.             ff [d:]filename
  46.  
  47.            Where filename is required. Filename may contain the
  48.            wildcard characters '?' and '*'.
  49.  
  50.  
  51.      Examples:
  52.  
  53.              ff *.c
  54.  
  55.            will display all the directories where any file having the extension
  56.            .C is found, and each occurence of file with that extension.
  57.  
  58.            A drive specifier 'd:' may be specified to search a drive other than
  59.            the current drive. Hidden files will be displayed, subdirectory
  60.            entries will not.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. DABUTIL Version 1.1 Documentation, Copyright 1988 by Don Branson          page 2
  68.  
  69.  
  70.  - - - - - - - - - - - - - - DI (Disk Info) - - - - - - - - - - - - - - - - - -
  71.      List information about a diskette or fixed disk.  Shows sector size,
  72.      track size, cluster size, FAT (File Allocation Table) size, root directory
  73.      size, etc. Shows if the boot record, the FAT, and the root directory can be
  74.      read. A drive may be specified. A subdirectory or file may be specified.
  75.      The cluster and sector numbers where that subdirectory or file resides
  76.      will be displayed.
  77.  
  78.      Format:
  79.  
  80.             di [d:][filename]
  81.  
  82.            Where filename can be:
  83.  
  84.                  file                 or
  85.                  \subdirectory        or
  86.                  \subdirectory\file   or
  87.                  c:\subdir\file       etc.
  88.  
  89.            No wildcards (? or *) are allowed in the file name.
  90.  
  91.      Examples:
  92.                    di readme.doc
  93.           
  94.            will list the boot record information for the current disk
  95.            and the clusters and sectors for readme.doc. DI will search
  96.            for readme.doc in the current directory.
  97.            
  98.                    di \readme.doc
  99.           
  100.            will do the same thing, except that the backslash will indicate 
  101.            to DI to search in the root directory of the current disk.
  102.          
  103.                    di c:\readme.doc
  104.  
  105.            will again do the same thing, except that DI will look on the drive
  106.            C: to find file readme.doc
  107.            
  108.                    di \word\readme.doc
  109.           
  110.            will tell DI to look on the current disk, in the subdirectory
  111.            WORD to find readme.doc.
  112.            
  113.                    di c:\word\readme.doc
  114.           
  115.            will tell DI to look on disk C: in subdirectory WORD for readme.doc.
  116.  
  117.            Instead of readme.doc, a subdirectory could be specified, for
  118.            example:
  119.           
  120.                    di c:\word
  121.           
  122.            will look in the root directory of the current drive for the
  123.            subdirectory WORD and list the clusters and sectors that WORD
  124.            occupies.
  125.            DI first attempts to read the boot record, and indicates if there
  126.            are any problems reading it. If read successfully, this is the
  127.            information it contains (all numbers are shown in decimal and
  128.            hexadecimal):
  129.  
  130.  
  131.  
  132.  
  133. DABUTIL Version 1.1 Documentation, Copyright 1988 by Don Branson          page 3
  134.  
  135.  
  136.  - - - - - - - - - - - - - - DI (Disk Info) continued - - - - - - - - - - - - -
  137.             + System id:
  138.                          Indicates what operating system was used to
  139.                          format the disk. For example: IBM   3.1
  140.             + Sector size:
  141.                          The size in bytes of a disk sector (usually 512).
  142.             + Sectors per cluster:
  143.                          A cluster is the unit of storage that files are
  144.                          allocated in. This value indicates the size of
  145.                          a cluster.
  146.             + Total sectors on disk:
  147.                          Includes boot record, FAT, root directory, and data 
  148.                          area.
  149.             + Total clusters on disk:
  150.                          Total sectors / sectors-per-cluster.
  151.             + Sectors per track:
  152.                          Each concentric ring on one disk surface is divided
  153.                          into this number of sectors.
  154.             + Number of heads (sides):
  155.                          The number of recording surfaces (and therefore the
  156.                          number of read/write heads).
  157.             + Total cylinders:
  158.                          The total number of cylinders on the disk.
  159.             + Disk capacity:
  160.                          Total storage in kilobytes. Includes the boot record,
  161.                          the FAT, the root directory, and the data area.
  162.             + FAT size (in sectors):
  163.                          The FAT (File Allocation Table) is a table which
  164.                          contains lists of the clusters allocated to each
  165.                          file. The value shown is the size of a single copy
  166.                          of the FAT.
  167.             + Copies of the FAT:
  168.                          Typically, two copies are kept of the FAT, in case
  169.                          the first becomes unreadable.
  170.             + First directory block:
  171.                          The first sector assigned to the root directory. The
  172.                          root directory is assigned in a single contiguous
  173.                          block.
  174.             + Number of directory entries:
  175.                          The root directory is fixed in size. This number is
  176.                          the maximum number of directory entries that it may
  177.                          have.
  178.             + Directory size (in sectors):
  179.                          The total sectors required to hold the number of
  180.                          directory entries.
  181.             + Number of reserved sectors:
  182.                          This is the number of sectors reserved before the
  183.                          FAT. Typically one, for the boot record.
  184.             + Special reserved sectors:
  185.                          I don't know all that this field includes. It does
  186.                          include the sectors of previous partitions on a
  187.                          partitioned drive.
  188.  
  189.            DI then attempts to read the FAT and the root directory into memory.
  190.            An error message will indicate any problems.
  191.            If a file was specified on the command line, the FAT chain is listed.
  192.            The FAT chain is the list of all clusters. The sectors in each
  193.            cluster are displayed.
  194.  
  195.  
  196.  
  197.  
  198.  
  199. DABUTIL Version 1.1 Documentation, Copyright 1988 by Don Branson          page 4
  200.  
  201.  
  202.  - - - - - - - - - - - - - - - ENC (ENCrypt) - - - - - - - - - - - - - - - - -
  203.      Encrypts a file using the supplied password. This program performs a simple
  204.      encryption, and is useful against casual prying, but does not necessarily
  205.      comply with any standards for security.
  206.  
  207.      Format:
  208.  
  209.             enc file1 file2 password
  210.  
  211.            Where file1 is the file to encrypt, file2 is the resultant
  212.            encrypted file, and password is used to perform the encryption.
  213.  
  214.            To recover the contents of file1, type:
  215.  
  216.                    enc file2 file3 password
  217.  
  218.            File3 will now contain what file1 contained. Password
  219.            must be keyed exactly the same: case and length, etc.
  220.  
  221.            If the password contains spaces, it must be
  222.            enclosed in double quotes:
  223.  
  224.                    enc file1 file2 "pass word"
  225.  
  226.            You must know the password in order to restore the original
  227.            contents of the file, since the password is not saved anywhere.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265. DABUTIL Version 1.1 Documentation, Copyright 1988 by Don Branson          page 5
  266.  
  267.  
  268.  - - - - - - - - - - - - - - - -  CATALOG - - - - - - - - - - - - - - - - - - -
  269.      Lists files on a diskette or fixed disk to stdout. (Which may be
  270.      redirected.) A header with the disk name, the date and file size is
  271.      printed, each directory will be shown, and all the files in each
  272.      subdirectory. If an .ARC file is found, all the files contained in it will
  273.      be listed, indented after the .ARC file.
  274.  
  275.      Format:
  276.  
  277.             catalog [d:] [-w]
  278.  
  279.            Where 'd:' can be specified to list a disk other than the
  280.            current one, and where '-w' specifies that a description of
  281.            compression technique is printed for each file in an archive.
  282.            Files are printed with file name, extension, size, and date
  283.            of last update. Files in archives are additionally listed
  284.            with the CRC, and the compressed size of the file. The compression 
  285.            technique is shown if the '-w' (wide) option is selected.
  286.            If the wide option is selected, the print width is 132
  287.            characters, so set your 80-column printer to compressed mode
  288.            if it has that option.
  289.  
  290.      Examples:
  291.  
  292.                    catalog
  293.  
  294.            will list all the files in all directories of the current disk
  295.            to the screen. Files contained in .ARC files will be listed.
  296.  
  297.                    catalog >prn
  298.  
  299.            will do the same thing, but the output will be sent to the printer.
  300.            (Substitute LPT1, etc. where applicable.)
  301.  
  302.                    catalog a:
  303.  
  304.            will list the files in all directories of the A: disk to the screen.
  305.  
  306.                    catalog -w
  307.  
  308.            will list all files of the current disk. In addition, when files in
  309.            .ARC files are listed, a short description of the technique used to
  310.            compress the file will be displayed. When this option is specified,
  311.            the ouput is 132 characters wide, so probably, you will want to set
  312.            your printer to 132 columns, then redirect the output of CATALOG to
  313.            the printer, like this:
  314.  
  315.                    catalog -w >prn
  316.  
  317.            You may also do this:
  318.  
  319.                   catalog a: -w >prn
  320.  
  321.            or this:
  322.  
  323.                   catalog -w a: >prn
  324.  
  325.            which does the same.
  326.  
  327.  
  328.  
  329.  
  330. DABUTIL Version 1.1 Documentation, Copyright 1988 by Don Branson          page 6
  331.  
  332.  
  333.  - - - - - - - - - - - - - - - - SD (Sort Directory) - - - - - - - - - - - - -
  334.     Reads the current directory, sorts it based on sort options specified, and
  335.     writes it back to the disk. This program has been tested on an IBM-PC, an
  336.     IBM-PC/AT, and a PS/2 model 80. It has been tested with 360K floppies and
  337.     1 meg floppies, and with a 20M fixed disk. It has been tested under MS-DOS
  338.     versions 2.0, 3.0, 3.1 and 3.3. If you use this program with any other
  339.     configuration, test it first on a scratch disk, to make sure that the
  340.     directory format is compatible with SD.
  341.  
  342.     Format:
  343.  
  344.             sd {nedts} [-d]
  345.  
  346.            Where n, e, d, t, and s are the sort options. Any or all of
  347.            these may be specified, and in any order.
  348.  
  349.            Sort options:    n - Sort on filename    (Alphabetically)
  350.                             e - File extension      (Alphabetically)
  351.                             d - Date                (Oldest to newest)
  352.                             t - Time                (Oldest to newest)
  353.                             s - Size                (Smallest to largest)
  354.  
  355.            The '-d' parameter specifies that all subdirectory entries in
  356.            the directory be sorted to the top of the list. If not
  357.            specified, the subdirectory entries are sorted with the other
  358.            files. Deleted entries are always sorted to the end of
  359.            the directory. (When a file is deleted by MS-DOS, the entry
  360.            is not physically removed, but is flagged to indicate that
  361.            it can be used for another file entry.) A '-' can be used after
  362.            any sort option to reverse the order of that sort.
  363.  
  364.     Examples:
  365.  
  366.                   sd ne
  367.  
  368.            will sort the current directory by name first, then extension, like
  369.            this:
  370.  
  371.                  Volume in drive C is HARD DRIVE
  372.                  Directory of  C:\WORD
  373.  
  374.                 .            <DIR>      9-03-87  10:45a
  375.                 ..           <DIR>      9-03-87  10:45a
  376.                 1        STY     1664   9-19-84  12:00p
  377.                 ARTICLE  STY     1024   9-19-84  12:00p
  378.                 DANSRES  BAK      512   4-06-85   2:56p
  379.                 DANSRES  DOC      512   4-06-85   3:03p
  380.                 DEFAULT  STY      768   9-19-84  12:00p
  381.                 DRAFT    STY     1024   9-19-84  12:00p
  382.                 EXAMPLE  DOC     4352   9-18-84  12:00p
  383.                 MOUSE    COM     4192   9-18-84  12:00p
  384.                 WORD     COM     2062   9-18-84  12:00p
  385.                        11 File(s)   5275648 bytes free
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397. DABUTIL Version 1.1 Documentation, Copyright 1988 by Don Branson          page 7
  398.  
  399.  
  400.  - - - - - - - - - - - - - - SD (Sort Directory) continued - - - - - - - - - -
  401.  
  402.                   sd en
  403.  
  404.            will sort the current directory by extension first, then name, like
  405.            this:
  406.  
  407.  
  408.                  Volume in drive C is HARD DRIVE
  409.                  Directory of  C:\WORD
  410.  
  411.                 .            <DIR>      9-03-87  10:45a
  412.                 ..           <DIR>      9-03-87  10:45a
  413.                 DANSRES  BAK      512   4-06-85   2:56p
  414.                 MOUSE    COM     4192   9-18-84  12:00p
  415.                 WORD     COM     2062   9-18-84  12:00p
  416.                 DANSRES  DOC      512   4-06-85   3:03p
  417.                 EXAMPLE  DOC     4352   9-18-84  12:00p
  418.                 1        STY     1664   9-19-84  12:00p
  419.                 ARTICLE  STY     1024   9-19-84  12:00p
  420.                 DEFAULT  STY      768   9-19-84  12:00p
  421.                 DRAFT    STY     1024   9-19-84  12:00p
  422.                        11 File(s)   5271552 bytes free
  423.  
  424.     Other examples:
  425.  
  426.                   sd dts -d
  427.  
  428.            will sort subdirectory entries to the top, and will sort the files
  429.            on date, time and size. The subdirectories will be sorted on the 
  430.            same parameters.
  431.  
  432.                   sd dt
  433.  
  434.            will sort the directory with the newest files at the end of the list.
  435.  
  436.                   sd d-t-
  437.  
  438.            will sort the directory with the newest files at the top of the list.
  439.  
  440.                   sd n-e
  441.  
  442.            will sort the directory on name in reverse alphabetic order, and
  443.  
  444.            When using the  -d parameter to sort the subdirectory entries to the
  445.            top, the subdirectory entries will be sorted on the same parameters
  446.            as the filename entries.
  447.  
  448.  
  449.