shlock(1) - Linux man page
Name
shlock - create lock files for use in shell scriptsSynopsis
shlock -p pid -f name [ -b ] [ -u ] [ -c ]Description
Shlock exits with a zero status if it was able to create the lock file, or non-zero if the file refers to currently-active process.
Options
- -b
- Process IDs are normally read and written in ASCII. If the ''-b'' flag is used, then they will be written as a binary int. For compatibility with other systems, the ''-u'' flag is accepted as a synonym for ''-b'' since binary locks are used by many UUCP packages.
- -c
- If the ''-c'' flag is used, then shlock will not create a lock file, but will instead use the file to see if the lock is held by another program. If the lock is valid, the program will exit with a non-zero status; if the lock is not valid (i.e., invoking shlock without the flag would have succeeded), then the program will exit with a zero status.
Examples
The following example shows how shlock would be used within a shell script:LOCK=<pathrun in inn.conf>/LOCK.send
trap 'rm -f ${LOCK} ; exit 1' 1 2 3 15
if shlock -p $$ -f ${LOCK} ; then
# Do appropriate work
else
echo Locked by 'cat ${LOCK}'
fi