From: Sami Kerola <kerolasa@iki.fi>
Date: Sun, 16 Jun 2013 18:53:52 +0000 (+0100)
Subject: docs: add --time-format option and ISO-8601 format to manual
X-Git-Tag: v2.24-rc1~475
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c31f4b860460e8211d8f15c7da5614f826c6088b;p=thirdparty%2Futil-linux.git

docs: add --time-format option and ISO-8601 format to manual

Signed-off-by: Sami Kerola <kerolasa@iki.fi>
---

diff --git a/sys-utils/dmesg.1 b/sys-utils/dmesg.1
index c0606884af..ce186d84e7 100644
--- a/sys-utils/dmesg.1
+++ b/sys-utils/dmesg.1
@@ -153,6 +153,28 @@ Wait for new messages. This feature is supported on systems with readable
 /dev/kmsg only (since kernel 3.5.0).
 .IP "\fB\-x\fR, \fB\-\-decode\fR"
 Decode facility and level (priority) number to human readable prefixes.
+.IP "\fB\-\-time\-format\fR \fIformat\fR"
+Print time stam using format
+.IR ctime ,
+.IR delta ,
+.I reltime
+or
+.IR iso .
+The three first time formats are aliases of time format specific options.
+The
+.I iso
+is a
+.B dmesg
+implementation of ISO-8601 timestamp format.  Purpose of this format is
+to make comparing of timestamps in between two system, and other parsing,
+easy.  The defition of timestamp is YYYY-MM-DD<T stands for date and time
+separator>HH:MM:SS,<microseconds><-+><GMT-0 timezone offset>.
+.IP
+The
+.I iso
+time format has the same issue as
+.IR ctime ,
+the time may be inaccurate if a system is suspended and resumed.
 .SH SEE ALSO
 .BR syslogd (8)
 .SH AUTHORS