manual/util-linux/original/man8/dmesg.8

   1 .\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
   2 .\" May be distributed under the GNU General Public License
   3 .TH DMESG 8
   4 .SH NAME
   5 dmesg \- print or control the kernel ring buffer
   6 .SH SYNOPSIS
   7 .BI "dmesg [ \-c ] [ \-n " level " ] [ \-s " bufsize " ]"
   8 .SH DESCRIPTION
   9 .B dmesg
  10 is used to examine or control the kernel ring buffer.
  11
  12 The program helps users to print out their bootup messages.  Instead of
  13 copying the messages by hand, the user need only:
  14 .RS
  15 dmesg > boot.messages
  16 .RE
  17 and mail the
  18 .I boot.messages
  19 file to whoever can debug their problem.
  20 .SH OPTIONS
  21 .TP
  22 .B \-c
  23 Clear the ring buffer contents after printing.
  24 .TP
  25 .BI \-s bufsize
  26 Use a buffer of size
  27 .I bufsize
  28 to query the kernel ring buffer.  This is 16392 by default.
  29 (The default kernel syslog buffer size was 4096
  30 at first, 8192 since 1.3.54, 16384 since 2.1.113.)
  31 If you have set the kernel buffer to be larger than the default
  32 then this option can be used to view the entire buffer.
  33 .TP
  34 .BI \-n level
  35 Set the
  36 .I level
  37 at which logging of messages is done to the console.  For example,
  38 .B \-n 1
  39 prevents all messages, expect panic messages, from appearing on the
  40 console.  All levels of messages are still written to
  41 .IR /proc/kmsg ,
  42 so
  43 .BR syslogd (8)
  44 can still be used to control exactly where kernel messages appear.  When
  45 the
  46 .B \-n
  47 option is used,
  48 .B dmesg
  49 will
  50 .I not
  51 print or clear the kernel ring buffer.
  52
  53 When both options are used, only the last option on the command line will
  54 have an effect.
  55 .SH SEE ALSO
  56 .BR syslogd (8)
  57 .\" .SH AUTHOR
  58 .\" Theodore Ts'o (tytso@athena.mit.edu)