rev: be careful with close()

[thirdparty/util-linux.git] / sys-utils / dmesg.1

diff --git a/sys-utils/dmesg.1 b/sys-utils/dmesg.1
index d55341882c227287ea2f174b09effa861a44850e..a93821aeae2507035ef1a9ef7c0a98cc39dbd1a1 100644 (file)
--- a/sys-utils/dmesg.1
+++ b/sys-utils/dmesg.1
@@ -49,8 +49,9 @@ Display the local time and the delta in human-readable format.  Be aware that
 conversion to the local time could be inaccurate (see \fB\-T\fR for more
 details).
 .IP "\fB\-F\fR, \fB\-\-file \fIfile\fR"
-Read the messages from the given
+Read the syslog messages from the given
 .IR file .
+Note that \fB\-F\fR does not support messages in kmsg format. The old syslog format is supported only.
 .IP "\fB\-f\fR, \fB\-\-facility \fIlist\fR"
 Restrict output to the given (comma-separated)
 .I list
@@ -99,7 +100,7 @@ output.
 For example,
 .B \-n 1
 or
-.B \-n alert
+.B \-n emerg
 prevents all messages, except emergency (panic) messages, from appearing on
 the console.  All levels of messages are still written to
 .IR /proc/kmsg ,
@@ -114,6 +115,8 @@ will
 print or clear the kernel ring buffer.
 .IP "\fB\-P\fR, \fB\-\-nopager\fR"
 Do not pipe output into a pager.  A pager is enabled by default for \fB\-\-human\fR output.
+.IP "\fB\-p\fR, \fB\-\-force\-prefix\fR"
+Add facility, level or timestamp information to each line of a multi-line message.
 .IP "\fB\-r\fR, \fB\-\-raw\fR"
 Print the raw message buffer, i.e. do not strip the log-level prefixes.
 
@@ -157,7 +160,7 @@ Do not print kernel's timestamps.
 Print timestamps using the given \fIformat\fR, which can be
 .BR ctime ,
 .BR reltime ,
-.BR delta
+.B delta
 or
 .BR iso .
 The first three formats are aliases of the time-format-specific options.
@@ -225,7 +228,13 @@ The text of the message with the warning log priority.
 .TP
 .B segfault
 The text of the message that inform about segmentation fault.
-
+.SH EXIT STATUS
+.B dmesg
+can fail reporting permission denied error.  This is usually caused by
+.B dmesg_restrict
+kernel setting, please see
+.BR syslog (2)
+for more details.
 .SH SEE ALSO
 .BR terminal-colors.d (5),
 .BR syslogd (8)
@@ -242,6 +251,6 @@ Theodore Ts'o
 .ME
 .SH AVAILABILITY
 The dmesg command is part of the util-linux package and is available from
-.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
+.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
 Linux Kernel Archive
 .UE .