155 lines
2.3 KiB
Groff
155 lines
2.3 KiB
Groff
.TH MDB 1
|
|
.SH NAME
|
|
mdb \- MINIX 3 debugger
|
|
.SH SYNOPSIS
|
|
.B mdb
|
|
.RB [ \-fc ]
|
|
.I file
|
|
.br
|
|
.B mdb
|
|
.BR [-L|-l]log\-file
|
|
.I exec-file
|
|
.RI [ core\-file ]
|
|
.RI [ @command\-file ]
|
|
.SH DESCRIPTION
|
|
.de SP
|
|
.if t .sp 0.4
|
|
.if n .sp
|
|
..
|
|
.B mdb
|
|
is the MINIX 3 debugger.
|
|
.SH OPTIONS
|
|
Its command line options are:
|
|
.TP
|
|
.B \-f
|
|
Just examine the specified file.
|
|
.TP
|
|
.B \-c
|
|
Examine 'core' file. No exec-file will be supplied.
|
|
.TP
|
|
.B \-Llog\-file
|
|
Log to file only
|
|
.TP
|
|
.B \-llog\-file
|
|
Log to file.
|
|
.SP
|
|
.IR exec\-file
|
|
Unless the -c option has been specified, the exec-file is required.
|
|
.SP
|
|
.IR core\-file
|
|
The core-file is optional.
|
|
.SP
|
|
If the core-file is supplied,
|
|
.B mdb
|
|
assumes that the user wishes to examine the core file.
|
|
Otherwise
|
|
.B mdb
|
|
assumes that the user will run the exec-file and trace it.
|
|
.SP
|
|
.IR @command\-file
|
|
.B mdb
|
|
executes command from command-file.
|
|
.SH OVERVIEW
|
|
.br
|
|
.B mdb
|
|
commands are of the form:
|
|
.I [ expression ]
|
|
.I command
|
|
.SP
|
|
.I expression
|
|
can be of the form:
|
|
.IP
|
|
.I address
|
|
which defaults to text segment
|
|
.IP
|
|
address
|
|
.I overriden
|
|
by
|
|
.I T:
|
|
for Text segment
|
|
or
|
|
.I D:
|
|
for Data segment
|
|
or
|
|
.I S:
|
|
for Stack segment
|
|
.IP
|
|
.I symbol
|
|
where
|
|
.B mdb
|
|
does a lookup for the symbol first as a
|
|
.I text
|
|
symbol and then as a
|
|
.I data
|
|
symbol.
|
|
.SP
|
|
.TP
|
|
.I command
|
|
.SP
|
|
The help command is ?.
|
|
.SP
|
|
For detailed help on a command type:
|
|
.I command ?.
|
|
.SP
|
|
A semi-colon can be used to separate commands on a line.
|
|
.SP
|
|
.SH MDB COMMANDS
|
|
.SP
|
|
! Shell escape
|
|
.SP
|
|
# Set Variable or register
|
|
.SP
|
|
Tt Current call / Backtrace all
|
|
.SP
|
|
/nsf Display for n size s with format f
|
|
.SP
|
|
Xx [n] Disasm / & display reg for n instructions
|
|
.SP
|
|
Rr a Run / with arguments a
|
|
.SP
|
|
Cc [n] Continue with current signal / no signal n times
|
|
.SP
|
|
Ii [n] Single step with / no signal for n instructions
|
|
.SP
|
|
Mm t n Trace until / Stop when modified t type for n instructions
|
|
.SP
|
|
k Kill
|
|
.SP
|
|
Bb Display / Set Break-pt
|
|
.SP
|
|
Dd Delete all / one break-points
|
|
.SP
|
|
P Toggle Pagging
|
|
.SP
|
|
Ll name Log to file name / and to standard output
|
|
.SP
|
|
Vv Toggle debug flag / Version info
|
|
.SP
|
|
V Version info
|
|
.SP
|
|
e [t] List symbols for type t
|
|
.SP
|
|
y Print segment mappings
|
|
.SP
|
|
s [n] Dump stack for n words
|
|
.SP
|
|
z [a] Trace syscalls with address a
|
|
.SP
|
|
? Help - short help
|
|
.SP
|
|
@ file Execute commands from file
|
|
.SP
|
|
Qq Quit / and kill traced process
|
|
.SP
|
|
.SH "SEE ALSO"
|
|
.SP
|
|
trace(2).
|
|
.SH DIAGNOSTICS
|
|
|
|
.SH NOTES
|
|
|
|
.SH BUGS
|
|
|
|
.SH AUTHOR
|
|
Philip Murton and others
|