diff options
author | Paul Eggert <eggert@cs.ucla.edu> | 2010-11-05 19:35:12 -0700 |
---|---|---|
committer | Jim Meyering <meyering@redhat.com> | 2010-11-06 15:24:49 +0100 |
commit | c7375c236ca5fa23661388e9f9c41e8312eb0cce (patch) | |
tree | 37fc8fa9c0b9765ddbc491abdffef6146688cfbe /doc | |
parent | 312549b627b9cb634c5bc978bf3def44ea88be21 (diff) | |
download | coreutils-c7375c236ca5fa23661388e9f9c41e8312eb0cce.tar.xz |
stat: use e.g. %.3X instead of %X.%3:X for sub-second precision
* NEWS: Document this.
* doc/coreutils.texi (stat invocation): Likewise.
* gl/lib/fstimeprec.c, gl/lib/fstimeprec.h, gl/modules/fstimeprec:
* gl/modules/fstimeprec-tests, gl/tests/test-fstimeprec.c:
New files.
* bootstrap.conf (gnulib_modules): Add fstimeprec.
* src/stat.c: Include fstimeprec.h. Don't include xstrtol.h.
(decimal_point, decimal_point_len): New static vars.
(main): Initialize them.
(epoch_sec, out_ns): Remove.
(out_int, out_uint): Now returns whatever printf returned.
(out_minus_zero, out_epoch_secs): New functions.
(print_stat): Use out_epoch_sec instead of out_ns and epoch_sec.
(print_stat, print_it, usage): Remove the %:X-style formats.
* tests/misc/stat-nanoseconds: Set TZ=UTC0 to avoid problems
with weird time zones. Use a time stamp near the Epoch so that we
don't have to worry about leap seconds. Redo test cases to match
new behavior.
* tests/touch/60-seconds: Change %Y.%:Y to %.9Y, to adjust to
new behavior.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/coreutils.texi | 37 |
1 files changed, 18 insertions, 19 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index be5999ffe..8dfb069c0 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -10707,37 +10707,36 @@ The valid @var{format} directives for files with @option{--format} and @item %U - User name of owner @item %w - Time of file birth, or @samp{-} if unknown @item %W - Time of file birth as seconds since Epoch, or @samp{0} -@item %:W - Time of file birth: nanoseconds remainder, or @samp{0} @item %x - Time of last access @item %X - Time of last access as seconds since Epoch -@item %:X - Time of last access: nanoseconds remainder @item %y - Time of last modification @item %Y - Time of last modification as seconds since Epoch -@item %:Y - Time of last modification: nanoseconds remainder @item %z - Time of last change @item %Z - Time of last change as seconds since Epoch -@item %:Z - Time of last change: nanoseconds remainder @end itemize -Note that each of @samp{%:W}, @samp{%:X}, @samp{%:Y} and @samp{%:Z} -prints its zero-padded number of nanoseconds on a field of width 9. -However, if you specify anything between the @samp{%} and @samp{:}, -e.g., @samp{%10:X}, your modifier replaces the default of @samp{09}. - -Here are some examples: +The @samp{%W}, @samp{%X}, @samp{%Y}, and @samp{%Z} formats accept a +precision preceded by a period to specify the number of digits to +print after the decimal point. For example, @samp{%.9X} outputs the +last access time to nanosecond precision. If a period is given but no +precision, @command{stat} uses the estimated precision of the file +system. When discarding excess precision, time stamps are truncated +toward minus infinity. @example zero pad: - $ stat -c '[%015:Y]' /usr - [000000031367045] + $ stat -c '[%015Y]' /usr + [000001288929712] space align: - $ stat -c '[%15:Y]' /usr - [ 31367045] - $ stat -c '[%-15:Y]' /usr - [31367045 ] -truncate: - $ stat -c '[%.3:Y]' /usr - [031] + $ stat -c '[%15Y]' /usr + [ 1288929712] + $ stat -c '[%-15Y]' /usr + [1288929712 ] +precision: + $ stat -c '[%.3Y]' /usr + [1288929712.114] + $ stat -c '[%.Y]' /usr + [1288929712.114951] @end example The mount point printed by @samp{%m} is similar to that output |