[src/trunk]: src document sparc ddb commands. PR#38312.

[mrg <mrg%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/cc3a4b41cac7
branches:  trunk
changeset: 750669:cc3a4b41cac7
user:      mrg <mrg%NetBSD.org@localhost>
date:      Sun Jan 10 08:24:32 2010 +0000

description:
document sparc ddb commands.  PR#38312.

diffstat:

 share/man/man4/ddb.4                |  16 ++++++++++++++--
 sys/arch/sparc/sparc/db_interface.c |  25 +++++++++++++++++--------
 2 files changed, 31 insertions(+), 10 deletions(-)

diffs (79 lines):

diff -r 5db29b00357a -r cc3a4b41cac7 share/man/man4/ddb.4
--- a/share/man/man4/ddb.4      Sun Jan 10 07:37:09 2010 +0000
+++ b/share/man/man4/ddb.4      Sun Jan 10 08:24:32 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ddb.4,v 1.127 2009/06/05 09:29:15 wiz Exp $
+.\"    $NetBSD: ddb.4,v 1.128 2010/01/10 08:24:32 mrg Exp $
 .\"
 .\" Copyright (c) 1997 - 2009 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -956,8 +956,20 @@
 .El
 .Ss SPARC
 .Bl -tag -width "traptrace" -compact
+.It Ic cpu
+Switch to another cpu.
 .It Ic prom
-Exit to the Sun PROM monitor.
+Enter the Sun PROM monitor.
+.It Ic proc
+Display some information about the LWP pointed to, or curlwp.
+.It Ic pcb
+Display information about the
+.Dq struct pcb
+listed.
+.It Ic page
+Display the pointer to the
+.Dq struct vm_page
+for this physical address.
 .El
 .Ss SPARC64
 .Bl -tag -width "traptrace" -compact
diff -r 5db29b00357a -r cc3a4b41cac7 sys/arch/sparc/sparc/db_interface.c
--- a/sys/arch/sparc/sparc/db_interface.c       Sun Jan 10 07:37:09 2010 +0000
+++ b/sys/arch/sparc/sparc/db_interface.c       Sun Jan 10 08:24:32 2010 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: db_interface.c,v 1.85 2009/11/21 04:16:51 rmind Exp $ */
+/*     $NetBSD: db_interface.c,v 1.86 2010/01/10 08:24:32 mrg Exp $ */
 
 /*
  * Mach Operating System
@@ -33,7 +33,7 @@
  */
 
 #include <sys/cdefs.h>
-__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.85 2009/11/21 04:16:51 rmind Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.86 2010/01/10 08:24:32 mrg Exp $");
 
 #include "opt_ddb.h"
 #include "opt_kgdb.h"
@@ -485,14 +485,23 @@
 #endif /* MULTIPROCESSOR */
 
 const struct db_command db_machine_command_table[] = {
-       { DDB_ADD_CMD("prom",   db_prom_cmd,    0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("proc",   db_proc_cmd,    0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("pcb",    db_dump_pcb,    0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("page",   db_page_cmd,    0,      NULL,NULL,NULL) },
+       { DDB_ADD_CMD("prom",   db_prom_cmd,    0,
+         "Enter the Sun PROM monitor.",NULL,NULL) },
+       { DDB_ADD_CMD("proc",   db_proc_cmd,    0,
+         "Display some information about an LWP",
+         "[addr]","   addr:\tstruct lwp address (curlwp otherwise)") },
+       { DDB_ADD_CMD("pcb",    db_dump_pcb,    0,
+         "Display information about a struct pcb",
+         "[address]",
+         "   address:\tthe struct pcb to print (curpcb otherwise)") },
+       { DDB_ADD_CMD("page",   db_page_cmd,    0,
+         "Display the address of a struct vm_page given a physical address",
+          "pa", "   pa:\tphysical address to look up") },
 #ifdef MULTIPROCESSOR
-       { DDB_ADD_CMD("cpu",    db_cpu_cmd,     0,      NULL,NULL,NULL) },
+       { DDB_ADD_CMD("cpu",    db_cpu_cmd,     0,
+         "switch to another cpu's registers", "cpu-no", NULL) },
 #endif
-       { DDB_ADD_CMD(NULL,     NULL,           0,NULL,NULL,NULL) }
+       { DDB_ADD_CMD(NULL,     NULL,           0,      NULL,NULL,NULL) }
 };
 #endif /* DDB */