| 1 | .TH MDB 1
|
|---|
| 2 | .SH NAME
|
|---|
| 3 | mdb \- MINIX 3 debugger
|
|---|
| 4 | .SH SYNOPSIS
|
|---|
| 5 | .B mdb
|
|---|
| 6 | .RB [ \-fc ]
|
|---|
| 7 | .I file
|
|---|
| 8 | .br
|
|---|
| 9 | .B mdb
|
|---|
| 10 | .BR [-L|-l]log\-file
|
|---|
| 11 | .I exec-file
|
|---|
| 12 | .RI [ core\-file ]
|
|---|
| 13 | .RI [ @command\-file ]
|
|---|
| 14 | .SH DESCRIPTION
|
|---|
| 15 | .de SP
|
|---|
| 16 | .if t .sp 0.4
|
|---|
| 17 | .if n .sp
|
|---|
| 18 | ..
|
|---|
| 19 | .B mdb
|
|---|
| 20 | is the MINIX 3 debugger.
|
|---|
| 21 | .SH OPTIONS
|
|---|
| 22 | Its command line options are:
|
|---|
| 23 | .TP
|
|---|
| 24 | .B \-f
|
|---|
| 25 | Just examine the specified file.
|
|---|
| 26 | .TP
|
|---|
| 27 | .B \-c
|
|---|
| 28 | Examine 'core' file. No exec-file will be supplied.
|
|---|
| 29 | .TP
|
|---|
| 30 | .B \-Llog\-file
|
|---|
| 31 | Log to file only
|
|---|
| 32 | .TP
|
|---|
| 33 | .B \-llog\-file
|
|---|
| 34 | Log to file.
|
|---|
| 35 | .SP
|
|---|
| 36 | .IR exec\-file
|
|---|
| 37 | Unless the -c option has been specified, the exec-file is required.
|
|---|
| 38 | .SP
|
|---|
| 39 | .IR core\-file
|
|---|
| 40 | The core-file is optional.
|
|---|
| 41 | .SP
|
|---|
| 42 | If the core-file is supplied,
|
|---|
| 43 | .B mdb
|
|---|
| 44 | assumes that the user wishes to examine the core file.
|
|---|
| 45 | Otherwise
|
|---|
| 46 | .B mdb
|
|---|
| 47 | assumes that the user will run the exec-file and trace it.
|
|---|
| 48 | .SP
|
|---|
| 49 | .IR @command\-file
|
|---|
| 50 | .B mdb
|
|---|
| 51 | executes command from command-file.
|
|---|
| 52 | .SH OVERVIEW
|
|---|
| 53 | .br
|
|---|
| 54 | .B mdb
|
|---|
| 55 | commands are of the form:
|
|---|
| 56 | .I [ expression ]
|
|---|
| 57 | .I command
|
|---|
| 58 | .SP
|
|---|
| 59 | .I expression
|
|---|
| 60 | can be of the form:
|
|---|
| 61 | .IP
|
|---|
| 62 | .I address
|
|---|
| 63 | which defaults to text segment
|
|---|
| 64 | .IP
|
|---|
| 65 | address
|
|---|
| 66 | .I overriden
|
|---|
| 67 | by
|
|---|
| 68 | .I T:
|
|---|
| 69 | for Text segment
|
|---|
| 70 | or
|
|---|
| 71 | .I D:
|
|---|
| 72 | for Data segment
|
|---|
| 73 | or
|
|---|
| 74 | .I S:
|
|---|
| 75 | for Stack segment
|
|---|
| 76 | .IP
|
|---|
| 77 | .I symbol
|
|---|
| 78 | where
|
|---|
| 79 | .B mdb
|
|---|
| 80 | does a lookup for the symbol first as a
|
|---|
| 81 | .I text
|
|---|
| 82 | symbol and then as a
|
|---|
| 83 | .I data
|
|---|
| 84 | symbol.
|
|---|
| 85 | .SP
|
|---|
| 86 | .TP
|
|---|
| 87 | .I command
|
|---|
| 88 | .SP
|
|---|
| 89 | The help command is ?.
|
|---|
| 90 | .SP
|
|---|
| 91 | For detailed help on a command type:
|
|---|
| 92 | .I command ?.
|
|---|
| 93 | .SP
|
|---|
| 94 | A semi-colon can be used to separate commands on a line.
|
|---|
| 95 | .SP
|
|---|
| 96 | .SH MDB COMMANDS
|
|---|
| 97 | .SP
|
|---|
| 98 | ! Shell escape
|
|---|
| 99 | .SP
|
|---|
| 100 | # Set Variable or register
|
|---|
| 101 | .SP
|
|---|
| 102 | Tt Current call / Backtrace all
|
|---|
| 103 | .SP
|
|---|
| 104 | /nsf Display for n size s with format f
|
|---|
| 105 | .SP
|
|---|
| 106 | Xx [n] Disasm / & display reg for n instructions
|
|---|
| 107 | .SP
|
|---|
| 108 | Rr a Run / with arguments a
|
|---|
| 109 | .SP
|
|---|
| 110 | Cc [n] Continue with current signal / no signal n times
|
|---|
| 111 | .SP
|
|---|
| 112 | Ii [n] Single step with / no signal for n instructions
|
|---|
| 113 | .SP
|
|---|
| 114 | Mm t n Trace until / Stop when modified t type for n instructions
|
|---|
| 115 | .SP
|
|---|
| 116 | k Kill
|
|---|
| 117 | .SP
|
|---|
| 118 | Bb Display / Set Break-pt
|
|---|
| 119 | .SP
|
|---|
| 120 | Dd Delete all / one break-points
|
|---|
| 121 | .SP
|
|---|
| 122 | P Toggle Pagging
|
|---|
| 123 | .SP
|
|---|
| 124 | Ll name Log to file name / and to standard output
|
|---|
| 125 | .SP
|
|---|
| 126 | Vv Toggle debug flag / Version info
|
|---|
| 127 | .SP
|
|---|
| 128 | V Version info
|
|---|
| 129 | .SP
|
|---|
| 130 | e [t] List symbols for type t
|
|---|
| 131 | .SP
|
|---|
| 132 | y Print segment mappings
|
|---|
| 133 | .SP
|
|---|
| 134 | s [n] Dump stack for n words
|
|---|
| 135 | .SP
|
|---|
| 136 | z [a] Trace syscalls with address a
|
|---|
| 137 | .SP
|
|---|
| 138 | ? Help - short help
|
|---|
| 139 | .SP
|
|---|
| 140 | @ file Execute commands from file
|
|---|
| 141 | .SP
|
|---|
| 142 | Qq Quit / and kill traced process
|
|---|
| 143 | .SP
|
|---|
| 144 | .SH "SEE ALSO"
|
|---|
| 145 | .SP
|
|---|
| 146 | trace(2).
|
|---|
| 147 | .SH DIAGNOSTICS
|
|---|
| 148 |
|
|---|
| 149 | .SH NOTES
|
|---|
| 150 |
|
|---|
| 151 | .SH BUGS
|
|---|
| 152 |
|
|---|
| 153 | .SH AUTHOR
|
|---|
| 154 | Philip Murton and others
|
|---|
