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

FreeBSD Manual Pages

  
 
  

home | help
RPC.LOCKD(8)		     System Manager's Manual		    RPC.LOCKD(8)

NAME
     rpc.lockd -- NFS file locking daemon

SYNOPSIS
     rpc.lockd [-d debug_level] [-F] [-g grace period] [-h bindip] [-p port]

DESCRIPTION
     The  rpc.lockd  utility  provides monitored and unmonitored file and record
     locking services in an NFSv3 environment.	To monitor the status  of  hosts
     requesting locks, the locking daemon typically operates in conjunction with
     rpc.statd(8).

     Options and operands available for rpc.lockd:

     -d      The -d option causes debugging information to be written to syslog,
	     recording	all  RPC transactions to the daemon.  These messages are
	     logged with level LOG_DEBUG and facility LOG_DAEMON.  Specifying  a
	     debug_level of 1 results in the generation of one log line per pro-
	     tocol  operation.	 Higher  debug	levels can be specified, causing
	     display of operation arguments and internal operations of the  dae-
	     mon.

     -F      Run  rpc.lockd  in  the  foreground,  rather than going into daemon
	     mode.  This is useful  if	some  other  process  uses  fork(2)  and
	     exec(3)  to run rpc.lockd, and wants to monitor when and how it ex-
	     its.

     -g      The -g option allow to specify the grace period, in seconds.   Dur-
	     ing  the  grace  period  rpc.lockd only accepts requests from hosts
	     which are reinitialising locks  which  existed  before  the  server
	     restart.  Default is 30 seconds.

     -h bindip
	     Specify specific IP addresses to bind to.	This option may be spec-
	     ified multiple times.  If no -h option is specified, rpc.lockd will
	     bind  to  INADDR_ANY.   Note that when specifying IP addresses with
	     -h, rpc.lockd will automatically add 127.0.0.1 and if IPv6  is  en-
	     abled, ::1 to the list.

     -p      The  -p  option  allow to force the daemon to bind to the specified
	     port, for both AF_INET and AF_INET6 address families.

     Error conditions are logged to syslog, irrespective of the debug level, us-
     ing log level LOG_ERR and facility LOG_DAEMON.

     The rpc.lockd utility must NOT be invoked by inetd(8) because the	protocol
     assumes  that  the  daemon  will  run  from system start time.  Instead, it
     should be configured in rc.conf(5) to run at system startup.

FILES
     /usr/include/rpcsvc/nlm_prot.x  RPC protocol specification for the  network
				     lock manager protocol.

SEE ALSO
     syslog(3), nfslockd(4), rc.conf(5), rpc.statd(8)

STANDARDS
     The  implementation  is based on the specification in "Protocols for X/Open
     PC Interworking: XNFS, Issue 4", X/Open  CAE  Specification  C218,  ISBN  1
     872630 66 9.

HISTORY
     A version of rpc.lockd appeared in SunOS 4.

BUGS
     The current implementation serialises locks requests that could be shared.

FreeBSD ports 15.1		   May 8, 2024			    RPC.LOCKD(8)

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

home | help