From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-ve1eur01on0057.outbound.protection.outlook.com [104.47.1.57]) by dpdk.org (Postfix) with ESMTP id C382C1B026 for ; Mon, 16 Apr 2018 11:17:12 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=9L9C8BujEyVNoDE+YpqKsd3+FwGmHgtBSypwaiGKcbI=; b=ZVzw9dtoAXKrQcCe6uDr/CdhRWtXE/Buuz1SQG68lSXa9DDGOLMbD7sVaabJJw/C4VgVInFqyD6hJy6c8tsweaj6g/qDrCx6EcB9I/0K6Xvw0h5wJBiwANpvxv3CktvzJP0IuL31L7s5ihP3S7gDeUfEQ9OwFcQuEyB63oBCc8U= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=akhil.goyal@nxp.com; Received: from [IPv6:2402:3a80:9d6:3248:8d4f:1377:6658:252b] (2402:3a80:9d6:3248:8d4f:1377:6658:252b) by HE1PR04MB1386.eurprd04.prod.outlook.com (2a01:111:e400:535b::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.675.10; Mon, 16 Apr 2018 09:17:07 +0000 To: Abhinandan Gujjar , pablo.de.lara.guarch@intel.com, declan.doherty@intel.com, jerin.jacob@caviumnetworks.com, hemant.agrawal@nxp.com, dev@dpdk.org References: <1523861696-103397-1-git-send-email-abhinandan.gujjar@intel.com> <1523861696-103397-3-git-send-email-abhinandan.gujjar@intel.com> Cc: narender.vangati@intel.com, nikhil.rao@intel.com From: Akhil Goyal Message-ID: Date: Mon, 16 Apr 2018 14:46:53 +0530 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 In-Reply-To: <1523861696-103397-3-git-send-email-abhinandan.gujjar@intel.com> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Originating-IP: [2402:3a80:9d6:3248:8d4f:1377:6658:252b] X-ClientProxiedBy: PN1PR01CA0111.INDPRD01.PROD.OUTLOOK.COM (2603:1096:c00::27) To HE1PR04MB1386.eurprd04.prod.outlook.com (2a01:111:e400:535b::16) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(5600026)(4534165)(4627221)(201703031133081)(201702281549075)(48565401081)(2017052603328)(7153060)(7193020); SRVR:HE1PR04MB1386; X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 3:oUh4PY8YKK+QoHu6ORU4lQeutJP4MYkiJdmtF8hiuYkYKWnzY34gLgwvd1iImmco+yVdbBK6gkq0IgKXnHQ9MeFRkpXYi8mySzIDhsMqvhShr/AbddqLmsbUN9/dPqYNWSJN/zN4aDxspJzxIQkN9TRhd9hb9C+tTBVgICMdu9mzFecKZi9C26wCH32kC7Sch8Dw05Y+OIwXTwk/lRDwCQ6nw6R3z1w4h5AYMzLPDYrUkzSgPOe9cCJVjoSpk2cR; 25:bnyrsma83oY4OdbT6KsrxqrdvJASmgtv8yyAppMMDnMRjsCJA3HrOyrfIUUvOkyRJra7P+RyUxTvHRqW4SnXh5tTeye9l6gJ2PHgaL+LN61/uQR37qTcnj0D0/zGzvZV0XbghPePQ1BT1ahPq6SkZ0nX1KBOMpLWO043kZwHG+BOk/MT0ZwzJIyqAteaaZzETjxtuzNqbzAkSbJr/8efXBEkUwU9+EQPAz3ORfsSm6VOKQl68+qrhfM0njBB7s1Fhmx9kp8r5mGsH9qKX7K89G8zLZakyuMKYaPBo3z87/rmcVKvESDyz0pRLYkvHttiuM4eVRaMGX52SfeKxaFCRg==; 31:iEbKVA9L9JCNbdY1f738r0cXzu2T7SIyAZCVXNidHrKBDh6YR0flf9G2mLWYOgT49hYg9DAhRqUa+6IY/bUYgALczV9Mhbhqj9iBsjceDi0N/4XYQ6qSjD5EMAlM3GNNz8taIsJCwZHHJ/38pegAYfEtDE+KaImAK1dkY1qC/21sQQpK70bNYsKKVyP0rvCXtJyKJfU7wTLrFzhSBEb6YMa/Y7X+7ZjhzWxfTSBtwsE= X-MS-TrafficTypeDiagnostic: HE1PR04MB1386: X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 20:S4mtYtRA0pe9gOBXK4MFBxB5akVHLTDa2saajco/Jk0FtBgnSh4KAD3QKOSj4HeczhyQR8sQrJakYlLNjix9qN8BD51fYBfQxtGbhs4FuyxAPe48R8T0aSDPvAUIZcNYZEgNPeqZ+86R9cfckDOrBdkUCV3+9GBn0I4w/GwMucgBgEFtcQsKOXMsjb4Qz7mWyqb+7vn+GUKwf7Hmut1nrr8opXuxAuW0vtezL4qA6rSLbGe7XLaJayqUJrUSPiCUynCE9fIbRicc8EqSQHhHYjkN3a7u+tR9/3WMBBaP0Im41s6R3RkvSWN+4YjEFV8IlY3jbZx3hQeT2Va0BI3xRHCCLuMiQLMycqRywtafxAhsxUj+a05bWKAcmvrU6aLn/vPcwUcdmd3t3ZnFD/x+9RvojtH+eCvoLHmlAa1OdppW1DsGLfvGhOXiV6c0XjjgruEaUcRcXJSNRPm3ekWRVLDA+V9T4H97oi1Qz7uw1TkxaasyiriyZVSLGKIwmRJH; 4://e8ZmzHLmHMkpSPxqKUo+GdofhwEMVFDX5TFOBosxHRCJR5v8rzYNMJQ79pIcwFockZhLZVcRfj1XePe4hZEHK7uYOO31cX9JZs6J19RCS6xVqwp+nsBRTE0g1COcjo9DlBXi4nap8oCAoNzr9ToWGBG5lwQpR2dJSsaq3u+okezOhIhRziABX7V2ZFF0kVtCDnQKixvpbgTR5wdYgR+DHqtplmYMXsY/m+lQ8V80ELUa4Wm8/mklxVxcrhHIrVnRddWE3JsyvGidjElIqv0B56XIBfmlhwysVJ9Q1HSR6x1GAhpMetPYkV/UP0vVlZjBtg+wUGen7OQR3ToCRt+JMfIENGTSWC7hnPRR9TVCQ= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197)(228905959029699); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(3231232)(944501327)(52105095)(93006095)(93001095)(3002001)(10201501046)(6055026)(6041310)(20161123558120)(20161123560045)(20161123564045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(6072148)(201708071742011); SRVR:HE1PR04MB1386; BCL:0; PCL:0; RULEID:; SRVR:HE1PR04MB1386; X-Forefront-PRVS: 0644578634 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(346002)(39380400002)(366004)(39860400002)(376002)(199004)(189003)(54534003)(8936002)(478600001)(316002)(65956001)(65806001)(76176011)(52116002)(23746002)(386003)(53546011)(52396003)(6116002)(47776003)(105586002)(305945005)(7736002)(31686004)(106356001)(58126008)(64126003)(53936002)(6246003)(44832011)(67846002)(68736007)(46003)(230700001)(186003)(16526019)(65826007)(476003)(486006)(2906002)(5660300001)(446003)(50466002)(2616005)(11346002)(31696002)(229853002)(97736004)(86362001)(1706002)(36756003)(8676002)(6666003)(25786009)(4326008)(3260700006)(81166006)(6486002)(81156014); DIR:OUT; SFP:1101; SCL:1; SRVR:HE1PR04MB1386; H:[IPv6:2402:3a80:9d6:3248:8d4f:1377:6658:252b]; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?Windows-1252?Q?1; HE1PR04MB1386; 23:Pb2TBseY6IIHw5oKKTvfrdCatz1guBFs7j4mj?= =?Windows-1252?Q?hGFWxpxFuQ4HUdgcTtbhajoOwCq2I1cyDAx5j5VkGEGEhr+HmfL71813?= =?Windows-1252?Q?8r0OPNmMo+M9wJ76EVBuVvJbE+Zg4CRGJrn0MN2ClDPuT0NAmM7ee+/q?= =?Windows-1252?Q?n6IDFfNJhDhZ3o4+uNDg9V6f2IWaQllY0nGUWPY8j88Ix449ZUs1qg+3?= =?Windows-1252?Q?pkxupegBJ8F6VlXGyYc8c8YtNFRJE0qmjEQGcjsAO13bk1ynX3VpY9O6?= =?Windows-1252?Q?5nzeIjXtoZwW2Dbc6i5IlI+gw3Gqljbm7ko54diB9ein/xyIpLX9jN5R?= =?Windows-1252?Q?qn85KDc+NQA+c+MggESigJTOEnyiZ58YfWqDXQzFTchiXJTe3eAnkR/z?= =?Windows-1252?Q?6Tcm/9JaT20rY3wfBNc92XAzyqcHn5KSSrx48vJEqYJ50Ip1GnEuVpAU?= =?Windows-1252?Q?1yUO1Rce6sQ1gIYSYN4oxoewyz/m4YqoSUB6fOBij/+p6uoUicdg4Wgv?= =?Windows-1252?Q?WV+SuU1BzJ1IILFmi/ZoZ2eTPe4BNrradA6kcGGO0s3emdn052a8ari6?= =?Windows-1252?Q?JaAoYRfGTew4QW83PdznC1PyCTQOnD1mJx7PDuiJVCWldhtdZfeeV+sm?= =?Windows-1252?Q?GN9T04+cCy+IZDyBX2zTiJJhqSy3NRnuyWw2zfmq7DxFNoq4TjZOsZlf?= =?Windows-1252?Q?7MoYsb9r1rgR5VeU+lcAgRZfZZunwA0yyvGcgpOL871/D24S9flDqPzp?= =?Windows-1252?Q?lQPOkqIG/CpuRdwrIYOMHxamSLBKwdkJbKZUbiJImrrEEv2fCURq2jtD?= =?Windows-1252?Q?jCzbJYsT9XIzhdaiDja3souwXgfKeWCKtZNneTxA6OoqGDyAL1Jj1TsY?= =?Windows-1252?Q?jC2OLjjXv6BXOANBy98Nri6vZwabpWOHWrcpWUHuHIp12fpXKClTLwB6?= =?Windows-1252?Q?eS9r4viDhjFCVV+wGiADoniJNwDCMZfzI5EXfqw7SKrxuyEWZUBt1Te1?= =?Windows-1252?Q?4WSIwrg+3SaL5+lAPz1n2OFevDtbogBRjta+U6yhzR2t14KfqyKDIdPw?= =?Windows-1252?Q?SJE8XzIfuvhNKLGfbbVRaBGb+82cG4FPb34UDWE53wp8wY/bkGTvW9ZU?= =?Windows-1252?Q?HiM3BENvtVnXcQUJ2R3j52hMhDL7umJ1yXMXTfvu11PbiH217QOrp8JX?= =?Windows-1252?Q?dWaxOEsCSnD5ZTS0UHQjXWlR6fOgkzHNdnDKKOa9I/QZKeXDdsW//wr/?= =?Windows-1252?Q?PCDmwAfn4Ihqta05Rg2SFtV4/oGQ7weGK6nCX9Pr7ssBGTy3TmU8nRfP?= =?Windows-1252?Q?GETCZOWg5l5UEkDNkyH013CQj6YPH71DJJFD/Sx7oeC36puTOnbC4uHk?= =?Windows-1252?Q?GujHLw4TK5PZcc2w3ukFJGFAFMn4aVKmD9HBTjORXzi9n5wzoTu1T72j?= =?Windows-1252?Q?pEB8XV/cYInkn2+Ks2e50ZVgwQUhhnJatn3FD+B4gp8vIq3zh+HF+Pin?= =?Windows-1252?Q?jPhYOM=3D?= X-Microsoft-Antispam-Message-Info: tyJQXwl7JkDW+VOu9w+PKXmnIqfI7ewKCajVBTaq/DtylqTlkljfhT/ooU+NSnKKX5ecCH2wuz2wsw8AbmYIV/lV22ugyilnjp+4FByUDuRzedAm18TGjKeZnOSr2gSnChUymxY+sZlO8qRBwFt9mYAAh1Ej/6AWb4iVL7PJciU1yuxf6/8phpBf1tiuiVHT X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 6:EIB3LK7uWPtpdrNwv9SzOaRShPsnqW41/NfdbcF1u8gzac9ZClq6QU/x6JhufVvSQOMnyblEmw3ALYWFwK58v4DFkXjp4h0ySVg2Raat58iEXc0C51/ETsQwpcFpXXfbiIheSLunIRqUlFNIKMBScZI8wJK/DAsCnIdtR52K2UaqlBw1GLvuGqgggxf6g7kyZbTlkz6gmfHaWP5E+e9RmK2l/Um2rbVRYuKIIkow8ctQB405zwutIYekXhW+QGoSCkD0TWcxObMDVseogBgxl1q4dZTDnHWM7fFgTJ6/ovkaA+ZU96qWeS8c4ZqjOFaYQplN7pxRtdkMSjv4/J0XVR8BBru+0KgcrrLyLX1/eGiANxSwLZ+1VbZKjYAwzfn69obkg4tAK/r1sVUMIehcExVuW8ikLo2heDF6MAq+mCREBunYOBaQ8ZF7WqWioYyskNiWc5osX4a84pgcYFLv5w==; 5:4lyWIQ6O7vrex9oq3nY1568iYsXxHUTe28qUvFZt9NIeA6NYjPMfvW7LeZfAQsdNUDQEopVCwHFg4SgUn+gT2m2fvee7QXOM8uRPHs3i84/DXC3IQGYwwPhpbHOnwDX+33jhCUF5Z6NYLV6gEOdY2e1eq4X1Y9jNRijBux9TwLE=; 24:Wh8lUGweHkpy2yCToKOdBUHd4wM6oXGyXVZ0VzZ8WNvLK7yKUPxDM1mFiVCycFvG2dZflaSaAetdBQrOLGwgyMAjU/RaIWiunhBVAny9DFg= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 7:caw0BuTuRhC3Qx5xrQTlc1vSgZCAJSh6PV0XbJbo9rJWvowS/EslFAT2tMf+mpE3V4EFTn8QmJI4ujacl8+YGH/LoeMYT40OXO09iVXBWEYySGQm01fA4oqzM+fR7LXd2M+D56LTQ8dDjjCi47HOO35OZNayN0VN7GO1RyYoOFH+XBMnznx+B3Rjkpo29CrpAGpihG7YrHLdYFz/YG1YhM4pBvE4uM3+UclqD3gK4NgeV765TMfXUakIxJoDeijb X-MS-Office365-Filtering-Correlation-Id: 842cc70d-3297-46ae-30e9-08d5a37ad52e X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Apr 2018 09:17:07.6487 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 842cc70d-3297-46ae-30e9-08d5a37ad52e X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR04MB1386 Subject: Re: [dpdk-dev] [v3,3/3] doc: add private data info in crypto guide 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: Mon, 16 Apr 2018 09:17:13 -0000 Hi Abhinandan, On 4/16/2018 12:24 PM, Abhinandan Gujjar wrote: > Signed-off-by: Abhinandan Gujjar > Acked-by: Akhil Goyal I think I acked this complete series. And this patch is v2 not v3. You should also mention the changelog. Thanks, Akhil > --- > doc/guides/prog_guide/cryptodev_lib.rst | 27 +++++++++++++++++++++++++++ > 1 file changed, 27 insertions(+) > > diff --git a/doc/guides/prog_guide/cryptodev_lib.rst b/doc/guides/prog_guide/cryptodev_lib.rst > index 066fe2d..b279a20 100644 > --- a/doc/guides/prog_guide/cryptodev_lib.rst > +++ b/doc/guides/prog_guide/cryptodev_lib.rst > @@ -299,6 +299,33 @@ directly from the devices processed queue, and for virtual device's from a > enqueue call. > > > +Private data > +~~~~~~~~~~~~ > +For session-based operations, the set and get API provides a mechanism for an > +application to store and retrieve the private data information stored along with > +the crypto session. > + > +For example, suppose an application is submitting a crypto operation with a session > +associated and wants to indicate private data information which is required to be > +used after completion of the crypto operation. In this case, the application can use > +the set API to set the private data and retrieve it using get API. > + > +.. code-block:: c > + > + int rte_cryptodev_sym_session_set_private_data( > + struct rte_cryptodev_sym_session *sess, void *data, uint16_t size); > + > + void * rte_cryptodev_sym_session_get_private_data( > + struct rte_cryptodev_sym_session *sess); > + > + > +For session-less mode, the private data information can be placed along with the > +``struct rte_crypto_op``. The ``rte_crypto_op::private_data_offset`` indicates the > +start of private data information. The offset is counted from the start of the > +rte_crypto_op including other crypto information such as the IVs (since there can > +be an IV also for authentication). > + > + > Enqueue / Dequeue Burst APIs > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > >