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

FreeBSD Manual Pages

  
 
  

home | help
setlock(8)		    System Manager's Manual		    setlock(8)

NAME
       setlock - runs another program with a file locked.

SYNOPSIS
       setlock [ -nNxX ] fn child

DESCRIPTION
       fn is a single argument.	 child consists	of one or more arguments.

       setlock	opens  fn  for writing (creating it if it does not exist), ob-
       tains an	exclusive lock on it, and runs 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 fn.  The lock disappears when
       this ofile is

       o      closed by	all the	processes that have descriptors	for it or

       o      explicitly unlocked.

OPTIONS
       -n     No delay.	If fn is locked	by another process, setlock gives up.

       -N     (Default.) Delay.	If fn is locked	by  another  process,  setlock
	      waits until it can obtain	a new lock.

       -x     If  fn  cannot  be  opened (or created) or locked, setlock exits
	      zero.

       -X     (Default.) If fn cannot be opened	(or created) or	 locked,  set-
	      lock prints an error message and exits nonzero.

SEE ALSO
       envdir(8),   envini(8),	 envuidgid(8),	fghack(8),  multilog(8),  pgr-
       phack(8), readproctitle(8), setuidgid(8), setuser(8), softlimit(8), su-
       pervise(8),   svc(8),  svok(8),	svscan(8),  svscanboot(8),  svstat(8),
       tai64n(8), tai64nlocal(8)

								    setlock(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=setlock&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help