ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/mon/README
(Generate patch)

Comparing mon/README (file contents):
Revision 1.4 by cebix, 2000-09-25T12:44:30Z vs.
Revision 1.7 by cebix, 2000-10-10T21:14:33Z

# Line 1 | Line 1
1  
2    mon, Version 3.0
3 <  A command-driven file monitor
3 >  A command-line file manipulation tool and disassembler
4  
5    Copyright (C) 1997-2000 Christian Bauer, Marc Hellwig
6 <  GNU binutils disassemblers (C) 1988, 89, 91, 93, 94, 95, 96, 97, 1998
6 >  GNU binutils disassemblers Copyright (C) 1988, 89, 91, 93, 94, 95, 96, 97, 1998
7      Free Software Foundation, Inc.
8  
9  
# Line 17 | Line 17 | file "COPYING" that is included in the d
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, 80x86, 6502 and
27 < 8080 disassemblers.
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.
26  
27  
28   Installation
# Line 37 | Line 35 | Usage
35   -----
36  
37   mon can be started from the Shell or from the Tracker (BeOS), but command line
38 < history doesn't work when started from the Tracker). If you give no command
39 < line arguments, mon enters interactive mode. Otherwise, all arguments are
40 < interpreted and executed as mon commands. The default buffer size is 1MB.
38 > history doesn't work when started from the Tracker).
39 >
40 > Options:
41 >  -m  enables symbolic MacOS A-Trap and low memory globals display in the
42 >      680x0 disassembler
43 >  -r  makes mon operate in real (virtual) memory space instead of an allocated
44 >      buffer
45 >
46 > If no additional command line arguments are given, mon enters interactive
47 > mode. Otherwise, all remaining arguments are interpreted and executed as mon
48 > commands.
49 >
50 > The default buffer size is 1MB.
51 >
52   The mon command prompt looks like this:
53  
54    [00000000]->
# Line 209 | Line 218 | Entering "d80" without arguments is equi
218   "." is set to the address after the last address displayed.
219  
220  
221 <  d86 [start [end]]        Disassemble 80x86 code
221 >  d86 [start [end]]        Disassemble 80x86 (32-bit) code
222  
223   disassembles the buffer contents from address "start" to address "end".
224   Entering "d86" without arguments is equivalent to "d86 .". The value of
225   "." is set to the address after the last address displayed.
226  
227  
228 +  d8086 [start [end]]      Disassemble 80x86 (16-bit) code
229 +
230 + disassembles the buffer contents from address "start" to address "end".
231 + Entering "d8086" without arguments is equivalent to "d8086 .". The value
232 + of "." is set to the address after the last address displayed.
233 +
234 +
235    : start string           Modify memory
236  
237   puts the specified byte string at the address "start" into the buffer. The
# Line 331 | Line 347 | is omitted, the variable "var" is cleare
347   clears all currently defined variables.
348  
349  
334 rmon
335 ----
336
337 When mon is started as "rmon", it enters "real mode". That is, all memory
338 related functions no longer operate on the buffer but on "real" (virtual)
339 memory. Unless you are writing Mac emulators, this is probably of not much
340 use. :-)
341
342
350   Examples
351   --------
352  

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines