| 1 |
|
|
| 2 |
< |
mon, Version 2.2 |
| 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-1999 Christian Bauer, Marc Hellwig |
| 6 |
< |
Freely distributable |
| 5 |
> |
Copyright (C) 1997-2000 Christian Bauer, Marc Hellwig |
| 6 |
> |
GNU binutils disassemblers Copyright (C) 1988, 89, 91, 93, 94, 95, 96, 97, 1998 |
| 7 |
> |
Free Software Foundation, Inc. |
| 8 |
> |
|
| 9 |
> |
|
| 10 |
> |
License |
| 11 |
> |
------- |
| 12 |
> |
|
| 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 inspired |
| 21 |
< |
by the "Amiga Monitor" by Timo Rossi <trossi@jyu.fi>. It has commands and |
| 22 |
< |
features similar to a machine code monitor/debugger, but it is not intended |
| 23 |
< |
to be used for debugging. It doesn't operate on physical or virtual RAM |
| 24 |
< |
locations of a process but rather on a fixed-size (but adjustable) buffer with |
| 25 |
< |
adresses starting at 0. Also, there are no commands to trace code, set |
| 26 |
< |
breakpoints etc. There are, however, built-in PowerPC, 680x0, 6502 and 8080 |
| 19 |
< |
disassemblers. |
| 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 |
| 30 |
|
------------ |
| 31 |
|
|
| 32 |
< |
There are precompiled binaries for BeOS included in the archive. mon doesn't |
| 26 |
< |
need any auxiliary files. |
| 27 |
< |
|
| 28 |
< |
To compile under Unix, cd to "src", edit "Makefile" and type "make". |
| 32 |
> |
Please consult the file "INSTALL" for installation instructions. |
| 33 |
|
|
| 34 |
|
|
| 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). If you give no command |
| 40 |
< |
line arguments, mon enters interactive mode. Otherwise, all arguments are |
| 41 |
< |
interpreted and executed as mon commands. The default buffer size is 1MB. |
| 42 |
< |
The mon command prompt looks like this: |
| 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 cxmon operate in real (virtual) memory space instead of an |
| 45 |
> |
allocated buffer |
| 46 |
> |
|
| 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 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 |
| 178 |
|
of "." is set to the address after the last address displayed. |
| 179 |
|
|
| 180 |
|
|
| 181 |
+ |
b [start [end]] Binary memory dump |
| 182 |
+ |
|
| 183 |
+ |
displays the buffer contents from address "start" to address "end" in a binary |
| 184 |
+ |
format. Entering "b" without arguments is equivalent to "b .". The value of |
| 185 |
+ |
"." is set to the address after the last address displayed. |
| 186 |
+ |
|
| 187 |
+ |
|
| 188 |
|
m [start [end]] Hex/ASCII memory dump |
| 189 |
|
|
| 190 |
|
displays the buffer contents from address "start" to address "end" as hex |
| 199 |
|
set to the address after the last address displayed. |
| 200 |
|
|
| 201 |
|
|
| 202 |
< |
d65 [start [end]] Disassemble 6502 code |
| 202 |
> |
d65 [start [end]] Disassemble 6502 code |
| 203 |
|
|
| 204 |
|
disassembles the buffer contents from address "start" to address "end". |
| 205 |
|
Entering "d65" without arguments is equivalent to "d65 .". The value of |
| 206 |
|
"." is set to the address after the last address displayed. |
| 207 |
|
|
| 208 |
|
|
| 209 |
< |
d68 [start [end]] Disassemble 680x0 code |
| 209 |
> |
d68 [start [end]] Disassemble 680x0 code |
| 210 |
|
|
| 211 |
|
disassembles the buffer contents from address "start" to address "end". |
| 212 |
|
Entering "d68" without arguments is equivalent to "d68 .". The value of |
| 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 |
| 220 |
|
"." is set to the address after the last address displayed. |
| 221 |
|
|
| 222 |
|
|
| 223 |
< |
d86 [start [end]] Disassemble 80x86 code (very incomplete) |
| 223 |
> |
d86 [start [end]] Disassemble 80x86 (32-bit) code |
| 224 |
|
|
| 225 |
|
disassembles the buffer contents from address "start" to address "end". |
| 226 |
|
Entering "d86" without arguments is equivalent to "d86 .". The value of |
| 227 |
|
"." is set to the address after the last address displayed. |
| 228 |
|
|
| 229 |
|
|
| 230 |
+ |
d8086 [start [end]] Disassemble 80x86 (16-bit) code |
| 231 |
+ |
|
| 232 |
+ |
disassembles the buffer contents from address "start" to address "end". |
| 233 |
+ |
Entering "d8086" without arguments is equivalent to "d8086 .". The value |
| 234 |
+ |
of "." is set to the address after the last address displayed. |
| 235 |
+ |
|
| 236 |
+ |
|
| 237 |
|
: start string Modify memory |
| 238 |
|
|
| 239 |
|
puts the specified byte string at the address "start" into the buffer. The |
| 349 |
|
clears all currently defined variables. |
| 350 |
|
|
| 351 |
|
|
| 322 |
– |
rmon |
| 323 |
– |
---- |
| 324 |
– |
|
| 325 |
– |
When mon is started as "rmon", it enters "real mode". That is, all memory |
| 326 |
– |
related functions no longer operate on the buffer but on "real" (virtual) |
| 327 |
– |
memory. Unless you are writing Mac emulators, this is probably of not much |
| 328 |
– |
use. :-) |
| 329 |
– |
|
| 330 |
– |
|
| 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 |
< |
Legal stuff |
| 396 |
< |
----------- |
| 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 |
< |
Copyright 1997-1999 Christian Bauer. This program is freeware. You may do |
| 377 |
< |
whatever you want with it for personal use. Permission is granted to |
| 378 |
< |
redistribute this program free of charge, provided it is distributed in the |
| 379 |
< |
full archive with unmodified contents and no profit beyond the price of the |
| 380 |
< |
media on which it is distributed is made. Exception to the last rule: It may |
| 381 |
< |
be included on freeware/shareware collections on CD-ROM. There are no |
| 382 |
< |
warranties of any kind for this program. If you use this program, you do so |
| 383 |
< |
at your own risk. The authors are not responsible for any damages that might |
| 384 |
< |
result from using this program. |
| 417 |
> |
6. If you're done with cxmon, call mon_exit(). |
| 418 |
|
|
| 419 |
|
|
| 420 |
|
History |
| 421 |
|
------- |
| 422 |
|
|
| 423 |
< |
V1.0 - Initial release |
| 391 |
< |
V1.3 - Now uses libreadline |
| 392 |
< |
Disassembler: prints SPR names instead of numbers, fixed bugs |
| 393 |
< |
V1.4 - Implemented 6502 and 680x0 disassemblers |
| 394 |
< |
V1.5 - Non-interactive mode, real mode |
| 395 |
< |
V2.0 - Unified PPC and x86 release |
| 396 |
< |
V2.1 - Compiled for BeOS R4, opens Terminal window when started from Tracker, |
| 397 |
< |
implemented 8080 disassembler, included Unix makefile |
| 398 |
< |
V2.2 - Switched from project files to makefiles on BeOS, fixed some minor |
| 399 |
< |
bugs in the PPC disassembler, commands made modular |
| 423 |
> |
Please consult the file "ChangeLog" for the release history. |
| 424 |
|
|
| 425 |
|
|
| 426 |
|
Christian Bauer |
| 427 |
< |
<cbauer@iphcip1.physik.uni-mainz.de> |
| 427 |
> |
<Christian.Bauer@uni-mainz.de> |
| 428 |
|
|
| 429 |
|
Marc Hellwig |
| 430 |
< |
<hellwig@iphcip1.physik.uni-mainz.de> |
| 430 |
> |
<Marc.Hellwig@uni-mainz.de> |
