diff options
| author | Sami Kerola | 2016-06-27 21:38:27 +0200 |
|---|---|---|
| committer | Sami Kerola | 2016-06-27 21:40:37 +0200 |
| commit | 3d47107de5d04fe2803827d3e24c227a18d1a4b0 (patch) | |
| tree | d92f83cc209d0f7d6f3d1a2a1ec4d7c773077543 | |
| parent | tests: utmpdump add subsecond accuracy test (diff) | |
| download | kernel-qcow2-util-linux-3d47107de5d04fe2803827d3e24c227a18d1a4b0.tar.gz kernel-qcow2-util-linux-3d47107de5d04fe2803827d3e24c227a18d1a4b0.tar.xz kernel-qcow2-util-linux-3d47107de5d04fe2803827d3e24c227a18d1a4b0.zip | |
docs: add file format note to utmpdump manual page
Tell that the old textual format that does not use full utmp time precision,
and has issues with timezones. Warn also that the textual format may become
incompatible, although there are no plans in foreseeable future to do so.
Signed-off-by: Sami Kerola <kerolasa@iki.fi>
| -rw-r--r-- | login-utils/utmpdump.1 | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/login-utils/utmpdump.1 b/login-utils/utmpdump.1 index 68516d8bd..c7a843d1a 100644 --- a/login-utils/utmpdump.1 +++ b/login-utils/utmpdump.1 @@ -57,6 +57,18 @@ bogus entries, and reintegrated using: But be warned, .B utmpdump was written for debugging purposes only. +.SS File formats +.PP +The only binary version of the +.BR utmp (5) +is standardised. Textual dumps may become incompatible in future. +.PP +The version 2.28 was the last one that printed text output using +.BR ctime (3) +timestamp format. Newer dumps use millisecond precision ISO-8601 timestamp +format in UTC-0 timezone. Conversion from former timestamp format can be +made to binary, although attempt to do so can lead the timestamps to drift +amount of timezone offset. .SH BUGS You may .B not |