| 1 |
|
|
| 2 |
< |
mon, Version 3.0 |
| 2 |
> |
cxmon, Version 3.0 |
| 3 |
|
A command-line file manipulation tool and disassembler |
| 4 |
|
|
| 5 |
|
Copyright (C) 1997-2000 Christian Bauer, Marc Hellwig |
| 10 |
|
License |
| 11 |
|
------- |
| 12 |
|
|
| 13 |
< |
mon is available under the terms of the GNU General Public License. See the |
| 13 |
> |
cxmon is available under the terms of the GNU General Public License. See the |
| 14 |
|
file "COPYING" that is included in the distribution for details. |
| 15 |
|
|
| 16 |
|
|
| 17 |
|
Overview |
| 18 |
|
-------- |
| 19 |
|
|
| 20 |
< |
"mon" is an interactive command-driven file manipulation tool that is |
| 21 |
< |
inspired by the "Amiga Monitor" by Timo Rossi <trossi@jyu.fi>. It has |
| 22 |
< |
commands and features similar to a machine code monitor/debugger, but it |
| 23 |
< |
lacks any functions for running/tracing code. There are, however, built-in |
| 24 |
< |
PowerPC, 680x0, 80x86, 6502 and 8080 disassemblers. By default, mon operates |
| 25 |
< |
on a fixed-size (but adjustable) memory buffer with adresses starting at 0. |
| 20 |
> |
cxmon is an interactive command-driven file manipulation tool that is |
| 21 |
> |
inspired by the "Amiga Monitor" by Timo Rossi. It has commands and features |
| 22 |
> |
similar to a machine code monitor/debugger, but it lacks any functions for |
| 23 |
> |
running/tracing code. There are, however, built-in PowerPC, 680x0, 80x86, |
| 24 |
> |
6502 and Z80 disassemblers and special support for disassembling MacOS code. |
| 25 |
> |
By default, cxmon operates on a fixed-size (but adjustable) memory buffer |
| 26 |
> |
with adresses starting at 0. |
| 27 |
|
|
| 28 |
|
|
| 29 |
|
Installation |
| 35 |
|
Usage |
| 36 |
|
----- |
| 37 |
|
|
| 38 |
< |
mon can be started from the Shell or from the Tracker (BeOS), but command line |
| 39 |
< |
history doesn't work when started from the Tracker). |
| 38 |
> |
cxmon can be started from the Shell or from the Tracker (BeOS), but command |
| 39 |
> |
line history doesn't work when started from the Tracker. |
| 40 |
|
|
| 41 |
|
Options: |
| 42 |
|
-m enables symbolic MacOS A-Trap and low memory globals display in the |
| 43 |
|
680x0 disassembler |
| 44 |
< |
-r makes mon operate in real (virtual) memory space instead of an allocated |
| 45 |
< |
buffer |
| 44 |
> |
-r makes cxmon operate in real (virtual) memory space instead of an |
| 45 |
> |
allocated buffer |
| 46 |
|
|
| 47 |
< |
If no additional command line arguments are given, mon enters interactive |
| 48 |
< |
mode. Otherwise, all remaining arguments are interpreted and executed as mon |
| 47 |
> |
If no additional command line arguments are given, cxmon enters interactive |
| 48 |
> |
mode. Otherwise, all remaining arguments are interpreted and executed as cxmon |
| 49 |
|
commands. |
| 50 |
|
|
| 51 |
|
The default buffer size is 1MB. |
| 52 |
|
|
| 53 |
< |
The mon command prompt looks like this: |
| 53 |
> |
The cxmon command prompt looks like this: |
| 54 |
|
|
| 55 |
|
[00000000]-> |
| 56 |
|
|
| 60 |
|
|
| 61 |
|
Commands that create a longer output can be interrupted with Ctrl-C. |
| 62 |
|
|
| 63 |
< |
To quit mon, enter the command "x". |
| 63 |
> |
To quit cxmon, enter the command "x". |
| 64 |
|
|
| 65 |
|
|
| 66 |
|
Constants, variables and expressions |
| 76 |
|
combinations of digits and letters (they may also start with a digit) that |
| 77 |
|
are not also valid hexadecimal numbers. Names are case-sensitive. |
| 78 |
|
|
| 79 |
< |
mon accepts expressions in all places where you have to specify a number. The |
| 80 |
< |
following operators are available and have the same meaning and precedence as |
| 81 |
< |
in the C programming language: |
| 79 |
> |
cxmon accepts expressions in all places where you have to specify a number. |
| 80 |
> |
The following operators are available and have the same meaning and |
| 81 |
> |
precedence as in the C programming language: |
| 82 |
|
|
| 83 |
|
~ complement |
| 84 |
|
+ unary plus |
| 118 |
|
The buffer |
| 119 |
|
---------- |
| 120 |
|
|
| 121 |
< |
Those mon commands that operate on "memory" operate on a buffer allocated by |
| 122 |
< |
mon whose size is adjustable with the "@" command. The default buffer size is |
| 123 |
< |
1MB. The buffer is an array of bytes where each byte has a 32-bit integer |
| 124 |
< |
address. Addresses start at 0 and are taken modulo the buffer size (i.e. for |
| 125 |
< |
the default 1MB buffer, addresses 0 and 100000 refer to the same byte). |
| 121 |
> |
Those cxmon commands that operate on "memory" operate on a buffer allocated |
| 122 |
> |
by cxmon whose size is adjustable with the "@" command. The default buffer |
| 123 |
> |
size is 1MB. The buffer is an array of bytes where each byte has a 32-bit |
| 124 |
> |
integer address. Addresses start at 0 and are taken modulo the buffer size |
| 125 |
> |
(i.e. for the default 1MB buffer, addresses 0 and 100000 refer to the same |
| 126 |
> |
byte). |
| 127 |
|
|
| 128 |
< |
The buffer is the working area of mon where you load files into, manipulate |
| 128 |
> |
The buffer is the working area of cxmon where you load files into, manipulate |
| 129 |
|
them, and write files back from. Arbitraty portions of the buffer may be used |
| 130 |
|
as scratch space. |
| 131 |
|
|
| 133 |
|
Commands |
| 134 |
|
-------- |
| 135 |
|
|
| 136 |
< |
The following commands are available in mon ('[]' marks a parameter than can be |
| 137 |
< |
left out): |
| 136 |
> |
The following commands are available in cxmon ('[]' marks a parameter than |
| 137 |
> |
can be left out): |
| 138 |
|
|
| 139 |
|
|
| 140 |
< |
x Quit mon |
| 140 |
> |
x Quit cxmon |
| 141 |
|
|
| 142 |
< |
quits mon and returns to the shell. |
| 142 |
> |
quits cxmon and returns to the shell. |
| 143 |
|
|
| 144 |
|
|
| 145 |
|
h Show help text |
| 154 |
|
|
| 155 |
|
ver Show version |
| 156 |
|
|
| 157 |
< |
shows the version number of mon. |
| 157 |
> |
shows the version number of cxmon. |
| 158 |
|
|
| 159 |
|
|
| 160 |
|
? expression Calculate expression |
| 213 |
|
"." is set to the address after the last address displayed. |
| 214 |
|
|
| 215 |
|
|
| 216 |
< |
d80 [start [end]] Disassemble 8080 code |
| 216 |
> |
d80 [start [end]] Disassemble Z80 code |
| 217 |
|
|
| 218 |
|
disassembles the buffer contents from address "start" to address "end". |
| 219 |
|
Entering "d80" without arguments is equivalent to "d80 .". The value of |
| 352 |
|
Examples |
| 353 |
|
-------- |
| 354 |
|
|
| 355 |
< |
Here are some simple examples for what is possible with mon. |
| 355 |
> |
Here are some simple examples for what is possible with cxmon. |
| 356 |
|
|
| 357 |
|
Join "file1" and "file2" to "file3": |
| 358 |
|
|
| 365 |
|
[ 0 "file" |
| 366 |
|
] 18 .-18 "file" |
| 367 |
|
|
| 368 |
< |
Load the mon executable and search for PowerPC "nop" commands: |
| 368 |
> |
Load the cxmon executable and search for PowerPC "nop" commands: |
| 369 |
|
|
| 370 |
< |
[ 0 "mon" |
| 370 |
> |
[ 0 "cxmon" |
| 371 |
|
h 0 . 60,00,00,00 |
| 372 |
|
|
| 373 |
< |
Create a modified version of mon so that the prompt has " $" instead of "->": |
| 373 |
> |
Create a modified version of cxmon so that the prompt has " $" instead of |
| 374 |
> |
"->": |
| 375 |
|
|
| 376 |
< |
[ 0 "mon" |
| 376 |
> |
[ 0 "cxmon" |
| 377 |
|
set size=. |
| 378 |
|
h 0 . "->" |
| 379 |
|
: . " $" |
| 380 |
< |
] 0 size "mon1" |
| 380 |
> |
] 0 size "cxmon1" |
| 381 |
|
|
| 382 |
|
Convert a binary file which contains 16-bit numbers in little-endian format |
| 383 |
|
to big-endian format (or vice-versa): |
| 392 |
|
d 100 |
| 393 |
|
|
| 394 |
|
|
| 395 |
+ |
Using cxmon in your own programs |
| 396 |
+ |
-------------------------------- |
| 397 |
+ |
|
| 398 |
+ |
cxmon provides a simple interface for integration in other programs. It can, |
| 399 |
+ |
for example, be used as a monitor/debugger for an emulator (it is used in |
| 400 |
+ |
Basilisk II in this way). |
| 401 |
+ |
|
| 402 |
+ |
Here's how to do it (all functions are defined in the mon.h header file): |
| 403 |
+ |
|
| 404 |
+ |
1. Link all the cxmon object files, except main.o, to your program. |
| 405 |
+ |
2. In your program, call mon_init() before using any other cxmon functions. |
| 406 |
+ |
3. After calling mon_init(), set the mon_read_byte and mon_write_byte |
| 407 |
+ |
function pointers to the routines used for accessing memory. |
| 408 |
+ |
4. You can use mon_add_command() to add new commands to cxmon by specifying |
| 409 |
+ |
the command name, function and help text. From within your command |
| 410 |
+ |
function, you can use mon_get_token() and mon_expression() to parse the |
| 411 |
+ |
arguments and the mon_read/write_*() functions to access memory. |
| 412 |
+ |
5. To enter cxmon, call the mon() function like this: |
| 413 |
+ |
|
| 414 |
+ |
char *args[3] = {"mon", "-r", NULL}; |
| 415 |
+ |
mon(2, args); |
| 416 |
+ |
|
| 417 |
+ |
6. If you're done with cxmon, call mon_exit(). |
| 418 |
+ |
|
| 419 |
+ |
|
| 420 |
|
History |
| 421 |
|
------- |
| 422 |
|
|
