xref: /freebsd/sbin/nfsiod/nfsiod.8 (revision c0b0bcf4d39fe41ec1317d807a407284b7774f59)
18fae3551SRodney W. Grimes.\" Copyright (c) 1989, 1991, 1993
28fae3551SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
38fae3551SRodney W. Grimes.\"
48fae3551SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
58fae3551SRodney W. Grimes.\" modification, are permitted provided that the following conditions
68fae3551SRodney W. Grimes.\" are met:
78fae3551SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
88fae3551SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
98fae3551SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
108fae3551SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
118fae3551SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
128fae3551SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
138fae3551SRodney W. Grimes.\"    must display the following acknowledgement:
148fae3551SRodney W. Grimes.\"	This product includes software developed by the University of
158fae3551SRodney W. Grimes.\"	California, Berkeley and its contributors.
168fae3551SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
178fae3551SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
188fae3551SRodney W. Grimes.\"    without specific prior written permission.
198fae3551SRodney W. Grimes.\"
208fae3551SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
218fae3551SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
228fae3551SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
238fae3551SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
248fae3551SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
258fae3551SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
268fae3551SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
278fae3551SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
288fae3551SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
298fae3551SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
308fae3551SRodney W. Grimes.\" SUCH DAMAGE.
318fae3551SRodney W. Grimes.\"
32d599144dSGarrett Wollman.\"     From: @(#)nfsiod.8	8.2 (Berkeley) 2/22/94
33c0b0bcf4SMike Pritchard.\"	$Id: nfsiod.8,v 1.2 1994/09/22 22:16:59 wollman Exp $
348fae3551SRodney W. Grimes.\"
35d599144dSGarrett Wollman.Dd September 22, 1994
368fae3551SRodney W. Grimes.Dt NFSIOD 8
378fae3551SRodney W. Grimes.Os
388fae3551SRodney W. Grimes.Sh NAME
398fae3551SRodney W. Grimes.Nm nfsiod
408fae3551SRodney W. Grimes.Nd local
418fae3551SRodney W. Grimes.Tn NFS
428fae3551SRodney W. Grimesasynchronous I/O server
438fae3551SRodney W. Grimes.Sh SYNOPSIS
448fae3551SRodney W. Grimes.Nm nfsiod
458fae3551SRodney W. Grimes.Op Fl n Ar num_servers
468fae3551SRodney W. Grimes.Sh DESCRIPTION
478fae3551SRodney W. Grimes.Nm Nfsiod
488fae3551SRodney W. Grimesruns on an
498fae3551SRodney W. Grimes.Tn NFS
508fae3551SRodney W. Grimesclient machine to service asynchronous I/O requests to its server.
518fae3551SRodney W. GrimesIt improves performance but is not required for correct operation.
528fae3551SRodney W. Grimes.Pp
538fae3551SRodney W. GrimesUnless otherwise specified, a single server is started.
548fae3551SRodney W. Grimes.Pp
558fae3551SRodney W. GrimesThe options are as follows:
568fae3551SRodney W. Grimes.Bl -tag -width Ds
578fae3551SRodney W. Grimes.It Fl n
588fae3551SRodney W. GrimesSpecify how many servers are to be started.
598fae3551SRodney W. Grimes.El
608fae3551SRodney W. Grimes.Pp
618fae3551SRodney W. GrimesA client should run enough daemons to handle its maximum
628fae3551SRodney W. Grimeslevel of concurrency, typically four to six.
638fae3551SRodney W. Grimes.Pp
64d599144dSGarrett WollmanIf
65d599144dSGarrett Wollman.Nm nfsiod
66d599144dSGarrett Wollmandetects that the running kernel does not include
67d599144dSGarrett Wollman.Tn NFS
68d599144dSGarrett Wollmansupport, it will attempt to load a loadable kernel module containing
69d599144dSGarrett Wollman.Tn NFS
70d599144dSGarrett Wollmancode, using
71d599144dSGarrett Wollman.Xr modload 8
72d599144dSGarrett Wollmanby way of
73d599144dSGarrett Wollman.Xr vfsload 3 .
74d599144dSGarrett WollmanIf this fails, or no
75d599144dSGarrett Wollman.Tn NFS
76d599144dSGarrett WollmanLKM was available,
77d599144dSGarrett Wollman.Nm nfsiod
78d599144dSGarrett Wollmanexits with an error.
79d599144dSGarrett Wollman.Pp
808fae3551SRodney W. GrimesThe
818fae3551SRodney W. Grimes.Nm nfsiod
828fae3551SRodney W. Grimesutility exits 0 on success, and >0 if an error occurs.
838fae3551SRodney W. Grimes.Sh SEE ALSO
848fae3551SRodney W. Grimes.Xr nfsstat 1 ,
858fae3551SRodney W. Grimes.Xr nfssvc 2 ,
86d599144dSGarrett Wollman.Xr modload 8 ,
878fae3551SRodney W. Grimes.Xr mountd 8 ,
888fae3551SRodney W. Grimes.Xr portmap 8
898fae3551SRodney W. Grimes.Sh HISTORY
908fae3551SRodney W. GrimesThe
918fae3551SRodney W. Grimes.Nm nfsiod
92c0b0bcf4SMike Pritchardutility first appeared in
93c0b0bcf4SMike Pritchard.Bx 4.4 .
94