From patchwork Tue Feb 2 12:23:50 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jack Min X-Patchwork-Id: 87633 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 97AC7A052A; Tue, 2 Feb 2021 13:24:10 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 559552402D5; Tue, 2 Feb 2021 13:23:59 +0100 (CET) Received: from hqnvemgate25.nvidia.com (hqnvemgate25.nvidia.com [216.228.121.64]) by mails.dpdk.org (Postfix) with ESMTP id DB7C3240293 for ; Tue, 2 Feb 2021 13:23:55 +0100 (CET) Received: from hqpgpgate101.nvidia.com (Not Verified[216.228.121.13]) by hqnvemgate25.nvidia.com (using TLS: TLSv1.2, DES-CBC3-SHA) id ; Tue, 02 Feb 2021 04:23:55 -0800 Received: from HQMAIL105.nvidia.com ([172.20.161.6]) by hqpgpgate101.nvidia.com (PGP Universal service); Tue, 02 Feb 2021 04:23:55 -0800 X-PGP-Universal: processed; by hqpgpgate101.nvidia.com on Tue, 02 Feb 2021 04:23:55 -0800 Received: from HKMAIL102.nvidia.com (10.18.16.11) by HQMAIL105.nvidia.com (172.20.187.12) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 2 Feb 2021 12:23:53 +0000 Received: from HKMAIL104.nvidia.com (10.18.16.13) by HKMAIL102.nvidia.com (10.18.16.11) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 2 Feb 2021 12:23:52 +0000 Received: from NAM02-SN1-obe.outbound.protection.outlook.com (104.47.36.52) by HKMAIL104.nvidia.com (10.18.16.13) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Tue, 2 Feb 2021 12:23:52 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=gJvtzPuRMCOTLlb8fje91SfmQ+sabxn+llihVqbvOx958hz+mqg+VOXjdZ8KDQUiU/VaJ8iY0WBK91HsGj7DuSohmlEJgEevZF0tOLlZKjZ9cGVFtZkHj9d6jkkrxAaPSbFHCRQ3avXeDfj2GBN7/kgK3rsvsB8ilO/bDOkcnGWSyJ0JPp3Bixx7n/HaMTrye6zTzrXOTaNBEnYJ6d3qEbi5GAafUrOXy0y77LhmyprWGptBszYL+3b2MInVdTSuLe4WljXNNxb3PJZSQdv3UDCR34GIeGSo2vhoTz8Mm9RyowP2zyU26dzwFad68nt0ElyGi8+pwWfLgV7xSbme2w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=n2xJIEBIIcr9WasTuOjHu/34u+Ka9Xpk/CbtCdaGpAs=; b=MpaHMnyrEBBBslxP9NAYv6UOi85iqM4P8ut1lZmWFMqETtC8KjdIkguF0LOh1nqeTCCgrzE53CMpKZgYHoJvaQSEQdbuCe88pIks+maSc+A+V4KcTteNmKOoeajzuX7IShZvFIX227pY9QhJVM00TpVB54kIewDagg9OZrq3SMKmHdGIG6BXs50ry8r2msrUBOmHgTy5xBGCZnJ03qfSJ7lcrTh8VHX3j7KKnwD3L5idfzZRZrEM7+rka+GNE+1XPDigtvyT4RJLyH3dBbSNwXFf1Dk/5+8h4BaTtHxKr76mczmSbfK0fu6ZWunbKIbfiANJqQcKKwBrKn9RKvSyhg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none Received: from MN2PR12MB3344.namprd12.prod.outlook.com (2603:10b6:208:c5::10) by MN2PR12MB3406.namprd12.prod.outlook.com (2603:10b6:208:c9::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3805.24; Tue, 2 Feb 2021 12:23:50 +0000 Received: from MN2PR12MB3344.namprd12.prod.outlook.com ([fe80::d5e0:99dd:fb9b:600c]) by MN2PR12MB3344.namprd12.prod.outlook.com ([fe80::d5e0:99dd:fb9b:600c%6]) with mapi id 15.20.3805.027; Tue, 2 Feb 2021 12:23:50 +0000 From: Jack Min To: Ori Kam CC: "dev@dpdk.org" Thread-Topic: [PATCH 1/2] doc: more info of rte flow shared action Thread-Index: AQHW+V5DiPMKa/zPvk6qIasOGg3wzg== Date: Tue, 2 Feb 2021 12:23:50 +0000 Message-ID: <9b8375c7ce4991e771a8734e9759fd2aed811c65.1612266977.git.jackmin@nvidia.com> References: In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: nvidia.com; dkim=none (message not signed) header.d=none;nvidia.com; dmarc=none action=none header.from=nvidia.com; x-originating-ip: [183.195.51.193] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 38b63a80-7d26-424a-e4dd-08d8c77565b3 x-ms-traffictypediagnostic: MN2PR12MB3406: x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-header: ProcessedBy-CMR-outbound x-ms-oob-tlc-oobclassifiers: OLM:7691; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: sc6GmBmTH+DWJ3L1oTrOLOXbJDRvWw6FzgQTZM722mZqNk4lzVN1uivlLwVx7lZeoor1divlkNYGRzYLzLA4zkfF0R94Sd8HcH8XYY/PvdPyrFwM60BsZwwtDae+QrL6V6el3rkQfr6tcWOGZJbDX80JnH9K2PpuDYLAmLXNwfX1I5f1mcqygf3QJMZYtSwB3eOlKzv1J1EX/lb0fJvWBca5u2mIbGUGbf/3j/Ohv4j4b3M0W3CS3pENZZ9ikmBkI0jrNsWg0uoGHubUwbNK+f14cPJUuaZ9GrsVe0G6dm4npkxDfStYzUDoTidmJVZDqExavEewy129r6PTZxGhpbOG2vxXPhsIRZ8UAWs+sOvzXDOF0z5Qco7uO0b4EgWp5GvB97ZXZvyxSRskFCPoa9o71U3RPCRUIshLQkQ8Phz7NjkJaQZ3FZTmETWmWLf+dd7leGVRu+9fPNdpNqgcZaNqI8faIBY//DQ8APB41pE/bDc0N5QineNFOY5w8pHu2BWpo72xoae7gUd6d4/oCA== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR12MB3344.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(39860400002)(376002)(346002)(366004)(136003)(2906002)(86362001)(91956017)(76116006)(66946007)(4744005)(186003)(26005)(6636002)(316002)(6862004)(8936002)(478600001)(37006003)(6486002)(5660300002)(8676002)(6506007)(71200400001)(83380400001)(66476007)(64756008)(6512007)(66556008)(66446008)(4326008)(2616005)(36756003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: =?iso-8859-1?q?/LVw1CGChz49NIlqr2SzAyuKa?= =?iso-8859-1?q?8nu67d/QYIZTN+4xDjgCaMVnh1S0UOJBAVNjMCu9DIpGvXrTFToabnUaGzwr?= =?iso-8859-1?q?1o1F85Uuh9rfTjqGw6refgh6IPHMuULUL085oqKVDp3GDAanUUNFkXPGOPnR?= =?iso-8859-1?q?wStQefiEawCXfDcH0/RktTsFGd+5D9E9PZAsfyRSuAIfU24+lQsF3N6wCC0A?= =?iso-8859-1?q?cjD5+CRCIASz4ebisJVhto4jWm0AWo4qqf16URVgOCLeXMo3MYlqY9fpF8zy?= =?iso-8859-1?q?vEuuTrok+RJpTEWPoMsMz9pEkfV3o3ofrVCOfNqjA4kzDMy69OCgPDtE1YLd?= =?iso-8859-1?q?WbnzhBEGNNTmVsGGhi6tWTLY4pa3zkwWuPAo1INP/lTiuGRQXBwK2bpEzdH+?= =?iso-8859-1?q?zDhHhIBkBl+uI8AIZRnuQ2/dUFlbOgmC3FLJkvu+JKS0y0cKe1LFKS40EaOw?= =?iso-8859-1?q?MFiHcsczTCCEmUfiszr8JIEkGpKSvvlfSPSEW6TkzNtevq92F7VQpqrlEXCP?= =?iso-8859-1?q?O6nwLvCgiMgaZ3mucCbPelmIYvJ3mLhCRcvSnFtbcnJx/e8ZbKAHvv9NtgoF?= =?iso-8859-1?q?G6iBdsdvc5nWzhWNjmI2u6lmS7AspcJaWXiXZDpCAMShh+unJ8o5U1w76KY/?= =?iso-8859-1?q?MhGt8i6rha7+01bp9gv3marc6DBwPJFNRf3NMVIIrcDA2YwWK40AGmSGZt8Y?= =?iso-8859-1?q?XCFFogr4JtOOBXbZhFmcmoDgDVdMrJzxs/1Zg7CC/pDsvyNGZItLKMl4hxfs?= =?iso-8859-1?q?6JFJcUjZMBeugL4s5/DAuQDpMiEQTy8DHACIyaPO9+2+EPUXtsa6CXsIZvmE?= =?iso-8859-1?q?v9Yy+IWB1F8S2xXnk1x5sEPUm2huAT4cCG0ru7J2tyMgswfN1DYLgXBa0RRT?= =?iso-8859-1?q?Z2SrcE4yP6fL0oH9RST77zpEQ15dJfvIa9D7PECXlRcHapZLXtZs3OqrykuJ?= =?iso-8859-1?q?vmU1/BrjbkwxJ7NtZq2vgd/fMPBzwvYxAXDqMWGwhbsAHtxXofssVJR6FM89?= =?iso-8859-1?q?FioJkjxLDgVBOHbXLrg0w6079F0dVceLRZGqzgg4pM5QuvKYevbMCItGKPpr?= =?iso-8859-1?q?TILqNsPsRf1diwr4qNTyRoUdkYhx5TbjuU786OnpW5Nretwkq2lmdxs1bBzL?= =?iso-8859-1?q?IKoOQ=3D=3D?= MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: MN2PR12MB3344.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 38b63a80-7d26-424a-e4dd-08d8c77565b3 X-MS-Exchange-CrossTenant-originalarrivaltime: 02 Feb 2021 12:23:50.2875 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: Jkt4Cn4cCk+ddzv9ID2n1xnWQScIvmzoNQ6/HuHvELXsn+n9CEqylFeu4+PBDy/faHnEwcqZdl9vKlsIO3bXCg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR12MB3406 X-OriginatorOrg: Nvidia.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nvidia.com; s=n1; t=1612268635; bh=n2xJIEBIIcr9WasTuOjHu/34u+Ka9Xpk/CbtCdaGpAs=; h=X-PGP-Universal:ARC-Seal:ARC-Message-Signature: ARC-Authentication-Results:From:To:CC:Subject:Thread-Topic: Thread-Index:Date:Message-ID:References:In-Reply-To: Accept-Language:Content-Language:X-MS-Has-Attach: X-MS-TNEF-Correlator:authentication-results:x-originating-ip: x-ms-publictraffictype:x-ms-office365-filtering-correlation-id: x-ms-traffictypediagnostic:x-ms-exchange-transport-forked: x-microsoft-antispam-prvs:x-header:x-ms-oob-tlc-oobclassifiers: x-ms-exchange-senderadcheck:x-microsoft-antispam: x-microsoft-antispam-message-info:x-forefront-antispam-report: x-ms-exchange-antispam-messagedata:Content-Type: Content-Transfer-Encoding:MIME-Version: X-MS-Exchange-CrossTenant-AuthAs: X-MS-Exchange-CrossTenant-AuthSource: X-MS-Exchange-CrossTenant-Network-Message-Id: X-MS-Exchange-CrossTenant-originalarrivaltime: X-MS-Exchange-CrossTenant-fromentityheader: X-MS-Exchange-CrossTenant-id:X-MS-Exchange-CrossTenant-mailboxtype: X-MS-Exchange-CrossTenant-userprincipalname: X-MS-Exchange-Transport-CrossTenantHeadersStamped:X-OriginatorOrg; b=rsPVKLuipxQw7X9N/yjun3YFObij0H68XI0NDTNfIQTVkKH8j99sqbiVEdUxp3CoJ YKlzM7sH5oipuHbpS0EwEP6iKekqElORt9xel7RkK68SEa2sidUrxWMoLO1B7H/PXO 4WU9TbPL+LG0971/12IsICE9MaiqG033dkFhVdS1HfNHTHGS8IAaGNDRCO0Sx7LnEh /Vkon1fVNOoVRFabczVLkpbkgsB2bONf4Td6SNc4k3fWa1Ps726OlOxD5P3xjZ0HqS /Kzz4xE/uGgBqky6zYb2HeLZwumQsq7JpBoYie85ThaWwSYxuYep/9ky9YLJs1h1eH mjXLvHkz4Lr4A== Subject: [dpdk-dev] [PATCH 1/2] doc: more info of rte flow shared action X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 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" Added more information of shared action on how to update, query, and the benefits. Signed-off-by: Xiaoyu Min Acked-by: Ori Kam Reviewed-by: Asaf Penso Reviewed-by: Ferruh Yigit --- doc/guides/prog_guide/rte_flow.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index 0b8c243fe1..62a57919eb 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -2756,6 +2756,13 @@ Flow utilize shared action by handle as returned from The behaviour of the shared action defined by ``action`` argument of type ``struct rte_flow_action`` passed to ``rte_flow_shared_action_create()``. +Multiple flows can use the same shared action. +The shared action can be in-place updated by ``rte_flow_shared_action_update()`` +without destroying flow and creating flow again. + +The shared action specified data (e.g. counter) can be queried by +``rte_flow_shared_action_query()``. + .. _table_rte_flow_shared_action: .. table:: SHARED