Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/116709/?format=api
{ "id": 116709, "url": "http://patches.dpdk.org/api/patches/116709/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220923024023.15849-6-zhangfei.gao@linaro.org/", "project": { "id": 1, "url": "http://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": "<20220923024023.15849-6-zhangfei.gao@linaro.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20220923024023.15849-6-zhangfei.gao@linaro.org", "date": "2022-09-23T02:40:23", "name": "[v2,5/5] doc: Update doc for UADK crypto PMD", "commit_ref": null, "pull_url": null, "state": "changes-requested", "archived": true, "hash": "ba70fd01259519675d53d3b3309f1dfe168ec45c", "submitter": { "id": 2701, "url": "http://patches.dpdk.org/api/people/2701/?format=api", "name": "Zhangfei Gao", "email": "zhangfei.gao@linaro.org" }, "delegate": { "id": 6690, "url": "http://patches.dpdk.org/api/users/6690/?format=api", "username": "akhil", "first_name": "akhil", "last_name": "goyal", "email": "gakhil@marvell.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220923024023.15849-6-zhangfei.gao@linaro.org/mbox/", "series": [ { "id": 24792, "url": "http://patches.dpdk.org/api/series/24792/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=24792", "date": "2022-09-23T02:40:18", "name": "crypto/uadk: introduce uadk crypto driver", "version": 2, "mbox": "http://patches.dpdk.org/series/24792/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/116709/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/116709/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 17C26A054A;\n\tFri, 23 Sep 2022 04:41:17 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 16BF542905;\n\tFri, 23 Sep 2022 04:41:13 +0200 (CEST)", "from mail-pf1-f179.google.com (mail-pf1-f179.google.com\n [209.85.210.179])\n by mails.dpdk.org (Postfix) with ESMTP id 89F1942B75\n for <dev@dpdk.org>; Fri, 23 Sep 2022 04:41:10 +0200 (CEST)", "by mail-pf1-f179.google.com with SMTP id e5so11117046pfl.2\n for <dev@dpdk.org>; Thu, 22 Sep 2022 19:41:10 -0700 (PDT)", "from localhost.localdomain ([199.101.192.56])\n by smtp.gmail.com with ESMTPSA id\n t5-20020a625f05000000b0053e8940c4absm5075011pfb.209.2022.09.22.19.41.04\n (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128);\n Thu, 22 Sep 2022 19:41:09 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:from:to:cc:subject:date;\n bh=na9S0XUANIdkKUlVww4MNFwq9DfE+aDS+tu0zk16z6w=;\n b=ubhj7FlGbCo4EEEmqqKbTX0nn6iGTxfdQuSlGVQwt6efDloh3Wdxwy9S2sRN1fZ7wu\n U0EMDW9IgAiFUGnn0hWEet8tMklEO777Aidl7uPJvE3F/TXtScGZtSH6+vqk55Y8TCrm\n MbdGsBjCXlVvGc722FxY1V3uXJxy0aotNLoqVkFUzoYtSX2PxaNmJ4H3pk1RiEIqa2a2\n uP2/mX8irT1R1P5xsvb7ymbveAw6/fYCdopidiGnhWAE+8oAuMiWG4rCCmQgcAvJzkHc\n lmTcZrpXY/DTkJUaLOo9qd9vFVsqzpAMODB73bhJaJLH01s/iIIjenog5TjKPnatO88Q\n 5y4Q==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20210112;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc\n :subject:date;\n bh=na9S0XUANIdkKUlVww4MNFwq9DfE+aDS+tu0zk16z6w=;\n b=FpJraarfrnoSfwinImI/EMkFdESj2g50j41qJS0iutWMEjKIz2g1YTmvxvS/AMhc25\n jy/sF0JQyNzE+82PDStTibZoZc1XUtztMrThO3yejUyI1/SJ5jC9A4RweUHjELu1DHAJ\n ubTEQyMbaZq+LR+zEWBwhc/6JG3LZFRQF2GDmdKOXskuHyb/oXslqrNqHrGoXzRu0+U3\n n3VGEUZEJ0q0wj07x091UDAmEuMN5AZS9RzDEWWOonp7NZ1fZGUQoToS6c5hh1n9YPys\n WZSoJsPcmTTjf9etCx1fXUmQHSJXfk0lCpghEs5aAvqzTAyK0AGrRKwoHz3F6J4JiWNz\n 9XAg==", "X-Gm-Message-State": "ACrzQf2C/nVxU7L8MLE+RF1bZ1LrHTNxvV7ZHcXsSUh3oPKTXsPLUnX5\n q1VAZXh7nTJk9AwvtJqH/D3e4g==", "X-Google-Smtp-Source": "\n AMsMyM4O3BQTuZtpWmRxxKiKigKFTi4WMOgoDs8IsH3OXPvviKG7yGe2GoDXKezvinzDtsElCBVp3g==", "X-Received": "by 2002:a63:b957:0:b0:434:c30d:84b0 with SMTP id\n v23-20020a63b957000000b00434c30d84b0mr5771420pgo.293.1663900869796;\n Thu, 22 Sep 2022 19:41:09 -0700 (PDT)", "From": "Zhangfei Gao <zhangfei.gao@linaro.org>", "To": "Akhil Goyal <gakhil@marvell.com>,\n Declan Doherty <declan.doherty@intel.com>,\n Fan Zhang <roy.fan.zhang@intel.com>,\n Ashish Gupta <ashish.gupta@marvell.com>, Ray Kinsella <mdr@ashroe.eu>", "Cc": "dev@dpdk.org,\n\tacc@openeuler.org,\n\tZhangfei Gao <zhangfei.gao@linaro.org>", "Subject": "[PATCH v2 5/5] doc: Update doc for UADK crypto PMD", "Date": "Fri, 23 Sep 2022 10:40:23 +0800", "Message-Id": "<20220923024023.15849-6-zhangfei.gao@linaro.org>", "X-Mailer": "git-send-email 2.36.1", "In-Reply-To": "<20220923024023.15849-1-zhangfei.gao@linaro.org>", "References": "<20220923024023.15849-1-zhangfei.gao@linaro.org>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "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" }, "content": "Update doc for the new UADK crypto PMD, which relies on UADK library [1].\n\nUADK is a framework for user applications to access hardware accelerators.\nUADK relies on IOMMU SVA (Shared Virtual Address) feature, which share\nthe same page table between IOMMU and MMU.\n\n[1] https://github.com/Linaro/uadk\n\nSigned-off-by: Zhangfei Gao <zhangfei.gao@linaro.org>\n---\n MAINTAINERS | 6 ++\n doc/guides/cryptodevs/features/uadk.ini | 54 +++++++++++++++++\n doc/guides/cryptodevs/index.rst | 1 +\n doc/guides/cryptodevs/uadk.rst | 77 +++++++++++++++++++++++++\n 4 files changed, 138 insertions(+)\n create mode 100644 doc/guides/cryptodevs/features/uadk.ini\n create mode 100644 doc/guides/cryptodevs/uadk.rst", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 32ffdd1a61..f485cec2ed 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -1061,6 +1061,12 @@ M: Fan Zhang <roy.fan.zhang@intel.com>\n F: drivers/crypto/scheduler/\n F: doc/guides/cryptodevs/scheduler.rst\n \n+HiSilicon UADK crypto\n+M: Zhangfei Gao <zhangfei.gao@linaro.org>\n+F: drivers/crypto/uadk/\n+F: doc/guides/cryptodevs/uadk.rst\n+F: doc/guides/cryptodevs/features/uadk.ini\n+\n Intel QuickAssist\n M: Fan Zhang <roy.fan.zhang@intel.com>\n F: drivers/crypto/qat/\ndiff --git a/doc/guides/cryptodevs/features/uadk.ini b/doc/guides/cryptodevs/features/uadk.ini\nnew file mode 100644\nindex 0000000000..1418959bd4\n--- /dev/null\n+++ b/doc/guides/cryptodevs/features/uadk.ini\n@@ -0,0 +1,54 @@\n+;\n+; Supported features of the 'uadk' crypto driver.\n+;\n+; Refer to default.ini for the full list of available PMD features.\n+;\n+[Features]\n+Symmetric crypto = Y\n+HW Accelerated = Y\n+\n+;\n+; Supported crypto algorithms of the 'uadk' crypto driver.\n+;\n+[Cipher]\n+AES CBC (128) = Y\n+AES CBC (192) = Y\n+AES CBC (256) = Y\n+AES ECB (128) = Y\n+AES ECB (192) = Y\n+AES ECB (256) = Y\n+AES XTS (128) = Y\n+AES XTS (256) = Y\n+DES CBC = Y\n+;\n+; Supported authentication algorithms of the 'uadk' crypto driver.\n+;\n+[Auth]\n+MD5 = Y\n+MD5 HMAC = Y\n+SHA1 = Y\n+SHA1 HMAC = Y\n+SHA224 = Y\n+SHA224 HMAC = Y\n+SHA256 = Y\n+SHA256 HMAC = Y\n+SHA384 = Y\n+SHA384 HMAC = Y\n+SHA512 = Y\n+SHA512 HMAC = Y\n+\n+;\n+; Supported AEAD algorithms of the 'uadk' crypto driver.\n+;\n+[AEAD]\n+\n+;\n+; Supported Asymmetric algorithms of the 'uadk' crypto driver.\n+;\n+[Asymmetric]\n+\n+;\n+; Supported Operating systems of the 'uadk' crypto driver.\n+;\n+[OS]\n+Linux = Y\ndiff --git a/doc/guides/cryptodevs/index.rst b/doc/guides/cryptodevs/index.rst\nindex 39cca6dbde..cb4ce227e9 100644\n--- a/doc/guides/cryptodevs/index.rst\n+++ b/doc/guides/cryptodevs/index.rst\n@@ -30,5 +30,6 @@ Crypto Device Drivers\n scheduler\n snow3g\n qat\n+ uadk\n virtio\n zuc\ndiff --git a/doc/guides/cryptodevs/uadk.rst b/doc/guides/cryptodevs/uadk.rst\nnew file mode 100644\nindex 0000000000..15633be010\n--- /dev/null\n+++ b/doc/guides/cryptodevs/uadk.rst\n@@ -0,0 +1,77 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright 2022-2023 Huawei Technologies Co.,Ltd. All rights reserved.\n+ Copyright 2022-2023 Linaro ltd.\n+\n+UADK Crypto Poll Mode Driver\n+=======================================================\n+\n+UADK crypto PMD provides poll mode driver\n+All cryptographic operations are using UADK crypto API.\n+Hardware accelerators using UADK are supposed to be supported.\n+\n+\n+Features\n+--------\n+\n+UADK crypto PMD has support for:\n+\n+Cipher algorithms:\n+\n+* ``RTE_CRYPTO_CIPHER_AES_ECB``\n+* ``RTE_CRYPTO_CIPHER_AES_CBC``\n+* ``RTE_CRYPTO_CIPHER_AES_XTS``\n+* ``RTE_CRYPTO_CIPHER_DES_CBC``\n+\n+Hash algorithms:\n+\n+* ``RTE_CRYPTO_AUTH_MD5``\n+* ``RTE_CRYPTO_AUTH_MD5_HMAC``\n+* ``RTE_CRYPTO_AUTH_SHA1``\n+* ``RTE_CRYPTO_AUTH_SHA1_HMAC``\n+* ``RTE_CRYPTO_AUTH_SHA224``\n+* ``RTE_CRYPTO_AUTH_SHA224_HMAC``\n+* ``RTE_CRYPTO_AUTH_SHA256``\n+* ``RTE_CRYPTO_AUTH_SHA256_HMAC``\n+* ``RTE_CRYPTO_AUTH_SHA384``\n+* ``RTE_CRYPTO_AUTH_SHA384_HMAC``\n+* ``RTE_CRYPTO_AUTH_SHA512``\n+* ``RTE_CRYPTO_AUTH_SHA512_HMAC``\n+\n+Test steps\n+-----------\n+\n+ .. code-block:: console\n+\n+\t1. Build\n+\tcd dpdk\n+\tmkdir build\n+\tmeson build (--reconfigure)\n+\tcd build\n+\tninja\n+\tsudo ninja install\n+\n+\t2. Prepare\n+\techo 1024 > /sys/devices/system/node/node0/hugepages/hugepages-2048kB/nr_hugepages\n+\techo 1024 > /sys/devices/system/node/node1/hugepages/hugepages-2048kB/nr_hugepages\n+\techo 1024 > /sys/devices/system/node/node2/hugepages/hugepages-2048kB/nr_hugepages\n+\techo 1024 > /sys/devices/system/node/node3/hugepages/hugepages-2048kB/nr_hugepages\n+\tmkdir -p /mnt/huge_2mb\n+\tmount -t hugetlbfs none /mnt/huge_2mb -o pagesize=2MB\n+\n+\t2 Test with crypto_uadk\n+\tsudo dpdk-test --vdev=crypto_uadk (--log-level=6)\n+\tRTE>>cryptodev_uadk_autotest\n+\tRTE>>quit\n+\n+Dependency\n+------------\n+\n+UADK crypto PMD relies on UADK library [1]\n+\n+UADK is a framework for user applications to access hardware accelerators.\n+UADK relies on IOMMU SVA (Shared Virtual Address) feature, which share\n+the same page table between IOMMU and MMU.\n+As a result, user application can directly use virtual address for device dma,\n+which enhances the performance as well as easy usability.\n+\n+[1] https://github.com/Linaro/uadk\n", "prefixes": [ "v2", "5/5" ] }