diff options
author | bde <bde@FreeBSD.org> | 2006-10-10 11:07:37 +0000 |
---|---|---|
committer | bde <bde@FreeBSD.org> | 2006-10-10 11:07:37 +0000 |
commit | f2196eb28d05443eb647ff47556d3efbcb071ccf (patch) | |
tree | 4a853c43e8ee971a7ddd31e102bf2624a1edd9f6 /share/man/man4 | |
parent | 42563bac38b301c75cc89305667e577c9816fd57 (diff) | |
download | FreeBSD-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.
Diffstat (limited to 'share/man/man4')
-rw-r--r-- | share/man/man4/ddb.4 | 72 |
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. |