Bring in a transport-independent RPC (TI-RPC).
[dragonfly.git] / sbin / nfsd / nfsd.8
index ad02eea..e692213 100644 (file)
@@ -9,10 +9,6 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
@@ -30,7 +26,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    @(#)nfsd.8      8.4 (Berkeley) 3/29/95
-.\" $FreeBSD: src/sbin/nfsd/nfsd.8,v 1.12.2.3 2002/05/20 18:06:11 gordon Exp $
+.\" $FreeBSD: src/usr.sbin/nfsd/nfsd.8,v 1.24 2005/01/17 07:44:42 ru Exp $
 .\" $DragonFly: src/sbin/nfsd/nfsd.8,v 1.4 2007/11/23 23:16:36 swildner Exp $
 .\"
 .Dd March 29, 1995
 server
 .Sh SYNOPSIS
 .Nm
-.Op Fl arut
+.Op Fl ardut
 .Op Fl n Ar num_servers
 .Op Fl h Ar bindip
 .Sh DESCRIPTION
-.Nm Nfsd
-runs on a server machine to service
+The
+.Nm
+utility runs on a server machine to service
 .Tn NFS
 requests from client machines.
 At least one
@@ -65,13 +62,19 @@ The following options are available:
 Register the
 .Tn NFS
 service with
-.Xr portmap 8
+.Xr rpcbind 8
 without creating any servers.
 This option can be used along with the
 .Fl u
 or
 .Fl t
-options to re-register NFS if the portmap server is restarted.
+options to re-register NFS if the rpcbind server is restarted.
+.It Fl d
+Unregister the
+.Tn NFS
+service with
+.Xr rpcbind 8
+without creating any servers.
 .It Fl n
 Specifies how many servers to create.
 .It Fl h Ar bindip
@@ -84,9 +87,11 @@ options may be specified.
 Specifies that nfsd should bind to the wildcard IP address.
 This is the default if no
 .Fl h
-options are given.  It may also be specified in addition to any
+options are given.
+It may also be specified in addition to any
 .Fl h
-options given.  Note that NFS/UDP does not operate properly when
+options given.
+Note that NFS/UDP does not operate properly when
 bound to the wildcard IP address whether you use -a or do not use -h.
 .It Fl t
 Serve
@@ -110,8 +115,9 @@ A server should run enough daemons to handle
 the maximum level of concurrency from its clients,
 typically four to six.
 .Pp
-.Nm Nfsd
-listens for service requests at the port indicated in the
+The
+.Nm
+utility listens for service requests at the port indicated in the
 .Tn NFS
 server specification; see
 .%T "Network File System Protocol Specification" ,
@@ -126,9 +132,7 @@ is not loaded in the running kernel, it will attempt
 to load a loadable kernel module containing
 .Tn NFS
 support using
-.Xr kldload 8
-by way of
-.Xr vfsload 3 .
+.Xr kldload 2 .
 If this fails, or no
 .Tn NFS
 KLD is available,
@@ -140,41 +144,46 @@ If
 is to be run on a host with multiple interfaces or interface aliases, use
 of the
 .Fl h
-option is recommended.  If you do not use the option NFS may not respond to
-UDP packets from the same IP address they were sent to.  Use of this option
+option is recommended.
+If you do not use the option NFS may not respond to
+UDP packets from the same IP address they were sent to.
+Use of this option
 is also recommended when securing NFS exports on a firewalling machine such
 that the NFS sockets can only be accessed by the inside interface.
-.Nm Ipfw
+The
+.Nm ipfw
+utility
 would then be used to block nfs-related packets that come in on the outside
 interface.
 .Pp
+The
 .Nm
-has to be terminated with
+utility has to be terminated with
 .Dv SIGUSR1
 and cannot be killed with
 .Dv SIGTERM
 or
 .Dv SIGQUIT .
+The
 .Nm
-needs to ignore these signals in order to stay alive as long
+utility needs to ignore these signals in order to stay alive as long
 as possible during a shutdown, otherwise loopback mounts will
 not be able to unmount.
 If you have to kill
 .Nm
 just do a
 .Dq Li "kill -USR1 <PID of master nfsd>"
-.Pp
-The
-.Nm
-utility exits 0 on success, and >0 if an error occurs.
+.Sh EXIT STATUS
+.Ex -std
 .Sh SEE ALSO
 .Xr nfsstat 1 ,
+.Xr kldload 2 ,
 .Xr nfssvc 2 ,
+.Xr exports 5 ,
 .Xr ipfw 8 ,
-.Xr kldload 8 ,
 .Xr mountd 8 ,
 .Xr nfsiod 8 ,
-.Xr portmap 8
+.Xr rpcbind 8
 .Sh HISTORY
 The
 .Nm