diff options
author | Cedric Ware <cedric.ware__bml@normalesup.org> | 2020-04-20 12:10:01 -0500 |
---|---|---|
committer | dana <dana@dana.is> | 2020-04-20 12:10:01 -0500 |
commit | 25c9b61a6663f90bfb22fa73c1a7aa4fb9dee4ae (patch) | |
tree | 120e8f1e11ab3791b6fbe1d6302dda275d09c2ac /Doc | |
parent | f179dbf72a4f482c1ad513b7c58cd7f96c7cf7f3 (diff) | |
download | zsh-25c9b61a6663f90bfb22fa73c1a7aa4fb9dee4ae.tar.gz zsh-25c9b61a6663f90bfb22fa73c1a7aa4fb9dee4ae.tar.xz zsh-25c9b61a6663f90bfb22fa73c1a7aa4fb9dee4ae.zip |
45708: zsh/system: Enable sub-second timeout in zsystem flock
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/Zsh/mod_system.yo | 16 |
1 files changed, 12 insertions, 4 deletions
diff --git a/Doc/Zsh/mod_system.yo b/Doc/Zsh/mod_system.yo index 6292af071..06ea87918 100644 --- a/Doc/Zsh/mod_system.yo +++ b/Doc/Zsh/mod_system.yo @@ -166,7 +166,7 @@ to the command, or 2 for an error on the write; no error message is printed in the last case, but the parameter tt(ERRNO) will reflect the error that occurred. ) -xitem(tt(zsystem flock) [ tt(-t) var(timeout) ] [ tt(-f) var(var) ] [tt(-er)] var(file)) +xitem(tt(zsystem flock) [ tt(-t) var(timeout) ] [ tt(-i) var(interval) ] [ tt(-f) var(var) ] [tt(-er)] var(file)) item(tt(zsystem flock -u) var(fd_expr))( The builtin tt(zsystem)'s subcommand tt(flock) performs advisory file locking (via the manref(fcntl)(2) system call) over the entire contents @@ -196,9 +196,17 @@ a safety check that the file descriptor is in use for file locking. By default the shell waits indefinitely for the lock to succeed. The option tt(-t) var(timeout) specifies a timeout for the lock in -seconds; currently this must be an integer. The shell will attempt -to lock the file once a second during this period. If the attempt -times out, status 2 is returned. +seconds; fractional seconds are allowed. During this period, the +shell will attempt to lock the file every var(interval) seconds +if the tt(-i) var(interval) option is given, otherwise once a second. +(This var(interval) is shortened before the last attempt if needed, +so that the shell waits only until the var(timeout) and not longer.) +If the attempt times out, status 2 is returned. + +(Note: var(timeout) must be less than +ifzman(2^30-1)ifnzman(2NOTRANS(@sup{30})-1) seconds (about 34 years), +and var(interval) must be less than 0.999 * LONG_MAX microseconds +(only about 35 minutes on 32-bit systems).) If the option tt(-e) is given, the file descriptor for the lock is preserved when the shell uses tt(exec) to start a new process; |