See Changelog
[nfs-utils.git] / utils / mountd / mountd.man
1 .\"
2 .\" mountd(8)
3 .\"
4 .\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de>
5 .TH rpc.mountd 8 "25 Aug 2000"
6 .SH NAME
7 rpc.mountd \- NFS mount daemon
8 .SH SYNOPSIS
9 .BI "/usr/sbin/rpc.mountd [" options "]"
10 .SH DESCRIPTION
11 The
12 .B rpc.mountd
13 program implements the NFS mount protocol. When receiving a MOUNT
14 request from an NFS client, it checks the request against the list of
15 currently exported file systems. If the client is permitted to mount
16 the file system,
17 .B rpc.mountd
18 obtains a file handle for requested directory and returns it to
19 the client.
20 .SS Exporting NFS File Systems
21 Making file systems available to NFS clients is called
22 .IR exporting .
23 .P
24 Usually, a file system and the hosts it should be made available to
25 are listed in the
26 .B /etc/exports
27 file, and invoking
28 .B exportfs -a
29 whenever the system is booted. The
30 .BR exportfs (8)
31 command makes export information available to both the kernel NFS
32 server module and the
33 .B rpc.mountd
34 daemon.
35 .P
36 Alternatively, you can export individual directories temporarily 
37 using
38 .BR exportfs 's
39 .IB host : /directory
40 syntax.
41 .SS The rmtab File
42 For every mount request received from an NFS client,
43 .B rpc.mountd
44 adds an entry to the
45 .B /var/lib/nfs/rmtab
46 file. When receiving an unmount request, that entry is removed.
47 user level part of the NFS service.
48 .P
49 However, this file is mostly ornamental. One, the client can continue
50 to use the file handle even after calling
51 .B rpc.mountd 's
52 UMOUNT procedure. And two, if a client reboots without notifying
53 .B rpc.mountd ,
54 a stale entry will remain in
55 .BR rmtab .
56 .SH OPTIONS
57 .TP
58 .B \-d kind " or " \-\-debug kind
59 Turn on debugging. Valid kinds are: all, auth, call, general and parse.
60 .TP
61 .B \-F " or " \-\-foreground
62 Run in foreground (do not daemonize)
63 .TP
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
67 such mount (see
68 .BR exports (5)).
69 By default, export information is read from
70 .IR /etc/exports .
71 .TP
72 .B \-h " or " \-\-help
73 Display usage message.
74 .TP
75 .B \-o num " or " \-\-descriptors num
76 Set the limit of the number of open file descriptors to num. The
77 default is 256.
78 .TP
79 .B \-N " or " \-\-no-nfs-version
80 This option can be used to request that
81 .B rpc.mountd
82 do not offer certain versions of NFS. The current version of
83 .B rpc.mountd
84 can support both NFS version 2 and the newer version 3. If the
85 NFS kernel module was compiled without support for NFSv3,
86 .B rpc.mountd
87 must be invoked with the option
88 .B "\-\-no-nfs-version 3" .
89 .TP
90 .B \-n " or " \-\-no-tcp
91 Don't advertise TCP for mount.
92 .TP
93 .B \-P
94 Ignored (compatibility with unfsd??).
95 .TP
96 .B \-p " or " \-\-port num
97 Force
98 .B rpc.mountd
99 to bind to the specified port num, instead of using the random port
100 number assigned by the portmapper.
101 .TP
102 .B \-V " or " \-\-nfs-version
103 This option can be used to request that
104 .B rpc.mountd
105 offer certain versions of NFS. The current version of
106 .B rpc.mountd
107 can support both NFS version 2 and the newer version 3.
108 .TP
109 .B \-v " or " \-\-version
110 Print the version of
111 .B rpc.mountd
112 and exit.
113
114 .SH TCP_WRAPPERS SUPPORT
115 This
116 .B rpc.mountd
117 version is protected by the
118 .B tcp_wrapper
119 library. You have to give the clients access to
120 .B rpc.mountd
121 if they should be allowed to use it. To allow connects from clients of
122 the .bar.com domain you could use the following line in /etc/hosts.allow:
123
124 mountd: .bar.com
125
126 You have to use the daemon name 
127 .B mountd
128 for the daemon name (even if the binary has a different name).
129
130 For further information please have a look at the
131 .BR tcpd (8)
132 and
133 .BR hosts_access (5)
134 manual pages.
135
136 .SH SEE ALSO
137 .BR rpc.nfsd (8),
138 .BR exportfs (8),
139 .BR exports (5),
140 .BR rpc.rquotad (8).
141 .SH FILES
142 .BR /etc/exports ,
143 .BR /var/lib/nfs/xtab .
144 .SH AUTHOR
145 Olaf Kirch, H. J. Lu, G. Allan Morris III, and a host of others.