ddb.4 (d0353b836e88609b9400851d32e0aa6645ff9be3) ddb.4 (c2d03ea87913b49c09051746bb4ab5b45c80c49a)
1.\"
2.\" Mach Operating System
3.\" Copyright (c) 1991,1990 Carnegie Mellon University
4.\" All Rights Reserved.
5.\"
6.\" Permission to use, copy, modify and distribute this software and its
7.\" documentation is hereby granted, provided that both the copyright
8.\" notice and this permission notice appear in all copies of the

--- 177 unchanged lines hidden (view full) ---

186except that the next address displayed by it is used as the start address.
187.It Cm xb
188Examine backward:
189Execute an examine command with the last specified parameters to it
190except that the last start address subtracted by the size displayed by it
191is used as the start address.
192.It Cm print Ns Op Cm /acdoruxz
193Print
1.\"
2.\" Mach Operating System
3.\" Copyright (c) 1991,1990 Carnegie Mellon University
4.\" All Rights Reserved.
5.\"
6.\" Permission to use, copy, modify and distribute this software and its
7.\" documentation is hereby granted, provided that both the copyright
8.\" notice and this permission notice appear in all copies of the

--- 177 unchanged lines hidden (view full) ---

186except that the next address displayed by it is used as the start address.
187.It Cm xb
188Examine backward:
189Execute an examine command with the last specified parameters to it
190except that the last start address subtracted by the size displayed by it
191is used as the start address.
192.It Cm print Ns Op Cm /acdoruxz
193Print
194.No Ar addr Ns s
194.Ar addr Ns s
195according to the modifier character (as described above for
196.Li examine ) .
197Valid formats are:
198.Li a ,
199.Li x ,
200.Li z ,
201.Li o ,
202.Li d ,

--- 10 unchanged lines hidden (view full) ---

213.Pp
214will print like:
215.Bd -literal -offset indent
216eax = xxxxxx
217ecx = yyyyyy
218.Ed
219.It Xo
220.Cm write Ns Op Cm /bhl
195according to the modifier character (as described above for
196.Li examine ) .
197Valid formats are:
198.Li a ,
199.Li x ,
200.Li z ,
201.Li o ,
202.Li d ,

--- 10 unchanged lines hidden (view full) ---

213.Pp
214will print like:
215.Bd -literal -offset indent
216eax = xxxxxx
217ecx = yyyyyy
218.Ed
219.It Xo
220.Cm write Ns Op Cm /bhl
221.No Ar addr Ar expr1 Op Ar "expr2 ..."
221.Ar addr Ar expr1 Op Ar "expr2 ..."
222.Xc
223Write the expressions specified after
224.Ar addr
225on the command line at succeeding locations starting with
226.Ar addr
227The write unit size can be specified in the modifier with a letter
228.Li b
229(byte),

--- 4 unchanged lines hidden (view full) ---

234long word is assumed.
235.Pp
236.Sy Warning :
237since there is no delimiter between expressions, strange
238things may happen.
239It's best to enclose each expression in parentheses.
240.It Xo
241.Cm set
222.Xc
223Write the expressions specified after
224.Ar addr
225on the command line at succeeding locations starting with
226.Ar addr
227The write unit size can be specified in the modifier with a letter
228.Li b
229(byte),

--- 4 unchanged lines hidden (view full) ---

234long word is assumed.
235.Pp
236.Sy Warning :
237since there is no delimiter between expressions, strange
238things may happen.
239It's best to enclose each expression in parentheses.
240.It Xo
241.Cm set
242.No Li \&$ Ns Ar variable
242.Li \&$ Ns Ar variable
243.Op Li =
244.Ar expr
245.Xc
246Set the named variable or register with the value of
247.Ar expr .
248Valid variable names are described below.
249.It Cm break Ns Op Cm /u
250Set a break point at

--- 70 unchanged lines hidden (view full) ---

321.It Cm match Ns Op Cm /p
322Stop at the matching return instruction.
323If the
324.Li p
325modifier is specified, print the call nesting depth and the
326cumulative instruction count at each call or return. Otherwise,
327only print when the matching return is hit.
328.It Xo
243.Op Li =
244.Ar expr
245.Xc
246Set the named variable or register with the value of
247.Ar expr .
248Valid variable names are described below.
249.It Cm break Ns Op Cm /u
250Set a break point at

--- 70 unchanged lines hidden (view full) ---

321.It Cm match Ns Op Cm /p
322Stop at the matching return instruction.
323If the
324.Li p
325modifier is specified, print the call nesting depth and the
326cumulative instruction count at each call or return. Otherwise,
327only print when the matching return is hit.
328.It Xo
329.No Cm trace Ns Op Cm /u
329.Cm trace Ns Op Cm /u
330.Op Ar frame
331.Op , Ns Ar count
332.Xc
333Stack trace. The
334.Li u
335option traces user space; if omitted,
336.Cm trace
337only traces
338kernel space.
339.Ar count
340is the number of frames to be traced.
341If
342.Ar count
343is omitted, all frames are printed.
344.Pp
345.Sy Warning :
346User space stack trace is valid
347only if the machine dependent code supports it.
348.It Xo
330.Op Ar frame
331.Op , Ns Ar count
332.Xc
333Stack trace. The
334.Li u
335option traces user space; if omitted,
336.Cm trace
337only traces
338kernel space.
339.Ar count
340is the number of frames to be traced.
341If
342.Ar count
343is omitted, all frames are printed.
344.Pp
345.Sy Warning :
346User space stack trace is valid
347only if the machine dependent code supports it.
348.It Xo
349.No Cm search Ns Op Cm /bhl
349.Cm search Ns Op Cm /bhl
350.Ar addr
351.Ar value
352.Op Ar mask
353.Op , Ns Ar count
354.Xc
355Search memory for
356.Ar value .
357This command might fail in interesting

--- 42 unchanged lines hidden (view full) ---

400If the
401.Li f
402option is specified the
403complete object is printed.
404.It Cm "show watches"
405Displays all watchpoints.
406.It Xo
407.Cm watch
350.Ar addr
351.Ar value
352.Op Ar mask
353.Op , Ns Ar count
354.Xc
355Search memory for
356.Ar value .
357This command might fail in interesting

--- 42 unchanged lines hidden (view full) ---

400If the
401.Li f
402option is specified the
403complete object is printed.
404.It Cm "show watches"
405Displays all watchpoints.
406.It Xo
407.Cm watch
408.No Ar addr Ns Li \&, Ns Ar size
408.Ar addr Ns Li \&, Ns Ar size
409.Xc
410Set a watchpoint for a region. Execution stops
411when an attempt to modify the region occurs.
412The
413.Ar size
414argument defaults to 4.
415If you specify a wrong space address, the request is rejected
416with an error message.

--- 11 unchanged lines hidden (view full) ---

428.Em i386
429architecture.
430.It Cm help
431Print a short summary of the available commands and command
432abbreviations.
433.El
434.Sh VARIABLES
435The debugger accesses registers and variables as
409.Xc
410Set a watchpoint for a region. Execution stops
411when an attempt to modify the region occurs.
412The
413.Ar size
414argument defaults to 4.
415If you specify a wrong space address, the request is rejected
416with an error message.

--- 11 unchanged lines hidden (view full) ---

428.Em i386
429architecture.
430.It Cm help
431Print a short summary of the available commands and command
432abbreviations.
433.El
434.Sh VARIABLES
435The debugger accesses registers and variables as
436.No Li \&$ Ns Em name .
436.Li \&$ Ns Em name .
437Register names are as in the
438.Dq Cm show registers
439command.
440Some variables are suffixed with numbers, and may have some modifier
441following a colon immediately after the variable name.
442For example, register variables can have a
443.Li u
444modifier to indicate user register (e.g.,

--- 87 unchanged lines hidden ---
437Register names are as in the
438.Dq Cm show registers
439command.
440Some variables are suffixed with numbers, and may have some modifier
441following a colon immediately after the variable name.
442For example, register variables can have a
443.Li u
444modifier to indicate user register (e.g.,

--- 87 unchanged lines hidden ---