usr/src/man/man1m/in.discardd.1m

   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.DISCARDD 1M "Aug 23, 2004"
   7 .SH NAME
   8 in.discardd \- UDP or TCP discard protocol service
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBin.discardd\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 FMRI \fIsvc\fR:/internet/discard: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(1M) and \fBsmf\fR(5).
  25 .sp
  26 .LP
  27 The \fBin.discardd\fR service provides the server-side of the discard protocol.
  28 This protocol is used for debugging and bandwidth measurement and is available
  29 on both TCP and UDP transports through port 9.
  30 .sp
  31 .LP
  32 The \fBin.discardd\fR service is an \fBinetd\fR(1M) \fBsmf\fR(5) delegated
  33 service. The \fBin.discardd\fR detects which transport is requested by
  34 examining the socket it is passed by the \fBinetd\fR daemon.
  35 .sp
  36 .LP
  37 The discard service simply throws away any data it receives from the client.
  38 .sp
  39 .ne 2
  40 .na
  41 \fBTCP-based service\fR
  42 .ad
  43 .RS 21n
  44 Once a connection is established, the \fBin.discardd\fR discards any data
  45 received. No response is generated. The connection remains open until the
  46 client terminates it.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fBUDP-based service\fR
  53 .ad
  54 .RS 21n
  55 The \fBin.discardd\fR listens for UDP datagrams. When a datagram is received,
  56 the server discards it. No response is sent.
  57 .RE
  58
  59 .SH ATTRIBUTES
  60 .sp
  61 .LP
  62 See \fBattributes\fR(5) for descriptions of the following attributes:
  63 .sp
  64
  65 .sp
  66 .TS
  67 box;
  68 c | c
  69 l | l .
  70 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  71 _
  72 Interface Stability     Evolving
  73 .TE
  74
  75 .SH SEE ALSO
  76 .sp
  77 .LP
  78 \fBinetd\fR(1M), \fBattributes\fR(5), \fBsmf\fR(5)
  79 .sp
  80 .LP
  81 RFC 863