[src/netbsd-1-6]: src/sbin/dmesg Pullup rev 1.15-1.16 (requested by briggs in...

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

details:   https://anonhg.NetBSD.org/src/rev/865e403cd65a
branches:  netbsd-1-6
changeset: 531453:865e403cd65a
user:      jmc <jmc%NetBSD.org@localhost>
date:      Fri Aug 13 04:41:01 2004 +0000

description:
Pullup rev 1.15-1.16 (requested by briggs in ticket #1728)

Talk a little about the system message buffer and cross-reference
MSGBUFSIZE in options(4).

diffstat:

 sbin/dmesg/dmesg.8 |  19 +++++++++++++++++--
 1 files changed, 17 insertions(+), 2 deletions(-)

diffs (46 lines):

diff -r a1eb322c36fe -r 865e403cd65a sbin/dmesg/dmesg.8
--- a/sbin/dmesg/dmesg.8        Fri Aug 13 04:39:45 2004 +0000
+++ b/sbin/dmesg/dmesg.8        Fri Aug 13 04:41:01 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dmesg.8,v 1.13 2001/06/05 11:22:43 wiz Exp $
+.\"    $NetBSD: dmesg.8,v 1.13.2.1 2004/08/13 04:41:01 jmc Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)dmesg.8    8.1 (Berkeley) 6/5/93
 .\"
-.Dd June 5, 1993
+.Dd April 30, 2004
 .Dt DMESG 8
 .Os
 .Sh NAME
@@ -56,12 +56,27 @@
 Extract the name list from the specified system instead of the default
 ``/netbsd''.
 .El
+.Pp
+The system message buffer is a circular buffer of a fixed size.
+If the buffer has been filled, the first line of the
+.Nm
+output may not be complete.
+The size of the message buffer is configurable at compile-time on
+most systems with the
+.Dv MSGBUFSIZE
+kernel option.
+Look for
+.Dv MSGBUFSIZE
+in
+.Xr options 4
+for details.
 .Sh FILES
 .Bl -tag -width /var/run/dmesg.boot -compact
 .It Pa /var/run/dmesg.boot
 copy of dmesg at the time of last boot.
 .El
 .Sh SEE ALSO
+.Xr options 4 ,
 .Xr syslogd 8
 .Sh HISTORY
 The