xref: /netbsd-src/libexec/rpc.rstatd/rpc.rstatd.8 (revision 8e6ab8837d8d6b9198e67c1c445300b483e2f304)
1*8e6ab883Sagc.\"	$NetBSD: rpc.rstatd.8,v 1.13 2003/08/07 09:46:47 agc Exp $
2aee4b07bSmycroft.\"
3dc16f163Sbrezak.\" Copyright (c) 1985, 1991 The Regents of the University of California.
4dc16f163Sbrezak.\" All rights reserved.
5dc16f163Sbrezak.\"
6dc16f163Sbrezak.\" Redistribution and use in source and binary forms, with or without
7dc16f163Sbrezak.\" modification, are permitted provided that the following conditions
8dc16f163Sbrezak.\" are met:
9dc16f163Sbrezak.\" 1. Redistributions of source code must retain the above copyright
10dc16f163Sbrezak.\"    notice, this list of conditions and the following disclaimer.
11dc16f163Sbrezak.\" 2. Redistributions in binary form must reproduce the above copyright
12dc16f163Sbrezak.\"    notice, this list of conditions and the following disclaimer in the
13dc16f163Sbrezak.\"    documentation and/or other materials provided with the distribution.
14*8e6ab883Sagc.\" 3. Neither the name of the University nor the names of its contributors
15dc16f163Sbrezak.\"    may be used to endorse or promote products derived from this software
16dc16f163Sbrezak.\"    without specific prior written permission.
17dc16f163Sbrezak.\"
18dc16f163Sbrezak.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19dc16f163Sbrezak.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20dc16f163Sbrezak.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21dc16f163Sbrezak.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22dc16f163Sbrezak.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23dc16f163Sbrezak.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24dc16f163Sbrezak.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25dc16f163Sbrezak.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26dc16f163Sbrezak.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27dc16f163Sbrezak.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28dc16f163Sbrezak.\" SUCH DAMAGE.
29dc16f163Sbrezak.\"
30dc16f163Sbrezak.Dd June 7, 1993
31dc16f163Sbrezak.Dt RPC.RSTATD 8
32f1247650Sgarbled.Os
33dc16f163Sbrezak.Sh NAME
34c44131f3Senami.Nm rpc.rstatd ,
35c44131f3Senami.Nm rstatd
36b977f15bSjtc.Nd kernel statistics server
37dc16f163Sbrezak.Sh SYNOPSIS
38dc16f163Sbrezak.Nm /usr/libexec/rpc.rstatd
393db12eddSbgrayson.Op Ar interval
40dc16f163Sbrezak.Sh DESCRIPTION
41c44131f3Senami.Nm
42b977f15bSjtcis a server which returns performance statistics obtained from the kernel.
43e7153151SbrezakThese statistics are read using the
44b977f15bSjtc.Xr rup 1
45e7153151Sbrezakcommand.
46e7153151SbrezakThe
47c44131f3Senami.Nm
48b977f15bSjtcdaemon is normally invoked by
49b977f15bSjtc.Xr inetd 8 .
50dc16f163Sbrezak.Pp
513db12eddSbgraysonThe
523db12eddSbgrayson.Ar interval
533db12eddSbgraysonargument specifies the number of seconds that
543db12eddSbgrayson.Nm
55d6285bbfSwizshould stay active, updating its internal statistics every second.
56d6285bbfSwizIf no value is specified, 20 seconds will be used.
57d6285bbfSwizAfter
583db12eddSbgrayson.Ar interval
593db12eddSbgraysonseconds with no new RPC requests,
603db12eddSbgraysonif
613db12eddSbgrayson.Nm
623db12eddSbgraysonwas invoked from
633db12eddSbgrayson.Xr inetd 8 ,
643db12eddSbgrayson.Nm
65d6285bbfSwizexits.
66d6285bbfSwizOtherwise,
673db12eddSbgrayson.Nm
683db12eddSbgraysonloops, becoming dormant until it receives a new RPC
693db12eddSbgraysonrequest, and staying active until
703db12eddSbgrayson.Ar interval
713db12eddSbgraysonseconds pass with no new requests.
723db12eddSbgrayson.Pp
73c44131f3Senami.Nm
74b977f15bSjtcuses an RPC protocol defined in
75b977f15bSjtc.Pa /usr/include/rpcsvc/rstat.x .
76dc16f163Sbrezak.Sh SEE ALSO
77dc16f163Sbrezak.Xr rup 1 ,
78dc16f163Sbrezak.Xr inetd 8
79