Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/disasm.refentry @ 1404:097d8033bccc
source improvements
| author | boisy |
|---|---|
| date | Thu, 27 Nov 2003 23:46:01 +0000 |
| parents | 4dae346c4969 |
| children | b00cf13c9f61 |
| rev | line source |
|---|---|
| 971 | 1 <refentry id="disasm"> |
| 2 <refnamediv> | |
| 3 <refname>DISASM</refname> | |
| 4 <refpurpose>OS9 Module Disassembler</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>disasm</command> |
| 971 | 10 <group> |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
971
diff
changeset
|
11 <arg choice="opt">-m <replaceable>module name</replaceable></arg> |
|
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
971
diff
changeset
|
12 <arg choice="plain"><replaceable>filename</replaceable></arg> |
| 971 | 13 </group> |
| 14 <arg choice="opt">options</arg> | |
| 15 </cmdsynopsis> | |
| 16 </refsynopsisdiv> | |
| 17 | |
| 18 <refsect1><title>Description</title> | |
| 19 <para> | |
| 20 Disasm was written to hack apart OS9 system modules,command modules, | |
| 21 file managers and device drivers/descriptors either from memory or disk. | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
975
diff
changeset
|
22 Unlike most other disassemblers, <command>disasm</command> is a two pass disassembler, creating |
| 971 | 23 output using only referenced labels. This output can be redirected to a file |
| 24 and (after modifications if desired) then re-assembled. | |
| 25 </para> | |
| 26 <para> | |
| 27 Disasm provides completely commented disassembly of Device Descriptors... | |
| 28 very useful for building a customized boot file. | |
| 29 </para> | |
| 30 </refsect1> | |
| 31 <refsect1><title>Options</title> | |
| 32 <variablelist> | |
| 33 <varlistentry> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
971
diff
changeset
|
34 <term>disasm -m <replaceable>module name</replaceable></term> |
| 971 | 35 <listitem> |
| 36 <para> | |
| 37 will link to module in memory - if not found,will load module from exec | |
| 38 directory and then link to it...after disassembly,it will attempt to | |
| 39 unlink the module. | |
| 40 </para> | |
| 41 </listitem> | |
| 42 </varlistentry> | |
| 43 | |
| 44 <varlistentry> | |
|
975
c565a4700689
The entitity replstart was replaced with <replaceable>
roug
parents:
971
diff
changeset
|
45 <term>disasm <replaceable>pathlist/module name</replaceable></term> |
| 971 | 46 <listitem> |
| 47 <para> | |
| 48 will 'read' the module from the specified path without loading. | |
| 49 </para> | |
| 50 </listitem> | |
| 51 </varlistentry> | |
| 52 | |
| 53 <varlistentry> | |
| 54 <term>other options:</term> | |
| 55 <listitem> | |
| 56 <para> | |
| 57 o = display line number,address,object code & source code... useful for | |
| 58 hard to crack modules with data embedded in the middle. | |
| 59 </para> | |
| 60 <para> | |
| 61 x = look for module in execution directory. | |
| 62 </para> | |
| 63 </listitem> | |
| 64 </varlistentry> | |
| 65 </variablelist> | |
| 66 <para> | |
| 67 ANY combination of options is allowed (upper or lower case) but they *must* | |
| 68 immediately follow the '-' and there must be no spaces separating the options. | |
| 69 </para> | |
| 70 </refsect1> | |
| 71 <refsect1><title>OS9 Level I Users</title> | |
| 72 <para> | |
| 73 by changing relative address $17 from $64 to $30 will cause the output | |
| 74 source to reference /d0/defs instead of /dd/defs | |
| 75 </para><para> | |
| 76 also,if you are not using a driver which supports level II display codes, | |
| 77 you *MUST* change relative address $15 from 01 to 00 to avoid problems | |
| 78 in the event of an error message being printed out. | |
| 79 </para> | |
| 80 </refsect1> | |
| 81 </refentry> |