1cf92969a6dd86506d96d03a58d9926de53e2fbd
[nfs-utils.git] / utils / nfsd / nfsd.man
1 .\"
2 .\" nfsd(8)
3 .\"
4 .\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de>
5 .TH rpc.nfsd 8 "7 Aug 2006"
6 .SH NAME
7 rpc.nfsd \- NFS server process
8 .SH SYNOPSIS
9 .BI "/usr/sbin/rpc.nfsd [" options "]" " "nproc
10 .SH DESCRIPTION
11 The
12 .B rpc.nfsd
13 program implements the user level part of the NFS service. The
14 main functionality is handled by the
15 .B nfsd
16 kernel module. The user space program merely specifies what sort of sockets
17 the kernel service should listen on, what NFS versions it should support, and
18 how many kernel threads it should use.
19 .P
20 The
21 .B rpc.mountd
22 server provides an ancillary service needed to satisfy mount requests
23 by NFS clients.
24 .SH OPTIONS
25 .TP
26 .B \-d " or " \-\-debug
27 enable logging of debugging messages
28 .TP
29 .B \-H " or " \-\-host  hostname
30 specify a particular hostname (or address) that NFS requests will
31 be accepted on. By default,
32 .B rpc.nfsd
33 will accept NFS requests on all known network addresses.
34 Note that
35 .B lockd
36 (which performs file locking services for NFS) may still accept
37 request on all known network addresses.  This may change in future
38 releases of the Linux Kernel.
39 .TP
40 .B \-p " or " \-\-port  port
41 specify a different port to listen on for NFS requests. By default,
42 .B rpc.nfsd
43 will listen on port 2049.
44 .TP
45 .B \-N " or " \-\-no-nfs-version vers
46 This option can be used to request that 
47 .B rpc.nfsd
48 does not offer certain versions of NFS. The current version of
49 .B rpc.nfsd
50 can support both NFS version 2,3 and the newer version 4.
51 .TP
52 .B \-s " or " \-\-syslog
53 By default,
54 .B rpc.nfsd
55 logs error messages (and debug messages, if enabled) to stderr. This option makes 
56 .B rpc.nfsd
57 log these messages to syslog instead. Note that errors encountered during
58 option processing will still be logged to stderr regardless of this option.
59 .TP
60 .B \-T " or " \-\-no-tcp
61 Disable 
62 .B rpc.nfsd 
63 from accepting TCP connections from clients.
64 .TP
65 .B \-U " or " \-\-no-udp
66 Disable
67 .B rpc.nfsd
68 from accepting UDP connections from clients.
69 .TP
70 .I nproc
71 specify the number of NFS server threads. By default, just one
72 thread is started. However, for optimum performance several threads
73 should be used. The actual figure depends on the number of and the work
74 load created by the NFS clients, but a useful starting point is
75 8 threads. Effects of modifying that number can be checked using
76 the
77 .BR nfsstat (8)
78 program.
79 .P
80 Note that if the NFS server is already running, then the options for
81 specifying host, port, and protocol will be ignored.  The number of
82 processes given will be the only option considered, and the number of
83 active
84 .B nfsd
85 processes will be increased or decreased to match this number.
86 In particular
87 .B rpc.nfsd 0
88 will stop all threads and thus close any open connections.
89
90 .SH NOTES
91 If the program is built with TI-RPC support, it will enable any protocol and
92 address family combinations that are marked visible in the
93 .B netconfig
94 database.
95
96 .SH SEE ALSO
97 .BR rpc.mountd (8),
98 .BR exports (5),
99 .BR exportfs (8),
100 .BR rpc.rquotad (8),
101 .BR nfsstat (8),
102 .BR netconfig(5).
103 .SH AUTHOR
104 Olaf Kirch, Bill Hawes, H. J. Lu, G. Allan Morris III,
105 and a host of others.