setlock — runs another program with a file locked.
setlock
[-n] [-N] [-x] [-X] {fn
} {child
}
fn
is a single argument.
child
consists of one or more arguments.
setlock opens
for writing (creating it if it does not exist), obtains an exclusive lock on it, and runs fn
child
.
Normally the lock disappears when child
exits.
Here's the complete story:
child
is given a descriptor for a locked ofile pointing to the disk file named
.
The lock disappears when this ofile is
fn
either closed by all the processes that have descriptors for it
or explicitly unlocked.
No delay.
If
is locked by another process, setlock gives up.
fn
(Default.)
Delay.
If
is locked by another process, setlock waits until it can obtain a new lock.
fn
If
cannot be opened (or created) or locked, setlock exits zero.
fn
(Default.)
If
cannot be opened (or created) or locked, setlock prints an error message and exits nonzero.
fn