get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/117665/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 117665,
    "url": "http://patches.dpdk.org/api/patches/117665/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20221008083747.6559-2-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": "<20221008083747.6559-2-zhangfei.gao@linaro.org>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20221008083747.6559-2-zhangfei.gao@linaro.org",
    "date": "2022-10-08T08:37:42",
    "name": "[resend,v3,1/6] crypto/uadk: introduce uadk crypto driver",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "5013cd44e2d19cdc48099d8e42ffd3b637887932",
    "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/20221008083747.6559-2-zhangfei.gao@linaro.org/mbox/",
    "series": [
        {
            "id": 25045,
            "url": "http://patches.dpdk.org/api/series/25045/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=25045",
            "date": "2022-10-08T08:37:41",
            "name": "crypto/uadk: introduce uadk crypto driver",
            "version": 3,
            "mbox": "http://patches.dpdk.org/series/25045/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/117665/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/117665/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 8734DA0542;\n\tSat,  8 Oct 2022 10:38:53 +0200 (CEST)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id EB20242B7C;\n\tSat,  8 Oct 2022 10:38:51 +0200 (CEST)",
            "from mail-pl1-f169.google.com (mail-pl1-f169.google.com\n [209.85.214.169])\n by mails.dpdk.org (Postfix) with ESMTP id C4AB442B77\n for <dev@dpdk.org>; Sat,  8 Oct 2022 10:38:50 +0200 (CEST)",
            "by mail-pl1-f169.google.com with SMTP id 10so6514363pli.0\n for <dev@dpdk.org>; Sat, 08 Oct 2022 01:38:50 -0700 (PDT)",
            "from localhost.localdomain ([194.5.48.65])\n by smtp.gmail.com with ESMTPSA id\n n1-20020a17090a2bc100b0020a0571b354sm2644371pje.57.2022.10.08.01.38.46\n (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128);\n Sat, 08 Oct 2022 01:38:49 -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 :message-id:reply-to;\n bh=JkDnZ4RKTUrRQvxgfNNTRS+X4VFlzi2+BZbyWGbTG4Q=;\n b=y/MAttaO4dF4Js4JEqiHp/aMyhnLncZH3zH51gMwhzo12E1V6JxPYNxSFomX6rKJyP\n UkD/yq4MjWGHrqoff/+g06gekgEaQgYc0xNnzwcNxgpn+ohHtFoiKb4gVYcj5n8nvle1\n Czpe9UtlAYetYohFt6uuwQzCf9fzvUZlY10V9cXLXm/nBtBzHFaI0DknliXhUXFqa4Yb\n tko+d4rlKmLgAS65iJOEfdvUwLbi4UFdSTsYPF/CaMQvt6AE1qJpwHaxpeQwCgGsZ5yw\n PjS3thNlXgW5Kkrgg7M19UTKBmy/UuhkdvyVm8cHNICw8Idv6t5r2NzWFydH9QGozDmn\n EtYw==",
        "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:message-id:reply-to;\n bh=JkDnZ4RKTUrRQvxgfNNTRS+X4VFlzi2+BZbyWGbTG4Q=;\n b=5SJzZpgmRTIJpzT2lxnxCVZmiz3IgQMhKXorXAhLsO1Yyzsc0O5bHmRr/leeSmWonn\n NpwffwTYqgEBCXxU1V2W4u47qn3nW5BGYN6iE7zAVfsM9gvIm/oJbTka5bFjMOYGiU+L\n x/3qGmqbe0BdlEgwtnQLS1RpegAg+U8KIAp3KZKrt5YdSyOwkFbasFCAFpm8qC2Z3zcI\n Z0cHuBB2tiNFOidTvcU+7RVG/TM1D4j1IE9lsa5Yiip5XmVBpQthpkFSFTLZ9cjAbzRp\n FUSI7y9RRykgzLlizeq/vq4pAEKPtqH3/BNPVQXF288JZfyU18OWORNGHPvqDXD+E1r8\n AfXw==",
        "X-Gm-Message-State": "ACrzQf0l3/qv7uUUb8GrB4+3c3GWy3A4pGyxkeDrSRMeDN0TQSujR9RG\n TdLj72FuY9kMnnC4/SEz2pVxDQ==",
        "X-Google-Smtp-Source": "\n AMsMyM7/L86aLkr8LkD3dYm3X3LClyki6UZleZRAocOrhXgEzwm1QCiP5WBx76/BBNeAAFLGsLBELw==",
        "X-Received": "by 2002:a17:902:dad1:b0:17a:940:9c81 with SMTP id\n q17-20020a170902dad100b0017a09409c81mr9023378plx.93.1665218329981;\n Sat, 08 Oct 2022 01:38:49 -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 resend v3 1/6] crypto/uadk: introduce uadk crypto driver",
        "Date": "Sat,  8 Oct 2022 16:37:42 +0800",
        "Message-Id": "<20221008083747.6559-2-zhangfei.gao@linaro.org>",
        "X-Mailer": "git-send-email 2.36.1",
        "In-Reply-To": "<20221008083747.6559-1-zhangfei.gao@linaro.org>",
        "References": "<20221008083747.6559-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": "Introduce a new crypto PMD for hardware accelerators based on UADK [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.\nThereby user application can directly use virtual address for device dma,\nwhich enhances the performance as well as easy usability.\n\nThis patch adds the basic framework.\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 |  33 +++++++\n doc/guides/cryptodevs/index.rst         |   1 +\n doc/guides/cryptodevs/uadk.rst          |  53 ++++++++++\n drivers/crypto/meson.build              |   1 +\n drivers/crypto/uadk/meson.build         |  36 +++++++\n drivers/crypto/uadk/uadk_crypto_pmd.c   | 122 ++++++++++++++++++++++++\n drivers/crypto/uadk/version.map         |   3 +\n 8 files changed, 255 insertions(+)\n create mode 100644 doc/guides/cryptodevs/features/uadk.ini\n create mode 100644 doc/guides/cryptodevs/uadk.rst\n create mode 100644 drivers/crypto/uadk/meson.build\n create mode 100644 drivers/crypto/uadk/uadk_crypto_pmd.c\n create mode 100644 drivers/crypto/uadk/version.map",
    "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 5472fccf61..ed00b9afd1 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -1064,6 +1064,12 @@ M: Kai Ji <kai.ji@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: Kai Ji <kai.ji@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..df5ad40e3d\n--- /dev/null\n+++ b/doc/guides/cryptodevs/features/uadk.ini\n@@ -0,0 +1,33 @@\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+HW Accelerated         = Y\n+\n+;\n+; Supported crypto algorithms of the 'uadk' crypto driver.\n+;\n+[Cipher]\n+\n+;\n+; Supported authentication algorithms of the 'uadk' crypto driver.\n+;\n+[Auth]\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..a170224cac\n--- /dev/null\n+++ b/doc/guides/cryptodevs/uadk.rst\n@@ -0,0 +1,53 @@\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+\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+\t3. Run test app\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\ndiff --git a/drivers/crypto/meson.build b/drivers/crypto/meson.build\nindex 147b8cf633..ee5377deff 100644\n--- a/drivers/crypto/meson.build\n+++ b/drivers/crypto/meson.build\n@@ -18,6 +18,7 @@ drivers = [\n         'octeontx',\n         'openssl',\n         'scheduler',\n+        'uadk',\n         'virtio',\n ]\n \ndiff --git a/drivers/crypto/uadk/meson.build b/drivers/crypto/uadk/meson.build\nnew file mode 100644\nindex 0000000000..dda6c6b257\n--- /dev/null\n+++ b/drivers/crypto/uadk/meson.build\n@@ -0,0 +1,36 @@\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+if not is_linux\n+    build = false\n+    reason = 'only supported on Linux'\n+    subdir_done()\n+endif\n+\n+if arch_subdir != 'arm' or not dpdk_conf.get('RTE_ARCH_64')\n+    build = false\n+    reason = 'only supported on aarch64'\n+    subdir_done()\n+endif\n+\n+sources = files(\n+        'uadk_crypto_pmd.c',\n+)\n+\n+deps += 'bus_vdev'\n+dep = cc.find_library('libwd_crypto', required: false)\n+if not dep.found()\n+\tbuild = false\n+\treason = 'missing dependency, \"libwd_crypto\"'\n+else\n+\text_deps += dep\n+endif\n+\n+dep = cc.find_library('libwd', required: false)\n+if not dep.found()\n+\tbuild = false\n+\treason = 'missing dependency, \"libwd\"'\n+else\n+\text_deps += dep\n+endif\ndiff --git a/drivers/crypto/uadk/uadk_crypto_pmd.c b/drivers/crypto/uadk/uadk_crypto_pmd.c\nnew file mode 100644\nindex 0000000000..ec9bb174c7\n--- /dev/null\n+++ b/drivers/crypto/uadk/uadk_crypto_pmd.c\n@@ -0,0 +1,122 @@\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+\n+#include <bus_vdev_driver.h>\n+#include <cryptodev_pmd.h>\n+#include <rte_bus_vdev.h>\n+#include <rte_comp.h>\n+#include <stdlib.h>\n+#include <uadk/wd_cipher.h>\n+#include <uadk/wd_digest.h>\n+#include <uadk/wd_sched.h>\n+\n+enum uadk_crypto_version {\n+\tUADK_CRYPTO_V2,\n+\tUADK_CRYPTO_V3,\n+};\n+\n+struct uadk_crypto_priv {\n+\tenum uadk_crypto_version version;\n+} __rte_cache_aligned;\n+\n+static uint8_t uadk_cryptodev_driver_id;\n+\n+RTE_LOG_REGISTER_DEFAULT(uadk_crypto_logtype, INFO);\n+\n+#define UADK_LOG(level, fmt, ...)  \\\n+\trte_log(RTE_LOG_ ## level, uadk_crypto_logtype,  \\\n+\t\t\"%s() line %u: \" fmt \"\\n\", __func__, __LINE__,  \\\n+\t\t## __VA_ARGS__)\n+\n+static struct rte_cryptodev_ops uadk_crypto_pmd_ops = {\n+\t\t.dev_configure\t\t= NULL,\n+\t\t.dev_start\t\t= NULL,\n+\t\t.dev_stop\t\t= NULL,\n+\t\t.dev_close\t\t= NULL,\n+\t\t.stats_get\t\t= NULL,\n+\t\t.stats_reset\t\t= NULL,\n+\t\t.dev_infos_get\t\t= NULL,\n+\t\t.queue_pair_setup\t= NULL,\n+\t\t.queue_pair_release\t= NULL,\n+\t\t.sym_session_get_size\t= NULL,\n+\t\t.sym_session_configure\t= NULL,\n+\t\t.sym_session_clear\t= NULL,\n+};\n+\n+static int\n+uadk_cryptodev_probe(struct rte_vdev_device *vdev)\n+{\n+\tstruct rte_cryptodev_pmd_init_params init_params = {\n+\t\t.name = \"\",\n+\t\t.private_data_size = sizeof(struct uadk_crypto_priv),\n+\t\t.max_nb_queue_pairs =\n+\t\t\t\tRTE_CRYPTODEV_PMD_DEFAULT_MAX_NB_QUEUE_PAIRS,\n+\t};\n+\tenum uadk_crypto_version version = UADK_CRYPTO_V2;\n+\tstruct uadk_crypto_priv *priv;\n+\tstruct rte_cryptodev *dev;\n+\tstruct uacce_dev *udev;\n+\tconst char *name;\n+\n+\tudev = wd_get_accel_dev(\"cipher\");\n+\tif (!udev)\n+\t\treturn -ENODEV;\n+\n+\tif (!strcmp(udev->api, \"hisi_qm_v2\"))\n+\t\tversion = UADK_CRYPTO_V2;\n+\n+\tfree(udev);\n+\n+\tname = rte_vdev_device_name(vdev);\n+\tif (name == NULL)\n+\t\treturn -EINVAL;\n+\n+\tdev = rte_cryptodev_pmd_create(name, &vdev->device, &init_params);\n+\tif (dev == NULL) {\n+\t\tUADK_LOG(ERR, \"driver %s: create failed\", init_params.name);\n+\t\treturn -ENODEV;\n+\t}\n+\n+\tdev->dev_ops = &uadk_crypto_pmd_ops;\n+\tdev->driver_id = uadk_cryptodev_driver_id;\n+\tdev->dequeue_burst = NULL;\n+\tdev->enqueue_burst = NULL;\n+\tdev->feature_flags = RTE_CRYPTODEV_FF_HW_ACCELERATED;\n+\tpriv = dev->data->dev_private;\n+\tpriv->version = version;\n+\n+\trte_cryptodev_pmd_probing_finish(dev);\n+\n+\treturn 0;\n+}\n+\n+static int\n+uadk_cryptodev_remove(struct rte_vdev_device *vdev)\n+{\n+\tstruct rte_cryptodev *cryptodev;\n+\tconst char *name;\n+\n+\tname = rte_vdev_device_name(vdev);\n+\tif (name == NULL)\n+\t\treturn -EINVAL;\n+\n+\tcryptodev = rte_cryptodev_pmd_get_named_dev(name);\n+\tif (cryptodev == NULL)\n+\t\treturn -ENODEV;\n+\n+\treturn rte_cryptodev_pmd_destroy(cryptodev);\n+}\n+\n+static struct rte_vdev_driver uadk_crypto_pmd = {\n+\t.probe       = uadk_cryptodev_probe,\n+\t.remove      = uadk_cryptodev_remove,\n+};\n+\n+static struct cryptodev_driver uadk_crypto_drv;\n+\n+#define UADK_CRYPTO_DRIVER_NAME crypto_uadk\n+RTE_PMD_REGISTER_VDEV(UADK_CRYPTO_DRIVER_NAME, uadk_crypto_pmd);\n+RTE_PMD_REGISTER_CRYPTO_DRIVER(uadk_crypto_drv, uadk_crypto_pmd.driver,\n+\t\t\t       uadk_cryptodev_driver_id);\ndiff --git a/drivers/crypto/uadk/version.map b/drivers/crypto/uadk/version.map\nnew file mode 100644\nindex 0000000000..c2e0723b4c\n--- /dev/null\n+++ b/drivers/crypto/uadk/version.map\n@@ -0,0 +1,3 @@\n+DPDK_22 {\n+\tlocal: *;\n+};\n",
    "prefixes": [
        "resend",
        "v3",
        "1/6"
    ]
}