Show a cover letter.

GET /api/covers/78756/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 78756,
    "url": "https://patches.dpdk.org/api/covers/78756/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/cover/20200924163417.49983-1-roy.fan.zhang@intel.com/",
    "project": {
        "id": 1,
        "url": "https://patches.dpdk.org/api/projects/1/?format=api",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "dev.dpdk.org",
        "list_email": "dev@dpdk.org",
        "web_url": "http://core.dpdk.org",
        "scm_url": "git://dpdk.org/dpdk",
        "webscm_url": "http://git.dpdk.org/dpdk",
        "list_archive_url": "https://inbox.dpdk.org/dev",
        "list_archive_url_format": "https://inbox.dpdk.org/dev/{}",
        "commit_url_format": ""
    },
    "msgid": "<20200924163417.49983-1-roy.fan.zhang@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20200924163417.49983-1-roy.fan.zhang@intel.com",
    "date": "2020-09-24T16:34:13",
    "name": "[v10,0/4] cryptodev: add raw data-path APIs",
    "submitter": {
        "id": 304,
        "url": "https://patches.dpdk.org/api/people/304/?format=api",
        "name": "Fan Zhang",
        "email": "roy.fan.zhang@intel.com"
    },
    "mbox": "https://patches.dpdk.org/project/dpdk/cover/20200924163417.49983-1-roy.fan.zhang@intel.com/mbox/",
    "series": [
        {
            "id": 12481,
            "url": "https://patches.dpdk.org/api/series/12481/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=12481",
            "date": "2020-09-24T16:34:13",
            "name": "cryptodev: add raw data-path APIs",
            "version": 10,
            "mbox": "https://patches.dpdk.org/series/12481/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/covers/78756/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 91D1FA04B6;\n\tThu, 24 Sep 2020 18:34:26 +0200 (CEST)",
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 0DEEE1DECA;\n\tThu, 24 Sep 2020 18:34:25 +0200 (CEST)",
            "from mga09.intel.com (mga09.intel.com [134.134.136.24])\n by dpdk.org (Postfix) with ESMTP id 5B9931DEC6\n for <dev@dpdk.org>; Thu, 24 Sep 2020 18:34:23 +0200 (CEST)",
            "from fmsmga005.fm.intel.com ([10.253.24.32])\n by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 24 Sep 2020 09:34:22 -0700",
            "from silpixa00398673.ir.intel.com (HELO\n silpixa00398673.ger.corp.intel.com) ([10.237.223.136])\n by fmsmga005.fm.intel.com with ESMTP; 24 Sep 2020 09:34:20 -0700"
        ],
        "IronPort-SDR": [
            "\n HK82kuvLK/71AFbBAzcAO8iooCzd/XZKbedSlgESF0ZK7QDBq8By1KtV2p+971SNSpSDOIXAph\n 1vpzeTEXyZpw==",
            "\n zpTijZXasuxnp51CvRo6AxFfozKMgZ/gQEcFH50mq0JXbEgjcrO0WOOKE6i4VvQczjGD/O7I1o\n M2TAu+eYol5g=="
        ],
        "X-IronPort-AV": [
            "E=McAfee;i=\"6000,8403,9754\"; a=\"162162676\"",
            "E=Sophos;i=\"5.77,298,1596524400\"; d=\"scan'208\";a=\"162162676\"",
            "E=Sophos;i=\"5.77,298,1596524400\"; d=\"scan'208\";a=\"512233174\""
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "From": "Fan Zhang <roy.fan.zhang@intel.com>",
        "To": "dev@dpdk.org",
        "Cc": "akhil.goyal@nxp.com, fiona.trahe@intel.com, arkadiuszx.kusztal@intel.com,\n adamx.dybkowski@intel.com, anoobj@marvell.com,\n konstantin.ananyev@intel.com, Fan Zhang <roy.fan.zhang@intel.com>",
        "Date": "Thu, 24 Sep 2020 17:34:13 +0100",
        "Message-Id": "<20200924163417.49983-1-roy.fan.zhang@intel.com>",
        "X-Mailer": "git-send-email 2.20.1",
        "In-Reply-To": "<20200908084253.81022-1-roy.fan.zhang@intel.com>",
        "References": "<20200908084253.81022-1-roy.fan.zhang@intel.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] [dpdk-dev v10 0/4] cryptodev: add raw data-path APIs",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.15",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "The Crypto Raw data-path APIs are a set of APIs are designed to enable\nexternel libraries/applications which want to leverage the cryptographic\nprocessing provided by DPDK crypto PMDs through the cryptodev API but in a\nmanner that is not dependent on native DPDK data structures (eg. rte_mbuf,\nrte_crypto_op, ... etc) in their data-path implementation.\n\nThe raw data-path APIs have the following advantages:\n- External data structure friendly design. The new APIs uses the operation\ndescriptor ``struct rte_crypto_sym_vec`` that supports raw data pointer and\nIOVA addresses as input. Moreover, the APIs does not require the user to\nallocate the descriptor from mempool, nor requiring mbufs to describe input\ndata's virtual and IOVA addresses. All these features made the translation\nfrom user's own data structure into the descriptor easier and more efficient.\n- Flexible enqueue and dequeue operation. The raw data-path APIs gives the\nuser more control to the enqueue and dequeue operations, including the\ncapability of precious enqueue/dequeue count, abandoning enqueue or dequeue\nat any time, and operation status translation and set on the fly.\n\nV10:\n- Changed rte_crypto_sym_vec structure to support both sync cpu_crypto and\n  async raw data-path API.\n- Changed documentation.\n- Changed API names.\n- Changed the way data-path context is initialized.\n- Added new API to attach session or xform to existing context.\n- Changed QAT PMD accordingly with new APIs.\n- Changed unit test to use the device feature flag for the raw API tests.\n\nv9:\n- Changed return types of submit_done() and dequeue_done() APIs.\n- Added release note update. \n\nv8:\n- Updated following by comments.\n- Fixed a few bugs.\n- Fixed ARM build error.\n- Updated the unit test covering all tests.\n\nv7:\n- Fixed a few typos.\n- Fixed length calculation bugs.\n\nv6:\n- Rebased on top of DPDK 20.08.\n- Changed to service ctx and added single job submit/dequeue.\n\nv5:\n- Changed to use rte_crypto_sym_vec as input.\n- Changed to use public APIs instead of use function pointer.\n\nv4:\n- Added missed patch.\n\nv3:\n- Instead of QAT only API, moved the API to cryptodev.\n- Added cryptodev feature flags.\n\nv2:\n- Used a structure to simplify parameters.\n- Added unit tests.\n- Added documentation.\n\nFan Zhang (4):\n  cryptodev: change crypto symmetric vector structure\n  cryptodev: add raw crypto data-path APIs\n  crypto/qat: add raw crypto data-path API support\n  test/crypto: add unit-test for cryptodev raw API test\n\n app/test/test_cryptodev.c                     | 784 ++++++++++++++-\n app/test/test_cryptodev.h                     |  12 +\n app/test/test_cryptodev_blockcipher.c         |  58 +-\n doc/guides/prog_guide/cryptodev_lib.rst       |  96 +-\n doc/guides/rel_notes/release_20_11.rst        |  10 +\n drivers/crypto/aesni_gcm/aesni_gcm_pmd.c      |  18 +-\n drivers/crypto/aesni_mb/rte_aesni_mb_pmd.c    |   9 +-\n drivers/crypto/qat/meson.build                |   1 +\n drivers/crypto/qat/qat_sym.h                  |  11 +\n drivers/crypto/qat/qat_sym_hw_dp.c            | 951 ++++++++++++++++++\n drivers/crypto/qat/qat_sym_pmd.c              |   9 +-\n lib/librte_cryptodev/rte_crypto_sym.h         |  40 +-\n lib/librte_cryptodev/rte_cryptodev.c          | 104 ++\n lib/librte_cryptodev/rte_cryptodev.h          | 354 ++++++-\n lib/librte_cryptodev/rte_cryptodev_pmd.h      |  47 +-\n .../rte_cryptodev_version.map                 |  11 +\n lib/librte_ipsec/esp_inb.c                    |  12 +-\n lib/librte_ipsec/esp_outb.c                   |  12 +-\n lib/librte_ipsec/misc.h                       |   6 +-\n 19 files changed, 2437 insertions(+), 108 deletions(-)\n create mode 100644 drivers/crypto/qat/qat_sym_hw_dp.c"
}