usr/src/man/man7ipp/tswtclmt.7ipp

   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 TSWTCLMT 7IPP "Sep 29, 2004"
   7 .SH NAME
   8 tswtclmt \- Time Sliding Window Three Conformance Level Meter
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 The Time Sliding Window Three Conformance level meter (\fBtswtcl\fR) meters a
  13 traffic stream and determines the conformance level of its packets.
  14 .sp
  15 .LP
  16 Packets are deemed to belong to one of the three levels, Red, Yellow or Green,
  17 depending on the committed and peak rate.
  18 .sp
  19 .LP
  20 The meter provides an estimate of the running average bandwidth. It takes into
  21 account burstiness and smoothes out its estimate to  approximate the
  22 longer-term measured sending rate of the traffic  stream.
  23 .sp
  24 .LP
  25 The estimated bandwidth approximates the running average bandwidth of the
  26 traffic stream over a specific window (time interval). \fBtswtcl\fR estimates
  27 the average bandwidth using a time-based estimator. When a packet arrives for a
  28 class, \fBtswtcl\fR re-computes the average rate by using the rate in the last
  29 window (time interval) and the size of the arriving packet. The window is then
  30 slid to start at the current time (the packet arrival time). If the computed
  31 rate is less than the committed configuration parameter, the packet is deemed
  32 Green; else if the rate is less than the peak rate, it is Yellow; else Red. To
  33 avoid dropping multiple packets within a TCP window, \fBtswtcl\fR
  34 probabilistically assigns one of the three conformance level to the packet.
  35 .SH STATISTICS
  36 .sp
  37 .LP
  38 The \fBtswtcl\fR module exports global and per-class statistics through kstat:
  39 .sp
  40 .LP
  41 Global statistics:
  42 .sp
  43 .in +2
  44 .nf
  45 module: tswtclmt                         instance: <action id>
  46   name: tswtclmt statistics              class <action name>
  47         green_bits                      <number of bit in green>
  48         green_packets                   <number of packets in green>
  49         red_bits                        <number of bits in red>
  50         red_packets                     <number of packets in red>
  51         yellow_bits                     <number of bits in yellow>
  52         yellow_packets                  <number of packets in yellow>
  53 .fi
  54 .in -2
  55
  56 .SH FILES
  57 .sp
  58 .ne 2
  59 .na
  60 \fB\fB/kernel/ipp/sparcv9/tswtclmt\fR\fR
  61 .ad
  62 .sp .6
  63 .RS 4n
  64 64-bit module (SPARC only.)
  65 .RE
  66
  67 .SH SEE ALSO
  68 .sp
  69 .LP
  70 \fBipqosconf\fR(1M), \fBdlcosmk\fR(7ipp), \fBdscpmk\fR(7ipp),
  71 \fBflowacct\fR(7ipp), \fBipqos\fR(7ipp), \fBipgpc\fR(7ipp), \fBtokenmt\fR(7ipp)
  72 .sp
  73 .LP
  74 \fIRFC 2859, A Time Sliding Window Three Colour Marker (TSWTCM)\fR W. Fang, N.
  75 Seddigh, B. Nandy \(em The Internet Society, 2000