xref: /freebsd/sbin/nfsiod/nfsiod.8 (revision 51e16cb8fc536913f490ac6bc9c17e92ebd0411b)
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.
12*fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
138fae3551SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
148fae3551SRodney W. Grimes.\"    without specific prior written permission.
158fae3551SRodney W. Grimes.\"
168fae3551SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
178fae3551SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
188fae3551SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
198fae3551SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
208fae3551SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
218fae3551SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
228fae3551SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
238fae3551SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
248fae3551SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
258fae3551SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
268fae3551SRodney W. Grimes.\" SUCH DAMAGE.
278fae3551SRodney W. Grimes.\"
2848660452SRuslan Ermilov.Dd December 26, 2009
298fae3551SRodney W. Grimes.Dt NFSIOD 8
308fae3551SRodney W. Grimes.Os
318fae3551SRodney W. Grimes.Sh NAME
328fae3551SRodney W. Grimes.Nm nfsiod
338fae3551SRodney W. Grimes.Nd local
348fae3551SRodney W. Grimes.Tn NFS
358fae3551SRodney W. Grimesasynchronous I/O server
368fae3551SRodney W. Grimes.Sh SYNOPSIS
377c7fb079SRuslan Ermilov.Nm
388fae3551SRodney W. Grimes.Op Fl n Ar num_servers
398fae3551SRodney W. Grimes.Sh DESCRIPTION
40e1205e80SPhilippe CharnierThe
41e1205e80SPhilippe Charnier.Nm
4248660452SRuslan Ermilovutility controls the maximum number of
4348660452SRuslan Ermilov.Nm
4448660452SRuslan Ermilovkernel processes which run on an
458fae3551SRodney W. Grimes.Tn NFS
468fae3551SRodney W. Grimesclient machine to service asynchronous I/O requests to its server.
4748660452SRuslan ErmilovHaving
4848660452SRuslan Ermilov.Nm
4948660452SRuslan Ermilovkernel processes
5048660452SRuslan Ermilovimproves performance but is not required for correct operation.
518fae3551SRodney W. Grimes.Pp
5248660452SRuslan ErmilovThe option is as follows:
536ca76744SPhilippe Charnier.Bl -tag -width indent
548fae3551SRodney W. Grimes.It Fl n
5548660452SRuslan ErmilovSpecify how many processes are permitted to be started.
568fae3551SRodney W. Grimes.El
578fae3551SRodney W. Grimes.Pp
5848660452SRuslan ErmilovWithout an option,
5948660452SRuslan Ermilov.Nm
6048660452SRuslan Ermilovdisplays the current settings.
6148660452SRuslan ErmilovA client should allow enough number of processes 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
6848660452SRuslan Ermilovsupport, it will attempt to load a kernel module containing
69d599144dSGarrett Wollman.Tn NFS
70d599144dSGarrett Wollmancode, using
715965373eSMaxime Henrion.Xr kldload 2 .
72d599144dSGarrett WollmanIf this fails, or no
73d599144dSGarrett Wollman.Tn NFS
7448660452SRuslan Ermilovmodule was available,
756ca76744SPhilippe Charnier.Nm
76d599144dSGarrett Wollmanexits with an error.
77a866e170SRuslan Ermilov.Sh EXIT STATUS
78d628d776SRuslan Ermilov.Ex -std
798fae3551SRodney W. Grimes.Sh SEE ALSO
808fae3551SRodney W. Grimes.Xr nfsstat 1 ,
815965373eSMaxime Henrion.Xr kldload 2 ,
828fae3551SRodney W. Grimes.Xr nfssvc 2 ,
838fae3551SRodney W. Grimes.Xr mountd 8 ,
842a2d4405SMatthew Dillon.Xr nfsd 8 ,
858657581bSMaxim Sobolev.Xr rpcbind 8
868fae3551SRodney W. Grimes.Sh HISTORY
878fae3551SRodney W. GrimesThe
886ca76744SPhilippe Charnier.Nm
89c0b0bcf4SMike Pritchardutility first appeared in
90c0b0bcf4SMike Pritchard.Bx 4.4 .
9148660452SRuslan Ermilov.Pp
9248660452SRuslan ErmilovStarting with
9348660452SRuslan Ermilov.Fx 5.0 ,
9448660452SRuslan Ermilovthe utility no longer starts daemons, but only serves as a vfs
9548660452SRuslan Ermilovloader and
9648660452SRuslan Ermilov.Xr sysctl 3
9748660452SRuslan Ermilovwrapper.
98