Commit | Line | Data |
---|---|---|
7dd5dab1 KM |
1 | .\" Copyright (c) 1989 The Regents of the University of California. |
2 | .\" All rights reserved. | |
3 | .\" | |
7167345e | 4 | .\" %sccs.include.redist.man% |
7dd5dab1 | 5 | .\" |
7d52935b | 6 | .\" @(#)nfsd.8 5.7 (Berkeley) %G% |
7dd5dab1 KM |
7 | .\" |
8 | .TH NFSD 8 "" | |
9 | .UC 7 | |
10 | .SH NAME | |
11 | nfsd \- remote NFS server | |
12 | .SH SYNOPSIS | |
7167345e | 13 | .B nfsd |
1b3a818d | 14 | [ |
7d52935b MK |
15 | .B \-r |
16 | ] | |
17 | [ | |
7a094649 KM |
18 | .B \-u |
19 | .I msk,mtch,numprocs | |
20 | ] | |
1b3a818d | 21 | [ |
7a094649 KM |
22 | .B \-t |
23 | .I msk,mtch,hostadr1,hostadr2,... | |
24 | ] | |
25 | [ | |
26 | .I numprocs | |
27 | ] | |
7dd5dab1 KM |
28 | .SH DESCRIPTION |
29 | .I Nfsd | |
1b3a818d | 30 | runs on a server machine to service |
7dd5dab1 | 31 | .SM NFS |
1b3a818d KM |
32 | requests from client machines. |
33 | At least one | |
34 | .I nfsd | |
35 | must be running for a machine to operate as a server. | |
1b3a818d | 36 | The options |
7a094649 | 37 | .B \-u |
1b3a818d | 38 | and |
7a094649 KM |
39 | .B \-t |
40 | are used to indicate which transport protocols are to be served. | |
41 | .TP | |
42 | .B \-u | |
43 | Serve UDP NFS clients. | |
44 | .TP | |
45 | .B \-t | |
46 | Serve TCP NFS clients. | |
7d52935b MK |
47 | .TP \-r |
48 | Register the NFS service with | |
49 | .IR portmap (8) | |
50 | without creating any servers. | |
51 | This option can be used along with the | |
52 | .B \-u | |
53 | and/or | |
54 | .B \-t | |
55 | options to re-register NFS if the portmap server is restarted. | |
56 | .LP | |
57 | The following arguments to the | |
58 | .B \-u | |
59 | or | |
60 | .B \-t | |
61 | options are used to specify parameters for service using the respective | |
62 | protocol: | |
7a094649 KM |
63 | .TP |
64 | .I "msk, mtch" | |
65 | These arguments permit restriction of NFS services | |
66 | to a subset of the host addresses. The | |
67 | .I msk | |
1b3a818d | 68 | and |
7a094649 KM |
69 | .I mtch |
70 | are applied to the client host address as follows: | |
1b3a818d | 71 | .sp |
7a094649 KM |
72 | if (( |
73 | .I host_address | |
74 | & | |
75 | .I msk | |
76 | ) == | |
77 | .I mtch | |
78 | ) | |
79 | .br | |
80 | - service the client request | |
1b3a818d | 81 | .br |
7a094649 KM |
82 | else |
83 | .br | |
84 | - drop the request | |
85 | .TP | |
86 | .I hostadr1,... | |
87 | You may also specify zero or more specific host addresses to be accepted | |
88 | as well as ones that pass the | |
89 | .I msk, mtch | |
90 | test above. | |
91 | This may only be done for transport protocols that are connection based, such | |
92 | as TCP. | |
93 | For the internet domain, | |
94 | .I msk, mtch | |
95 | and | |
96 | .I hostadrs' | |
97 | are specified in internet | |
98 | .I dot | |
99 | notation. | |
100 | .TP | |
101 | .I numprocs | |
102 | Specifies how many servers to fork off. This may only be specified for | |
103 | non-connection based protocols such as UDP. | |
104 | .LP | |
105 | If neither | |
106 | .I \-u | |
107 | or | |
108 | .I \-t | |
109 | are specified, | |
110 | .I numprocs | |
111 | servers for UDP accepting requests from all clients are started. | |
112 | If | |
113 | .I numprocs | |
114 | is not specified, it defaults to 1. | |
115 | .LP | |
116 | For example: | |
1b3a818d | 117 | .sp |
7167345e | 118 | nfsd \-u 255.255.255.0,131.104.48.0,4 \-t 255.255.0.0,131.104.0.0,131.102.31.2 |
7a094649 KM |
119 | .IP "- " |
120 | Serves UDP and TCP transports. For UDP, | |
121 | it runs 4 daemons that accept requests | |
122 | from any client on subnet 131.104.48. | |
123 | For TCP, it accepts connections from any client on network 131.104 | |
124 | plus the client with the address 131.102.31.2. | |
125 | .LP | |
7167345e | 126 | nfsd \-u 255.255.240.0,131.104.0.0,6 \-t 0,0 |
7a094649 KM |
127 | .IP "- " |
128 | Serves UDP and TCP transports. | |
129 | For UDP, it runs 6 daemons that accept requests from clients with | |
130 | addresses in the range 131.104.0.x - 131.104.15.x. | |
131 | For TCP, it accepts connections from any client. | |
132 | .LP | |
7167345e | 133 | nfsd \-u 0,0,4 |
7a094649 KM |
134 | .IP "- " |
135 | Serves any UDP client with 4 servers, only. | |
136 | .LP | |
7167345e | 137 | nfsd 4 |
7a094649 KM |
138 | .IP "- " |
139 | Serves any UDP client with 4 servers, only. (Compatibility) | |
140 | .LP | |
141 | A server should typically run enough daemons to handle | |
142 | the maximum level of concurrency from its clients, | |
143 | typically four to six. | |
1b3a818d | 144 | .PP |
7dd5dab1 KM |
145 | .I Nfsd |
146 | listens for service requests at the port indicated in the | |
147 | .SM NFS | |
148 | server specification; see | |
1b3a818d | 149 | ``Network File System Protocol Specification, RFC1094'' |
7dd5dab1 KM |
150 | .SH SEE ALSO |
151 | .IR nfsstat (1), | |
8d25ae69 | 152 | .IR nfssvc (2), |
7dd5dab1 KM |
153 | .IR mountd (8), |
154 | .IR portmap (8) | |
7a094649 KM |
155 | .SH BUGS |
156 | The client host address restrictions specified here are unrelated to | |
157 | the mount restrictions specified in /etc/exports for | |
158 | .IR mountd (8). |