From patchwork Tue Jan 24 13:18:33 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Eric Dumazet X-Patchwork-Id: 137553 X-Patchwork-Delegate: shemminger@vyatta.com Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 71874B6EEA for ; Wed, 25 Jan 2012 00:18:57 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754908Ab2AXNSi (ORCPT ); Tue, 24 Jan 2012 08:18:38 -0500 Received: from mail-ww0-f44.google.com ([74.125.82.44]:52130 "EHLO mail-ww0-f44.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752923Ab2AXNSh (ORCPT ); Tue, 24 Jan 2012 08:18:37 -0500 Received: by wgbed3 with SMTP id ed3so3993496wgb.1 for ; Tue, 24 Jan 2012 05:18:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=message-id:subject:from:to:cc:date:content-type:x-mailer :content-transfer-encoding:mime-version; bh=ldAVDmqtmDBSDxqqIeLFjFKqOcGkiAuYRZtVpqHM+RY=; b=j6L2jNjTqKoTlnWIYd84+i6bhzonYeuDdpsalcu4G60SePuCnD8XJtuG+MYudLKSjZ RUO25iypwMbLxRpVRBkFwev00O72GO0p0T4mL6FVs2+Guwj/xYQD2vOirYFhv1RQu1tz wfMm5c0dBs6NiiZpIEneuPMqj2ET18TO70Wpo= Received: by 10.180.92.101 with SMTP id cl5mr20441363wib.21.1327411116208; Tue, 24 Jan 2012 05:18:36 -0800 (PST) Received: from [10.150.51.211] (gw0.net.jmsp.net. [212.23.165.14]) by mx.google.com with ESMTPS id fr8sm42985949wib.10.2012.01.24.05.18.34 (version=SSLv3 cipher=OTHER); Tue, 24 Jan 2012 05:18:35 -0800 (PST) Message-ID: <1327411113.7231.7.camel@edumazet-HP-Compaq-6005-Pro-SFF-PC> Subject: [PATCH iproute2] tc-red: update man page From: Eric Dumazet To: Stephen Hemminger Cc: netdev Date: Tue, 24 Jan 2012 14:18:33 +0100 X-Mailer: Evolution 3.2.1- Mime-Version: 1.0 Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org include documentation for harddrop and adaptive parameters. All parameters but limit and avpkt are optional. Signed-off-by: Eric Dumazet --- man/man8/tc-red.8 | 52 ++++++++++++++++++++++++++++++++++---------- 1 file changed, 41 insertions(+), 11 deletions(-) -- To unsubscribe from this list: send the line "unsubscribe netdev" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/man/man8/tc-red.8 b/man/man8/tc-red.8 index 32a47b8..f410d15 100644 --- a/man/man8/tc-red.8 +++ b/man/man8/tc-red.8 @@ -5,18 +5,19 @@ red \- Random Early Detection .B tc qdisc ... red .B limit bytes -.B min +.B [ min bytes -.B max +.B ] [ max bytes -.B avpkt +.B ] avpkt bytes -.B burst +.B [ burst packets -.B [ ecn ] [ bandwidth +.B ] [ ecn ] [ harddrop] [ bandwidth rate -.B ] probability +.B ] [ probability chance +.B ] [ adaptive ] .SH DESCRIPTION Random Early Detection is a classless qdisc which manages its queue size @@ -66,7 +67,10 @@ parameter is provided to set a hard maximum for the size of the queue. .SH PARAMETERS .TP min -Average queue size at which marking becomes a possibility. +Average queue size at which marking becomes a possibility. Defaults to +.B max +/3 + .TP max At this average queue size, the marking probability is maximal. Should be at @@ -74,11 +78,14 @@ least twice .B min to prevent synchronous retransmits, higher for low .B min. +Default to +.B limit +/4 .TP probability Maximum probability for marking, specified as a floating point number from 0.0 to 1.0. Suggested values are 0.01 or 0.02 (1 or 2%, -respectively). +respectively). Default : 0.02 .TP limit Hard limit on the real (not average) queue size in bytes. Further packets @@ -99,7 +106,7 @@ average queue size calculations. 1000 is a good value. bandwidth This rate is used for calculating the average queue size after some idle time. Should be set to the bandwidth of your interface. Does not mean -that RED will shape for you! Optional. +that RED will shape for you! Optional. Default : 10Mbit .TP ecn As mentioned before, RED can either 'mark' or 'drop'. Explicit Congestion @@ -109,7 +116,26 @@ dropping a packet. If this parameter is specified, packets which indicate that their hosts honor ECN will only be marked and not dropped, unless the queue size hits .B limit -bytes. Needs a tc binary with RED support compiled in. Recommended. +bytes. Recommended. +.TP +harddrop +If average flow queue size is above +.B max +bytes, this parameter forces a drop instead of ecn marking. +.TP +adaptive +(Added in linux-3.3) Sets RED in adaptive mode as described in http://icir.org/floyd/papers/adaptiveRed.pdf +.nf +Goal of Adaptive RED is to make 'probability' dynamic value between 1% and 50% to reach the target average queue : +.B (max - min) / 2 +.fi + +.SH EXAMPLE + +.P +# tc qdisc add dev eth0 parent 1:1 handle 10: red + limit 400000 min 30000 max 90000 avpkt 1000 + burst 55 ecn adaptive bandwidth 10Mbit .SH SEE ALSO .BR tc (8), @@ -123,10 +149,14 @@ Congestion Avoidance. http://www.aciri.org/floyd/papers/red/red.html .TP o Some changes to the algorithm by Alexey N. Kuznetsov. +.TP +o +Adaptive RED : http://icir.org/floyd/papers/adaptiveRed.pdf .SH AUTHORS Alexey N. Kuznetsov, , Alexey Makarenko -, J Hadi Salim . +, J Hadi Salim , +Eric Dumazet . This manpage maintained by bert hubert