path: root/sys-utils/dmesg.1

.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
.\" May be distributed under the GNU General Public License
.TH DMESG 1 "Jun 2011"
.SH NAME
dmesg \- print or control the kernel ring buffer
.SH SYNOPSIS
.B dmesg
.RB [ options ]
.sp
.B dmesg \-\-clear
.sp
.B dmesg \-\-read-clear
.RB [ options ]
.sp
.B dmesg \-\-console-level
.I level
.SH DESCRIPTION
.B dmesg
is used to examine or control the kernel ring buffer.

The default action is to read all messages from kernel ring buffer.

.SH OPTIONS
The --clear, --read-clear and --console-level options are mutually exclusive.

.IP "\fB\-C, \-\-clear\fP"
Clear the ring buffer.
.IP "\fB\-c, \-\-read-clear\fP"
Clear the ring buffer contents after printing.
.IP "\fB\-h, \-\-help\fP"
Print a help text and exit.
.IP "\fB\-n, \-\-console-level \fIlevel\fP
Set the
.I level
at which logging of messages is done to the console.  For example,
.B \-n 1
prevents all messages, except panic messages, from appearing on the
console.  All levels of messages are still written to
.IR /proc/kmsg ,
so
.BR syslogd (8)
can still be used to control exactly where kernel messages appear.  When
the
.B \-n
option is used,
.B dmesg
will
.I not
print or clear the kernel ring buffer.
.IP "\fB\-r, \-\-raw\fP"
Print the raw message buffer, i.e., don't strip the log level prefixes.
.IP "\fB\-s, \-\-buffer-size \fIsize\fP
Use a buffer of
.I size
to query the kernel ring buffer.  This is 16392 by default.
(The default kernel syslog buffer size was 4096
at first, 8192 since 1.3.54, 16384 since 2.1.113.)
If you have set the kernel buffer to be larger than the default
then this option can be used to view the entire buffer.
.IP "\fB\-V, \-\-version\fP"
Output version information and exit.
.SH SEE ALSO
.BR syslogd (8)
.\" .SH AUTHOR
.\" Theodore Ts'o (tytso@athena.mit.edu)
.SH AVAILABILITY
The dmesg command is part of the util-linux package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.