From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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+Y5hoKRdZP6Utd3Z3Oc75uxU1q4rf3bOWn?= =?iso-8859-1?Q?SDc8i1ZZ0EIhUo3EEG1cjjB7BUnD4OC6LW6RCgtyArMkKM0B1LFBqqfDgT?= =?iso-8859-1?Q?CU9zXOnEZpN7EBc5U3oW5k9bFukMEMjX/jcjXX0t+7NGGky/aZLcOvdKy8?= =?iso-8859-1?Q?8zv8RTVCFk6mqLWZGTIBpOEE4YVSanV4SnlxZTT85KFR9CkitoDK/j1MTl?= =?iso-8859-1?Q?a8F8b9v/iGJs/CILamwkL3GCvZi9O9jwMyejsc88VEp6NtTHpe/NxWEFXA?= =?iso-8859-1?Q?SNqboAs1SeGoBptNNahDZoE4I/S7wsr9PupleYWHBaRRADURcbt3Ci2s8q?= =?iso-8859-1?Q?IjRtPEO6iKUcTY4sLjcoOIrK3uIKC5AaptnDe0tHbbQs59LoZRcRU/6g3q?= =?iso-8859-1?Q?EGGfoGkYcOeYmGfr8tWgyRTDYCVLXeN4totoYdF3JZzbGJy9qF0ePxpLnH?= =?iso-8859-1?Q?skgcCPxkNUSq/FYFxkVYP33bcWlZzsTHQOLAWOExP8FAxCFMJJ+TswU6Ii?= =?iso-8859-1?Q?MYylK8Cd9IghZxnCaFrFHJJ5WrTCWsNL+wxm8ub+upXXJXyPDIBLIEXVmc?= =?iso-8859-1?Q?mloTMzXiRg8AbzCk+n1DUHUsJd+fyjpRYLPB9xaFn5owmtXx+QJQEBIqKI?= =?iso-8859-1?Q?RRS8zTqfPUWHB8+Z6KUGupE3/UM8nbVrlS66FpzSxHewKMOYqN3jMak5fv?= =?iso-8859-1?Q?lUJLFgstBtu0ypnDcpHA5NcBWYUYilG/3t8l17LoTBt6MsCG8uynhEZVaz?= =?iso-8859-1?Q?Ry3k3JBi1lkoDBoO1/td2KkmAR5bp5B0g4kesQDa1zgCPCN48PIMw2bZG8?= =?iso-8859-1?Q?cgznTkAwgK1/uB7j6Mxjn8msr1hYLlFPl/ZV4YxW3RxT9nzOofx5ARqgVx?= =?iso-8859-1?Q?Kgh1GBnxWurozS8rygxs4BwHUXM/rdL3rGzmVD3HLSmtNWMUy920NSHA1H?= =?iso-8859-1?Q?02O1Pp9e4rKHmjNRfunpmf2jYgtK6DkhNHfQltWA7WJKf/hg2cbvAY6FLD?= =?iso-8859-1?Q?Q1oRiiVvOwjaPrOsIqrz7T5e6OoGVax9LCp28mzKAApWG/sCFX7oKbMb4u?= =?iso-8859-1?Q?Zxs7FHZo2+88uQyaY1+tqYKYunduZWhdorMHyHtZeM4PJrabhRyRrBO43k?= =?iso-8859-1?Q?MbJ8ki2A+E71MzsNGyqTsc53wqWBXLMa6S9lZzJ92tkutQA+Xn8hDGnaof?= =?iso-8859-1?Q?uED6E1TKQOvyhDQG8nDXSjBj9DSX8l/qX5A+grMd85H5GSEimk4qrUyDcF?= =?iso-8859-1?Q?Ew=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= Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable 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: , X-List-Received-Date: Thu, 07 Mar 2019 10:39:55 -0000 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 --- 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/de= precation.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 =20 * crypto/aesni_mb: the minimum supported intel-ipsec-mb library version wi= ll 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 feat= ures + 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 offl= oad. + + - Member ``uint64_t ff_disable`` in ``rte_cryptodev_config`` + + The field would be added in v19.08. --=20 2.7.4