home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol016 / du-v75.doc < prev    next >
Text File  |  1984-04-29  |  4KB  |  158 lines
  1.  
  2.             DU-V74.DOC
  3.            by Ward Christensen
  4.     with additional notes by Ron Fowler
  5.         (revised 1/15/81)
  6.  
  7.     HOW TO USE DU ver 7.4 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 it's 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.     Z    Sleep - causes the program to pause, such
  128.         as to look at a dump.  Z is 1 sec.  Znn
  129.         is nn tenths of a second on a 2 MHz 8080.
  130.  
  131.     <    Saves current sector in a save buffer
  132.  
  133.     >    Gets saved buffer.  < and > may be used
  134.         to move a sector to another place.
  135.  
  136.     /    Repeats entire command.  Defaults
  137.  or    /nn    to "forever".  NN may be 2 to 65535
  138.  
  139. multiple commands may be separated by ";"
  140.  
  141. Example: the following commands will erase the
  142.      b disk directory to all E5's:
  143.  
  144.     lb        log in b drive
  145.     g0        position to dir.
  146.     ch0-7f,e5    fill with e5
  147.     <        save the sector
  148.     >;w;+;/16    restore, write, next,
  149.             repeat 16
  150.  
  151. ----This could be shortened to:
  152.  
  153.     lb;g0;ch0-7f,e5;<
  154.     >;w;+;/16
  155.  
  156. END
  157.  
  158.