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"