From patchwork Thu Jan 17 09:39:33 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anoob Joseph X-Patchwork-Id: 49903 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 0AA4E2D13; Thu, 17 Jan 2019 10:40:11 +0100 (CET) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by dpdk.org (Postfix) with ESMTP id C8C932C55 for ; Thu, 17 Jan 2019 10:40:09 +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 x0H9dusi024721; Thu, 17 Jan 2019 01:40:08 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=pfpt0818; bh=AEFdqbROOZN/OdWlj/hld8RKi+6DgTOHPkvqBMW61zM=; b=ATuQrqvinMMDzYgir7w3bcihlc+unI5Qi3d3zHdOMchjH9Y4+94P+eDmoa8KL8+i1lqf UOewow7f3tBMDci8TAi/ZK3FD4ye+ZcpGbK59M6ETP1WyTDNhKqjXg6m+8Zg+CynL0wo dhRsyvpKZYsfTdphJGvzzzoBNdxOQlpmJdcpBBnGS/zJd4PpvC2T5FQGh6o6hsSNGguD q0cNr+EQmbwbZuU3rlwZYnktcnhS55KbqA8S8gRcR2U61aEVP/KBogwbAwiX0XXgo4z1 DeIW5QwYw37KTNsdXIOl0oFEcnr4INYAQ2ywj6OREDdeg8av3AI6oQEqwYQeAIAbOnVj SQ== Received: from sc-exch01.marvell.com ([199.233.58.181]) by mx0b-0016f401.pphosted.com with ESMTP id 2q29mt4age-12 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Thu, 17 Jan 2019 01:40:08 -0800 Received: from SC-EXCH02.marvell.com (10.93.176.82) by SC-EXCH01.marvell.com (10.93.176.81) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Thu, 17 Jan 2019 01:39:35 -0800 Received: from NAM02-SN1-obe.outbound.protection.outlook.com (104.47.36.58) by SC-EXCH02.marvell.com (10.93.176.82) with Microsoft SMTP Server (TLS) id 15.0.1367.3 via Frontend Transport; Thu, 17 Jan 2019 01:39:35 -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=AEFdqbROOZN/OdWlj/hld8RKi+6DgTOHPkvqBMW61zM=; b=J29hSiDemJdAxoXifFqKrZ+XkLpCS5xon32czv/0LEfsREsdmyx2b0ab/f8HkqYUHAJswPvkseFQi9SfSbtWdbA8Fs9IBQ6hV/+KV/3qgoa8l7UcpmQhNdgc5AmiOMfH6ylCz7B68zGaN5UaQ28yHzg1iwg8lqziLOP+eN3hC5A= Received: from MN2PR18MB2877.namprd18.prod.outlook.com (20.179.22.16) by MN2PR18MB2896.namprd18.prod.outlook.com (20.179.22.75) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1537.26; Thu, 17 Jan 2019 09:39:33 +0000 Received: from MN2PR18MB2877.namprd18.prod.outlook.com ([fe80::e974:6b01:9631:11d7]) by MN2PR18MB2877.namprd18.prod.outlook.com ([fe80::e974:6b01:9631:11d7%6]) with mapi id 15.20.1537.018; Thu, 17 Jan 2019 09:39:33 +0000 From: Anoob Joseph To: Akhil Goyal , Pablo de Lara , Fiona Trahe CC: Anoob Joseph , Jerin Jacob Kollanukkaran , Narayana Prasad Raju Athreya , Shally Verma , "dev@dpdk.org" Thread-Topic: [PATCH] doc: announce ABI change for cryptodev config Thread-Index: AQHUrkiNRSYeo6tWnUGaZWm74s8S2A== Date: Thu, 17 Jan 2019 09:39:33 +0000 Message-ID: <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: BM1PR0101CA0045.INDPRD01.PROD.OUTLOOK.COM (2603:1096:b00:1a::31) To MN2PR18MB2877.namprd18.prod.outlook.com (2603:10b6:208:a0::16) 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-microsoft-exchange-diagnostics: 1; MN2PR18MB2896; 20:7m241R2feFLYrAc3VBRs7wwh4hDWJ4jrb+83Z9adCJEgJwnb79YnFNtwnL4jz9XuH6KKs74qfD+6fxkPo5HiVmAKUonyVhZ/tmjt5Pr1/DxofabX69zMBrVjQMnvMZ+lbb9oIGVIZhryUdoVnYtIPft+DP2W3unqadTN3JRWrjM= x-ms-office365-filtering-correlation-id: dcdf9705-d95f-4a4b-f548-08d67c5fafba x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(7168020)(4627221)(201703031133081)(201702281549075)(8990200)(5600109)(711020)(2017052603328)(7153060)(7193020); SRVR:MN2PR18MB2896; x-ms-traffictypediagnostic: MN2PR18MB2896: x-microsoft-antispam-prvs: x-forefront-prvs: 0920602B08 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(136003)(366004)(39860400002)(376002)(396003)(346002)(199004)(189003)(2906002)(97736004)(561944003)(6436002)(55236004)(316002)(36756003)(186003)(6486002)(102836004)(50226002)(81166006)(5660300001)(386003)(71190400001)(71200400001)(4326008)(81156014)(25786009)(6506007)(256004)(66066001)(8676002)(105586002)(7736002)(68736007)(3846002)(486006)(2616005)(478600001)(53936002)(52116002)(476003)(6512007)(110136005)(54906003)(86362001)(8936002)(305945005)(106356001)(26005)(99286004)(6116002)(14454004); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR18MB2896; H:MN2PR18MB2877.namprd18.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX: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: HPDZoravCWbrST6mhz2YesSB3ej1DkI8lFdL1sUNgfCi7nzrWxVUpZFZiENIEPiMT/GKBg8JpVOJrW+AxJXDnctODiiEgyOToNSu4xWN1nsqe56WQA/Zm2Bs1D/IzCiI1ka59bY7ZOodH8kNpOGIRU7hG3ajSkaPLVeHFtX4Phl8pzQd5etqUSuVar45pkGoPY65AKdUmf6biqcDODuLZ0z5VytyOVx3SRJRgv3/HgYtcqQf7mHloPYW5KfnRv6LIjaYpX2Smj9g5Qpov07YfGovyMMmcf50LHrGqP8o5OrrzGcNevsQmIB6a/zjRPOTeMXRgLu7pFW/BWkjouUCitA7UtIdKRGeUMvdk0Jnnuv9iUKKmsxeq/ajuX7M3Ui/AqCQ8Y213PzQM/fWQHkl91AfbEaROZfja4COALcGtAY= spamdiagnosticoutput: 1:99 spamdiagnosticmetadata: NSPM MIME-Version: 1.0 X-MS-Exchange-CrossTenant-Network-Message-Id: dcdf9705-d95f-4a4b-f548-08d67c5fafba X-MS-Exchange-CrossTenant-originalarrivaltime: 17 Jan 2019 09:39:30.9890 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 70e1fb47-1155-421d-87fc-2e58f638b6e0 X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR18MB2896 X-OriginatorOrg: marvell.com X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-01-17_03:, , signatures=0 X-Proofpoint-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1901170070 Subject: [dpdk-dev] [PATCH] 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_enable 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_enable; + /**< Feature flags to be enabled on the device. Only the features set + * on rte_cryptodev_info.feature_flags are allowed to be set. + */ }; 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: Akhil Goyal --- doc/guides/rel_notes/deprecation.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 5f03443..e289c2d 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -66,3 +66,13 @@ 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 + specify the features to be enabled on the crypto device. For eth devices, + applications can use ``rte_eth_conf.rxmode.offloads`` and + ``rte_eth_conf.txmode.offloads`` to control the offloads enabled. Adding + a similar field to facilitate efficient usage of HW/SW offloads. + + - Member ``uint64_t ff_enable`` in ``rte_cryptodev_config`` + + The field would be added in v19.05.