1 |
|
|
2 |
< |
mon, Version 3.0 |
3 |
< |
A command-driven file monitor |
2 |
> |
cxmon, Version 3.0 |
3 |
> |
A command-line file manipulation tool and disassembler |
4 |
|
|
5 |
|
Copyright (C) 1997-2000 Christian Bauer, Marc Hellwig |
6 |
|
GNU binutils disassemblers Copyright (C) 1988, 89, 91, 93, 94, 95, 96, 97, 1998 |
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 |
|
|