Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/disasm.refentry @ 2314:5f76d1a611f6
term signal sending for serread port status responses
| author | aaronwolfe |
|---|---|
| date | Sun, 03 Jan 2010 22:09:41 +0000 |
| parents | b00cf13c9f61 |
| children |
| rev | line source |
|---|---|
| 971 | 1 <refentry id="disasm"> |
| 2 <refnamediv> | |
| 3 <refname>DISASM</refname> | |
| 1500 | 4 <refpurpose>NitrOS-9 Module Disassembler</refpurpose> |
| 971 | 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> | |
| 1500 | 20 Disasm was written to hack apart NitrOS-9 system modules,command modules, |
| 971 | 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 </refentry> |