debian man page for runlock

RUNLOCK(1)						      General Commands Manual							RUNLOCK(1)

NAME
       runlock - prevent concurrent execution of a process

SYNOPSYS
       runlock [ -h ]

       runlock [ -d ] [ -f pathname ] [ -t timeout ] command [ args ]

DESCRIPTION
       runlock tries to hold an exclusive lock while it executes a command. Subsequent execution of runlock with the same lock, while that lock is
       held, will cause the new instance of runlock to terminate with a faliure exit code. Otherwise, the exit code of the subprocess is returned.

USAGE
       -d

	      Debug mode; send log messages to standard error as well as to the system log.

       -f pathname

	      Specifies the pathname of the file to use as a lock file.  The default is to create a lock file  in  /tmp/cronutils-$USER  with  the
	      name of the command, and suffix ".pid".

       -t timeout

	      Specifies the duration, in seconds, for runlock to wait before giving up on trying to acquire the lock.  The default is 5 seconds.

       -h

	      Prints some basic help.

BUGS
       Sending SIGALRM to runlock before the timer has expired will cause the subprocess to be killed.

SEE ALSO
       runalarm(1), runstat(1)

AUTHOR
       runlock was written by Jamie Wilkinson <jaq@google.com>.

COPYRIGHT
       This program is copyright (C) 2010 Google, Inc.

       It is licensed under the Apache License, Version 2.0

Google, Inc.							 October 18, 2010							RUNLOCK(1)