Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/90192/?format=api
{ "id": 90192, "url": "http://patches.dpdk.org/api/patches/90192/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/1617180669-225007-1-git-send-email-jiaweiw@nvidia.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<1617180669-225007-1-git-send-email-jiaweiw@nvidia.com>", "list_archive_url": "https://inbox.dpdk.org/dev/1617180669-225007-1-git-send-email-jiaweiw@nvidia.com", "date": "2021-03-31T08:51:09", "name": "[v2] doc: add sampling and mirroring in testpmd guide", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "8379d342d5cb3bebc7d4e9cde52936db489a1b74", "submitter": { "id": 1939, "url": "http://patches.dpdk.org/api/people/1939/?format=api", "name": "Jiawei Wang", "email": "jiaweiw@nvidia.com" }, "delegate": { "id": 319, "url": "http://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/1617180669-225007-1-git-send-email-jiaweiw@nvidia.com/mbox/", "series": [ { "id": 16001, "url": "http://patches.dpdk.org/api/series/16001/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=16001", "date": "2021-03-31T08:51:09", "name": "[v2] doc: add sampling and mirroring in testpmd guide", "version": 2, "mbox": "http://patches.dpdk.org/series/16001/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/90192/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/90192/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 7042EA034F;\n\tWed, 31 Mar 2021 10:51:16 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 049F84069E;\n\tWed, 31 Mar 2021 10:51:16 +0200 (CEST)", "from mellanox.co.il (mail-il-dmz.mellanox.com [193.47.165.129])\n by mails.dpdk.org (Postfix) with ESMTP id 8EC3840141\n for <dev@dpdk.org>; Wed, 31 Mar 2021 10:51:14 +0200 (CEST)", "from Internal Mail-Server by MTLPINE1 (envelope-from\n jiaweiw@nvidia.com) with SMTP; 31 Mar 2021 11:51:09 +0300", "from nvidia.com (gen-l-vrt-281.mtl.labs.mlnx [10.237.44.1])\n by labmailer.mlnx (8.13.8/8.13.8) with ESMTP id 12V8p9ko007844;\n Wed, 31 Mar 2021 11:51:09 +0300" ], "From": "Jiawei Wang <jiaweiw@nvidia.com>", "To": "viacheslavo@nvidia.com, xiaoyun.li@intel.com, ferruh.yigit@intel.com,\n thomas@monjalon.net", "Cc": "dev@dpdk.org", "Date": "Wed, 31 Mar 2021 11:51:09 +0300", "Message-Id": "<1617180669-225007-1-git-send-email-jiaweiw@nvidia.com>", "X-Mailer": "git-send-email 1.8.3.1", "In-Reply-To": "<1615295935-11197-1-git-send-email-jiaweiw@nvidia.com>", "References": "<1615295935-11197-1-git-send-email-jiaweiw@nvidia.com>", "Subject": "[dpdk-dev] [PATCH v2] doc: add sampling and mirroring in testpmd\n guide", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Update documentation for sample action usage in testpmd and\nshow the command line example.\n\nSigned-off-by: Jiawei Wang <jiaweiw@nvidia.com>\nAcked-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>\n---\nv2:\n* Update the description.\n---\n doc/guides/testpmd_app_ug/testpmd_funcs.rst | 63 +++++++++++++++++++++++++++++\n 1 file changed, 63 insertions(+)", "diff": "diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst\nindex f59eb8a..6606433 100644\n--- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst\n+++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst\n@@ -2003,6 +2003,24 @@ Set fec mode for a specific port::\n \n testpmd> set port (port_id) fec_mode auto|off|rs|baser\n \n+Config Sample actions list\n+~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+Configure the sample actions list to be used when sampling a packet by\n+rte_flow_action_sample::\n+\n+ set sample_actions {index} {action} [/ {action} [...]] / end\n+\n+There are multiple global buffers for ``sample_actions``, this command will set\n+one internal buffer index by ``{index}``.\n+\n+In order to use different sample actions list, ``index`` must be specified\n+during the flow rule creation::\n+\n+ testpmd> flow create 0 ingress pattern eth / ipv4 / end actions\n+ sample ratio 2 index 2 / end\n+\n+Otherwise the default index ``0`` is used.\n \n Port Functions\n --------------\n@@ -4841,6 +4859,51 @@ if seid is set)::\n testpmd> flow create 0 ingress pattern eth / ipv6 / pfcp s_field is 1\n seid is 1 / end actions queue index 3 / end\n \n+Sample Sampling/Mirroring rules\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+\n+Sample/Mirroring rules can be set by the following commands\n+\n+NIC-RX Sampling rule, the matched ingress packets and sent to the queue 1,\n+also each second packets are duplicated and marked with 0x1234 and sent to\n+queue 0.\n+\n+::\n+\n+ testpmd> set sample_actions 0 mark id 0x1234 / queue index 0 / end\n+ testpmd> flow create 0 ingress group 1 pattern eth / end actions\n+ sample ratio 2 index 0 / queue index 1 / end\n+\n+Sampling rule with port representors (with \"transfer\" attribute), the matched\n+ingress packets are sent to port id 2, also each second packets are sent to\n+PF port.\n+\n+::\n+\n+ testpmd> set sample_actions 0 / end\n+ testpmd> flow create 0 ingress transfer pattern eth / end actions\n+ sample ratio 2 index 0 / port_id id 2 / end\n+\n+Mirroring rule with port representors (with \"transfer\" attribute), the matched\n+ingress packets with encapsulation header are sent to port id 0, and also\n+mirrored the packets and sent to port id 2.\n+\n+::\n+\n+ testpmd> set sample_actions 0 port_id id 2 / end\n+ testpmd> flow create 1 ingress transfer pattern eth / end actions\n+ sample ratio 1 index 0 / raw_encap / port_id id 0 / end\n+\n+Mirroring rule with port representors (with \"transfer\" attribute), the matched\n+ingress packets are sent to port id 2, and also mirrored the packets with\n+encapsulation header and sent to port id 0.\n+\n+::\n+\n+ testpmd> set sample_actions 0 raw_encap / port_id id 0 / end\n+ testpmd> flow create 0 ingress transfer pattern eth / end actions\n+ sample ratio 1 index 0 / port_id id 2 / end\n+\n BPF Functions\n --------------\n \n", "prefixes": [ "v2" ] }