summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorbde <bde@FreeBSD.org>2006-10-10 11:07:37 +0000
committerbde <bde@FreeBSD.org>2006-10-10 11:07:37 +0000
commitf2196eb28d05443eb647ff47556d3efbcb071ccf (patch)
tree4a853c43e8ee971a7ddd31e102bf2624a1edd9f6
parent42563bac38b301c75cc89305667e577c9816fd57 (diff)
downloadFreeBSD-src-f2196eb28d05443eb647ff47556d3efbcb071ccf.zip
FreeBSD-src-f2196eb28d05443eb647ff47556d3efbcb071ccf.tar.gz
Sort some of the most inconsistently ordered descriptions of commands
(the group of watchpoint commands, and the `reset' command). NetBSD has sorted everything alphabetically, but I think we would have too many commands for that if all commands were actually documented here, so this commit moves towards alphabetical order in several sections: - section for pure ddb (non-"show") commands. Now contains the watchpoint commands and is mostly in "logical" order. - section for pure ddb "show" commands - similarly for auxilary commands. Most of these are currently missing here.
-rw-r--r--share/man/man4/ddb.472
1 files changed, 36 insertions, 36 deletions
diff --git a/share/man/man4/ddb.4 b/share/man/man4/ddb.4
index 08cb5b3..b4bfc3e 100644
--- a/share/man/man4/ddb.4
+++ b/share/man/man4/ddb.4
@@ -361,6 +361,39 @@ specified in the original
.Ic break
command.
.Pp
+.It Ic watch Ar addr Ns Li , Ns Ar size
+Set a watchpoint for a region.
+Execution stops when an attempt to modify the region occurs.
+The
+.Ar size
+argument defaults to 4.
+If you specify a wrong space address, the request is rejected
+with an error message.
+.Pp
+.Sy Warning :
+Attempts to watch wired kernel memory
+may cause unrecoverable error in some systems such as i386.
+Watchpoints on user addresses work best.
+.Pp
+.It Ic hwatch Ar addr Ns Li , Ns Ar size
+Set a hardware watchpoint for a region if supported by the
+architecture.
+Execution stops when an attempt to modify the region occurs.
+The
+.Ar size
+argument defaults to 4.
+.Pp
+.Sy Warning :
+The hardware debug facilities do not have a concept of separate
+address spaces like the watch command does.
+Use
+.Ic hwatch
+for setting watchpoints on kernel address locations only, and avoid
+its use on user mode address spaces.
+.Pp
+.It Ic dhwatch Ar addr Ns Li , Ns Ar size
+Delete specified hardware watchpoint.
+.Pp
.It Ic step Ns Op Li / Ns Cm p
.It Ic s Ns Op Li / Ns Cm p
Single step
@@ -527,42 +560,6 @@ Displays details about the given vnode.
.It Ic show Cm watches
Displays all watchpoints.
.Pp
-.It Ic reset
-Hard reset the system.
-.Pp
-.It Ic watch Ar addr Ns Li , Ns Ar size
-Set a watchpoint for a region.
-Execution stops when an attempt to modify the region occurs.
-The
-.Ar size
-argument defaults to 4.
-If you specify a wrong space address, the request is rejected
-with an error message.
-.Pp
-.Sy Warning :
-Attempts to watch wired kernel memory
-may cause unrecoverable error in some systems such as i386.
-Watchpoints on user addresses work best.
-.Pp
-.It Ic hwatch Ar addr Ns Li , Ns Ar size
-Set a hardware watchpoint for a region if supported by the
-architecture.
-Execution stops when an attempt to modify the region occurs.
-The
-.Ar size
-argument defaults to 4.
-.Pp
-.Sy Warning :
-The hardware debug facilities do not have a concept of separate
-address spaces like the watch command does.
-Use
-.Ic hwatch
-for setting watchpoints on kernel address locations only, and avoid
-its use on user mode address spaces.
-.Pp
-.It Ic dhwatch Ar addr Ns Li , Ns Ar size
-Delete specified hardware watchpoint.
-.Pp
.It Ic gdb
Toggles between remote GDB and DDB mode.
In remote GDB mode, another machine is required that runs
@@ -573,6 +570,9 @@ Currently only available on the
i386
architecture.
.Pp
+.It Ic reset
+Hard reset the system.
+.Pp
.It Ic help
Print a short summary of the available commands and command
abbreviations.
OpenPOWER on IntegriCloud