[src/trunk]: src document powerpc ddb commands. PR#38307.

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

details:   https://anonhg.NetBSD.org/src/rev/23c22f8302a1
branches:  trunk
changeset: 751048:23c22f8302a1
user:      mrg <mrg%NetBSD.org@localhost>
date:      Sat Jan 23 01:32:06 2010 +0000

description:
document powerpc ddb commands.  PR#38307.

diffstat:

 share/man/man4/ddb.4                    |  27 +++++++++++++++++++++--
 sys/arch/powerpc/powerpc/db_interface.c |  37 ++++++++++++++++++++++++--------
 2 files changed, 51 insertions(+), 13 deletions(-)

diffs (101 lines):

diff -r d91a373b1bac -r 23c22f8302a1 share/man/man4/ddb.4
--- a/share/man/man4/ddb.4      Sat Jan 23 01:17:23 2010 +0000
+++ b/share/man/man4/ddb.4      Sat Jan 23 01:32:06 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ddb.4,v 1.129 2010/01/10 09:08:23 wiz Exp $
+.\"    $NetBSD: ddb.4,v 1.130 2010/01/23 01:32:06 mrg Exp $
 .\"
 .\" Copyright (c) 1997 - 2009 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -938,12 +938,33 @@
 .Dv DEBUG
 option.
 .El
+.Ss POWERPC
+.Bl -tag -width "traptrace" -compact
+.It Ic ctx
+Print process MMU context information.
+.It Ic pv
+Print PA->VA mapping information.
+.It Ic reset
+Reset the system.
+.It Ic tf
+Display the contents of the trapframe.
+.It Ic tlb
+Display instruction translation storage buffer information.
+.It Ic dcr
+Set the DCR register.
+Must be between 0x00 and 0x3ff.
+.It Ic user
+Display user memory.
+Use the
+.Dq i
+modifier to get instruction decoding.
+.El
 .Ss SH3
 .Bl -tag -width "traptrace" -compact
 .It Ic tlb
-Print TLB entries
+Print TLB entries.
 .It Ic cache
-Print cache entries
+Print cache entries.
 .It Ic frame
 Print switch frame and trap frames.
 .It Ic stack
diff -r d91a373b1bac -r 23c22f8302a1 sys/arch/powerpc/powerpc/db_interface.c
--- a/sys/arch/powerpc/powerpc/db_interface.c   Sat Jan 23 01:17:23 2010 +0000
+++ b/sys/arch/powerpc/powerpc/db_interface.c   Sat Jan 23 01:32:06 2010 +0000
@@ -1,8 +1,8 @@
-/*     $NetBSD: db_interface.c,v 1.39 2007/10/17 19:56:47 garbled Exp $ */
+/*     $NetBSD: db_interface.c,v 1.40 2010/01/23 01:32:06 mrg Exp $ */
 /*     $OpenBSD: db_interface.c,v 1.2 1996/12/28 06:21:50 rahnds Exp $ */
 
 #include <sys/cdefs.h>
-__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.39 2007/10/17 19:56:47 garbled Exp $");
+__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.40 2010/01/23 01:32:06 mrg Exp $");
 
 #define USERACC
 
@@ -194,16 +194,33 @@
 
 #ifdef DDB
 const struct db_command db_machine_command_table[] = {
-       { DDB_ADD_CMD("ctx",    db_ppc4xx_ctx,          0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("pv",             db_ppc4xx_pv,           0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("reset",  db_ppc4xx_reset,        0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("tf",             db_ppc4xx_tf,           0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("tlb",    db_ppc4xx_dumptlb,      0,      NULL,NULL,NULL) },
-       { DDB_ADD_CMD("dcr",    db_ppc4xx_dcr,          CS_MORE|CS_SET_DOT,     NULL,NULL,NULL) },
+       { DDB_ADD_CMD("ctx",    db_ppc4xx_ctx,          0,
+         "Print process MMU context information", NULL,NULL) },
+       { DDB_ADD_CMD("pv",     db_ppc4xx_pv,           0,
+         "Print PA->VA mapping information",
+         "address",
+         "   address:\tphysical address to look up") },
+       { DDB_ADD_CMD("reset",  db_ppc4xx_reset,        0,
+         "Reset the system ", NULL,NULL) },
+       { DDB_ADD_CMD("tf",     db_ppc4xx_tf,           0,
+         "Display the contents of the trapframe",
+         "address",
+         "   address:\tthe struct trapframe to print") },
+       { DDB_ADD_CMD("tlb",    db_ppc4xx_dumptlb,      0,
+         "Display instruction translation storage buffer information.",
+         NULL,NULL) },
+       { DDB_ADD_CMD("dcr",    db_ppc4xx_dcr,          CS_MORE|CS_SET_DOT,
+         "Set the DCR register",
+         "dcr",
+         "   dcr:\tNew DCR value (between 0x0 and 0x3ff)") },
 #ifdef USERACC
-       { DDB_ADD_CMD("user",   db_ppc4xx_useracc,      0,      NULL,NULL,NULL) },
+       { DDB_ADD_CMD("user",   db_ppc4xx_useracc,      0,
+          "Display user memory.", "[address][,count]",
+          "   address:\tuserspace address to start\n"
+          "   count:\tnumber of bytes to display") },
 #endif
-       { DDB_ADD_CMD(NULL,     NULL,               0,  NULL,NULL,NULL) }
+       { DDB_ADD_CMD(NULL,     NULL,                   0, 
+         NULL,NULL,NULL) }
 };
 
 static void