6253 F_GETLK doesn't always return lock owner
[illumos-gate.git] / usr / src / man / man1m / statd.1m
blob910001b00f2cebae77316b139a50f2ac1a836de1
1 '\" te
2 .\"  Copyright 1989 AT&T  Copyright (c) 2004 Sun Microsystems, Inc.  All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH STATD 1M "Nov 18, 2004"
7 .SH NAME
8 statd \- network status monitor
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fB/usr/lib/nfs/statd\fR
13 .fi
15 .SH DESCRIPTION
16 .sp
17 .LP
18 \fBstatd\fR is an intermediate version of the status monitor. It interacts with
19 \fBlockd\fR(1M) to provide the crash and recovery functions for the locking
20 services on NFS. \fBstatd\fR keeps track of the clients with processes which
21 hold locks on a server. When the server reboots after a crash, \fBstatd\fR
22 sends a message to the \fBstatd\fR on each client indicating that the server
23 has rebooted. The client \fBstatd\fR processes then inform the \fBlockd\fR on
24 the client that the server has rebooted. The client \fBlockd\fR then attempts
25 to reclaim the lock(s) from the server.
26 .sp
27 .LP
28 \fBstatd\fR on the client host also informs the \fBstatd\fR on the server(s)
29 holding locks for the client when the client has rebooted. In this case, the
30 \fBstatd\fR on the server informs its \fBlockd\fR that all locks held by the
31 rebooting client should be released, allowing other processes to lock those
32 files.
33 .sp
34 .LP
35 \fBlockd\fR is started by \fBautomountd\fR(1M), \fBmount_nfs\fR(1M), and
36 \fBshare\fR(1M) if NFS automounts are needed.
37 .SH FILES
38 .sp
39 .ne 2
40 .na
41 \fB\fB/var/statmon/sm\fR\fR
42 .ad
43 .sp .6
44 .RS 4n
45 lists hosts and network addresses to be contacted after a reboot
46 .RE
48 .sp
49 .ne 2
50 .na
51 \fB\fB/var/statmon/sm.bak\fR\fR
52 .ad
53 .sp .6
54 .RS 4n
55 lists hosts and network addresses that could not be contacted after last reboot
56 .RE
58 .sp
59 .ne 2
60 .na
61 \fB\fB/var/statmon/state\fR\fR
62 .ad
63 .sp .6
64 .RS 4n
65 includes a number which changes during a reboot
66 .RE
68 .sp
69 .ne 2
70 .na
71 \fB\fB/usr/include/rpcsvc/sm_inter.x\fR\fR
72 .ad
73 .sp .6
74 .RS 4n
75 contains the rpcgen source code for the interface services provided by the
76 statd daemon.
77 .RE
79 .SH SEE ALSO
80 .sp
81 .LP
82 \fBsvcs\fR(1), \fBautomountd\fR(1M), \fBlockd\fR(1M), \fBmount_nfs\fR(1M),
83 \fBshare\fR(1M), \fBsvcadm\fR(1M), \fBattributes\fR(5), \fBsmf\fR(5)
84 .sp
85 .LP
86 \fI\fR
87 .SH NOTES
88 .sp
89 .LP
90 The crash of a server is only detected upon its recovery.
91 .sp
92 .LP
93 The \fBstatd\fR service is managed by the service management facility,
94 \fBsmf\fR(5), under the service identifier:
95 .sp
96 .in +2
97 .nf
98 svc:/network/nfs/status
99 .fi
100 .in -2
105 Administrative actions on this service, such as enabling, disabling, or
106 requesting restart, can be performed using \fBsvcadm\fR(1M). The service's
107 status can be queried using the \fBsvcs\fR(1) command.
110 If it is disabled, it will be enabled by \fBmount_nfs\fR(1M),
111 \fBshare_nfs\fR(1M), and \fBautomountd\fR(1M) unless  its
112 \fBapplication/auto_enable\fR property is set to \fBfalse\fR.