Module Name: src Committed By: mrg Date: Wed Jun 9 02:48:52 UTC 2010
Modified Files: src/share/man/man4: ddb.4 src/sys/arch/acorn26/acorn26: db_interface.c src/sys/arch/i386/i386: db_interface.c src/sys/arch/ia64/ia64: db_interface.c src/sys/arch/vax/vax: db_machdep.c Log Message: document the acorn26, i386, ia64 and vax ddb commands in both the builtin help and in ddb.4. fixes PR#38304, PR#38305, PR#38309 and PR#38313. To generate a diff of this commit: cvs rdiff -u -r1.139 -r1.140 src/share/man/man4/ddb.4 cvs rdiff -u -r1.17 -r1.18 src/sys/arch/acorn26/acorn26/db_interface.c cvs rdiff -u -r1.64 -r1.65 src/sys/arch/i386/i386/db_interface.c cvs rdiff -u -r1.6 -r1.7 src/sys/arch/ia64/ia64/db_interface.c cvs rdiff -u -r1.54 -r1.55 src/sys/arch/vax/vax/db_machdep.c Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/share/man/man4/ddb.4 diff -u src/share/man/man4/ddb.4:1.139 src/share/man/man4/ddb.4:1.140 --- src/share/man/man4/ddb.4:1.139 Tue Jun 8 06:14:57 2010 +++ src/share/man/man4/ddb.4 Wed Jun 9 02:48:52 2010 @@ -1,4 +1,4 @@ -.\" $NetBSD: ddb.4,v 1.139 2010/06/08 06:14:57 mrg Exp $ +.\" $NetBSD: ddb.4,v 1.140 2010/06/09 02:48:52 mrg Exp $ .\" .\" Copyright (c) 1997 - 2009 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -919,6 +919,23 @@ set (e.g. .Ic machine reboot ) . Some of these commands are: +.Ss ACORN26 +.Bl -tag -width "traptrace" -compact +.It Ic bsw +Writes a one or two bytes to the IObus. +Takes an address and a value. +Use the +.Dq b +modifier to write a single byte and the +.Dq h +modifier to write two bytes. +.It Ic frame +Given a trap frame address, print out the trap frame. +.It Ic irqstat +Display the IRQ statistics +.It Ic panic +Print the current "panic" string. +.El .Ss ALPHA .Bl -tag -width "traptrace" -compact .It Ic cpu @@ -928,12 +945,17 @@ .\" .It Ic reboot .\" Call the PROM monitor to reboot the CPU. .El +.Ss AMD64 +.Bl -tag -width "traptrace" -compact +.It Ic cpu +Switch to another cpu. +.El .Ss ARM32 .Bl -tag -width "traptrace" -compact -.It Ic panic -Print the current "panic" string. .It Ic frame Given a trap frame address, print out the trap frame. +.It Ic panic +Print the current "panic" string. .El .Ss HP700 .Bl -tag -width "traptrace" -compact @@ -943,6 +965,17 @@ .Dq l modifier is used, an LWP address. .El +.Ss I386 +.Bl -tag -width "traptrace" -compact +.It Ic cpu +Switch to another cpu. +.El +.Ss IA64 +.Bl -tag -width "traptrace" -compact +.It Ic vector +Without a vector, information about all 256 vectors is shown. +Otherwise, the given vector is shown. +.El .Ss MIPS .Bl -tag -width "traptrace" -compact .It Ic cp0 @@ -1124,6 +1157,11 @@ Given an address, print the address, segment map, page map, and Page Table Entry (PTE). .El +.Ss VAX +.Bl -tag -width "traptrace" -compact +.It Ic cpu +Switch to another cpu. +.El .Sh VARIABLES .Nm accesses registers and variables as Index: src/sys/arch/acorn26/acorn26/db_interface.c diff -u src/sys/arch/acorn26/acorn26/db_interface.c:1.17 src/sys/arch/acorn26/acorn26/db_interface.c:1.18 --- src/sys/arch/acorn26/acorn26/db_interface.c:1.17 Wed Mar 18 10:22:21 2009 +++ src/sys/arch/acorn26/acorn26/db_interface.c Wed Jun 9 02:48:52 2010 @@ -1,4 +1,4 @@ -/* $NetBSD: db_interface.c,v 1.17 2009/03/18 10:22:21 cegger Exp $ */ +/* $NetBSD: db_interface.c,v 1.18 2010/06/09 02:48:52 mrg Exp $ */ /* * Copyright (c) 1996 Scott K. Stevens @@ -35,7 +35,7 @@ */ #include <sys/cdefs.h> -__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.17 2009/03/18 10:22:21 cegger Exp $"); +__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.18 2010/06/09 02:48:52 mrg Exp $"); #include "opt_ddb.h" @@ -241,10 +241,22 @@ } const struct db_command db_machine_command_table[] = { - { DDB_ADD_CMD("bsw", db_bus_write_cmd, CS_MORE, NULL,NULL,NULL) }, - { DDB_ADD_CMD("frame", db_show_frame_cmd, 0, NULL, NULL,NULL) }, - { DDB_ADD_CMD("irqstat",db_irqstat_cmd, 0, NULL, NULL,NULL) }, - { DDB_ADD_CMD("panic", db_show_panic_cmd, 0, NULL, NULL,NULL) }, + { DDB_ADD_CMD("bsw", db_bus_write_cmd, CS_MORE, + "Writes a one or two bytes to the IObus", + "[/bh] [addr]", + " addr:\tIO address to write\n" + " /b:\twrite a single byte\n" + " /h:\twrite two bytes") }, + { DDB_ADD_CMD("frame", db_show_frame_cmd, 0, + "Displays the contents of a trapframe", + "[address]", + " address:\taddress of trapfame to display")}, + { DDB_ADD_CMD("irqstat", db_irqstat_cmd, 0, + "Displays the IRQ statistics", + NULL,NULL) }, + { DDB_ADD_CMD("panic", db_show_panic_cmd, 0, + "Displays the last panic string", + NULL,NULL) }, { DDB_ADD_CMD( NULL, NULL, 0, NULL, NULL,NULL) } }; Index: src/sys/arch/i386/i386/db_interface.c diff -u src/sys/arch/i386/i386/db_interface.c:1.64 src/sys/arch/i386/i386/db_interface.c:1.65 --- src/sys/arch/i386/i386/db_interface.c:1.64 Sun Mar 15 15:40:34 2009 +++ src/sys/arch/i386/i386/db_interface.c Wed Jun 9 02:48:52 2010 @@ -1,4 +1,4 @@ -/* $NetBSD: db_interface.c,v 1.64 2009/03/15 15:40:34 cegger Exp $ */ +/* $NetBSD: db_interface.c,v 1.65 2010/06/09 02:48:52 mrg Exp $ */ /* * Mach Operating System @@ -33,7 +33,7 @@ */ #include <sys/cdefs.h> -__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.64 2009/03/15 15:40:34 cegger Exp $"); +__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.65 2010/06/09 02:48:52 mrg Exp $"); #include "opt_ddb.h" #include "opt_multiprocessor.h" @@ -74,7 +74,8 @@ const struct db_command db_machine_command_table[] = { #ifdef MULTIPROCESSOR - { DDB_ADD_CMD("cpu", db_mach_cpu, 0, NULL,NULL,NULL) }, + { DDB_ADD_CMD("cpu", db_mach_cpu, 0, + "switch to another cpu", "cpu-no", NULL) }, #endif { DDB_ADD_CMD(NULL, NULL, 0, NULL,NULL,NULL) }, Index: src/sys/arch/ia64/ia64/db_interface.c diff -u src/sys/arch/ia64/ia64/db_interface.c:1.6 src/sys/arch/ia64/ia64/db_interface.c:1.7 --- src/sys/arch/ia64/ia64/db_interface.c:1.6 Mon Jul 20 04:41:37 2009 +++ src/sys/arch/ia64/ia64/db_interface.c Wed Jun 9 02:48:52 2010 @@ -1,4 +1,4 @@ -/* $NetBSD: db_interface.c,v 1.6 2009/07/20 04:41:37 kiyohara Exp $ */ +/* $NetBSD: db_interface.c,v 1.7 2010/06/09 02:48:52 mrg Exp $ */ /*- * Copyright (c) 2003-2005 Marcel Moolenaar @@ -80,7 +80,7 @@ #include <sys/cdefs.h> /* RCS ID & Copyright macro defns */ -__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.6 2009/07/20 04:41:37 kiyohara Exp $"); +__KERNEL_RCSID(0, "$NetBSD: db_interface.c,v 1.7 2010/06/09 02:48:52 mrg Exp $"); #include <sys/param.h> #include <sys/proc.h> @@ -112,11 +112,13 @@ static void db_show_vector(db_expr_t, bool, db_expr_t, const char *); - const struct db_command db_machine_command_table[] = { - { DDB_ADD_CMD("vector", db_show_vector, 0, NULL,NULL,NULL) }, + { DDB_ADD_CMD("vector", db_show_vector, 0, + "Display information about vectors", + "[vector]", + " vector:\tthe vector to show (all vectors otherwise)") }, - { DDB_ADD_CMD(NULL, NULL, 0, NULL,NULL,NULL) }, + { DDB_ADD_CMD(NULL, NULL, 0, NULL,NULL,NULL) }, }; static int Index: src/sys/arch/vax/vax/db_machdep.c diff -u src/sys/arch/vax/vax/db_machdep.c:1.54 src/sys/arch/vax/vax/db_machdep.c:1.55 --- src/sys/arch/vax/vax/db_machdep.c:1.54 Thu Nov 26 00:19:23 2009 +++ src/sys/arch/vax/vax/db_machdep.c Wed Jun 9 02:48:52 2010 @@ -1,4 +1,4 @@ -/* $NetBSD: db_machdep.c,v 1.54 2009/11/26 00:19:23 matt Exp $ */ +/* $NetBSD: db_machdep.c,v 1.55 2010/06/09 02:48:52 mrg Exp $ */ /* * :set tabs=4 @@ -39,7 +39,7 @@ */ #include <sys/cdefs.h> -__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.54 2009/11/26 00:19:23 matt Exp $"); +__KERNEL_RCSID(0, "$NetBSD: db_machdep.c,v 1.55 2010/06/09 02:48:52 mrg Exp $"); #include "opt_ddb.h" #include "opt_multiprocessor.h" @@ -632,7 +632,8 @@ const struct db_command db_machine_command_table[] = { #ifdef MULTIPROCESSOR - { DDB_ADD_CMD("cpu", db_mach_cpu, 0, NULL,NULL,NULL) }, + { DDB_ADD_CMD("cpu", db_mach_cpu, 0, + "switch to another cpu", "cpu-no", NULL) }, #endif { DDB_ADD_CMD(NULL,NULL,0,NULL,NULL,NULL) }, };