NAME
lockd, rpc.lockd — network lock daemon
SYNOPSIS
/usr/sbin/rpc.lockd
[-l
log_file]
[-t
timeout]
[-g
graceperiod]
DESCRIPTION
lockd
is an RPC server that processes NFS
file locking requests from the local kernel
or from another remote lock daemon.
lockd
forwards lock requests for remote data
to the server site's lock daemon through the RPC/XDR package (see
rpc(3N)).
lockd
then requests the status monitor daemon,
statd
for monitor service (see
statd(1M)).
The reply to the lock request is not sent to the kernel
until the status daemon and the server site's lock daemon have replied.
If either the status monitor or server site's lock daemon is unavailable,
the reply to a lock request for remote data is delayed
until all daemons become available.
When a server recovers, it waits for a grace period for all NFS client-site
lockds
to submit reclaim requests.
Client-site
lockds
are notified by the
statd
of the server recovery,
and promptly resubmit previously granted lock requests.
If a
lockd
fails to secure a previously granted lock at the server site, the
lockd
sends a
SIGLOST
to the process holding that lock.
A fixed port can be specified for
lockd
by using the
LOCKD_PORT
variable in the
/etc/rc.config.d/nfsconf
file, as shown:
The port number can have any value between 1 and 65535.
After adding the port variable to the
/etc/rc.config.d/nfsconf
file,
lockd
must be restarted for this to take effect.
This feature can be disabled by deleting or commenting out the port
variable from the
/etc/rc.config.d/nfsconf
file and restarting
lockd.
Options
lockd
recognizes the following options and command-line arguments:
- -l log_file
Log any errors to the named log file
log_file.
Errors are not logged if the
-l
option is not specified.
Information logged to the file includes date and time of the error,
host name, process ID
and name of the function generating the error,
and the error message.
- -t timeout
lockd
uses
timeout
(seconds) as the interval instead of the default value (10 seconds)
to retransmit a lock request to the remote server.
Note that changing this value also changes the value
for grace period duration.
- -g graceperiod
lockd
uses
[1+(graceperiod/timeout)]×timeout
(seconds) as the grace period duration instead of the default value
(5×timeout
seconds).
If both
-t
and
-g
are specified, the
-t
should appear first since the grace period
duration is dependent on the value of timeout.
WARNINGS
The
LOCKD_PORT
variable will be obsoleted in HP-UX 11i V3, and
lockd
will use 4045 as a hard coded fixed port.
For this reason, HP recommends using 4045 for
LOCKD_PORT.
AUTHOR
lockd
was developed by Sun Microsystems, Inc., and HP.