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

FreeBSD Manual Pages


home | help
lockd(1M)		System Administration Commands		     lockd(1M)

       lockd - network lock daemon

       /usr/lib/nfs/lockd  [-g graceperiod]  [-l listen_min_backlog] [-t time-
       out] [nthreads]

       The lockd utility is part of  the  NFS  lock  manager,  which  supports
       record locking operations on NFS	files. See fcntl(2) and	lockf(3C). The
       lock manager provides the following two functions:

	 o  It forwards	fcntl(2) locking requests for NFS mounted file systems
	    to the lock	manager	on the NFS server.

	 o  It generates local file locking operations in response to requests
	    forwarded from lock	managers running on NFS	client machines.

       State information kept by the lock manager about	these locking requests
       can be lost if the lockd	is killed or the operating system is rebooted.
       Some of this information	can be recovered as follows. When  the	server
       lock  manager restarts, it waits	for a grace period for all client-site
       lock managers to	submit reclaim requests. Client-site lock managers, on
       the  other  hand, are notified by the status monitor daemon, statd(1M),
       of the restart and promptly resubmit previously granted lock  requests.
       If  the	lock  daemon  fails to secure a	previously granted lock	at the
       server site, then it sends SIGLOST to a process.

       Administrators can make changes to the startup parameters for lockd  by
       logging in as root and editing the /etc/default/nfs file	(See nfs(4)).

       The following options are supported:

       -g graceperiod	       Deprecated  in  favor  of GRACE_PERIOD. Specify
			       the number of seconds that  all	clients	 (both
			       NLM  and	NFSv4) have to reclaim locks after the
			       server reboots.	It  also  controls  the	 NFSv4
			       lease  interval.	 This  option is equivalent to
			       the LOCKD_GRACE_PERIOD parameter.

       -l listen_min_backlog   Specify the listener backlog  (listen_min_back-
			       log).  listen_min_backlog is the	number connect
			       requests	that are queued	and waiting to be pro-
			       cessed before new connect requests start	to get

       -t timeout	       Specify the number of seconds  to  wait	before
			       retransmitting  a  lock	request	 to the	remote
			       server. The default value is 15 seconds.	Equiv-
			       alent of	the LOCKD_RETRANSMIT_TIMEOUT parameter
			       in the nfs file.

       nthreads		       Specify	the  maximum  number   of   concurrent
			       threads	that  the server can handle. This con-
			       currency	is achieved by up to nthreads  threads
			       created	as  needed  in	the  kernel.  nthreads
			       should be based on the load  expected  on  this
			       server. If nthreads is not specified, the maxi-
			       mum number of concurrent	threads	 will  default
			       to  20. Equivalent of the LOCKD_SERVERS parame-
			       ter in the nfs file.

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWnfscu			   |

       svcs(1),	 automountd(1M),  clear_locks(1M),  mount_nfs(1M),  share(1M),
       share_nfs(1M),  statd(1M), svcadm(1M), fcntl(2),	lockf(3C), nfs(4), at-
       tributes(5), smf(5)

       The lockd service  is  managed  by  the	service	 management  facility,
       smf(5), under the service identifier:


       Administrative actions on this service, such as enabling, disabling, or
       requesting restart, can be performed using  svcadm(1M).	The  service's
       status can be queried using the svcs(1) command.

       If  it is disabled, it will be enabled by mount_nfs(1M),	share_nfs(1M),
       and automountd(1M) unless  its	     application/auto_enable  property
       is set to false.

       This daemon might not exist in a	future release of Solaris.

SunOS 5.10			  17 Nov 2004			     lockd(1M)


Want to link to this manual page? Use this URL:

home | help