xref: /freebsd/sbin/nfsiod/nfsiod.8 (revision 8657581bfd0e8dceb5b3c485d666e9c18b4d6fdd)
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
337f3dea24SPeter Wemm.\" $FreeBSD$
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
447c7fb079SRuslan Ermilov.Nm
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:
566ca76744SPhilippe Charnier.Bl -tag -width indent
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
656ca76744SPhilippe Charnier.Nm
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
718570fd2aSGuy Helmer.Xr kldload 8
72d599144dSGarrett Wollmanby way of
73d599144dSGarrett Wollman.Xr vfsload 3 .
74d599144dSGarrett WollmanIf this fails, or no
75d599144dSGarrett Wollman.Tn NFS
768570fd2aSGuy HelmerKLD was available,
776ca76744SPhilippe Charnier.Nm
78d599144dSGarrett Wollmanexits with an error.
79d599144dSGarrett Wollman.Pp
808fae3551SRodney W. GrimesThe
816ca76744SPhilippe Charnier.Nm
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 ,
868570fd2aSGuy Helmer.Xr kldload 8 ,
878fae3551SRodney W. Grimes.Xr mountd 8 ,
882a2d4405SMatthew Dillon.Xr nfsd 8 ,
898657581bSMaxim Sobolev.Xr rpcbind 8
908fae3551SRodney W. Grimes.Sh HISTORY
918fae3551SRodney W. GrimesThe
926ca76744SPhilippe Charnier.Nm
93c0b0bcf4SMike Pritchardutility first appeared in
94c0b0bcf4SMike Pritchard.Bx 4.4 .
95