aboutsummaryrefslogtreecommitdiff
path: root/jim_tcl.txt
diff options
context:
space:
mode:
authorSteve Bennett <steveb@workware.net.au>2016-08-27 14:09:31 +1000
committerSteve Bennett <steveb@workware.net.au>2018-09-21 12:57:41 +1000
commitfd07366b2c527527425dce94d1c337168ea86638 (patch)
tree4e5de3da314e9d70cacfcc818327c5b193d40133 /jim_tcl.txt
parent022f90263261694bbcb98373ad7e5a282ab74453 (diff)
downloadjimtcl-fd07366b2c527527425dce94d1c337168ea86638.zip
jimtcl-fd07366b2c527527425dce94d1c337168ea86638.tar.gz
jimtcl-fd07366b2c527527425dce94d1c337168ea86638.tar.bz2
file: Add microsecond resolution for mtime: mtimeus
Note that actual support is dependent upon the underlying operating system and filesystem. Signed-off-by: Steve Bennett <steveb@workware.net.au>
Diffstat (limited to 'jim_tcl.txt')
-rw-r--r--jim_tcl.txt14
1 files changed, 12 insertions, 2 deletions
diff --git a/jim_tcl.txt b/jim_tcl.txt
index efe13c5..64642a9 100644
--- a/jim_tcl.txt
+++ b/jim_tcl.txt
@@ -3,7 +3,7 @@ Jim Tcl(n)
NAME
----
-Jim Tcl v0.78 - reference manual for the Jim Tcl scripting language
+Jim Tcl v0.78+ - reference manual for the Jim Tcl scripting language
SYNOPSIS
--------
@@ -52,6 +52,10 @@ Some notable differences with Tcl 8.5/8.6 are:
RECENT CHANGES
--------------
+Changes since 0.78
+~~~~~~~~~~~~~~~~~~
+1. Add `file mtimeus` for high resolution file timestamps
+
Changes between 0.77 and 0.78
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Add serial/tty support with `aio tty`
@@ -2373,6 +2377,12 @@ abbreviation for +'option'+ is acceptable. The valid options are:
error is generated. If +'time'+ is given, sets the modification time
of the file to the given value.
++*file mtimeus* 'name ?time_us?'+::
+ As for `file mtime` except the time value is in microseconds
+ since the epoch (see also `clock microseconds`).
+ Note that some platforms and some filesystems don't support high
+ resolution timestamps for files.
+
+*file normalize* 'name'+::
Return the normalized path of +'name'+. See 'realpath(3)'.
@@ -2410,7 +2420,7 @@ abbreviation for +'option'+ is acceptable. The valid options are:
Invoke the 'stat' kernel call on +'name'+, and return the result
as a dictionary with the following keys: 'atime',
'ctime', 'dev', 'gid', 'ino', 'mode', 'mtime',
- 'nlink', 'size', 'type', 'uid'.
+ 'nlink', 'size', 'type', 'uid', 'mtimeus' (if supported - see `file mtimeus`)
Each element except 'type' is a decimal string with the value of
the corresponding field from the 'stat' return structure; see the
manual entry for 'stat' for details on the meanings of the values.