xref: /netbsd-src/usr.sbin/mountd/mountd.8 (revision f648d12d47727113ad5330b0753bb2f2ef8e1045)
1.\"	$NetBSD: mountd.8,v 1.26 2003/09/07 16:22:25 wiz Exp $
2.\"
3.\" Copyright (c) 1989, 1991, 1993
4.\"	The Regents of the University of California.  All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\" 3. Neither the name of the University nor the names of its contributors
15.\"    may be used to endorse or promote products derived from this software
16.\"    without specific prior written permission.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE.
29.\"
30.\"     @(#)mountd.8	8.4 (Berkeley) 4/28/95
31.\"
32.Dd April 28, 1995
33.Dt MOUNTD 8
34.Os
35.Sh NAME
36.Nm mountd
37.Nd service remote
38.Tn NFS
39mount requests
40.Sh SYNOPSIS
41.Nm
42.Op Fl P Ar policy
43.Op Fl dn
44.Op Ar exportsfile
45.Sh DESCRIPTION
46.Nm
47is the server for
48.Tn NFS
49mount requests from other client machines.
50.Nm
51listens for service requests at the port indicated in the
52.Tn NFS
53server specification; see
54.%T "Network File System Protocol Specification" ,
55RFC 1094, Appendix A and
56.%T "NFS: Network File System Version 3 Protocol Specification" ,
57Appendix I.
58.Pp
59Options and operands available for
60.Nm mountd :
61.Bl -tag -width Ds
62.It Fl P Ar policy
63IPsec
64.Ar policy
65string,
66as described in
67.Xr ipsec_set_policy 3 .
68Multiple IPsec policy strings may be specified by using a semicolon as
69a separator. If conflicting policy strings are found in a single line,
70the last string will take effect. If an invalid IPsec policy string is used
71.Nm
72logs an error message and terminates itself.
73.It Fl d
74Enable debugging mode.
75.Nm
76will not detach from the controlling terminal and will print
77debugging messages to stderr.
78.It Fl n
79This flag used to indicate that clients were required to make requests
80from reserved ports, but it is now no longer functional. It
81is only provided for backwards compatibility. Requests
82are checked for reserved ports on a per-export basis, see
83.Xr exports 5 .
84.It Ar exportsfile
85The
86.Ar exportsfile
87argument specifies an alternative location
88for the exports file.
89.El
90.Pp
91When
92.Nm
93is started,
94it loads the export host addresses and options into the kernel
95using the
96.Xr mount 2
97system call.
98After changing the exports file,
99a hangup signal should be sent to the
100.Nm
101daemon to get it to reload the export information.
102After sending the SIGHUP
103(kill \-s HUP `cat /var/run/mountd.pid`),
104check the syslog output to see if
105.Nm
106logged any parsing errors in the exports file.
107.Pp
108After receiving SIGTERM,
109.Nm
110sends a broadcast request to remove the mount list from all the clients.
111This can take a long time, since the broadcast request waits for each
112client to respond.
113.Sh FILES
114.Bl -tag -width /var/run/mountd.pid -compact
115.It Pa /etc/exports
116the list of exported filesystems
117.It Pa /var/run/mountd.pid
118the pid of the currently running
119.Nm
120.El
121.Sh SEE ALSO
122.Xr nfsstat 1 ,
123.Xr exports 5 ,
124.Xr nfsd 8 ,
125.Xr rpcbind 8 ,
126.Xr showmount 8
127.Sh HISTORY
128The
129.Nm
130utility first appeared in
131.Bx 4.4 .
132