Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LCKDO(1)			    moreutils				LCKDO(1)

NAME
     lckdo - run a program with a lock held

SYNOPSIS
     lckdo [options] {lockfile} {program} [arguments]

DESCRIPTION
     lckdo  runs  a  program  with  a  lock  held,  in order to prevent multiple
     processes from running in parallel. Use just like nice or nohup.

     Now that util-linux contains a similar command named flock, lckdo is depre-
     cated, and will be removed from some future version of moreutils.

OPTIONS
     -w
	 If the lock is already held by another process, wait for it to complete
	 instead of failing immediately.

     -W {sec}
	 The same as -w but wait not more than sec seconds.

     -e
	 Execute the program directly without forking and waiting (keeps an  ex-
	 tra file descriptor open).

     -E {nnn}
	 Set  the  file  descriptor  number to keep open when exec()ing (implies
	 -e).

     -n
	 Do not create the lock file if it does not exist.

     -q
	 Produce no output if lock is already held.

     -s
	 Lock in shared (read) mode.

     -x
	 Lock in exclusive (write) mode (default).

     -t
	 Test for lock existence.

EXIT STATUS
     If the lock was successfully acquired, the return value is that of the pro-
     gram invoked by lckdo. If the lock couldn't be acquired, EX_TEMPFAIL is re-
     turned. If there was a problem opening/creating or locking the  lock  file,
     EX_CANTCREAT or EX_OSERR will be returned.

AUTHOR
     Michael Tokarev

moreutils			   2007-08-15				LCKDO(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lckdo&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help