home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / sysutl / egutil53.lbr / SRW.DZC / SRW.DOC
Encoding:
Text File  |  1988-07-12  |  6.9 KB  |  193 lines
  1. ;;01-11-87
  2.                            SRW V 1.50  
  3.                             12/31/87
  4. Eric Gans
  5. French Department, UCLA
  6. Los Angeles, CA 90024
  7.  
  8. Version 1.50
  9. Allows  5-digit  addresses for files (up to  1  megabyte).   Adds 
  10. online syntax help.
  11.  
  12. Version 1.43
  13. Fixed a bug that appeared in certain versions of v1.42.
  14.  
  15. Version 1.42
  16. Improvement:  added  2-byte  BIOS address for  irregular  systems 
  17. that  don't  have the BIOS jump table on a page  boundary.   This 
  18. will also allow you to run SRW using "R" in Wordstar, in case you 
  19. ever wanted to do such a thing.
  20. Fix:  bug  that  forgot to add in reserved tracks in  calculating 
  21. maximum track number.  (Thanks to faithful SRW user Helmut  Wilck 
  22. for this one!)
  23.  
  24.                               *****
  25.  
  26. SRW  is  just about the most practical,  versatile  and  powerful 
  27. disk/memory utility available for CP/M.   SRW can access all data 
  28. either  on disk or in RAM.   The different options allow the user 
  29. to read the disk directory,  a track, an allocation block, a disk 
  30. file or the memory,  and to search/write strings in both hex  and 
  31. ascii.   The  Jump  command  allows  rapid  movement  around  the 
  32. disk/memory.   For  speed  and  convenience,  prompts  have  been 
  33. reduced to a minimum,  but online help is now (1.50) available if 
  34. you forget the command syntax.
  35.  
  36.  
  37.                           Instructions
  38.  
  39. SRW can be called with or without an operand:  srw <command line>
  40. or  srw  .  If  invoked alone,  the program prompts you  for  the 
  41. command line.
  42.  
  43. COMMAND MODE
  44.  
  45.      The command line formats are:
  46.  
  47. (B)lock: bd:hhh (d = drive, hhh = allocation block number in HEX) 
  48. Example: srw ba:3f (drive A, block 3F)
  49.  
  50. (D)irectory:  d[dr]  (dr  is the  drive;  default=current).  This 
  51. function  puts  you at the start of the disk directory  in  track 
  52. mode.  Examples: srw d   srw dc (drive C)
  53.  
  54. (F)ile:  f[du:]ufn  (Current  drive/user  need not  be  entered.) 
  55. Examples:  srw fa11:blurk.com | srw f0:zap.dat | srw fu (Accesses 
  56. a file named "U" in the current drive/user area.) 
  57.  
  58. (H)elp: Help on command-mode syntax
  59.  
  60. (M)emory:  mhhhh  (hhhh  =  memory address in HEX)  In  order  to 
  61. simplify the display, the last digit will be set to 0; thus mffff 
  62. will  have  the  same  effect  as  mfff0.   Example:   srw  ma000 
  63.  
  64. (T)rack:  td:nnn (d = drive, nnn = track number in DECIMAL)
  65. Example: srw tc:11 (drive C, track 11)
  66.  
  67. (E)xit: e Returns to CP/M (no warm boot). 
  68.  
  69. The D,  M,  B,  T and F commands produce an immediate dump of the 
  70. first sector/page of the block,  track,  file,  or memory address 
  71. selected.
  72.  
  73.  
  74. OPERATION MODE  
  75.  
  76.      The options in operation mode are:
  77.  
  78. D = (D)ump current sector/memory page
  79.  
  80. N = dump (N)ext sector/memory page
  81.  
  82. B = (B)ack one sector/page
  83.  
  84. (N or B will not take you out of a Block or a File; this does not 
  85. apply to Memory or Track reads.)
  86.  
  87. J = (J)ump    This command must be followed by an address:
  88.  
  89.      Track: Jnn (nn = absolute sector number in DECIMAL) On track 
  90. 33, J63 will put you in sector # 63 of that track (if it has that 
  91. many). Sector numbers in tracks/blocks begin with 0.
  92.  
  93.      Block: Jnn (nn = block-relative sector number in DECIMAL) If 
  94. the block has 32 sectors then J0 goes to the first and J31 to the 
  95. last.
  96.  
  97.      File:  Jhhhhh (hhhhh = file address)  Even for files of over 
  98. 64 K,  this address is based on an offset of 100h.   Version 1.50 
  99. will address files of up to 1 megabyte (100000H) in length.
  100.  
  101.      Memory:  Jhhhh (hhhh = memory address) 
  102.  
  103. S = (S)earch
  104. This function permits a search of up to 80 ascii/hex characters.
  105.  
  106. Format:  Hex bytes must be separated by commas, ascii enclosed in 
  107. quotes.   Commas before/after quotes are not strictly  necessary, 
  108. although you should use them.
  109.  
  110. Examples: Scd,5,0  S"blurk"20"ZAP",d,a,27,"="45,45
  111.  
  112. The search function terminates if the string is found,  or if the 
  113. end  of  the  file,  block or memory is  reached.  To  facilitate 
  114. directory searches,  it will go four tracks in track mode  before 
  115. giving up.
  116.  
  117. C = (C)ontinue search
  118.  
  119. Searches  for  the  next occurrence  of  the  same  string.  This 
  120. function remains active until the search is unsuccessful or a new 
  121. search is called. 
  122.  
  123. W = (W)rite
  124.  
  125.      You must enter a starting address:
  126.  
  127.   Memory:   1-byte address (0-FFH)
  128.   
  129.   File:     Either 7 or 8 bits: D7 will be treated
  130.      the same way as 57.  
  131.  
  132.   Other modes:  7-bit sector address (0-7FH)
  133.  
  134.      As a check, SRW will output the present byte value.
  135.      Strings  to  write follow the same format as for the  search 
  136. function.    Nothing   will   be  written  beyond   the   current 
  137. sector/page.
  138.  
  139. Example:
  140. >W3f  <CR>          ;you enter this (3FH = sector/page address)
  141. >W3f = E5 >>?       ;enter the string to write at the "?"
  142. >W    type a <CR> to end
  143.  
  144. F = (F)ile information
  145.  
  146. This  function  operates only in file mode;  it gives  the  "next 
  147. address"  (1 byte more than the last address of the file) and the 
  148. number of sectors.  This information is also given at the  outset 
  149. when the "F" command is given in command mode. 
  150.  
  151. R = (R)eturn to command mode 
  152.  
  153. H = (H)elp on operation-mode syntax
  154.  
  155. E = (E)xit to CP/M 
  156.  
  157. *****************************************************************
  158.  
  159. Notes:
  160.  
  161.  1. The Track function will continue on to the next track; if you 
  162. want  to step through the disk without returning to command mode, 
  163. find  out  the  number of sectors/track and do a J  to  the  last 
  164. sector  followed by an N to get you to the beginning of the  next 
  165. track.
  166.  
  167.  2.  The  Search function distinguishes between upper  and  lower 
  168. case.
  169.  
  170.  3.  If a disk write has occurred, on exit the logged drives will 
  171. be reset. 
  172.  
  173.  4.  This  program  makes  use of the Disk  Parameter  Block  and 
  174. (v1.40) SECTRAN and should thus be portable to all CP/M machines. 
  175. It  assumes that sectors/track is a one-byte number (< 256);  are 
  176. there any disks out there with 300 sectors per track??  The  File 
  177. function  assumes  that  an  E5  in the  area  reserved  for  the 
  178. filename,  (as  opposed  to the E5 that stands for erasure  of  a 
  179. file)  indicates the end of the directory.  This saves  searching 
  180. four tracks of a hard disk that has only a few files,  since CP/M 
  181. always writes to the directory from the bottom up.  If,  however, 
  182. something has gone wrong,  or you have formatted one track in the 
  183. middle of your directory,  the program won't find all your files. 
  184. Either  find them via a directory search or put  something  other 
  185. than  E5 in the first byte of the filename (bytes 1,21,41 and  61 
  186. of each directory sector). This can be done using SRW itself.
  187.  
  188.  
  189. SRW  has been considerably enhanced from version to  version.  If 
  190. you  have suggestions for further improvement,  find bugs in  the 
  191. program,  or  simply find it useful,  I would appreciate  hearing 
  192. from you.
  193.