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