share/man/man8/in.chargend.8

   1 '\" te
   2 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH IN.CHARGEND 8 "Aug 23, 2004"
   7 .SH NAME
   8 in.chargend \- UDP or TCP character generator service daemon
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBin.chargend\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 FMRI \fIsvc\fR:/internet/chargen:default
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 FMRI stands for Fault Management Resource Identifier. It is used to identify
  24 resources managed by the Fault Manager. See \fBfmd\fR(8) and \fBsmf\fR(5).
  25 .sp
  26 .LP
  27 The \fBin.chargend\fR service provides the server-side of the
  28 character-generator protocol. This protocol is used for debugging and bandwidth
  29 measurement and is available on both TCP and UDP transports, through port 19.
  30 .sp
  31 .LP
  32 The in.chargend service is an \fBinetd\fR(8) \fBsmf\fR(5) delegated service.
  33 The \fBin.chargend\fR detects which transport is requested by examining the
  34 socket it is passed by the \fBinetd\fR daemon.
  35 .sp
  36 .ne 2
  37 .na
  38 \fBTCP-based service\fR
  39 .ad
  40 .RS 21n
  41 Once a connection is established, the \fBin.chargend\fR generates a stream of
  42 data. Any data received is discarded. The server generates data until the
  43 client program terminates the connection. Note that the data flow is limited by
  44 TCP flow control mechanisms.
  45 .RE
  46
  47 .sp
  48 .ne 2
  49 .na
  50 \fBUDP-based service\fR
  51 .ad
  52 .RS 21n
  53 The \fBin.chargend\fR listens for UDP datagrams. When a datagram is received,
  54 the server generates a UDP datagram in response containing a random number of
  55 ASCII characters (ranging from 0 to 512 characters). Any received data is
  56 ignored.
  57 .RE
  58
  59 .sp
  60 .LP
  61 The \fBin.chargend\fR data consists of a pattern of 72 character lines
  62 containing the printable, 7-bit ASCII characters. Each line is terminated with
  63 a carriage return and a line feed character.
  64 .SH ATTRIBUTES
  65 .sp
  66 .LP
  67 See \fBattributes\fR(5) for descriptions of the following attributes:
  68 .sp
  69
  70 .sp
  71 .TS
  72 box;
  73 c | c
  74 l | l .
  75 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  76 _
  77 Interface Stability     Evolving
  78 .TE
  79
  80 .SH SEE ALSO
  81 .sp
  82 .LP
  83 \fBinetd\fR(8), \fBattributes\fR(5), \fBsmf\fR(5)
  84 .sp
  85 .LP
  86 RFC 864