2000-08-25 Ion Badulescu <ionut@cs.columbia.edu>
[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/state/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 " or " \-\-debug
59 Turn on debugging.
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 \-N " or " \-\-no-nfs-version
76 This option can be used to request that
77 .B rpc.mountd
78 do not offer certain versions of NFS. The current version of
79 .B rpc.mountd
80 can support both NFS version 2 and the newer version 3. If the
81 NFS kernel module was compiled without support for NFSv3,
82 .B rpc.mountd
83 must be invoked with the option
84 .B "\-\-no-nfs-version 3" .
85 .TP
86 .B \-P
87 Ignored (compatibility with unfsd??).
88 .TP
89 .B \-p " or " \-\-port
90 Force
91 .B rpc.mountd
92 to bind to the specified port, instead of using the random port
93 number assigned by the portmapper.
94 .TP
95 .B \-V " or " \-\-nfs-version
96 This option can be used to request that
97 .B rpc.mountd
98 offer certain versions of NFS. The current version of
99 .B rpc.mountd
100 can support both NFS version 2 and the newer version 3.
101 .TP
102 .B \-v " or " \-\-version
103 Print the version of
104 .B rpc.mountd
105 and exit.
106
107 .SH TCP_WRAPPERS SUPPORT
108 This
109 .B rpc.mountd
110 version is protected by the
111 .B tcp_wrapper
112 library. You have to give the clients access to
113 .B rpc.mountd
114 if they should be allowed to use it. To allow connects from clients of
115 the .bar.com domain you could use the following line in /etc/hosts.allow:
116
117 mountd: .bar.com
118
119 You have to use the daemon name 
120 .B mountd
121 for the daemon name (even if the binary has a different name). For the
122 client names you can only use the keyword ALL or IP addresses (NOT
123 host or domain names).
124
125 For further information please have a look at the
126 .BR tcpd (8),
127 .BR hosts_allow (5)
128 and
129 .BR hosts_access (5)
130 manual pages.
131
132 .SH SEE ALSO
133 .BR rpc.nfsd (8),
134 .BR exportfs (8),
135 .BR exports (5),
136 .BR rpc.rquotad (8).
137 .SH FILES
138 .BR /etc/exports ,
139 .BR /var/state/nfs/xtab .
140 .SH AUTHOR
141 Olaf Kirch, H. J. Lu, G. Allan Morris III, and a host of others.