4 .\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de>
5 .\" Modified by Paul Clements, 2004.
6 .TH rpc.mountd 8 "31 Aug 2004"
8 rpc.mountd \- NFS mount daemon
10 .BI "/usr/sbin/rpc.mountd [" options "]"
14 program implements the NFS mount protocol. When receiving a MOUNT
15 request from an NFS client, it checks the request against the list of
16 currently exported file systems. If the client is permitted to mount
19 obtains a file handle for requested directory and returns it to
21 .SS Exporting NFS File Systems
22 Making file systems available to NFS clients is called
25 Usually, a file system and the hosts it should be made available to
30 whenever the system is booted. The
32 command makes export information available to both the kernel NFS
37 Alternatively, you can export individual directories temporarily
43 For every mount request received from an NFS client,
47 file. When receiving an unmount request, that entry is removed.
49 However, this file is mostly ornamental. One, the client can continue
50 to use the file handle even after calling
52 UMOUNT procedure. And two, if a client reboots without notifying
54 a stale entry will remain in
58 .B \-d kind " or " \-\-debug kind
59 Turn on debugging. Valid kinds are: all, auth, call, general and parse.
61 .B \-F " or " \-\-foreground
62 Run in foreground (do not daemonize)
64 .B \-f " or " \-\-exports-file
65 This option specifies the exports file, listing the clients that this
66 server is prepared to serve and parameters to apply to each
69 By default, export information is read from
72 .B \-h " or " \-\-help
73 Display usage message.
75 .B \-o num " or " \-\-descriptors num
76 Set the limit of the number of open file descriptors to num. The
77 default is to leave the limit unchanged.
79 .B \-N " or " \-\-no-nfs-version
80 This option can be used to request that
82 do not offer certain versions of NFS. The current version of
84 can support both NFS version 2 and the newer version 3. If the
85 NFS kernel module was compiled without support for NFSv3,
87 must be invoked with the option
88 .B "\-\-no-nfs-version 3" .
90 .B \-n " or " \-\-no-tcp
91 Don't advertise TCP for mount.
94 Ignored (compatibility with unfsd??).
96 .B \-p " or " \-\-port num
99 to bind to the specified port num, instead of using the random port
100 number assigned by the portmapper.
102 .B \-H " or " \-\-ha-callout prog
103 Specify a high availability callout program, which will receive callouts
104 for all client mount and unmount requests. This allows
106 to be used in a High Availability NFS (HA-NFS) environment. This callout is not
107 needed (and should not be used) with 2.6 and later kernels (instead,
108 mount the nfsd filesystem on
111 The program will be called with 4 arguments.
116 depending on the reason for the callout.
117 The second will be the name of the client performing the mount.
118 The third will be the path that the client is mounting.
119 The last is the number of concurrent mounts that we believe the client
122 .BI "\-P," "" " \-\-state\-directory\-path " directory
123 specify a directory in which to place statd state information.
124 If this option is not specified the default of
128 .BR "\-t N" " or " "\-\-num\-threads=N"
129 This option specifies the number of worker threads that rpc.mountd
130 spawns. The default is 1 thread, which is probably enough. More
131 threads are usually only needed for NFS servers which need to handle
132 mount storms of hundreds of NFS mounts in a few seconds, or when
133 your DNS server is slow or unreliable.
135 .B \-V " or " \-\-nfs-version
136 This option can be used to request that
138 offer certain versions of NFS. The current version of
140 can support both NFS version 2 and the newer version 3.
142 .B \-v " or " \-\-version
147 .SH TCP_WRAPPERS SUPPORT
150 version is protected by the
152 library. You have to give the clients access to
154 if they should be allowed to use it. To allow connects from clients of
155 the .bar.com domain you could use the following line in /etc/hosts.allow:
159 You have to use the daemon name
161 for the daemon name (even if the binary has a different name).
163 For further information please have a look at the
176 .BR /var/lib/nfs/xtab .
178 Olaf Kirch, H. J. Lu, G. Allan Morris III, and a host of others.