diff options
author | ru <ru@FreeBSD.org> | 2006-10-03 21:06:19 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2006-10-03 21:06:19 +0000 |
commit | b5bc2576e3e6a6afcc9a6c6696904b4810216a2c (patch) | |
tree | 21456510752a13b6ec784ad68fe60dd4ddcc9bfa /share/man/man4/ddb.4 | |
parent | dafc0585f073aee454644269566b7f332ad1efa2 (diff) | |
download | FreeBSD-src-b5bc2576e3e6a6afcc9a6c6696904b4810216a2c.zip FreeBSD-src-b5bc2576e3e6a6afcc9a6c6696904b4810216a2c.tar.gz |
Format the list of commands so that the output looks nicer,
by putting command aliases on the adjacent lines.
Prodded by: bde
Diffstat (limited to 'share/man/man4/ddb.4')
-rw-r--r-- | share/man/man4/ddb.4 | 28 |
1 files changed, 27 insertions, 1 deletions
diff --git a/share/man/man4/ddb.4 b/share/man/man4/ddb.4 index 8987d82..3e39993 100644 --- a/share/man/man4/ddb.4 +++ b/share/man/man4/ddb.4 @@ -151,7 +151,7 @@ the emacs control keys, the usual ANSI arrow keys might be used to browse through the history buffer, and move the cursor within the current line. .Sh COMMANDS -.Bl -ohang +.Bl -tag -width indent -compact .It Cm examine .It Cm x Display the addressed locations according to the formats in the modifier. @@ -212,15 +212,18 @@ No alternate format. No alternate format. .El .El +.Pp .It Cm xf Examine forward: Execute an examine command with the last specified parameters to it except that the next address displayed by it is used as the start address. +.Pp .It Cm xb Examine backward: Execute an examine command with the last specified parameters to it except that the last start address subtracted by the size displayed by it is used as the start address. +.Pp .It Cm print Ns Op Cm /acdoruxz Print .Ar addr Ns s @@ -249,6 +252,7 @@ will print like: eax = xxxxxx ecx = yyyyyy .Ed +.Pp .It Xo .Cm write Ns Op Cm /bhl .Ar addr Ar expr1 Op Ar "expr2 ..." @@ -271,6 +275,7 @@ long word is assumed. since there is no delimiter between expressions, strange things may happen. It is best to enclose each expression in parentheses. +.Pp .It Xo .Cm set .Li \&$ Ns Ar variable @@ -280,6 +285,7 @@ It is best to enclose each expression in parentheses. Set the named variable or register with the value of .Ar expr . Valid variable names are described below. +.Pp .It Cm break Ns Op Cm /u Set a break point at .Ar addr . @@ -311,6 +317,7 @@ If a user text is shadowed by a normal user space debugger, user space break points may not work correctly. Setting a break point at the low-level code paths may also cause strange behavior. +.Pp .It Cm delete Ar addr .It Cm delete Li \&# Ns Ar number Delete the break point. @@ -322,6 +329,7 @@ or by using the same specified in the original .Cm break command. +.Pp .It Cm step Ns Op Cm /p Single step .Ar count @@ -337,6 +345,7 @@ single-step through some low-level code paths or user space code. On machines with software-emulated single-stepping (e.g., pmax), stepping through code executed by interrupt handlers will probably do the wrong thing. +.Pp .It Cm continue Ns Op Cm /c Continue execution until a breakpoint or watchpoint. If the @@ -348,6 +357,7 @@ Some machines (e.g., pmax) also count loads and stores. when counting, the debugger is really silently single-stepping. This means that single-stepping on low-level code may cause strange behavior. +.Pp .It Cm until Ns Op Cm /p Stop at the next call or return instruction. If the @@ -356,6 +366,7 @@ modifier is specified, print the call nesting depth and the cumulative instruction count at each call or return. Otherwise, only print when the matching return is hit. +.Pp .It Cm next Ns Op Cm /p .It Cm match Ns Op Cm /p Stop at the matching return instruction. @@ -364,6 +375,7 @@ If the modifier is specified, print the call nesting depth and the cumulative instruction count at each call or return. Otherwise, only print when the matching return is hit. +.Pp .It Xo .Cm trace Ns Op Cm /u .Op Ar frame @@ -385,6 +397,7 @@ is omitted, all frames are printed. .Sy Warning : User space stack trace is valid only if the machine dependent code supports it. +.Pp .It Xo .Cm search Ns Op Cm /bhl .Ar addr @@ -400,6 +413,7 @@ This is because ddb does not always recover from touching bad memory. The optional .Ar count argument limits the search. +.Pp .It Cm show all procs Ns Op Cm /m .It Cm ps Ns Op Cm /m Display all process information. @@ -410,6 +424,7 @@ The .Li m modifier will alter the display to show VM map addresses for the process and not show other info. +.Pp .It Cm show registers Ns Op Cm /u Display the register set. If the @@ -422,6 +437,7 @@ The support of the .Li u modifier depends on the machine. If not supported, incorrect information will be displayed. +.Pp .It Cm show geom Op Ar addr If the .Ar addr @@ -430,6 +446,7 @@ If the .Ar addr is given, displays details about the given GEOM object (class, geom, provider or consumer). +.Pp .It Xo .Cm show map Ns Op Cm /f .Ar addr @@ -440,6 +457,7 @@ If the .Li f modifier is specified the complete map is printed. +.Pp .It Xo .Cm show object Ns Op Cm /f .Ar addr @@ -450,12 +468,16 @@ If the .Li f option is specified the complete object is printed. +.Pp .It Cm show vnode Ar addr Displays details about the given vnode. +.Pp .It Cm "show watches" Displays all watchpoints. +.Pp .It Cm reset Hard reset the system. +.Pp .It Xo .Cm watch .Ar addr Ns Li \&, Ns Ar size @@ -472,6 +494,7 @@ with an error message. Attempts to watch wired kernel memory may cause unrecoverable error in some systems such as i386. Watchpoints on user addresses work best. +.Pp .It Xo .Cm hwatch .Ar addr Ns Li \&, Ns Ar size @@ -490,11 +513,13 @@ Use .Cm hwatch for setting watchpoints on kernel address locations only, and avoid its use on user mode address spaces. +.Pp .It Xo .Cm dhwatch .Ar addr Ns Li \&, Ns Ar size .Xc Delete specified hardware watchpoint. +.Pp .It Cm gdb Toggles between remote GDB and DDB mode. In remote GDB mode, another machine is required that runs @@ -504,6 +529,7 @@ console port on the target machine. Currently only available on the .Em i386 architecture. +.Pp .It Cm help Print a short summary of the available commands and command abbreviations. |