From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR01-DB5-obe.outbound.protection.outlook.com (mail-db5eur01on0060.outbound.protection.outlook.com [104.47.2.60]) by dpdk.org (Postfix) with ESMTP id 7B44A1B87D for ; Tue, 10 Apr 2018 11:22:15 +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=bf8GPEQOx6P495jRC3OWJrug5Pf4/2PRREr19tQvWrA=; b=IQu40q7zCYW6p42A9Ff/3mgJGmq3liL3qVsXsqRh9hN4Mx07ccl2xuTlrMy1lNtFyjH7BZq+VitnZ2bAeM/dLYXJl2TjCViA0FwSJIdpuaxkOIrlAaXc6V2rWfy0CFGj3Nn4hpQThfo6Kr8aYaRWIVqmvWxj8vWBuErPNPO2JBs= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=akhil.goyal@nxp.com; Received: from [192.168.1.8] (171.61.180.195) 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.653.12; Tue, 10 Apr 2018 09:22:11 +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 Cc: narender.vangati@intel.com, nikhil.rao@intel.com References: <1522823672-60023-1-git-send-email-abhinandan.gujjar@intel.com> From: Akhil Goyal Message-ID: <41e3bfb1-22ce-f359-0969-e8edec7bd9dc@nxp.com> Date: Tue, 10 Apr 2018 14:51:57 +0530 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 In-Reply-To: <1522823672-60023-1-git-send-email-abhinandan.gujjar@intel.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Originating-IP: [171.61.180.195] X-ClientProxiedBy: BM1PR01CA0079.INDPRD01.PROD.OUTLOOK.COM (2603:1096:b00:1::19) To HE1PR04MB1386.eurprd04.prod.outlook.com (2a01:111:e400:535b::16) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 25de2773-0c24-46a4-b94e-08d59ec48bac X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(5600026)(4604075)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:HE1PR04MB1386; X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 3:LaoecRQO6zXCpCyo+zz5ayTuczJfhj+zYAlv1Z2JazMHnvGZ4ymWOd9eVOK8tB1tcy1bCf/J2ojXYyAR52MXizOqLjoxRQKVBbPwzceqMiif7ksW9rT8OyFHFvZJPAVnIaxt5P2J3IwX0NIbOs9KkyXKOYBi6E3DRBcrttUzk+unB8S03eYaNVIxDOKfRixQTAXs3j+XnhXKZKrti9T2SMvz0Fj0Ay+aLoR3D905XvNPCsrMXCzgSZCB29oNvJON; 25:YdwFX6IIG453OHi+g2wYFHexp3Rfb5cZiPbJnerTiaaYVxIsB1Jw62Ebmt80qx66skn5qqUdmmRGbJ7Gcu2kTjTN+ZnPckGVRphYfU5cgF0hUea+LxrPTbrKVo19CaOqi43YIZpQsOzlVzPEhPHJD0+D8inubO2bAsnaq4TjD/sgwOKT8RG2HFBF0xl1VqgZzr0QH0XOJoy3J74lSzvwfHtFpNpu7OKvJfPpOwc0UEd8isC2RrbujdMk0No3n9g8blymx1ZC3wJGu3iIgj0pWPdV+K3EGKZfDeZJlSA3EGVX3TZ6eNJZKq5w+tLKXXfpMlsOpHhdFlIBUIiSVULgVg==; 31:YRJI7POj9lvg1ljiAZbaNuFTwx1sbLicb3Sb2jId3knZ30pkJ0Pl1K57u05tan7bIaqQTgne2LkLj/ZH1iUnwcySVLhyjIJpZCKkc2Nk3pI8XQdCtnP9mRju/0/YmWyr0I6pB5by97R+4qmh2nmSkhNPc7igwbsxyznSsR2XtCEkgywAt7ycCoAUEzAMHgu+wCjgnlNZ9HiAw+Ut3Wfw1ElcABLxtOaFpbAcqDdrixA= X-MS-TrafficTypeDiagnostic: HE1PR04MB1386: X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 20:/FK0ep237oR5Ffh/iJ1MJvOOt4LsvnZyljzkxA3nV/usS0ewzGVqbfd3tNARJpL+wJtW9hrsENmMxeAFv8PZt+HDz43mLuC78eGdoDd7S3RybtiKWiBKoG26MkpeA4LBxOLPmJ55fYhlWjQM3ydbEwthyTY6SDLBKUc2RHJLPeuEQO6wFNeBo+eNJn2/qRQsuGruLmphp+m9YLdAp0M0lHFRbNJ9BAmurjTkehUR4P2APoiwZqKvn9QPEK2StX4yAdoFwCsKuDo12jGURsTVb4XOfjDjNNMt/C4QpAx/OG0WkOt3i9OtWH9sIJxx4jFr671nZAuKmANTD0GclQ4OkiWm4AS7O0dmCBmiaBnhzHs/lvmkHR75kCMk0jrNLoan1aNf9xc5itbVZP7hk2wARNajRoVF7SB6Fi+ZvKM/rAUFIwWp3Zmhni26UCGT2s6IXK5T3fWbRJ1MbbrTRRYqGDqAc1WcijUXQ3mlgAaypB7IEt/FV5LMs4LXcRnAATag; 4:BUpDDBMS5I3LuNcQdfJM6bHdqWXPJGwvBH9Q0Xzwssa0nr0g7GqjdhzjlhziT/UkYKuVAnBPuAQLPH4eb5nQMQjbqIIDySrrKlHxICg/6lm0kD6yK/TEf2UBTOaU3dGqayWGl0xXVvm0ypPVpBMvq/SMNBlILNoY7PwooqUwlhsD1vH9XAiOBoXGBmWGn6Uxv6wZzXzNesvn1mrtpRY1ptbUW9pdNCgxHCQRDFQxkHYAfqG0h8upVZIDl8KGLdFF4Hd0oIPbw6X6feo3gsqQZXDxHOyC6JyntGD+gmA4WmYvOLZv16l+qXUftc+a4B90nJcZzzkrNzCYDz9/5ohRO6/1AtGcZq01cHzB2nmWUs4= 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)(3231221)(944501327)(52105095)(10201501046)(93006095)(93001095)(3002001)(6055026)(6041310)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123564045)(20161123562045)(6072148)(201708071742011); SRVR:HE1PR04MB1386; BCL:0; PCL:0; RULEID:; SRVR:HE1PR04MB1386; X-Forefront-PRVS: 0638FD5066 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6049001)(366004)(39860400002)(39380400002)(346002)(376002)(396003)(189003)(199004)(23676004)(52116002)(52146003)(3846002)(2486003)(6116002)(2906002)(66066001)(486006)(67846002)(8936002)(65806001)(47776003)(97736004)(65956001)(77096007)(65826007)(16526019)(106356001)(446003)(76176011)(105586002)(26005)(186003)(36756003)(956004)(11346002)(5660300001)(31686004)(2616005)(50466002)(386003)(230700001)(316002)(16576012)(58126008)(476003)(6246003)(305945005)(6666003)(4326008)(53936002)(53546011)(31696002)(81166006)(86362001)(117156002)(64126003)(25786009)(6486002)(81156014)(229853002)(7736002)(8676002)(478600001)(68736007); DIR:OUT; SFP:1101; SCL:1; SRVR:HE1PR04MB1386; H:[192.168.1.8]; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtIRTFQUjA0TUIxMzg2OzIzOkEydVcxdHVZcnA3OVQwNVdTYVVtWGhidU42?= =?utf-8?B?VzNWNWs5M04wV3h3TzVoSUZRQ0J1WUZvQjhXN05jYTZ5Mkp6OG9GbXl3blJr?= =?utf-8?B?c0VKbkhTczFPVnlObC9PVktVS2lMc3EzTndtcEFlcVYvYmx5NVZIbzVyMFRJ?= =?utf-8?B?Mmo4V3NrbFNjS2V1NHFZKzNOWHhYY3NtbnRPQkhPVFh0cjZjZjl6QnpRcVR3?= =?utf-8?B?YXU2K1YxTVFxZlVWQ3gxaVd4a0drR0RIZUNCcHNpeHJjaU9LN3JYMUVueU55?= =?utf-8?B?bWpkY2NVeGpJWjJMMnRCT1B2LzVEV3c2c0VUMG42Sk01M1F2VW5BaCthbDRp?= =?utf-8?B?L3paaloya1k2eDFzdWpybnUyRkFVR2F6MFlveDU3aC9oVXRCWld1dEFtem5T?= =?utf-8?B?V2IzRU5SL211M0JMSmhXUFlzeVFlZHpDeW13YkI1MWNQbkJ4Y1JSdGRwQU1r?= =?utf-8?B?dmNQcjJwRWFRYllpbUFKcW1wZ1ZqajZjOStyVFk1RVN4WEUzaEh3N1hEUk53?= =?utf-8?B?NVJOUENKUGJlUFlBUExlTElpN2NnNHZBNFFlUmE5Y0lIM0xwWnQ0T29rb2k4?= =?utf-8?B?MHhVNjBDOEZ5aVUyL1dwa1BOVG9HVmNxR2xLT1VVcytqN04yQmtoQURXTkU1?= =?utf-8?B?bmhaS0QvZHB1V2dtQWNvOTBaL3V0ZEk5RGtHSVNWaWQ4Qnc4YmM1QmhxS3lQ?= =?utf-8?B?MUppTUdXRjJweW15cmFrU1BUTEpIR1dIcXZRdVMzSnh0MHZhSk5nQnBNS0F3?= =?utf-8?B?b0IyMyttUktqaCtJTS9sS0VDQ2ZmMlJVUUEwQk16VEt0R0xTblA4YzUyQk9R?= =?utf-8?B?WHFMRzh3WWJXSWZmcTRWK2lCTE9HbmoreFVjcFJrMnNNNFRXdStnOThhY1ZS?= =?utf-8?B?N1VoSjA1Mzdaa1dIajRoSzAxbHpkS3JuU2phOG9oN3F1VnR1SVljU2pCQU9m?= =?utf-8?B?TVJlZXVLWDVJNVRuT21mcXRLMjNjbGtSaEIyLyt2aUtORzRmUGxlc01YUlh5?= =?utf-8?B?TGpCUE0xZmplb1RmdkJQeUpjS2ovN0ozbjVqMTFSV1hnNHU1RVZOWm9YL2Vp?= =?utf-8?B?eitabzJveGN1ZkRKUVZzV3BxMzF0elBnekZ5dUlST0NLVWxsMWJYVlVIbWZP?= =?utf-8?B?RmZWbFlYMzdhclI5Z2RSQTU5WFc5Q3BVTWl3Ujc3V0lmZmhFTFF1WW1KRXJy?= =?utf-8?B?K0dWeUhjN01UZ1Qzc2hPM25HbGJJMC8wVWhFbzlwQkRtTXdCNDVCaExQWGdE?= =?utf-8?B?WGFnbXQ5U3BJZ1c1QXlLN3Z6S05lOTE3UVZRc1luS3U3VC95S2I4WGQvMzE3?= =?utf-8?B?QnJHNGJtSUVoNnhZNHFsOE1SYlFUeXlUYnNUWlhCOCtmS2UyS2cwKzBLeTJM?= =?utf-8?B?QlYyWG1mekQ4UWF0cUxNU3ZibmNVM0ZLUVpZaHlJVmthVEVOb1dFRGs0M0hl?= =?utf-8?B?UWx1MzNVWjFJanFzR0h1ZXdlSFdQeU1RYXhrWXNLTGR4cHpOMVhtekJPMVJr?= =?utf-8?B?RjdlZEpLTXdBYVFvMTRxMjRuaFc2NHNGVmNBNWZqRnU3K0xaVEVpcWd2enFt?= =?utf-8?B?UzNzU2ppUDgxRExyS2lnT2JsU2JlSExERnpUMlFjUkNEV1FpcDlzZHplOTRN?= =?utf-8?B?L0plRU9LcllxdjhxbWYrT0tSOCtFdnRDSElZbVdxK3ZNZDl2cGd4TkhUTlFF?= =?utf-8?B?WWF6eE9EZm9COXNxOG12M2RubkYxTEZVeENlSGQ4RUVTRjRaWkhwN0NtcC9i?= =?utf-8?B?M0ZOeERPQ2ViL3c2V0l2K3JYOG85RUNnQmRid2ZSdW5BbE8yNDVNaHlhRlVR?= =?utf-8?B?YnpJT3V5R0FONUgwMTcxbGs5bkFROWtoaGdKTkVUT05WdGZFdGJZSzI4Qk80?= =?utf-8?B?NHZWY2ZOYlRFTm1ERWJxZDlrNnJvU3V3dE9VYmQxa1N3cjgrT2FXTEFSV2da?= =?utf-8?Q?U/iCHhYglwUfQkMsRCOkiygwyxbH54=3D?= X-Microsoft-Antispam-Message-Info: Bn0c2IvFq1FgWSblvQBCit7rvMIUupxfeDJEospvmQ4xu4jDit+PEmwPyHvwtYODm4UH8M8/dZk/YgrshUovwu8zfQzkh1NhXZVVXc8ioSeG20xpQQgh2i8dX2hkmsRIAsCTDRv51QUJNzLQdmzmmlVteean1FHXN3HOM40qDaXtHmEf9wEqH3UYIYhFx23F X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 6:tv9s++gjveUC/9N013zUQKwIla33p3q3X00nIfuqp7BnZWB22vLz2PBa0Icg/8oZJngznKTvFTMkv32YkIx88bzil4JJL+GBC0FYWhVw7H3bVaEijB6V/VcKD3EWFOyiOW+F5VejDCgTr7kEgh1Czz1MGWooyqutdJqoeaU6lNTh+vx6BohHjL7fFKfcCi8sXRUndMP1hkrha3to4z5HcV1SKK+c0NVVqH8Xp7asIRIMXUcjBjwphBGdPAscWNeIgGhbckqmk3SilZV7lyrXgoxuPuypZ0PRSnPIicSAhLUICh9GVEsIEGdIFCdJA6HRBOGD1kfqwTEjkaym/yl0iYCruOX1e9Veu0xSSZpmbESFPavXJx2tv4lDyluG1U0+UK/+LGa7RB/QrRVQj1eo53GFthXIf1gb+Q0vsBcb+5EbKYJIXqfSa/uhGgZmwevabUOoEp1MoksRRVH5wawkLQ==; 5:1JtYVraOIJnIXv7nWUDZ4rku8niXKK0aXuzn7+ZcppSJHHfWjxX+uheOJOmbuh+d6x1v2dR+pZskOw/l1/9LzjJt7E/MXkoEQZaLpBPZuRWAo71KfxsJsZpXJQ30/svceiAMM/48EqcuxDhgkA7CAVAozcvDVkdwbqm03rQQ0xo=; 24:K5LG+0BMgzYFLFNs1jauYFld6joSz2hjCL4mIqgky9uyyjlZ1dckAVW8fZ+qMLUoej2nLPPaBqWVmVKDM9BQF4DvUTS7wAWwE2VClKRCRjg= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HE1PR04MB1386; 7:TkshPTYzkY33Yiyoxz9PmXNjJWzL/5I4U6ddppv5pyXrwAwq9+7PMGnmMb5Gp9NBun5TecYnvXkn0sWL2jMF2OU48X2f4Fb7PE/dlCuyaWCowGmlmHK8J8bZeAFOj6GFU8I6OmGqerFYQvFPJGf5Xj9wtHgOnw4GKt+sQRL2w2l8hDQNeuMyBaE03Zo4MB2++Y1tKzdOviE8K6pNzwzLdCghiZo7CZEbjQ/hrK85Wfxn/xgjZ56ytPl2a9Lrlbbo X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Apr 2018 09:22:11.6921 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 25de2773-0c24-46a4-b94e-08d59ec48bac 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] [dpdk-dev, v1, 3/3] doc: update cryptodev documentation for set/get private data 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: Tue, 10 Apr 2018 09:22:15 -0000 Hi Abhinandan, One minor comment. Series Acked-by: Akhil Goyal On 4/4/2018 12:04 PM, Abhinandan Gujjar wrote: > Signed-off-by: Abhinandan Gujjar > --- > doc/guides/prog_guide/cryptodev_lib.rst | 26 ++++++++++++++++++++++++++ > 1 file changed, 26 insertions(+) > > diff --git a/doc/guides/prog_guide/cryptodev_lib.rst b/doc/guides/prog_guide/cryptodev_lib.rst > index 066fe2d..57b3f6e 100644 > --- a/doc/guides/prog_guide/cryptodev_lib.rst > +++ b/doc/guides/prog_guide/cryptodev_lib.rst > @@ -299,6 +299,32 @@ directly from the devices processed queue, and for virtual device's from a > enqueue call. > > > +Set/Get 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 rte_cryptodev_sym_session session. > + > +For example, suppose an application is submitting a rte_cryptodev_sym_session > +operation and wants to indicate private data information is required to be used wants to indicate private data information which is required > +after completion of the rte_cryptodev_sym_session 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 initialization vector (IV). > + > + > Enqueue / Dequeue Burst APIs > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > >