he DIRPAT version 3.xx manual (c) S Kluger 1986
fo DIRPAT manual page #
DIRPAT version 3
1. WHAT IS DIRPAT?
DIRPA� i� � DIRector� PATc� utilit� fo� TurboDO� versio� 1.� �
an� higher� I� allow� fo� tota� manipulatio� o� dat� containe� i� �
th� dis� directory�� regardless� o� TurboDO� file/recor� locking� �
Usually�� DIRPA� i� use� afte� som� catastrophi� even� o� i� cas� �
o� director� entie� tha� canno� b� delete� wit� th� DELETŠ com�
mand�� DIRPAԠ ma� als� b� use� t� mass-delet� file� acros� use� �
areas�� Also�� i� i� a� interestin� learnin� too� i� yo� wan� t� �
fin� ou� wha� � TurboDO� director� look� like.
2. THE DIRECTORY
The TurboDOS disk directory is organized into three parts:
- volume label
The volume label is the first entry in the first sector of the
directory.
- bit map
Th� bi� ma� (dis� allocatio� map� contain� � binar�� "1�� fo� �
eac� used block, a "0" for each unused block on the disk.
NOTE: DIRPAT should never be used to manipulate the bit map!
- the directory
3. USING DIRPAT
Befor� usin� DIRPAT� i� mus� b� installe� fo� you� terminal� �
Sinc� i� use� direc� curso� addressing�� i� canno� b� use� wit� �
printin� terminals� T� install� hav� th� manua� fo� you� termina� �
handy�� the� execut� th� comman� "DPINST"�� Yo� wil� b� aske� fo� �
th� followin� information� al� o� whic� mus� b� entere� i� ASCII:
- clear screen sequence
- cursor positioning sequence
I� ther� ar� an� problem� configurin� DIRPA� fo� you� termi�
nal�� pleas� sen� m� � lis� o� escap� code� fo� you� termina� an� �
th� dis� o� whic� DIRPA� came�� an� I'l� b� gla� t� recitf�� th� �
problem.
NOTE: DIRPAT comes configured for HEATH H19 and BEEHIVE ATL-004.
pa
�
Afte� installin� DIRPAT�� i� i� read� fo� use�� Pleas� not� �
tha� DIRPA� must� b� invoke� fro� th� driv� yo� wis� t� process� �
DIRPA� ma� b� starte� wit� a� explici� driv� specification� I� i� �
is run without drive spec, the current drive is assumed.
Whe� DIRPA� i� starte� up�� th� copyrigh� messag� appear� o� �
th� scree� an� DIRPA� asks�� "D� yo� wis� t� loc� driv� x:?"� Yo� �
shoul� respon� wit� "Y� fo� "YES� i� yo� inten� t� alte� th� dis� �
directory�� O� � bus� syste� o� jus� t� browse� yo� ma� ente� "N� �
fo� "NO� an� DIRPA� wil� no� attemp� t� loc� th� drive�� NOTE:� i� �
yo�� requeste� DIRPA� t� loc� th� driv� an� th� driv� i� busy� �
DIRPA� wil� abor� wit� a� erro� message.
Next�� � messag� wil� b� displaye� t� pres� RETUR� t� star� �
usin� DIRPA� an� th� DIRPA� comman� promp� wil� appea� o� lin� 1� �
wit� th� curren� tim� displaye� i� colum� 0�� A� thi� time�� yo� �
ma� ente� an� comman� a� explaine� i� chapte� 4.
4. DIRPAT COMMANDS
? HELP
Typin� � questio� mar� wil� displa� � brie� hel� scree� �
����������showing all commands and a 1-line description.
> NEXT ACTIVE
Th� ">� comman� advance� t� th� nex� secto� containin� �
����������a� leas� on� activ� director� entry� skippin� al� empt� �
����������sectors.
! HOME
Th� HOM� comman� (!� set� th� curren� secto� t� �� an� �
����������displays it.
+ NEXT SECTOR
Th� "+� comman� advance� th� curren� secto� pointe� an� �
����������display� th� nex� sector�� A� th� en� o� th� directory� �
����������th� firs� secto� (secto� 0� i� displayed�� Sinc� "+� i� �
����������� shifte� characte� o� mos� keyboards�� "=�� i� als� �
����������permissible.
- PREVIOUS SECTOR
Th� "-� comman� decrement� th� secto� counte� an� dis�
����������play� th� previou� director� sector�� A� secto� 0�� th� �
����������las� director� secto� wil� b� displayed.
D CHANGE DRIVE
Th� Ġ comman� prompt� fo� � ne� driv� letter�� Ente� �
����������onl�� � lette� "A� throug� "P�� (n� colon�� an� th� �
����������correspondin砠 driv� wil� b� selected��� An�� othe� �
����������characte� cause� DIRPA� t� retur� t� displa� mod� wit� �
����������no changes.
pa
� E ERASE FILES
Thi� comman� prompt� fo� � filename�� Th� filenam� ma� �
����������contai� � use� number�� an� ma�� b� ambiguous�� Al� �
����������director�� entrie� matchin� th� fil� nam� wil� b� �
����������erased�� i� th� driv� i� no� locked�� � warnin� messag� �
����������wil� b� displaye� an� yo� ar� allowe� t� chang� you� �
����������mind.
F FIND HEX DATA
Th� "F�� comman� ma� b� use� t� locat� � strin� o� �
����������hexadecima� value� i� th� directory�� Th� strin� mus� �
����������no� cros� secto� boundaries�� Searc� wil� commenc� a� �
����������byt� � o� th� curren� sector� I� found� th� secto� wil� �
����������b� displayed�� th� byt� numbe� wil� b� show� i� th� �
����������uppe� right-han� corne� o� th� scree� an� th� curso� �
����������wil� b� place� o� th� firs� characte� o� th� strin� fo� �
����������subsequent editing. See "S" command on editing.
G GOTO
Th� "G� comman� allow� yo� t� jum� t� an� secto� withi� �
����������th� directory�� I� valid�� th� specifie� secto� become� �
����������the current sector and is displayed.
H HASH STATUS
Wit� thi� command�� th� director� ha� statu� ma� b� se� �
����������o� reset�� Has� o� nonhas� wil� hav� effec� afte� �
����������exiting�� NOTE�� tha� i� th� driv� i� no� locked�� thi� �
����������command should not be used.
L LOCATE A FILE
Th� "L� comman� allow� yo� t� locate� � filenam� i� th� �
����������directory�� Searc� commence� a� th� curren� secto� an� �
����������stop� a� th� firs� match�� I� � use� area� i� specifie� �
����������wit� th� filename�� DIRPA� wil� searc� fo� th� firs� �
����������occurrenc� o� tha� filename�� els� i� wil� sto� a� th� �
����������firs� matc� o� an� kin� (erase� fil� o� an� use� area)� �
����������Otherwise� operatio� i� identica� t� th� "F� command.
Q QUIT
Th� Qui� comman� terminate� DIRPAԠ an� exit� t� �
����������TurboDOS�� I� th� driv� wa� locke� an� an� change� wer� �
����������writte� t� th� directory�� � FIXMA� operatio� i� don� �
����������befor� exiting�� Then�� i� th� director� wa� hashe� o� �
����������th� has� statu� wa� changed�� � FIXDI� cal� wil� b� �
����������made�� too� I� an� change� wer� mad� wit� th� driv� not� �
����������locked�� � messag� wil� b� displaye� t� th� effec� tha� �
����������FIXDIR and FIXMAP should be run as soon as possible.
R RE-READ
Thi� comman� i� use� t� redispla� th� curren� sector� �
����������usuall� afte� extensiv� editin� wa� don� o� th� secto� �
����������(without writing) and the changes are to be discarded.
pa
� S SUBSTITUTE (EDIT)
Thi� mos� powerfu� DIRPA� comman� allow� on-scree� �
����������editin� o� th� curren� sector�� Th� curso� i� place� o� �
����������byt� �� an� DIRPA� await� furthe� input�� Fo� curso� �
����������movement� us� ^E=up� ^X=down� ^S=left� ^D=right� A� th� �
����������beginnin� an� end�� th� command� wrap� i� ^� a� byt� 1� �
����������wil� mov� th� curso� t� byt� 10�� Th� ^� comman� exit� �
����������back to the DIRPAT command prompt.
T� chang� � certai� byt� o� strin� o� bytes�� mov� th� �
����������curso� t� th� targe� byte�� Yo� ma�� the� ente� two� �
����������hexadecima젠 characters��� Pleas堠 not堠 tha� bot� �
����������character� mus� b� vali� he� digit� (0..9�� A..F)�� I� �
����������th� secon� characte� i� no� � vali� he�� character� �
����������DIRPAԠ wil� wai� unti� on� i� typed�� Afte� tw� he� �
����������character� hav� bee� typed�� th� ASCI� portio� o� th� �
����������displa� i� update� an� th� curso� i� move� t� th� nex� �
����������byt� o� th� sam� line� o� t� th� firs� byt� o� th� nex� �
����������lin� i� a� th� en� o� th� lin� (o� t� th� firs� byt� o� �
����������the screen if at the end of the block).
T� edi� i� ASCII�� yo� mus� prefi� th� characte� wit� � �
����������singl� quot� (')�� So� t� ente� � "s"� typ� "'s� a� th� �
����������curso� location� Th� he� an� ASCI� part� o� th� displa� �
����������wil� b� update� appropriatel� an� th� curso� move� t� �
����������th� nex� byte.
U UNDELETE
Th� "U� comman� allow� � fil� o� man� file� t� b� "un-�
����������deleted"�� Pleas� not� tha� ther� ma� b� man�� delete� �
����������entrie� fo� on� fil� an� tha� yo� ma� b� resurrectin� �
����������tras� instea� o� data�� caus� allocatio� conflict� o� �
����������eve� wip� ou� existin� files�� Thi� shoul� onl� b� don� �
����������i� desperat� situation� i� � controlle� environmen� (i� �
����������nobod� els� o� th� system� driv� locked)� th� U� comman� �
����������display� th� secto� i� foun� � matc� an� ask� fo� �
����������confirmatio� befor� unerasin� th� file(s)� the� goe� o� �
����������t� th� nex� sector�� unti� th� whol� director� ha� bee� �
����������processed.
W WRITE SECTOR
Thi� comman� write� th� curren� director�� secto� t� �
����������dis� makin� an� change� permanent�� I� th� driv� i� not� �
����������locked, you will be asked for confirmation.
X HEX TOGGLE
Th� "X� comman� toggle� th� secto� numbe� displa� bet�
����������wee� he�� an� decimal�� Not� tha� al� secto� numbe� �
����������entrie� requeste� b� DIRPA� mus� b� mad� i� decimal� �
����������whil� th� defaul� displa� mod� i� hex.
pa
�
5. DIRPAT DISPLAY/EDIT FORMAT
Th� followin� i� � typica� DIRPA� secto� display� jus� afte� �
a command has been executed:
Sec [000B] Hash=ON Size 0040 sectors WL
ADDR 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 0123456789ABCDEF
0000 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 eeeeeeeeeeeeeeee
0010 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 eeeeeeeeeeeeeeee
0020 00 44 49 52 50 41 54 33 20 4D 41 43 00 00 00 80 .DIRPAT3 MAC....
0030 74 00 75 00 76 00 77 00 78 00 79 00 7A 00 7B 00 t.u.v.w.x.y.z.{.
0040 00 44 49 52 50 41 54 33 20 4D 41 43 01 00 00 10 .DIRPAT3 MAC....
0050 7C 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 |...............
0060 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 eeeeeeeeeeeeeeee
0070 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 E5 eeeeeeeeeeeeeeee
11:29:46 Command (or ? for help) [_]
Above�� yo� se� th� statu� line� followe� b� th� rule� line� �
� blan� lin� an� th� curren� sector�� Th� comman� prom� an� �
current time appear on line 16 of your terminal.
The status line displays the following info, left to right:
- Currently displayed sector (in hex or decimal)
- HASH status (ON or OFF)
- Size of the directory (in hex or decimal)
- "W" if directory has been written to
- "L" if drive is locked
- I� th� displa� i� immediatel� afte� � "L� o� "F� command�� th� �
string, "Found: xx" is displayed also (where "xx" is the byte).
pa
�
6. MISCELLANEOUS
I� i� bes� t� gai� proficienc� an� confidenc� b�� extensiv� �
"playing�� wit� DIRPAԠ o� � flopp� diskett� create� fo� tha� �
purpose�� DIRPA� wil� no� acces� an� driv� othe� tha� th� on� i� �
wa� invoke� from�� s� ther� i� n� nee� t� worr�� abou� othe� �
drives�� I� yo� hav� use� th� previou� version� o� DIRPA� before� �
yo�� ma�� fin� thi� on� quit� � bi� easie� an� mor� friendl�� t� �
use�� DIRPAԠ wa� bor� ou� o� necessit� an� evolve� wit� it� use� �
an� i� yo� thin� o� an� improvement� o� additiona� commands� �
please let me know.
Pleas� note� tha� DIRPA� versio� 3.x� i� copyrighte� an� ma� �
no� b� duplicate� o� redistributed�� unlik� olde� version� o� �
DIRPAT�� whic� ar� i� th� Publi� Domain�� Th� purchas� o� DIRPA� �
authorize� th� purchase� a� wel� a� th� purchaser'� employee� t� �
us� DIRPA� o� thei� ow� TurboDO� compute� system� an� (i� purcha�
se� i� � company� o� thei� client'� computers�� Purchase� i� �
authorize� t� mak� a� man� copie� o� DIRPA� a� ar� necessar� fo� �
convenience�� DIRPAԠ ma�� b� use� on� bu� no� copie� onto�� an� �
system� no� owne� b� purchaser.
Th� use� o� DIRPA� i� solel� responsibl� fo� an�� o� it� �
uses�� damage� cause� b�� bug� i� DIRPAT�� damage� cause� b� �
inappropriate�� unauthorize� o� ignoran� us� o� DIRPAT�� an� an� �
other damages or losses related to DIRPAT or its use.
For bug reports or comments, please write to:
S. Kluger, 7120 Skillman#2104, Dallas TX 75231
th� us� o� DIRPAԠ signifie� agreemen� t� al� restriction� �
mentioned above.
"TurboDOS is a registered trademark of and (c) by Software 2000"