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