ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/CPM/TURBODSG/DIRPAT3.MAN

Text File | 2000-06-30 | 13KB | 280 lines

.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"