From patchwork Mon Mar 12 08:42:08 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomasz Duszynski X-Patchwork-Id: 35963 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id DD1194CBD; Mon, 12 Mar 2018 09:42:30 +0100 (CET) Received: from mail-lf0-f65.google.com (mail-lf0-f65.google.com [209.85.215.65]) by dpdk.org (Postfix) with ESMTP id 8C9EE4C74 for ; Mon, 12 Mar 2018 09:42:28 +0100 (CET) Received: by mail-lf0-f65.google.com with SMTP id t204-v6so21886535lff.9 for ; Mon, 12 Mar 2018 01:42:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=semihalf-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=+dE+TY8NQQmPf60+SgCe3+hUuC0PrHN8IcMckVdbQYA=; b=PFJpZ2wkv5Zgr2EFmJJkBYQ6H2IdxJrNU1qES0ijr5fQVs8/CyzbxEOkvrFvS0cJIm FZ5m3Pt3HCzuOxQlwVaJ47pr1tbaRo7twYw2WoUMPVnItqhHDxfNiyPY9/RNtVDu5zXZ eIQ6fYFECRvrFfqg/jvgMICDxrXyBuGM7+eQoXUGnC2jNnFtUcDsn/Pua6Yev+w9MTNv 1UqPbRbGeJ4l15XOTJFqI/T9txnbLw5t6iCtr+1JSYTFJRcMbBK9rphtseioVrVdN9XN s+/F8ETbZ2oTDNLH5QaYvBx7BXnPiA3tqz7KnhC/Eu3EyQCyc+Ff//gshUwA8DLO3Ak0 9dpQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=+dE+TY8NQQmPf60+SgCe3+hUuC0PrHN8IcMckVdbQYA=; b=IsjaGB2oTrMxchxRnOJPxj5YgyTYSdnCDMUiBMWKxhvyTg3Tw+bdbRHQ4BWOkkZ5jc yL5nhK6yhgjLqOuXwpw5mwa9uTNInRzArO3HBy4DlYSDLRZi7CVflG6/1nTOLaPMVbzJ OWx/iNlHTZgaiontwTUs7BZt+zSHSb2mjCfOQQEymqUUn5LEqP9xuHAvY5h87drvZn23 QT1MhFBhoc98lQdftLWQ8tJQZfRoREDJ1CFT15DiOzPsshpajGrr2STAiw7/AfqIdwpR pkihcivf4e/RuuaiPbAXJnUCNiu7CL8pzogX07d4YES4O0EX4zmD/b6nmQoOqF8O3ByR k/mQ== X-Gm-Message-State: AElRT7Hofa6aey5q47LLkIA8WcE7gRu/8qro6trhU+RbUB6P/E6c1bRl gwICTuXJfmFS+MbEVnHCidDUw42qCaI= X-Google-Smtp-Source: AG47ELu0uf+G8Rue8f8qGLlvD5gRZvTKdFHZ17AA5DEOrhAUpx/F35i9mzcU7THTlKyfaTTGfcNMTg== X-Received: by 2002:a19:988d:: with SMTP id a135-v6mr4245468lfe.93.1520844148049; Mon, 12 Mar 2018 01:42:28 -0700 (PDT) Received: from sh.semihalf.local (31-172-191-173.noc.fibertech.net.pl. [31.172.191.173]) by smtp.gmail.com with ESMTPSA id t21sm1549933ljd.55.2018.03.12.01.42.26 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 12 Mar 2018 01:42:27 -0700 (PDT) From: Tomasz Duszynski To: dev@dpdk.org Cc: mw@semihalf.com, dima@marvell.com, nsamsono@marvell.com, jck@semihalf.com, jianbo.liu@arm.com, Tomasz Duszynski Date: Mon, 12 Mar 2018 09:42:08 +0100 Message-Id: <1520844132-29969-5-git-send-email-tdu@semihalf.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1520844132-29969-1-git-send-email-tdu@semihalf.com> References: <1519222460-14605-1-git-send-email-tdu@semihalf.com> <1520844132-29969-1-git-send-email-tdu@semihalf.com> Subject: [dpdk-dev] [PATCH v2 4/8] net/mrvl: document policer/scheduler/rate limiter usage X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Add documentation and example for ingress policer, egress scheduler and egress rate limiter. Signed-off-by: Natalie Samsonov Signed-off-by: Tomasz Duszynski --- doc/guides/nics/mrvl.rst | 86 ++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 80 insertions(+), 6 deletions(-) diff --git a/doc/guides/nics/mrvl.rst b/doc/guides/nics/mrvl.rst index b7f3292..6794cbb 100644 --- a/doc/guides/nics/mrvl.rst +++ b/doc/guides/nics/mrvl.rst @@ -149,17 +149,36 @@ Configuration syntax [port default] default_tc = mapping_priority = + policer_enable = + token_unit = + color = + cir = + ebs = + cbs = + + rate_limit_enable = + rate_limit = + burst_size = [port tc ] rxq = pcp = dscp = + default_color = [port tc ] rxq = pcp = dscp = + [port txq ] + sched_mode = + wrr_weight = + + rate_limit_enable = + rate_limit = + burst_size = + Where: - ````: DPDK Port number (0..n). @@ -176,6 +195,30 @@ Where: - ````: List of DSCP values to handle in particular TC (e.g. 0-12 32-48 63). +- ````: Enable ingress policer. + +- ````: Policer token unit (`bytes` or `packets`). + +- ````: Policer color mode (`aware` or `blind`). + +- ````: Committed information rate in unit of kilo bits per second (data rate) or packets per second. + +- ````: Committed burst size in unit of kilo bytes or number of packets. + +- ````: Excess burst size in unit of kilo bytes or number of packets. + +- ````: Default color for specific tc. + +- ````: Enables per port or per txq rate limiting. + +- ````: Committed information rate, in kilo bits per second. + +- ````: Committed burst size, in kilo bytes. + +- ````: Egress scheduler mode (`wrr` or `sp`). + +- ````: Txq weight. + Setting PCP/DSCP values for the default TC is not required. All PCP/DSCP values not assigned explicitly to particular TC will be handled by the default TC. @@ -187,11 +230,26 @@ Configuration file example [port 0 default] default_tc = 0 - qos_mode = ip + mapping_priority = ip + + rate_limit_enable = 1 + rate_limit = 1000 + burst_size = 2000 [port 0 tc 0] rxq = 0 1 + [port 0 txq 0] + sched_mode = wrr + wrr_weight = 10 + + [port 0 txq 1] + sched_mode = wrr + wrr_weight = 100 + + [port 0 txq 2] + sched_mode = sp + [port 0 tc 1] rxq = 2 pcp = 5 6 7 @@ -199,15 +257,31 @@ Configuration file example [port 1 default] default_tc = 0 - qos_mode = vlan/ip + mapping_priority = vlan/ip + + policer_enable = 1 + token_unit = bytes + color = blind + cir = 100000 + ebs = 64 + cbs = 64 [port 1 tc 0] rxq = 0 + dscp = 10 [port 1 tc 1] - rxq = 1 2 - pcp = 5 6 7 - dscp = 26-38 + rxq = 1 + dscp = 11-20 + + [port 1 tc 2] + rxq = 2 + dscp = 30 + + [port 1 txq 0] + rate_limit_enable = 1 + rate_limit = 10000 + burst_size = 2000 Usage example ^^^^^^^^^^^^^ @@ -215,7 +289,7 @@ Usage example .. code-block:: console ./testpmd --vdev=eth_mrvl,iface=eth0,iface=eth2,cfg=/home/user/mrvl.conf \ - -c 7 -- -i -a --rxq=2 + -c 7 -- -i -a --disable-hw-vlan-strip --rxq=3 --txq=3 Building DPDK