commands/mdb/mdb.1

   1 .TH MDB 1
   2 .SH NAME
   3 mdb \- Minix 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 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