0467614a12
Approved by: re (kensmith) The merged revisions/files are: Revision Path 1.10 src/lib/libarchive/archive_entry.3 1.21 src/lib/libarchive/archive_read.3 1.8 src/lib/libautofs/libautofs.3 1.10 src/lib/libc/net/inet6_rth_space.3 1.8 src/lib/libc/posix1e/acl_get_entry.3 1.15 src/lib/libc/posix1e/mac.3 1.7 src/lib/libc/posix1e/mac_prepare.3 1.37 src/lib/libc/stdtime/strftime.3 1.16 src/lib/libc/sys/kse.2 1.8 src/lib/libc/sys/uuidgen.2 1.4 src/share/man/man4/man4.i386/acpi_ibm.4 1.6 src/share/man/man4/man4.i386/acpi_panasonic.4 1.40 src/share/man/man4/man4.i386/ep.4 1.6 src/share/man/man4/man4.i386/pbio.4 1.5 src/share/man/man4/man4.i386/snc.4 1.2 src/share/man/man4/man4.sparc64/openprom.4 1.4 src/share/man/man4/man4.sparc64/snd_audiocs.4 1.11 src/share/man/man4/witness.4 1.3 src/share/man/man5/devfs.conf.5 1.51 src/share/man/man9/ifnet.9 1.7 src/share/man/man9/printf.9 1.12 src/usr.bin/file2c/file2c.1 1.27 src/usr.bin/indent/indent.1 1.17 src/usr.bin/lockf/lockf.1 1.90 src/usr.bin/make/make.1 1.45 src/usr.bin/systat/systat.1 1.19 src/usr.bin/truss/truss.1 1.33 src/usr.bin/xinstall/install.1 1.11 src/usr.sbin/bluetooth/rfcomm_pppd/rfcomm_pppd.8 1.4 src/usr.sbin/bluetooth/sdpd/sdpd.8 1.9 src/usr.sbin/bsnmpd/modules/snmp_netgraph/snmp_netgraph.3 1.36 src/usr.sbin/i4b/isdnd/isdnd.rc.5 1.53 src/usr.sbin/mtree/mtree.8 1.8 src/usr.sbin/ndiscvt/ndiscvt.8 1.13 src/usr.sbin/ntp/doc/ntpdc.8 1.26 src/usr.sbin/pppd/pppd.8 1.40 src/usr.sbin/syslogd/syslog.conf.5 1.5 src/usr.sbin/wpa/wpa_supplicant/wpa_supplicant.conf.5
136 lines
3.4 KiB
Groff
136 lines
3.4 KiB
Groff
.\"
|
|
.\" Copyright (C) 1998 John D. Polstra. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY JOHN D. POLSTRA AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL JOHN D. POLSTRA OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd July 7, 1998
|
|
.Os
|
|
.Dt LOCKF 1
|
|
.Sh NAME
|
|
.Nm lockf
|
|
.Nd execute a command while holding a file lock
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl ks
|
|
.Op Fl t Ar seconds
|
|
.Ar file
|
|
.Ar command
|
|
.Op Ar arguments
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility acquires an exclusive lock on a
|
|
.Ar file ,
|
|
creating it if necessary,
|
|
.Bf Em
|
|
and removing the file on exit unless explicitly told not to.
|
|
.Ef
|
|
While holding the lock, it executes a
|
|
.Ar command
|
|
with optional
|
|
.Ar arguments .
|
|
After the
|
|
.Ar command
|
|
completes,
|
|
.Nm
|
|
releases the lock, and removes the
|
|
.Ar file
|
|
unless the
|
|
.Fl k
|
|
option is specified.
|
|
.Bx Ns -style
|
|
locking is used, as described in
|
|
.Xr flock 2 ;
|
|
the mere existence of the
|
|
.Ar file
|
|
is not considered to constitute a lock.
|
|
.Pp
|
|
The following options are supported:
|
|
.Bl -tag -width Fl
|
|
.It Fl k
|
|
Causes the lock file to be kept (not removed) after the command
|
|
completes.
|
|
.It Fl s
|
|
Causes
|
|
.Nm
|
|
to operate silently.
|
|
Failure to acquire the lock is indicated only in the exit status.
|
|
.It Fl t Ar seconds
|
|
Specifies a timeout for waiting for the lock.
|
|
By default,
|
|
.Nm
|
|
waits indefinitely to acquire the lock.
|
|
If a timeout is specified with this option,
|
|
.Nm
|
|
will wait at most the given number of
|
|
.Ar seconds
|
|
before giving up.
|
|
A timeout of 0 may be given, in which case
|
|
.Nm
|
|
will fail unless it can acquire the lock immediately.
|
|
When a lock times out,
|
|
.Ar command
|
|
is
|
|
.Em not
|
|
executed.
|
|
.El
|
|
.Pp
|
|
In no event will
|
|
.Nm
|
|
break a lock that is held by another process.
|
|
.Sh EXIT STATUS
|
|
If
|
|
.Nm
|
|
successfully acquires the lock, it returns the exit status produced by
|
|
.Ar command .
|
|
Otherwise, it returns one of the exit codes defined in
|
|
.Xr sysexits 3 ,
|
|
as follows:
|
|
.Bl -tag -width F_CANTCREATX
|
|
.It Dv EX_TEMPFAIL
|
|
The specified lock file was already locked by another process.
|
|
.It Dv EX_CANTCREAT
|
|
The
|
|
.Nm
|
|
utility
|
|
was unable to create the lock file, e.g., because of insufficient access
|
|
privileges.
|
|
.It Dv EX_USAGE
|
|
There was an error on the
|
|
.Nm
|
|
command line.
|
|
.It Dv EX_OSERR
|
|
A system call (e.g., fork) failed unexpectedly.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr flock 2 ,
|
|
.Xr sysexits 3
|
|
.Sh HISTORY
|
|
A
|
|
.Nm
|
|
utility first appeared in
|
|
.Fx 2.2 .
|
|
.Sh AUTHORS
|
|
.An John Polstra Aq jdp@polstra.com .
|