Updated to nfs-utils 0.1.1.
[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 "31 May 1999"
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 .BR rpc.mountd 's
52 UMOUNT procedure. And two, if a client reboots without notifying
53 .BR rpc.mountd ,
54 a stale entry will remain in
55 .BR rmtab .
56 .SH OPTIONS
57 .TP
58 .\" This file isn't touched by mountd at all--even though it
59 .\" accepts the option.
60 .\" .BR \-f " or " \-\-exports-file
61 .\" This option specifies the exports file, listing the clients that this
62 .\" server is prepared to serve and parameters to apply to each
63 .\" such mount (see
64 .\" .BR exports (5)).
65 .\" By default, export information is read from
66 .\" .IR /etc/exports .
67 .TP
68 .BR \-N " or " \-\-no-nfs-version
69 This option can be used to request that
70 .B rpc.mountd
71 does not offer certain versions of NFS. The current version of
72 .B rpc.mountd
73 can support both NFS version 2 and the newer version 3. If the
74 NFS kernel module was compiled without support for NFSv3,
75 .B rpc.mountd
76 must be invoked with the option
77 .BR "\-\-no-nfs-version 3" .
78 .TP
79 .BR \-v " or " \-\-version
80 Print the version of
81 .B rpc.mountd
82 and exit.
83 .SH SEE ALSO
84 .BR rpc.nfsd (8),
85 .BR exportfs (8),
86 .BR exports (5),
87 .BR rpc.rquotad (8).
88 .SH FILES
89 .BR /etc/exports ,
90 .BR /var/state/nfs/xtab .
91 .SH AUTHOR
92 Olaf Kirch, H. J. Lu, G. Allan Morris III, and a host of others.