[src/trunk]: src/share/man document ddb.panicstackframes

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

details:   https://anonhg.NetBSD.org/src/rev/fbfac8c81aad
branches:  trunk
changeset: 828720:fbfac8c81aad
user:      christos <christos%NetBSD.org@localhost>
date:      Thu Dec 28 17:51:49 2017 +0000

description:
document ddb.panicstackframes

diffstat:

 share/man/man4/ddb.4     |  11 +++++++++--
 share/man/man4/options.4 |  11 +++++++++--
 share/man/man7/sysctl.7  |  15 ++++++++++-----
 3 files changed, 28 insertions(+), 9 deletions(-)

diffs (107 lines):

diff -r 27b43a5d9752 -r fbfac8c81aad share/man/man4/ddb.4
--- a/share/man/man4/ddb.4      Thu Dec 28 17:51:19 2017 +0000
+++ b/share/man/man4/ddb.4      Thu Dec 28 17:51:49 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ddb.4,v 1.167 2017/07/03 21:30:58 wiz Exp $
+.\"    $NetBSD: ddb.4,v 1.168 2017/12/28 17:51:49 christos Exp $
 .\"
 .\" Copyright (c) 1997 - 2009 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 January 12, 2017
+.Dd December 28, 2017
 .Dt DDB 4
 .Os
 .Sh NAME
@@ -1292,6 +1292,13 @@
 selected commands as discussed above to log the output.
 Mixing both /l
 and this setting can give double loggings.
+.It Va panicstackframes
+Number of stack frames to display on panic.
+Useful to avoid scrolling way the interesting frames on a glass tty.
+Default value is
+.Dv 65535
+(all frames), useful value around
+.Dv 10 .
 .\" .It Va work Ns Sy xx
 .\" Temporary work variable.
 .\" .Sq Sy xx
diff -r 27b43a5d9752 -r fbfac8c81aad share/man/man4/options.4
--- a/share/man/man4/options.4  Thu Dec 28 17:51:19 2017 +0000
+++ b/share/man/man4/options.4  Thu Dec 28 17:51:49 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: options.4,v 1.475 2017/09/14 08:52:41 wiz Exp $
+.\"    $NetBSD: options.4,v 1.476 2017/12/28 17:51:49 christos Exp $
 .\"
 .\" Copyright (c) 1996
 .\"    Perry E. Metzger.  All rights reserved.
@@ -30,7 +30,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd September 13, 2017
+.Dd December 28, 2017
 .Dt OPTIONS 4
 .Os
 .Sh NAME
@@ -586,6 +586,13 @@
 This option adds more verbose descriptions to the
 .Em help
 command.
+.It Cd options DDB_PANICSTACKFRAMES=integer
+Number of stack frames to display on panic.
+Useful to avoid scrolling way the interesting frames on a glass tty.
+Default value is
+.Dv 65535
+(all frames), useful value around
+.Dv 10 .
 .It Cd options KGDB
 Compiles in a remote kernel debugger stub for diagnosing kernel problems
 using the
diff -r 27b43a5d9752 -r fbfac8c81aad share/man/man7/sysctl.7
--- a/share/man/man7/sysctl.7   Thu Dec 28 17:51:19 2017 +0000
+++ b/share/man/man7/sysctl.7   Thu Dec 28 17:51:49 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysctl.7,v 1.117 2017/07/30 16:07:06 maxv Exp $
+.\"    $NetBSD: sysctl.7,v 1.118 2017/12/28 17:51:49 christos Exp $
 .\"
 .\" Copyright (c) 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"    @(#)sysctl.3    8.4 (Berkeley) 5/9/95
 .\"
-.Dd July 30, 2017
+.Dd December 28, 2017
 .Dt SYSCTL 7
 .Os
 .Sh NAME
@@ -2465,6 +2465,7 @@
 .It ddb.fromconsole    integer yes
 .It ddb.tee_msgbuf     integer yes
 .It ddb.commandonenter string  yes
+.It ddb.panicstackframes       integer yes
 .El
 .Bl -tag -width "123456"
 .It Li ddb.radix ( Dv DDBCTL_RADIX )
@@ -2492,9 +2493,13 @@
 .It Li ddb.commandonenter
 If not empty, a command to be executed on each enter to the
 .Tn DDB .
-.\"
-.\" XXX: (a) ddb.commandonenter is missing in ddb(4);
-.\"     (b) No DDBCTL definitions for tee_msgbuf and commandonenter.
+.It Li ddb.panicstackframes
+Number of stack frames to display on panic.
+Useful to avoid scrolling way the interesting frames on a glass tty.
+Default value is
+.Dv 65535
+(all frames), useful value around
+.Dv 10 .
 .El
 .Pp
 Some of these