summaryrefslogtreecommitdiffstats
path: root/sys-utils/dmesg.1
diff options
context:
space:
mode:
authorKarel Zak2014-05-12 09:53:39 +0200
committerKarel Zak2014-05-13 12:13:02 +0200
commitf4bc7f96a6ff6239e89334e5b887227eb9f4d9c2 (patch)
treeefdff50682ca84378025d1ee17dae6ab73a2656e /sys-utils/dmesg.1
parentlib/colors: update man page (diff)
downloadkernel-qcow2-util-linux-f4bc7f96a6ff6239e89334e5b887227eb9f4d9c2.tar.gz
kernel-qcow2-util-linux-f4bc7f96a6ff6239e89334e5b887227eb9f4d9c2.tar.xz
kernel-qcow2-util-linux-f4bc7f96a6ff6239e89334e5b887227eb9f4d9c2.zip
dmesg: support colors customization
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'sys-utils/dmesg.1')
-rw-r--r--sys-utils/dmesg.144
1 files changed, 34 insertions, 10 deletions
diff --git a/sys-utils/dmesg.1 b/sys-utils/dmesg.1
index 75af1ec53..c4c64dfe5 100644
--- a/sys-utils/dmesg.1
+++ b/sys-utils/dmesg.1
@@ -64,8 +64,8 @@ Display help text and exit.
.IP "\fB\-k\fR, \fB\-\-kernel\fR"
Print kernel messages.
.IP "\fB\-L\fR, \fB\-\-color\fR[=\fIwhen\fR]"
-Colorize important messages. The optional argument \fIwhen\fP can be \fBauto\fR,
-\fBnever\fR or \fBalways\fR. If the \fIwhen\fR argument is omitted,
+Colorize important messages (enabled by default). The optional argument \fIwhen\fP
+can be \fBauto\fR, \fBnever\fR or \fBalways\fR. If the \fIwhen\fR argument is omitted,
then it defaults to \fBauto\fR.
.IP "\fB\-l\fR, \fB\-\-level \fIlist\fR"
Restrict output to the given (comma-separated)
@@ -178,23 +178,47 @@ format has the same issue as
.BR ctime :
the time may be inaccurate when a system is suspended and resumed.
.SH COLORS
-Implicit coloring can be disabled as follows:
-.RS
+Implicit coloring can be disabled by an empty file \fI/etc/terminal-colors.d/dmesg.disable\fR.
-.br
-.BI "touch /etc/terminal-colors.d/dmesg.disable"
-.br
+See
+.BR terminal-colors.d (5)
+for more details about colorization configuration. The logical color names
+support by
+.B dmesg
+are:
+.TP
+.B subsys
+The message sub-system prefix (e.g. "ACPI:").
+.TP
+.B time
+The message timestamp.
+.TP
+.B alert
+The text of the message with the alert log priority.
+.TP
+.B crit
+The text of the message with the critical log priority.
+.TP
+.B err
+The text of the message with the error log priority.
+.TP
+.B warn
+The text of the message with the warning log priority.
+.TP
+.B segfault
+The text of the message that inform about segmentation fault.
-.RE
-For more details see
-.BR terminal-colors.d (5).
.SH SEE ALSO
.BR syslogd (8)
+.BR terminal-colors.d (5)
.SH AUTHORS
.MT kzak@redhat.com
Karel Zak
.ME
+
.br
+.B dmesg
+was originally written by
.MT tytso@athena.mit.edu
Theodore Ts'o
.ME