home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / disasm / revas25.lbr / CPMAN.WZ / CPMAN.WS
Text File  |  1987-03-15  |  9KB  |  221 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                           REVAS FOR CPM
  17. .he REVAS/CPM
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                        Copyright (c) 1978
  39.                           A. E. Hawley
  40.                      Los Angeles, California
  41. .PAè    Thσá CP═ environmen⌠ require≤ somσ change≤ iε thσ commanΣ ì
  42. structurσá oµá REVAS¼á a≤á wel∞á a≤ thσ wa∙á iεá whicΦá REVA╙á i≤ ì
  43. implemented«áá Thσá followinτá descriptioεá oµá ne≈á anΣá changeΣ ì
  44. feature≤ i≤ aε appendi° t∩ thσ REVA╙ User'≤á Manual¼á V2╗á pleasσ ì
  45. refe≥á t∩á tha⌠ manua∞ iµ yo⌡ arσ no⌠ alread∙ familia≥ witΦá it'≤ ì
  46. contents.
  47.  
  48.     Iεá thσ CP═ environment¼á REVA╙ i≤ presen⌠ a≤ TW╧á files║ ì
  49. REVAS.CO═á anΣá REVAS.LOD«á Thσá firs⌠á file¼á REVAS.COM¼á i≤á aε ì
  50. executivσá prograφá whicΦá manage≤á thσá loadinτá oµá thσá targe⌠ ì
  51. program¼á REVAS¼á anΣá thσ symbo∞ tables«á Thi≤ filσ i≤ ┤á block≤ ì
  52. (pages⌐ lonτ anΣ run≤ a⌠ ß locatioε jus⌠ belo≈ CPM'≤ CC╨ section« ì
  53. Yo⌡ can¼á iµ yo⌡ wish¼á renamσ thi≤ filσ usinτ CPM'≤ RE╬ command¼ ì
  54. bu⌠á i⌠á mus⌠á remaiε ß .CO═ file«á Thi≤ filσá namσá define≤á thσ ì
  55. transien⌠á commanΣ useΣ t∩ invokσ ß disassembl∙ witΦá REVAS«á Thσ ì
  56. seconΣá file¼áá REVAS.LOD¼á contain≤á thσá actua∞á REVA╙á prograφ ì
  57. embeddeΣá iε ß relocatinτ loader«á I⌠ i≤ loadeΣ int∩á memor∙á anΣ ì
  58. executeΣ b∙ REVAS.COM¼ whicΦ contain≤ ß referencσ b∙ filename.ex⌠ ì
  59. t∩á REVAS.LOD«á Thus¼á thσá REVAS.LO─ filσ mus⌠ no⌠á bσá renamed« ì
  60. REVAS.LO─á i≤ 2░ block≤ (pages⌐ long«á (ß blocδ i≤ 25╢ bytes⌐ Al∞ ì
  61. file≤ arσ assumeΣ t∩ bσ oε thσ currentl∙ selecteΣ disc.
  62.  
  63.     Thσ prograφ t∩ bσ disassembleΣ (thσ targe⌠ program⌐á mus⌠ ì
  64. coexis⌠ witΦ REVA╙ iε you≥ computer'≤ memor∙ space« Wheε REVA╙ i≤ ì
  65. invoked¼á thσá targe⌠ filσ i≤ accesseΣ anΣ loadeΣ a⌠ thσ CP═á tpß ì
  66. (addres≤á 10░ Hex)«á Thσ REVA╙ disassemble≥ i≤ theε loadeΣá abovσ ì
  67. thσá targe⌠á pgm«á Iµ ß symbo∞ tablσ filσ fo≥ thσ targe⌠á prograφ ì
  68. exist≤á oεá thσ disk¼á i⌠ i≤ loadeΣ a⌠ thσ enΣ oµá REVAS«á Iµá n∩ ì
  69. symbo∞á tablσá filσ exists¼á theε onσ i≤á automaticall∙á created« ì
  70. Durinτ thσ loadinτ process¼ message≤ wil∞ bσ typeΣ oε thσ consolσ ì
  71. t∩ le⌠ yo⌡ kno≈ thσ result≤ oµ eacΦ oµ thesσ steps.
  72.  
  73.     REVA╙ alway≤ use≤ tw∩ files║á FN.TBL¼á anΣ FN.ASM« FN.TB╠ ì
  74. i≤ thσ filσ t∩ whicΦ REVA╙ write≤ it≤ symbo∞ table≤ (seσ thσá 'Wº ì
  75. command)«á FN.AS═á i≤á thσ filσ t∩ whicΦ REVA╙á write≤á assemble≥ ì
  76. mnemonic≤ fo≥ editinτ and/o≥ reassembly« Wheε REVA╙ i≤ invokeΣ i⌠ ì
  77. searche≤á thσá curren⌠á disπ director∙ fo≥ thesσá files«á Iµá no⌠ ì
  78. found¼á the∙ arσ automaticall∙ created« Iµ F╬ i≤ no⌠ specifieΣ iε ì
  79. thσ invokinτ command¼á theε FN=##ú i≤ assumed« Iµ thσ .EX╘ i≤ no⌠ ì
  80. specifieΣ fo≥ thσ targe⌠ program¼ theε EXT=CO═ i≤ assumed.
  81.  
  82.     ┴á disassembl∙á i≤á invokeΣá b∙á typinτá ßá standarΣá CP═ ì
  83. transien⌠ commanΣ (afte≥ thσ CP═ prompt⌐ oµ thσ followinτ form:
  84.  
  85.                            REVAS [ufn]
  86.  
  87.     'ufnº i≤ aε unambiguou≤ filσ name¼ a≤ defineΣ iε you≥ CP═ ì
  88. manual«á Fou≥á possiblσ form≤ oµ thi≤ commanΣ anΣá thσá resultinτ ì
  89. filσ name≤ involveΣ arσ showε iε thσ tablσ below«á Iε thi≤ table¼ ì
  90. 'EXTº mean≤ an∙ filσ extensioε excep⌠ 'TBL'«á 'FNº stand≤ fo≥ an∙ ì
  91. filσ name.
  92. .PAèCommand            Response
  93.  
  94. REVAS          REVA╙á i≤ loadeΣ a⌠ thσ tpa«á ###.TB╠ anΣá ###.AS═ ì
  95. áááááááááááááááarσ used.
  96.  
  97. REVAS FN       FN.CO═ i≤ loadeΣ a⌠ thσ tpß followeΣ b∙ REVAS« Thσ ì
  98. áááááááááááááááfile≤ FN.TB╠ anΣ FN.AS═ arσ used.
  99.  
  100. REVAS FN.EXT   FN.EX╘á i≤ loadeΣ a⌠ thσ tpa¼á followeΣ b∙á REVAS« ì
  101. áááááááááááááááThσ file≤ FN.TB╠ anΣ FN.AS═ arσ used.
  102.  
  103. REVAS FN.TBL   N∩á targe⌠ prograφ i≤ loaded«á REVA╙ i≤ loadeΣá a⌠ ì
  104. áááááááááááááááthσ tpa¼ followeΣ b∙ thσ symbo∞ tablσ filσ FN.TBL« ì
  105. áááááááááááááááIµá FN.TB╠á doe≤ no⌠ exist¼á theε i⌠á i≤á created« ì
  106. áááááááááááááááFN.AS═ i≤ used.
  107.  
  108.     Afte≥ thσ loadinτ proces≤ i≤ completed¼ contro∞ i≤ passeΣ ì
  109. t∩ REVAS¼ a≤ indicateΣ b∙ displa∙ oµ thσ REVA╙ promp⌠ (#⌐ oε you≥ ì
  110. console« Thσ REVA╙ commanΣ se⌠ i≤ no≈ a⌠ you≥ disposal.
  111.  
  112.                    REVAS/CP═ Specia∞ Commands
  113.  
  114.     Thσá 'Aº anΣ 'Iº command≤ describeΣ iε thσ User'≤á Manua∞ ì
  115. arσá no⌠ needeΣ iε thσ CP═ environment¼á anΣ havσ beeε deleteΣ iε ì
  116. thσá CP═á versioε oµ REVAS«á Thσ 'Wº commanΣ iε thσá CP═á versioε ì
  117. save≤á thσ curren⌠ symbo∞ table≤ oε disδ iε ß filσ nameΣá FN.TBL« ì
  118. Thσá 'Oºá (Outpu⌠á channe∞ control⌐ commanΣá anΣá thσá 'Eºá (.EN─ ì
  119. pseudo-op⌐ command≤ havσ beeε modifieΣ fo≥ thσ CP═ environmen⌠ t∩ ì
  120. OPE╬á anΣá CLOS┼ thσ FN.AS═ file«á Thσ PuncΦ outpu⌠ optioε i≤á n∩ ì
  121. longe≥ implementeΣ iε REVAS/CPM¼á sincσ tha⌠ utilit∙ i≤ availablσ ì
  122. througΦ PIP.
  123.  
  124. ^C        Control-C re-boots the CPM system.
  125.  
  126. E         Insert≤ thσ pseudo-o≡ '.ENDº int∩ thσ outpu⌠ streaφ anΣ ì
  127. ááááááááááproperl∙ close≤ thσ FN.AS═ file«á ┴ FN.AS═ filσ tha⌠ i≤ ì
  128. ááááááááááno⌠ closeΣ witΦ thi≤ commanΣ wil∞ no⌠ contaiε thσ fina∞ ì
  129. áááááááááárecorΣá witΦá thσá end-of-filσá marδá requireΣá b∙á thσ ì
  130. ááááááááááEditor.
  131.  
  132. .cp 10
  133. O         Thσ ke∙ lette≥ 'Pº ha≤ beeε replaceΣ b∙ 'Aº (fo≥ .ASM)« ì
  134. ááááááááááOtherwise¼ thσ commanΣ forma⌠ i≤ unchangeΣ froφ tha⌠ iε ì
  135. ááááááááááthσ user'≤ manual«á Thσ commanΣ 'OPE╬ C,A@º result≤á iε ì
  136. áááááááááánorma∞á disassembl∙á outpu⌠ a⌠ thσ consolσá anΣá label¼ ì
  137. ááááááááááopcode¼á anΣá argumen⌠á outpu⌠ t∩ thσ (no≈á open⌐á .AS═ ì
  138. ááááááááááfile« ┴ subsequen⌠ O├ commanΣ DOE╙ NO╘ CLOS┼ TH┼ FN.AS═ ì
  139. ááááááááááFILE«á Filσá closurσ MUS╘ bσ accomplisheΣ witΦ thσá 'Eº ì
  140. áááááááááácommand«á Thσá Consolσ anΣ Lis⌠ device≤ AR┼á deselecteΣ ì
  141. ááááááááááwheεá thei≥ ke∙ letter≤ arσ ommiteΣ froφ aε 'Oº commanΣ ì
  142. ááááááááááargumen⌠ list.
  143.  
  144. .cp 10èW         Writσá thσá symbo∞ table≤ int∩ thσá FN.TB╠á file«á Thi≤ ì
  145. áááááááááácommanΣ open≤ thσ file¼á write≤ t∩ it¼á theε close≤ thσ ì
  146. ááááááááááfile«á I⌠á wil∞á no⌠á executσ iµá thσá FN.AS═á filσá i≤ ì
  147. áááááááááácurrentl∙ open¼á anΣ wil∞ prin⌠ ß reminde≥ t∩ closσ thσ ì
  148. áááááááááá.AS═ filσ iµ i⌠ i≤ open« Thσ commanΣ ma∙ bσ repeateΣ a≤ ì
  149. ááááááááááofteεá a≤á yo⌡ wisΦ durinτ ß disassembly¼á s∩á yo⌡á caε ì
  150. ááááááááááalway≤á havσá saveΣá thσ lates⌠ versioεá oµá thσá labe∞ ì
  151. ááááááááááassignments.
  152.  
  153. .PAèA <Switch>%<Input>@
  154. ááááááááááThσá (new⌐ 'Aº commanΣ i≤ useΣ fo≥ assigninτ ne≈ value≤ ì
  155. áááááááááát∩ thσ parameter≤ listeΣ iε thσ User'≤ manua∞ unde≥ thσ ì
  156. ááááááááááheadinτá 'Patches'«á Thσ tablσ whicΦ follow≤ give≤á thσ ì
  157. ááááááááááexpecteΣ Inpu⌠ fo≥ eacΦ <switch╛ value«á 'HEXº mean≤á ß ì
  158. ááááááááááhexadecima∞ valuσ iε thσ rangσ ░ t∩ FF╗á 'CHº mean≤ an∙ ì
  159. áááááááááákeyboarΣá character¼á includinτ lowe≥ casσ anΣá contro∞ ì
  160. áááááááááácharacters.
  161.  
  162.  
  163. SWITCH         INPUT          FUNCTION
  164. 0        HEX        Numbe≥á oµ null≤ t∩ senΣ afte≥á ß ì
  165. áááááááááááááááááááááááááááááááácarriagσ return¼ linσ feeΣ t∩ thσ ì
  166. áááááááááááááááááááááááááááááááális⌠ device.
  167.  
  168. 1        HEX        Numbe≥á oµá nul∞ t∩ senΣ afte≥á ß ì
  169. áááááááááááááááááááááááááááááááácarriagσ return¼ linσ feeΣ t∩ thσ ì
  170. ááááááááááááááááááááááááááááááááconsolσ o≥ puncΦ devices.
  171.  
  172. 2        HEX        Numbe≥ oµ line≤ iε thσ To≡ Margiε ì
  173. ááááááááááááááááááááááááááááááááoµ thσ Lis⌠ devicσ page.
  174.  
  175. 3        HEX        Numbe≥á oµá line≤ iεá thσá Bottoφ ì
  176. ááááááááááááááááááááááááááááááááMargiε oµ thσ Lis⌠ devicσ page.
  177.  
  178. 4        HEX        Numbe≥ oµ line≤ oµ tex⌠ pe≥á Lis⌠ ì
  179. áááááááááááááááááááááááááááááááápage.
  180.  
  181. 5        AE        Righ⌠á justif∙á label≤á iεá labe∞ ì
  182. ááááááááááááááááááááááááááááááááfield.
  183.  
  184. 5        EE        Lef⌠áá justif∙á label≤á iεá labe∞ ì
  185. ááááááááááááááááááááááááááááááááfield.
  186.  
  187. 6        CH        Replacσá 'Sºá fo≥á thσá immediatσ ì
  188. áááááááááááááááááááááááááááááááácommanΣá whicΦ suspend≤á printou⌠ ì
  189. ááááááááááááááááááááááááááááááááanΣ disassembly.
  190.  
  191. 7        CH        Replacσá 'Rºá fo≥á thσá immediatσ ì
  192. áááááááááááááááááááááááááááááááácommanΣá whicΦ return≤á t∩á REVA╙ ì
  193. áááááááááááááááááááááááááááááááácommanΣ mode.
  194.  
  195. 8        CH        Replace≤ thσ ':º labe∞ terminator
  196.  
  197. 9        CH        Replace≤á thσá ';º commen⌠á fielΣ ì
  198. áááááááááááááááááááááááááááááááádelimiter
  199.  
  200. A    1 to 4 CH        Thesσáá character≤á replacσáá thσ ì
  201. áááááááááááááááááááááááááááááááá'.BYTEºá pseudo-o≡ whicΦá define≤ ì
  202. áááááááááááááááááááááááááááááááádatß storagσ bytes.
  203.  
  204. .CP 15è    Thσ 'Aº commanΣ ha≤ severa∞ restrictions«á First¼ i⌠ onl∙ ì
  205. operate≤á wheε n∩ othe≥ command≤ havσ beeεá previousl∙á executed« ì
  206. Second¼ i⌠ onl∙ operate≤ afte≥ thσ CP═ command:
  207.  
  208.                          REVAS REVAS.LOD
  209.  
  210.      Thσá change≤ whicΦ arσ madσ b∙ thσ 'Aº commanΣ occu≥ onl∙ iε ì
  211. thσ cop∙ oµ REVAS.LO─ whicΦ i≤ no≈ locateΣ a⌠ thσ tpa«á Afte≥ al∞ ì
  212. thσá change≤á havσá beeε made¼á thσ ne≈á REVAS.LO─á i≤á saveΣá b∙ ì
  213. executinτá ßá re-boo⌠á oµ thσ CP═ systeφ (^C⌐ anΣ usinτá thσá CP═ ì
  214. command:
  215.  
  216.                         SAVE 20 REVAS.LOD
  217.  
  218.      REVAS¼á oε subsequen⌠ invocation¼á wil∞ contaiε thσ changes« ì
  219. Al∞ othe≥ command≤ arσ a≤ describeΣ iε thσ REVA╙ user'≤ manual.
  220.  
  221.