home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / turbodos / dirpat16.dqc / DIRPAT16.DOC
Encoding:
Text File  |  1985-02-10  |  4.8 KB  |  117 lines
  1. DIRPAT version 1.60 as of 26 Aug 84
  2.  
  3.  
  4. What is DIRPAT?
  5.  
  6. It is a DIRectory PATch utility, designed to allow unerasing of accidentally
  7. erased files or otherwise change a TurboDOS disk directory byte by byte.
  8.  
  9. THIS PROGRAM IS NOT INTENDED FOR THE INEXPERIENCED USER, AND GREAT DAMAGE
  10. MAY RESULT IF THIS PROGRAM IS ABUSED. DIRPAT CAN ONLY BE RUN BY A PRIVILEGED
  11. USER AND IT WILL REFUSE TO OPERATE IF FILES ARE OPEN ON THE CURRENT DRIVE.
  12.  
  13.  
  14. Use of DIRPAT:
  15.  
  16. DIRPAT is meant to be used immediately after an accidental erasure of a file
  17. or similar disaster. Be sure nobody else (in a multiuser system) is accessing
  18. the drive in question, then execute the DIRPAT program from that drive.
  19. DIRPAT will ignore drive arguments and always use the current drive. The
  20. program will terminate with an error message if
  21.     1. you are  NOT running version 1.3 or later TD
  22.     2. a lock cannot be obtained on the drive
  23.     3. $.DIR cannot be found.
  24.  
  25. You will get a warning message if you are running TD ver 1.3 (see below).
  26.  
  27. DIRPAT will then tell you the number of 128-byte sectors in the directory
  28. and the maximum number of available directory entries. It reads sector 0
  29. into the buffer and then waits for a command.
  30.  
  31. COMMANDS:
  32.  
  33. The following is a brief explanation of all DIRPAT commands. Gain proficiency
  34. by exercising all commands on a work diskette with backed-up, non-critical
  35. data!
  36.  
  37.  
  38. CMD    use
  39.  
  40. ?    display brief help message
  41. A    FIND a string of up to 8 ASCII characters starting from the current
  42. D    display current sector in hex and ASCII
  43. F    FIND hex bytes (you are prompted to enter data)
  44.     sector up to the end of the disk. Sector pointer is positioned to
  45.     the first sector the string is found at or not moved if the string
  46.     is not found (may lock up in TD 1.3). Only 7 bits are matched, so
  47.     that filenames with status bits set may be found.
  48. G    GOTO a sector. Prompts for a sector number which must be in range
  49.     (between 0 and the number of sectors in the directory, minus 1).
  50.     Reads and displays that sector.
  51. H    set/reset directory hash flag. You could use the S command to do
  52.     this but this won't properly rebuild the directory. A FIXDIR
  53.     operation is performed upon exit if H was used.
  54. Q    QUIT to TurboDOS. If you used the W command, the disk map will be
  55.     regenerated. If the directory is hashed, it will be reorganized.
  56.     WARNING: DO NOT ABORT! Hashed directories may take VERY LONG to
  57.     reorganize, especially on large hard disks!
  58. R    READ the current sector into memory. Useful if you used the S command
  59.     and then changed your mind.
  60. S    SUBSTITUTE byte(s). Prompts for an address 00..7F and then displays
  61.     the current contents in hex. RETURN skips to the next byte, a PERIOD
  62.     ends this substitution and re-asks for another address, any valid
  63.     hex number 00..FF will be stored at the location displayed.
  64.     Example: to change location 0060 from to 00, do:
  65.     S, then at the prompt enter 60, and when "0060 xx " is displayed,
  66.     type in "00".
  67. W    WRITE the current sector. Used to save changes made with the S
  68.     command. If you have made any changes, the previous values are
  69.     irretrievably lost after a W.
  70.  
  71.  
  72. KNOWN PROBLEMS:
  73.  
  74. The program was developed under TurboDOS version 1.4 and works with that
  75. version. I tried it under 1.3 and the following problems occur:
  76. 1. The directory size is displayed as 0, but it can be accessed properly.
  77.    The - command should not be used at sector 0, while it is up to you
  78.    to figure out how far out you can step with the + or G commands.
  79.    The F comamnd may not work correctly.
  80. 2. When exiting the program in a multi-user system where someone has attempted
  81.    to access the drive (and received a "not ready" error), the system may
  82.    crash completely.
  83. 3. Due to the fact that TD version 1.22 does not support T-function calls
  84.    or the FIXDIR call, DIRPAT cannot be run on ver 1.22 or earlier.
  85.  
  86. If you don't have TurboDOS version 1.4 run like hell to your dealer and
  87. get the upgrade! It's well worth it. Among many other things, the following
  88. command lines are now possible:
  89. 0A}5B:
  90. 5B}copy c7:*.* 1a:;n
  91. 5B}dir 31a:
  92.  
  93. COMMENTS:
  94.  
  95. Please direct all comments, questions or requests for additional features to:
  96.  
  97. S. Kluger
  98. c/o B-KOMP Inc.
  99. 5949 Sherry Ln
  100. Dallas TX 75225
  101. (214) 750-KOMP
  102.  
  103.  
  104. LIABILITIES:
  105.  
  106. This program is not intended for the inexperienced user. Gain proficiency by
  107. lots of practice on a scratch floppy.
  108. This program is FREE (in the public domain). Nobody in the world will ever
  109. guarantee it. You should not attempt to recover any losses incurred by a
  110. malfunction of the program or the user or both. However, your loss is everyone
  111. else's gain if you notify me of bugs and tell me the exact circumstances.
  112. That is the only way the program will be supported.
  113.  
  114.  
  115. TurboDOS is a Trademark of Software 2000, Inc.
  116. alls
  117.    or the FIXDIR call, DIRPAT cannot