xref: /freebsd/usr.sbin/mountd/mountd.8 (revision 5ebc7e6281887681c3a348a5a4c902e262ccd656)
1.\" Copyright (c) 1989, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\"    must display the following acknowledgement:
14.\"	This product includes software developed by the University of
15.\"	California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\"    may be used to endorse or promote products derived from this software
18.\"    without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\"     From: @(#)mountd.8	8.1 (Berkeley) 6/9/93
33.\"	$Id: mountd.8,v 1.2 1994/09/22 22:16:49 wollman Exp $
34.\"
35.Dd September 22, 1994
36.Dt MOUNTD 8
37.Os
38.Sh NAME
39.Nm mountd
40.Nd service remote
41.Tn NFS
42mount requests
43.Sh SYNOPSIS
44.Nm /sbin/mountd
45.Op Fl n
46.Op Ar exportsfile
47.Sh DESCRIPTION
48.Xr Mountd
49is the server for
50.Tn NFS
51mount requests from other client machines.
52.Xr Mountd
53listens for service requests at the port indicated in the
54.Tn NFS
55server specification; see
56.%T "Network File System Protocol Specification" ,
57RFC1094.
58.Pp
59Options and operands available for
60.Nm mountd :
61.Bl -tag -width Ds
62.It Fl n
63The
64.Fl n
65option allows non-root mount requests to be served.
66This should only be specified if there are clients such as PC's,
67that require it.
68.It Ar exportsfile
69The
70.Ar exportsfile
71argument specifies an alternate location
72for the exports file.
73.El
74.Pp
75When mountd is started,
76it loads the export host addresses and options into the kernel
77using the mount(2) system call.
78After changing the exports file,
79a hangup signal should be sent to the mountd daemon
80to get it to reload the export information.
81After sending the SIGHUP
82(kill -HUP `cat /var/run/mountd.pid`),
83check the syslog output to see if mountd logged any parsing
84errors in the exports file.
85.Pp
86If
87.Nm mountd
88detects that the running kernel does not include
89.Tn NFS
90support, it will attempt to load a loadable kernel module containing
91.Tn NFS
92code, using
93.Xr modload 8
94by way of
95.Xr vfsload 3 .
96If this fails, or no
97.Tn NFS
98LKM was available,
99.Nm mountd
100exits with an error.
101.Sh FILES
102.Bl -tag -width /var/run/mountd.pid -compact
103.It Pa /etc/exports
104the list of exported filesystems
105.It Pa /var/run/mountd.pid
106the pid of the currently running mountd
107.It Pa /var/db/mountdtab
108the current list of remote mounted filesystems
109.El
110.Sh SEE ALSO
111.Xr nfsstat 1 ,
112.Xr exports 5 ,
113.Xr modload 8 ,
114.Xr nfsd 8 ,
115.Xr portmap 8 ,
116.Xr showmount 8
117.Sh HISTORY
118The
119.Nm mountd
120utility first appeared in 4.4BSD.
121