From patchwork Thu Mar 7 10:39:50 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anoob Joseph X-Patchwork-Id: 50911 X-Patchwork-Delegate: gakhil@marvell.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 514332C18; Thu, 7 Mar 2019 11:39:56 +0100 (CET) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by dpdk.org (Postfix) with ESMTP id 8336E1DA4 for ; Thu, 7 Mar 2019 11:39:55 +0100 (CET) Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x27AZ5vF021942; Thu, 7 Mar 2019 02:39:54 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=pfpt0818; bh=nZJmpvurzJIXe6mSRbaAfOZ5CpfB19FQB3cV2xAmpas=; b=rHqwfcAwZgD6bGOOn8B1GxoTmvdu5nAPqhuCzacwzokDEzzy1+u2X2a9W6i8WTNEdT3M Lv2W4XQZcxBqtx0CdL8vLiqY4TPKuxo0PemyQfenuhfFg/Iss8nVsCjz19XR52FWp3il suHQfKh6H0qTt9S3TyhiVTWSslwRPJeUFbKjWKLMnRI0l4+bLPwd+bnsIw18VyRiYs5e 1TifGnrqlwVHF/EGIo+dtisoC2Dn7ALRr4DA7G2NO1oxscp9PBmVm/2gDoviQMNyxwz+ X8CjG1stc9/fyqPb4v+YUPfZC5EByxKcOjeP7Zntw/J0QmIhIVlHnYVQqcfd1amoXzRo 5w== Received: from sc-exch04.marvell.com ([199.233.58.184]) by mx0b-0016f401.pphosted.com with ESMTP id 2r2y9wgeru-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Thu, 07 Mar 2019 02:39:54 -0800 Received: from SC-EXCH03.marvell.com (10.93.176.83) by SC-EXCH04.marvell.com (10.93.176.84) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Thu, 7 Mar 2019 02:39:52 -0800 Received: from NAM03-CO1-obe.outbound.protection.outlook.com (104.47.40.58) by SC-EXCH03.marvell.com (10.93.176.83) with Microsoft SMTP Server (TLS) id 15.0.1367.3 via Frontend Transport; Thu, 7 Mar 2019 02:39:52 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.onmicrosoft.com; s=selector1-marvell-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nZJmpvurzJIXe6mSRbaAfOZ5CpfB19FQB3cV2xAmpas=; b=VVbX3m8azYjt1aDon+e2SPjjy7khYO/TmW6tH3Y5kaYfknSmA8PhN6q0xVMbXAsV8GEo1iV5NIB45b609HVqoMR5AhlLdetPIVsPhlKZ6PWYeZZ1DLYPsKp4k6yn0sqjDSfb9M2ys3t2bxjs7wlJMz6C4PByTst7H/x0L0B5ok4= Received: from MN2PR18MB2877.namprd18.prod.outlook.com (20.179.20.218) by MN2PR18MB2910.namprd18.prod.outlook.com (20.179.22.89) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1686.18; Thu, 7 Mar 2019 10:39:51 +0000 Received: from MN2PR18MB2877.namprd18.prod.outlook.com ([fe80::1905:8cf6:f4a1:5d9a]) by MN2PR18MB2877.namprd18.prod.outlook.com ([fe80::1905:8cf6:f4a1:5d9a%4]) with mapi id 15.20.1686.018; Thu, 7 Mar 2019 10:39:51 +0000 From: Anoob Joseph To: Akhil Goyal , Fiona Trahe , Pablo de Lara CC: Anoob Joseph , Jerin Jacob Kollanukkaran , Narayana Prasad Raju Athreya , Shally Verma , Suheil Chandran , "dev@dpdk.org" Thread-Topic: [PATCH v2] doc: announce ABI change for cryptodev config Thread-Index: AQHU1NIXPhN9XiWCiE+etRrbIwtq3g== Date: Thu, 7 Mar 2019 10:39:50 +0000 Message-ID: <1551955163-1752-1-git-send-email-anoobj@marvell.com> References: <1547717928-21203-1-git-send-email-anoobj@marvell.com> In-Reply-To: <1547717928-21203-1-git-send-email-anoobj@marvell.com> Accept-Language: en-IN, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-clientproxiedby: BM1PR0101CA0009.INDPRD01.PROD.OUTLOOK.COM (2603:1096:b00:18::19) To MN2PR18MB2877.namprd18.prod.outlook.com (2603:10b6:208:3b::26) x-ms-exchange-messagesentrepresentingtype: 1 x-mailer: git-send-email 2.7.4 x-originating-ip: [115.113.156.2] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 75447571-b467-40b4-9854-08d6a2e93a03 x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(5600127)(711020)(4605104)(4534185)(7168020)(4627221)(201703031133081)(201702281549075)(8990200)(2017052603328)(7153060)(7193020); SRVR:MN2PR18MB2910; x-ms-traffictypediagnostic: MN2PR18MB2910: x-microsoft-exchange-diagnostics: =?iso-8859-1?Q?1; MN2PR18MB2910; 23:6aFORvnNC+QyNUBOBDyglbAijIYpBUMFkzan7qp?= =?iso-8859-1?q?QUigWLd268rKYEzdXgCWVvzw+?= =?iso-8859-1?q?Y5hoKRdZP6Utd3Z3Oc75uxU1q4rf3bOWnSDc8i1ZZ0EIhUo3EEG?= =?iso-8859-1?q?1cjjB7BUnD4OC6LW6RCgtyArMkKM0B1LFBqqfDgTCU9zXOnEZpN?= =?iso-8859-1?q?7EBc5U3oW5k9bFukMEMjX/jcjXX0t+7NGGky/aZLcOvdKy88zv8?= =?iso-8859-1?q?RTVCFk6mqLWZGTIBpOEE4YVSanV4SnlxZTT85KFR9CkitoDK/j1?= =?iso-8859-1?q?MTla8F8b9v/iGJs/CILamwkL3GCvZi9O9jwMyejsc88VEp6NtTH?= =?iso-8859-1?q?pe/NxWEFXASNqboAs1SeGoBptNNahDZoE4I/S7wsr9PupleYWHB?= =?iso-8859-1?q?aRRADURcbt3Ci2s8qIjRtPEO6iKUcTY4sLjcoOIrK3uIKC5Aapt?= =?iso-8859-1?q?nDe0tHbbQs59LoZRcRU/6g3qEGGfoGkYcOeYmGfr8tWgyRTDYCV?= =?iso-8859-1?q?LXeN4totoYdF3JZzbGJy9qF0ePxpLnHskgcCPxkNUSq/FYFxkVY?= =?iso-8859-1?q?P33bcWlZzsTHQOLAWOExP8FAxCFMJJ+TswU6IiMYylK8Cd9IghZ?= =?iso-8859-1?q?xnCaFrFHJJ5WrTCWsNL+wxm8ub+upXXJXyPDIBLIEXVmcmloTMz?= =?iso-8859-1?q?XiRg8AbzCk+n1DUHUsJd+fyjpRYLPB9xaFn5owmtXx+QJQEBIqK?= =?iso-8859-1?q?IRRS8zTqfPUWHB8+Z6KUGupE3/UM8nbVrlS66FpzSxHewKMOYqN?= =?iso-8859-1?q?3jMak5fvlUJLFgstBtu0ypnDcpHA5NcBWYUYilG/3t8l17LoTBt?= =?iso-8859-1?q?6MsCG8uynhEZVazRy3k3JBi1lkoDBoO1/td2KkmAR5bp5B0g4ke?= =?iso-8859-1?q?sQDa1zgCPCN48PIMw2bZG8cgznTkAwgK1/uB7j6Mxjn8msr1hYL?= =?iso-8859-1?q?lFPl/ZV4YxW3RxT9nzOofx5ARqgVxKgh1GBnxWurozS8rygxs4B?= =?iso-8859-1?q?wHUXM/rdL3rGzmVD3HLSmtNWMUy920NSHA1H02O1Pp9e4rKHmjN?= =?iso-8859-1?q?Rfunpmf2jYgtK6DkhNHfQltWA7WJKf/hg2cbvAY6FLDQ1oRiiVv?= =?iso-8859-1?q?OwjaPrOsIqrz7T5e6OoGVax9LCp28mzKAApWG/sCFX7oKbMb4uZ?= =?iso-8859-1?q?xs7FHZo2+88uQyaY1+tqYKYunduZWhdorMHyHtZeM4PJrabhRyR?= =?iso-8859-1?q?rBO43kMbJ8ki2A+E71MzsNGyqTsc53wqWBXLMa6S9lZzJ92tkut?= =?iso-8859-1?q?QA+Xn8hDGnaofuED6E1TKQOvyhDQG8nDXSjBj9DSX8l/qX5A+gr?= =?iso-8859-1?q?Md85H5GSEimk4qrUyDcFEw=3D?= x-microsoft-antispam-prvs: x-forefront-prvs: 096943F07A x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(376002)(396003)(39860400002)(366004)(136003)(346002)(189003)(199004)(76176011)(6486002)(8936002)(36756003)(99286004)(52116002)(561944003)(14454004)(2906002)(81166006)(8676002)(6512007)(81156014)(6506007)(6436002)(55236004)(102836004)(26005)(386003)(186003)(53936002)(478600001)(316002)(110136005)(54906003)(106356001)(97736004)(105586002)(6116002)(68736007)(50226002)(3846002)(4326008)(86362001)(25786009)(256004)(66066001)(11346002)(71190400001)(446003)(2616005)(14444005)(71200400001)(305945005)(7736002)(476003)(486006)(5660300002); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR18MB2910; H:MN2PR18MB2877.namprd18.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; received-spf: None (protection.outlook.com: marvell.com does not designate permitted sender hosts) x-ms-exchange-senderadcheck: 1 x-microsoft-antispam-message-info: djVsabwSRu1HR47vpYIy1ddXgCTEz0T49o8q/2wo3UvjX4SyDiFYaKiuY43kW87L9WN0ybd75q9HSOrJFvlVtncadH7ox4j636PQnsaJeRMPX0UxWxzw9XwwZaXqvAHZGbZj5hxwDDEpbNVKxdVr00flT3nu1cnB+BXT1Vdn+hecPssa44OkXGtOD2MRx3NTWgCgTEnVbPvVa2m6rA/KSf3bxXcHwlWkVFqII9yeqLcPtGtNhC505ckmhQQEaZn1yMd7h/+Ds6TC8Ay0KbT6nl7V1oHotplvhehqHqlrs71KMofJ0wdUlhW2BCzt9jIO6MQ/Z1gOHY7bm9vOqG5/nv86xx2LWHt927d8i8Yp+4ueU5CCi7FgnmrkPl8N/Ej6iibcP3O0JDKeybBFM9s9hJWPolN8ODCo6NW/7atzDw4= MIME-Version: 1.0 X-MS-Exchange-CrossTenant-Network-Message-Id: 75447571-b467-40b4-9854-08d6a2e93a03 X-MS-Exchange-CrossTenant-originalarrivaltime: 07 Mar 2019 10:39:50.8400 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 70e1fb47-1155-421d-87fc-2e58f638b6e0 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR18MB2910 X-OriginatorOrg: marvell.com X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-03-07_05:, , signatures=0 Subject: [dpdk-dev] [PATCH v2] doc: announce ABI change for cryptodev config 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 new field ff_disable in rte_cryptodev_config. This enables applications to control the features enabled on the crypto device. Proposed new layout: /** Crypto device configuration structure */ struct rte_cryptodev_config { int socket_id; /**< Socket to allocate resources on */ uint16_t nb_queue_pairs; /**< Number of queue pairs to configure on device */ + uint64_t ff_disable; + /**< Feature flags to be disabled. Only the following features are + * allowed to be disabled, + * - RTE_CRYPTODEV_FF_SYMMETRIC_CRYPTO + * - RTE_CRYPTODEV_FF_ASYMMETRIC_CRYPTO + * - RTE_CRYTPODEV_FF_SECURITY + */ }; For eth devices, rte_eth_conf.rx_mode.offloads and rte_eth_conf.tx_mode.offloads fields are used by applications to control the offloads enabled on the eth device. This proposal adds a similar ability for the crypto device. Signed-off-by: Anoob Joseph Acked-by: Fiona Trahe Acked-by: Akhil Goyal --- v2: * Renamed 'ff_enable' to 'ff_disable' doc/guides/rel_notes/deprecation.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 1b4fcb7..d0a60f9 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -75,3 +75,17 @@ Deprecation Notices * crypto/aesni_mb: the minimum supported intel-ipsec-mb library version will be changed from 0.49.0 to 0.52.0. + +* cryptodev: New member in ``rte_cryptodev_config`` to allow applications to + disable features supported by the crypto device. Only the following features + would be allowed to be disabled this way, + + - ``RTE_CRYPTODEV_FF_SYMMETRIC_CRYPTO`` + - ``RTE_CRYPTODEV_FF_ASYMMETRIC_CRYPTO`` + - ``RTE_CRYPTODEV_FF_SECURITY`` + + Disabling unused features would facilitate efficient usage of HW/SW offload. + + - Member ``uint64_t ff_disable`` in ``rte_cryptodev_config`` + + The field would be added in v19.08.