xref: /openbsd/sbin/mountd/mountd.8 (revision 1821443c)
1.\"	$OpenBSD: mountd.8,v 1.15 2003/08/08 09:34:10 jmc Exp $
2.\"	$NetBSD: mountd.8,v 1.11 1996/02/18 11:57:51 fvdl Exp $
3.\"
4.\" Copyright (c) 1989, 1991, 1993
5.\"	The Regents of the University of California.  All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. Neither the name of the University nor the names of its contributors
16.\"    may be used to endorse or promote products derived from this software
17.\"    without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29.\" SUCH DAMAGE.
30.\"
31.\"     @(#)mountd.8	8.4 (Berkeley) 4/28/95
32.\"
33.Dd April 28, 1995
34.Dt MOUNTD 8
35.Os
36.Sh NAME
37.Nm mountd
38.Nd service remote
39.Tn NFS
40mount requests
41.Sh SYNOPSIS
42.Nm mountd
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
59The options are as follows:
60.Bl -tag -width Ds
61.It Fl d
62Enable debugging mode.
63.Nm
64will not detach from the controlling terminal and will print
65debugging messages to stderr.
66.It Fl n
67Do not require that clients make mount requests from reserved ports.
68(Normally, only mount requests from reserved ports are accepted.)
69This option should only be specified if there are clients, such as PCs,
70that need it.
71The use of
72.Fl n
73is STRONGLY discouraged, as it opens up a wide range of security problems.
74.It Ar exportsfile
75The
76.Ar exportsfile
77argument specifies an alternate location
78for the exports file.
79.El
80.Pp
81When
82.Nm
83is started,
84it loads the export host addresses and options into the kernel
85using the
86.Xr mount 2
87system call.
88After changing the exports file,
89a hangup signal should be sent to the
90.Nm
91daemon
92to get it to reload the export information.
93After sending the
94.Dv SIGHUP
95(kill \-HUP `cat /var/run/mountd.pid`),
96check the syslog output to see if
97.Nm
98logged any parsing
99errors in the exports file.
100.Sh FILES
101.Bl -tag -width /var/run/mountd.pid -compact
102.It Pa /etc/exports
103list of exported filesystems
104.It Pa /var/run/mountd.pid
105PID of the currently running
106.Nm
107.El
108.Sh SEE ALSO
109.Xr nfsstat 1 ,
110.Xr exports 5 ,
111.Xr nfsd 8 ,
112.Xr portmap 8 ,
113.Xr showmount 8
114.Sh HISTORY
115The
116.Nm
117utility first appeared in
118.Bx 4.4 .
119