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