X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=chiark-utils.git;a=blobdiff_plain;f=cprogs%2Fwith-lock-ex.1;h=941d1d9a0fa3a2d59d8c8aa2baa98ca0de7806ea;hp=ce3f87fd1b840f86a584e3727ff18588a5a214d1;hb=32440db4a50050a6337652369de275e653fa2780;hpb=78ad6d7c4fcfc77d83649a4082a8dae4359bdbf1 diff --git a/cprogs/with-lock-ex.1 b/cprogs/with-lock-ex.1 index ce3f87f..941d1d9 100644 --- a/cprogs/with-lock-ex.1 +++ b/cprogs/with-lock-ex.1 @@ -3,7 +3,7 @@ with-lock-ex \- file locker .SH SYNOPSIS .B with-lock-ex -.RB [\| \-w \||\| \-q \||\| \-f \|] +.BR \-w \||\| \-q \||\| \-f .I lockfile command .IR args \ \|.\|.\|. .br @@ -21,14 +21,16 @@ for each user class for which the umask has .SH OPTIONS .TP .B \-w -wait for the lock +Wait for the lock to be available. .TP .B \-f -fail if the lock cannot be acquired +Fail (printing a message to stderr and exiting 255) if the lock cannot +be acquired immediately because another process has it. .TP .B \-q -silently do nothing (ie, exit 0 instead of executing the specified -process) if the lock cannot be acquired +Silently do nothing (ie, exit 0 instead of executing the specified +process) if the lock cannot be acquired immediately because another +process has it. .SH STALE LOCKS The locking protocol used does not suffer from stale locks. If the lock cannot be acquired, one or more running processes must currently @@ -136,7 +138,7 @@ This Manual page was written by Matthew Vernon and enhanced by Ian Jackson , in 2003, but may be used by anyone. .SH COPYRIGHT -with-lock-ex was written by Ian Jackons +with-lock-ex was written by Ian Jackson in 1993, 1994, 1995, 1996, 1998, 1999. He has placed it in the public domain. .SH "SEE ALSO"