[src/trunk]: src/share/man/man4 Document the MIPs "mips machine {cpu,nmi,watc...

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

details:   https://anonhg.NetBSD.org/src/rev/742defa8b45e
branches:  trunk
changeset: 942973:742defa8b45e
user:      simonb <simonb%NetBSD.org@localhost>
date:      Sun Aug 23 03:23:53 2020 +0000

description:
Document the MIPs "mips machine {cpu,nmi,watch,unwatch}" commands.
Add commented out stubs for the mfcr and mtcr commands.

diffstat:

 share/man/man4/ddb.4 |  46 ++++++++++++++++++++++++++++++++++++++--------
 1 files changed, 38 insertions(+), 8 deletions(-)

diffs (81 lines):

diff -r 76edb6c29405 -r 742defa8b45e share/man/man4/ddb.4
--- a/share/man/man4/ddb.4      Sun Aug 23 03:21:57 2020 +0000
+++ b/share/man/man4/ddb.4      Sun Aug 23 03:23:53 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ddb.4,v 1.193 2020/08/23 03:17:00 simonb Exp $
+.\"    $NetBSD: ddb.4,v 1.194 2020/08/23 03:23:53 simonb Exp $
 .\"
 .\" Copyright (c) 1997 - 2019 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -56,7 +56,7 @@
 .\" any improvements or extensions that they make and grant Carnegie Mellon
 .\" the rights to redistribute these changes.
 .\"
-.Dd July 13, 2020
+.Dd August 23, 2020
 .Dt DDB 4
 .Os
 .Sh NAME
@@ -208,7 +208,7 @@
 or by setting
 .Ar ddb.commandonenter
 with
-.Xr sysctl 8 .
+2Xr sysctl 8 .
 Multiple commands can be separated by a semi-colon.
 .Sh COMMAND SYNTAX
 The general command syntax is:
@@ -1091,18 +1091,48 @@
 .Bl -tag -width "traptrace" -compact
 .It Ic cp0
 Dump CP0 (coprocessor 0) register values.
+.It Ic cpu
+Switch to another CPU.
 .It Ic kvtop
 Print the physical address for a given kernel virtual address.
+.\" .It Ic mfcr -- document this!
+.\" .It Ic mtcr -- document this!
+.It Ic nmi
+Send an NMI to a different CPU.
+This DDB command is currently only implemented for Cavium
+Octeon CPUs.
 .It Ic reset
 Reset the system.
 Not implemented for many CPUs and/or systems.
 .It Ic tlb
 Print out the Translation Lookaside Buffer (TLB).
-Only works in
-.Nx
-kernels compiled with
-.Dv DEBUG
-option.
+Use the
+.Cm /v
+modifier to show only valid TLB entries.
+.It Ic watch
+Set a hardware watchpoint on an address or a TLB ASID.
+Pass the address to be watched.
+If no address is specified, show a list of active watchpoints.
+The modifiers are
+.Cm /m
+i for trap on an instruction fetch,
+.Cm /r
+for trap on a read,
+.Cm /w
+for trap on a write,
+.Cm /m
+for a mask on the address to match,
+.Cm /a
+for trap on a TLB ASID match.
+The
+.Cm /m
+and
+.Cm /a
+modifiers require an extra argument for the mask and ASID respectively.
+.It Ic unwatch
+Clear a hardware watchpoint.
+If an address is specified, clear watchpoints that match that address.
+If no address is specified, clear all watchpoints.
 .El
 .Ss POWERPC 4xx
 .Bl -tag -width "traptrace" -compact