home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / mbug / mbug036.arc / DU-77.DOC < prev    next >
Text File  |  1979-12-31  |  6KB  |  198 lines
  1.  
  2.              DU-V77.DOC
  3.             by Ward Christensen
  4.   with additional notes by Ron Fowler and Keith Petersen
  5.          (revised 7/23/81)
  6.  
  7.     HOW TO USE DU ver 7.7 DISK UTILITY
  8.  
  9. INSTALLATION:
  10.     The 7.0 and later versions of DU are designed to
  11.   be installed with a minimum of trouble.  In fact, in al-
  12.   most all cases, no changes to the source file should be
  13.   necessary to get DU up and running. This is because DU
  14.   uses the disk paramter block of CP/M to determine the
  15.   characteristics of the disk environment.  (see the dis-
  16.   claimer for certain non-standard versions of CP/M 1.4).
  17.     The only parameter that should need to be changed
  18.   will be the clock speed flag at 103H.  Leave this byte
  19.   zero if you have a 2 mhz clock.  Patch it non-zero for
  20.   4 mhz.  This is only needed for the "Z" (sleep) command.
  21.  
  22. USE:
  23.  
  24. Any valid command string may be placed as an
  25. operand of the original DU command, i.e.:
  26.  
  27.      A>DU G0;D;G2;=OK<D><A><1A>;D
  28.  
  29. Functions supported:
  30.  
  31.     Tnn    Seek to track nn (no read)
  32.     Snn    Position to sector nn, and read
  33.     Gnn    Position to group nn and read.
  34.     G    Shows current position
  35.     V    Views the current sector.
  36.         (assumes ASCII data)
  37.     Vnn    Views nn sectors
  38.     Fname    print directory for file "name",
  39.         then positions to its directory 
  40.         sector. (Won't position under
  41.         CP/M 2.x, but see = command below.)
  42.  
  43.     =string    Ascii search, starting at current
  44.         sector. <xx> hex may be imbedded,
  45.         or used alone:  To find "IN 0FEH":
  46.         =<db><fe>
  47.         Ignores bit 7 unless <xx> is used.
  48.  
  49.     L    Re-logs in the current disk. You may pull
  50.         out a disk, put in a new, and "L" just
  51.         to log it in.
  52.  
  53.     Lx    Logs in disk 'x', such as: LB
  54.  
  55.     Ux    Logs user 'x' for next F command.  Gives
  56.         '?' error if not CP/M version 2.x.
  57.  
  58.     D    Dump sector, hex + ASCII
  59.     A    Dump sector, ASCII only
  60.     H    Dump sector, hex only
  61.  
  62. note all dump commands (D, A, H) may be optionally
  63.     followed by a starting and ending address:
  64.     D0,7F    is the same as just D
  65.     D3,5
  66.     A20,3F
  67.  
  68.     CHaddr,val,val,val... change hex in sector
  69.     CAaddr,char string... change ASCII in sector
  70.         NOTE that <xx> may be hex imbedded
  71.         in the Ascii:  ca0,OK<d><a><1a>
  72.  
  73.         ----> Use W to write changes to disk.
  74.         Note that the C command echoes
  75.         the overlaid data for verification.
  76.  
  77.     CHaddr-addr,byte
  78.  or    CAaddr-addr,byte    repeats a change
  79.  
  80.     +    advance 1 sector (if below track 2,
  81.         this advances to next numerical, if
  82.         2 or >, advances based on CP/M's normal
  83.         sector scrambling algorithm, i.e. so +
  84.         will get the next logical sector of the file
  85.  
  86.     -    backs up 1 logical sector
  87.  
  88.         Note + and - may take an amount:
  89.         for example, +F steps in 15 sectors.
  90.  
  91.         Note also that "-" issued at the first logical
  92.         sector of the disk will wrap back to the last.
  93.         Further, "+" issued at the last sector will
  94.         wrap forward to the first.
  95.  
  96.     ?    Gives command summary
  97.  
  98.     #    Prints the disk parameters
  99.  
  100.     M    Dumps a map of the group allocations
  101.         for files.
  102.     Mn    Shows which file is allocated to
  103.         group "n".
  104.  
  105.     N    Resets CP/M via the BDOS.  This may
  106.         make it possible under some implementations
  107.         of CP/M to change the disk format (e.g., density,
  108.         sides, etc)
  109.  
  110.     R    Reads the sector currently positioned to
  111.         into memory.  Note R (Read) is implicit in
  112.         the G, +, and - commands, but N-O-T in the
  113.         S and T commands (I did it because I was
  114.         tired of disk reading after T command before
  115.         I had a chance to issue the S command)
  116.  
  117.     W    Write back the current sector (N-O-T-E may
  118.         not be used after an F command, as CP/M was
  119.         used to find the file in the directory
  120.  
  121.     X    Exit back to CP/M (Must press return).  Ctl-c
  122.         was too easy to hit over modem lines, so I
  123.         decided on 2-byte (X, CR) to exit.
  124.  
  125.     P    Toggle printer switch on/off
  126.  
  127.     Y       Yanks current sector into sequential memory and
  128.         prints ending address.  This allows sectors to
  129.         be written sequentially into memory starting at
  130.         3000H, for later recovery by DDT, etc.
  131.  
  132.     Z    Sleep - causes the program to pause, such
  133.         as to look at a dump.  Z is 1 sec.  Znn
  134.         is nn tenths of a second on a 2 MHz 8080.
  135.  
  136.     <    Saves current sector in a save buffer
  137.  
  138.     >    Gets saved buffer.  < and > may be used
  139.         to move a sector to another place.
  140.  
  141.     /    Repeats entire command.  Defaults
  142.  or    /nn    to "forever".  NN may be 2 to 65535
  143.  
  144. multiple commands may be separated by ";"
  145.  
  146. Example: the following commands will erase the
  147.      b disk directory to all E5's:
  148.  
  149.     lb        log in b drive
  150.     g0        position to dir.
  151.     ch0-7f,e5    fill with e5
  152.     <        save the sector
  153.     >;w;+;/16    restore, write, next,
  154.             repeat 16
  155.  
  156. ----This could be shortened to:
  157.  
  158.     lb;g0;ch0-7f,e5;<
  159.     >;w;+;/16
  160.  
  161.  
  162.  
  163. INTERPRETATION OF DIRECTORY DATA PRESENTED BY THE DU PROGRAM
  164.  
  165.  
  166. The following explains the format of a CP/M directory entry
  167. as shown by DU, using either the "F" (find file) command,
  168. or just doing "D" (dump) of the directory sectors, which
  169. are located in groups 0 and 1 on a single density disk.
  170.         ----------------
  171. Sample result of "FSID.COM" command:
  172.  
  173. 40  00534944 20202020  20434F4D 0000003A  *.SID     COM...:*
  174. 50  33343536 3738393A  00000000 00000000  *3456789:........*
  175.  
  176. First line -
  177.  
  178. 40  00534944 20202020  20434F4D 0000003A  *.SID     COM...:*
  179. ||  |||                      |  ||    ||    |         |
  180. ||  ||^----hex file name-----^  ||    ||    ^file name^
  181. ||  ||                          ||    ||     in ASCII
  182. ||  ||                   extent-^^    ||
  183. ||  ||                                ||
  184. ||  ||           file size in sectors-^^
  185. ||  ||
  186. ||  ^^-00 = file active
  187. ||     E5 = file erased
  188. ^^-displacement of line in directory sector
  189.  
  190. Second line -
  191.  
  192. 50  33343536 3738393A  00000000 00000000  *3456789:........*
  193.     |                       |
  194.     |                       |
  195.     ^---allocation group numbers-------^
  196.  
  197. END
  198.