1 NFSD(1M) Maintenance Commands NFSD(1M)
2
3 NAME
4 nfsd - NFS daemon
5
6 SYNOPSIS
7 /usr/lib/nfs/nfsd [-a] [-c max_conn] [-l listen_backlog] [-p protocol]
8 [-t device] [nservers]
9
10 DESCRIPTION
11 nfsd is the daemon that handles client file system requests. Only users
12 with {PRIV_SYS_NFS} and sufficient privileges to write to /var/run can
13 run this daemon.
14
15 The nfsd daemon is automatically invoked using share(1M) with the -a
16 option.
17
18 By default, nfsd starts over the TCP and UDP transports for versions 2
19 and 3. By default, it starts over the TCP for version 4. You can change
20 this with the -p option.
21
22 A previously invoked nfsd daemon started with or without options must be
23 stopped before invoking another nfsd command.
24
25 See nfs(4) for available configuration properties for nfsd.
26
27 Options
28 The following options are supported:
29
30 -a Start a NFS daemon over all available connectionless and
31 connection-oriented transports, including UDP and TCP.
32 Equivalent of setting the protocol property to all.
33
34 -c max_conn
35 Set the maximum number of connections allowed to the NFS server
36 over connection-oriented transports. By default, the number of
37 connections is unlimited. Equivalent of the max_connections
38 property.
39
40 -l Set connection queue length for the NFS server over a connection-
41 oriented transport. The default value is 32 entries. Equivalent
42 of the listen_backlog property.
43
44 -p protocol
45 Start a NFS daemon over the specified protocol. Equivalent of
46 the protocol property.
47
48 -t device
49 Start a NFS daemon for the transport specified by the given
50 device. Equivalent of the device property.
51
52 Operands
53 The following operands are supported:
54
55 nservers
56 This sets the maximum number of concurrent NFS requests that the
57 server can handle. This concurrency is achieved by up to
58 nservers threads created as needed in the kernel. nservers
59 should be based on the load expected on this server. 16 is the
60 usual number of nservers. If nservers is not specified, the
61 maximum number of concurrent NFS requests will default to 1.
62 Equivalent of the servers property.
63
64 Usage
65 If the nfs_portmon variable is set to non-zero value in /etc/system, then
66 clients are required to use privileged ports (ports < IPPORT_RESERVED) to
67 get NFS services. This variable is equal to zero by default. This
68 variable has been moved from the "nfs" module to the "nfssrv" module. To
69 set the variable, edit the /etc/system file and add this entry:
70
71 set nfssrv:nfs_portmon = 1
72
73 FILES
74 .nfsXXX
75 Client machine pointer to an open-but-unlinked file.
76
77 /etc/system
78 System configuration information file.
79
80 /var/nfs/v4_state
81 /var/nfs/v4_oldstate
82 Directories used by the server to manage client state
83 information. These directories should not be removed.
84
85 EXIT STATUS
86 0 Daemon started successfully.
87
88 1 Daemon failed to start.
89
90 SEE ALSO
91 svcs(1), mountd(1M), share(1M), sharectl(1M), sharemgr(1M), svcadm(1M),
92 nfs(4), sharetab(4), system(4), attributes(5), smf(5), zones(5)
93
94 NOTES
95 Manually starting and restarting nfsd is not recommended. If it is
96 necessary to do so, use svcadm to enable or disable the nfs service
97 (svc:/network/nfs/server). If it is disabled, it will be enabled by
98 share_nfs(1M), unless its application/auto_enable property is set to
99 false. See smf(5) and svcadm(1M) for more information.
100
101 The nfsd service is managed by the service management facility, smf(5),
102 under the service identifier:
103
104 svc:/network/nfs/server
105
106 Administrative actions on this service, such as enabling, disabling, or
107 requesting restart, can be performed using svcadm(1M). The service's
108 status can be queried using the svcs(1) command.
109
110 If nfsd is killed with SIGTERM, it will not be restarted by the service
111 management facility. Instead, nfsd can be restarted by other signals,
112 such as SIGINT.
113
114 NFS service, which includes nfsd, can run inside a non-global zone. See
115 the discussion under ZONES in nfs(4) for more information.
116
117 illumos February 4, 2020 illumos