xref: /original-bsd/sbin/dmesg/dmesg.8 (revision 4c01ad61)
Copyright (c) 1980 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)dmesg.8 6.1 (Berkeley) 04/27/85

DMESG 8 ""
C 4
NAME
dmesg - collect system diagnostic messages to form error log
SYNOPSIS
/etc/dmesg [ - ]
DESCRIPTION
Dmesg looks in a system buffer for recently printed diagnostic messages and prints them on the standard output. The messages are those printed by the system when device (hardware) errors occur and (occasionally) when system tables overflow non-fatally. If the - flag is given, then dmesg computes (incrementally) the new messages since the last time it was run and places these on the standard output. This is typically used with cron (8) to produce the error log /usr/adm/messages by running the command
/etc/dmesg - >> /usr/adm/messages

every 10 minutes.

FILES
/usr/adm/messages error log (conventional location)

/usr/adm/msgbuf scratch file for memory of - option

BUGS
The system error message buffer is of small finite size. As dmesg is run only every few minutes, not all error messages are guaranteed to be logged. This can be construed as a blessing rather than a curse.

Error diagnostics generated immediately before a system crash will never get logged.