home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / dskutl / du-v87.hqp / DU-V87.HLP
Encoding:
Text File  |  1985-02-09  |  5.8 KB  |  199 lines
  1. Purpose and Use
  2. Display Commands
  3. Positioning Commands
  4. I/O Commands
  5. Change Commands
  6. Search Commands
  7. Logging Disks
  8. Miscellaneous
  9. Examples of command use
  10. Interpreting DU lines
  11. DU-V87 Installation
  12. :                  Disk Utility
  13.                  by Ward Christensen
  14.                   (revised 6/13/84)
  15.  
  16.      DU-v87 is a CP/M utility that provides the user capabilities to inspect
  17. and modify data on a diskette directly by specifying either track and sector
  18. or by specifying allocation unit.  The program may be used to recover files,
  19. including directory entries and system tracks that have been destroyed.
  20.  
  21. To invoke the program simply enter "DU" at the CP/M prompt:
  22.  
  23. A>DU
  24.  
  25. An initial command string may optionally be placed as an operand to the
  26. "DU" command:
  27.  
  28. A>DU M;X
  29.  
  30. This example will print a map of the disk and then exit.
  31.  
  32. :Display Commands
  33.  
  34. #    Shows the disk parameters.
  35.  
  36. A    Dumps a sector in ASCII.
  37. H    Dumps a sector in hex.
  38. D    Dumps a sector in hex and ASCII.
  39.  
  40.     These commands may add ff,tt (from,to) to dump a range of sectors.
  41.  
  42. G    Shows the current group, track, and sector.
  43.  
  44. M    Maps the disk.
  45. Mxx    Maps the disk starting at group xx.
  46.  
  47. Vnn    Views (much like CP/M type) nn sectors.
  48.  
  49. ?    Displays the help screen.
  50.  
  51. :Positioning commands
  52.  
  53. Gnn    Positions to and reads the first sector of an allocation group.
  54.     (nn = the allocation group in hex -- lowest value is 00)
  55.  
  56. Tnn    Positions to a specific track
  57.     (nn = the track in decimal -- lowest value is 0)
  58.     (does not do a read, must execute the S (sector) command first)
  59.  
  60. Snn    Positions to and reads a specific sector.
  61.     (nn = the sector in decimal -- lowest value is 1)
  62.     (the T (track) command must be executed first)
  63.  
  64. +nn    advances nn sectors and reads.
  65. -nn    backs up nn sector and reads.
  66.     (nn = the number of sectors in hex -- if omitted, 1 sector is assumed)
  67.     If "-" is issued at the first logical sector of the disk,
  68.     the sector number will wrap back to the last sector.
  69.     If "+" is issued at the last sector, the sector number
  70.     will wrap forward to the first sector.
  71.  
  72. :I/O Commands
  73.  
  74. R    Reads the currently positioned sector into memory.
  75.  
  76.     Note: R (Read) is implicit in the "G", "+",  and "-" commands,
  77.     but NOT in the S and T commands.
  78.  
  79. W    Writes the currently positioned sector from memory.
  80.  
  81. <    Saves the current sector in a save buffer.
  82.  
  83. >    Recalls previously saved sector.
  84.  
  85. Y    Saves the current sector in the yank buffer.
  86.  
  87. K    Dumps memory to a file previously stored using the Y (yank) command.
  88.     (requires the operand: [du:]filename[.ext])
  89.  
  90. :Change commands
  91.  
  92. CHaddr,val,val,val... change hex in sector.
  93.  
  94. CAaddr,char string... change ASCII in sector.
  95.  
  96.     NOTE that <xx> may be hex imbedded in the Ascii:  ca0,OK<d><a><1a>
  97.  
  98.     Use W to write changes to disk.  Note that the C command echoes the
  99.     overlaid data for verification.
  100.  
  101. CHaddr-addr,byte or CAaddr-addr,byte repeats a change.
  102.  
  103. :Search commands
  104.  
  105. Fname    Prints the directory entry for file "name",
  106.     then  positions to its directory sector.
  107.  
  108. F    Finds the next occurrence of the same name.
  109.  
  110. =aaaa    Scan for aaaa (in ASCII) from current sector.
  111.     (Specify upper or lower case, user <xx> for imbedded hex.
  112.  
  113. :Logging a disk
  114.  
  115. L    Logs in a disk.
  116.  
  117. Lx    Logs in disk "x", such as: LB.
  118.  
  119. Ux    Logs user "x" for next F command.
  120.  
  121. N    Resets CP/M via the BDOS.  This may make it possible under some
  122.     implementations of CP/M to change the disk format.
  123.     (e.g.,    density, sides, etc)
  124.  
  125.  
  126. :Miscellaneous
  127.  
  128. X    Exits back to CP/M (Must press return).
  129.  
  130. P    Toggles printer switch on/off.
  131.  
  132. Z    Sleep - causes the program to pause, such as to look at a dump.
  133.     Z is 1 sec.  Znn is nn tenths of a second on a 2 MHz 8080.
  134.  
  135. /nn    Repeats previous command nn times.
  136.  
  137. Q    Before a command does it "quietly".
  138.  
  139. (    Toggles map display of erased files.
  140.  
  141. B    Boots track number of sectors per track.
  142.  
  143. :Examples
  144.  
  145. Multiple commands may be separated by ";".
  146. Any valid command string may be placed as an operand of the original DU
  147. command, i.e.:
  148.  
  149.         A>DU G0;D;G2;=OK<D><A><1A>;D
  150.  
  151. The following commands will erase the disk directory to all E5's:
  152.  
  153.     lb        log in b drive
  154.     g0        position to dir.
  155.     ch0-7f,e5    fill with e5
  156.     <        save the sector
  157.     >;w;+;/16    restore, write, next,
  158.             repeat 16
  159.  
  160. This could be shortened to:
  161.  
  162.     lb;g0;ch0-7f,e5;<
  163.     >;w;+;/16
  164.  
  165. :Interpretation of a directory entry.
  166.  
  167. The following explains the format of a CP/M directory entry as shown by DU,
  168. using either the "F" (find file) command, or just doing "D" (dump) of the
  169. directory sectors, which are located in groups 0 and 1 on a single density
  170. disk.  Sample result of "FDU" command:
  171.  
  172. First    40    00445520 20202020  20434F4D 0000003B  *.DU    COM...:*
  173.  line    ||                 |      |      ||    |    | |
  174.    ||    ||^----hex file name-----^   |      |      ||    ^file name^
  175.    ||    ||                 |      |      ||     in ASCII
  176.    ||    ||              extent-^      ^      ||
  177.    ||    ||                      ||
  178.    ||    ||             file size in sectors-^^
  179.    ||    ||
  180.    ||    ^^-0x = file active/user area
  181.    ||  E5 = file erased
  182.    ^^-displacement of line in directory sector
  183.  
  184. Second     50    33343536 3738393A  00000000 00000000  *3456789:........*
  185. line        |                   |
  186.         ^---allocation group numbers-------^
  187. :Installation
  188.  
  189.      DU 7.0 and later versions of DU are designed to be installed with a
  190. minimum of trouble.  In fact, in almost all cases, no changes to the source
  191. file should be necessary to get DU up and running.  This is because DU uses
  192. the disk parameter block of CP/M to determine the characteristics of the disk
  193. environment.  (see the disclaimer for certain non-standard versions of CP/M
  194. 1.4).
  195.  
  196.      The only parameter that should need to be changed will be the clock
  197. speed flag at 103H.  Leave this byte zero if you  have a 2 mhz clock.  Patch
  198. it non-zero for 4 mhz.    This is only needed for the "Z" (sleep) command.
  199.