get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 1658285,
    "url": "http://patchwork.ozlabs.org/api/patches/1658285/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/linux-um/patch/20220720030436.79520-3-xuanzhuo@linux.alibaba.com/",
    "project": {
        "id": 60,
        "url": "http://patchwork.ozlabs.org/api/projects/60/?format=api",
        "name": "User-mode Linux Development",
        "link_name": "linux-um",
        "list_id": "linux-um.lists.infradead.org",
        "list_email": "linux-um@lists.infradead.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": "",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20220720030436.79520-3-xuanzhuo@linux.alibaba.com>",
    "list_archive_url": null,
    "date": "2022-07-20T03:03:58",
    "name": "[v12,02/40] virtio: struct virtio_config_ops add callbacks for queue_reset",
    "commit_ref": null,
    "pull_url": null,
    "state": "not-applicable",
    "archived": false,
    "hash": "a30885a1b28911177099ec77ccfa06f7314dafbd",
    "submitter": {
        "id": 80519,
        "url": "http://patchwork.ozlabs.org/api/people/80519/?format=api",
        "name": "Xuan Zhuo",
        "email": "xuanzhuo@linux.alibaba.com"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/linux-um/patch/20220720030436.79520-3-xuanzhuo@linux.alibaba.com/mbox/",
    "series": [
        {
            "id": 310331,
            "url": "http://patchwork.ozlabs.org/api/series/310331/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/linux-um/list/?series=310331",
            "date": "2022-07-20T03:03:59",
            "name": "virtio pci support VIRTIO_F_RING_RESET",
            "version": 12,
            "mbox": "http://patchwork.ozlabs.org/series/310331/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/1658285/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/1658285/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "\n <linux-um-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org>",
        "X-Original-To": "incoming@patchwork.ozlabs.org",
        "Delivered-To": "patchwork-incoming@bilbo.ozlabs.org",
        "Authentication-Results": [
            "bilbo.ozlabs.org;\n\tdkim=pass (2048-bit key;\n secure) header.d=lists.infradead.org header.i=@lists.infradead.org\n header.a=rsa-sha256 header.s=bombadil.20210309 header.b=MXQWKU7Y;\n\tdkim-atps=neutral",
            "ozlabs.org;\n spf=none (no SPF record) smtp.mailfrom=lists.infradead.org\n (client-ip=2607:7c80:54:3::133; helo=bombadil.infradead.org;\n envelope-from=linux-um-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org;\n receiver=<UNKNOWN>)"
        ],
        "Received": [
            "from bombadil.infradead.org (bombadil.infradead.org\n [IPv6:2607:7c80:54:3::133])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n\t(No client certificate requested)\n\tby bilbo.ozlabs.org (Postfix) with ESMTPS id 4LngYL1SLQz9s2R\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 20 Jul 2022 13:05:10 +1000 (AEST)",
            "from localhost ([::1] helo=bombadil.infradead.org)\n\tby bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux))\n\tid 1oE017-00HE4I-Pw; Wed, 20 Jul 2022 03:04:53 +0000",
            "from out30-43.freemail.mail.aliyun.com ([115.124.30.43])\n\tby bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux))\n\tid 1oE013-00HDxZ-LT\n\tfor linux-um@lists.infradead.org; Wed, 20 Jul 2022 03:04:52 +0000",
            "from localhost(mailfrom:xuanzhuo@linux.alibaba.com\n fp:SMTPD_---0VJuw0H6_1658286281)\n          by smtp.aliyun-inc.com;\n          Wed, 20 Jul 2022 11:04:42 +0800"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;\n\td=lists.infradead.org; s=bombadil.20210309; h=Sender:\n\tContent-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post:\n\tList-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:\n\tMessage-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description:\n\tResent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:\n\tList-Owner; bh=efezQZIy3grfjjyv5S0eLJvWgUouSDLWLBIZ/eZ4lFI=; b=MXQWKU7YH787am\n\thC39r0C47Zi2U3lEYu7cKxtvrVtE9+1nG88njfGWHJwgvwI1kqIBMKcep8Y0h/Xnj0tk+niv4vnxL\n\tNJ6Dcw+mMkYiYJDh35ryiRAm3nYf/ENts7ny7n7BFP0waGxMC4fH7m5A4yg+tBEESrcV/msobyNv/\n\tvN15Nw2x7/qbrWhBAeJrQgKR50saOB8LAdR4pU4PydvnkMLVYOW3/liOkY/dFiEefK/P7SKXYQKVN\n\tBCR3Wu9lZufDiHtDfqDqnZc86LFzdVa/aWtpuF4E0Cp497z/Bq2k2EHcqCI4SRMmb7qTNOwyPmmvm\n\t18FHfFfPbeuyXtQu2atw==;",
        "X-Alimail-AntiSpam": "\n AC=PASS;BC=-1|-1;BR=01201311R201e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045170;MF=xuanzhuo@linux.alibaba.com;NM=1;PH=DS;RN=37;SR=0;TI=SMTPD_---0VJuw0H6_1658286281;",
        "From": "Xuan Zhuo <xuanzhuo@linux.alibaba.com>",
        "To": "virtualization@lists.linux-foundation.org",
        "Cc": "Richard Weinberger <richard@nod.at>,\n\tAnton Ivanov <anton.ivanov@cambridgegreys.com>,\n\tJohannes Berg <johannes@sipsolutions.net>,\n\t\"Michael S. Tsirkin\" <mst@redhat.com>,\n\tJason Wang <jasowang@redhat.com>,\n\t\"David S. Miller\" <davem@davemloft.net>,\n\tEric Dumazet <edumazet@google.com>,\n\tJakub Kicinski <kuba@kernel.org>,\n\tPaolo Abeni <pabeni@redhat.com>,\n\tHans de Goede <hdegoede@redhat.com>,\n\tMark Gross <markgross@kernel.org>,\n\tVadim Pasternak <vadimp@nvidia.com>,\n\tBjorn Andersson <bjorn.andersson@linaro.org>,\n\tMathieu Poirier <mathieu.poirier@linaro.org>,\n\tCornelia Huck <cohuck@redhat.com>,\n\tHalil Pasic <pasic@linux.ibm.com>,\n\tEric Farman <farman@linux.ibm.com>,\n\tHeiko Carstens <hca@linux.ibm.com>,\n\tVasily Gorbik <gor@linux.ibm.com>,\n\tAlexander Gordeev <agordeev@linux.ibm.com>,\n\tChristian Borntraeger <borntraeger@linux.ibm.com>,\n\tSven Schnelle <svens@linux.ibm.com>,\n\tAlexei Starovoitov <ast@kernel.org>,\n\tDaniel Borkmann <daniel@iogearbox.net>,\n\tJesper Dangaard Brouer <hawk@kernel.org>,\n\tJohn Fastabend <john.fastabend@gmail.com>,\n\tXuan Zhuo <xuanzhuo@linux.alibaba.com>,\n\tVincent Whitchurch <vincent.whitchurch@axis.com>,\n\tlinux-um@lists.infradead.org,\n\tnetdev@vger.kernel.org,\n\tplatform-driver-x86@vger.kernel.org,\n\tlinux-remoteproc@vger.kernel.org,\n\tlinux-s390@vger.kernel.org,\n\tkvm@vger.kernel.org,\n\tbpf@vger.kernel.org,\n\tkangjie.xu@linux.alibaba.com",
        "Subject": "[PATCH v12 02/40] virtio: struct virtio_config_ops add callbacks for\n queue_reset",
        "Date": "Wed, 20 Jul 2022 11:03:58 +0800",
        "Message-Id": "<20220720030436.79520-3-xuanzhuo@linux.alibaba.com>",
        "X-Mailer": "git-send-email 2.31.0",
        "In-Reply-To": "<20220720030436.79520-1-xuanzhuo@linux.alibaba.com>",
        "References": "<20220720030436.79520-1-xuanzhuo@linux.alibaba.com>",
        "MIME-Version": "1.0",
        "X-Git-Hash": "366032b2ffac",
        "X-CRM114-Version": "20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 ",
        "X-CRM114-CacheID": "sfid-20220719_200449_913038_A47D44BC ",
        "X-CRM114-Status": "GOOD (  10.24  )",
        "X-Spam-Score": "-8.0 (--------)",
        "X-Spam-Report": "Spam detection software,\n running on the system \"bombadil.infradead.org\",\n has NOT identified this incoming email as spam.  The original\n message has been attached to this so you can view it or label\n similar future email.  If you have any questions, see\n the administrator of that system for details.\n Content preview:  reset can be divided into the following four steps\n (example):\n    1. transport: notify the device to reset the queue 2. vring: recycle the\n   buffer submitted 3. vring: reset/resize the vring (may re-alloc) [...]\n Content analysis details:   (-8.0 points, 5.0 required)\n  pts rule name              description\n ---- ----------------------\n --------------------------------------------------\n -0.0 RCVD_IN_DNSWL_NONE     RBL: Sender listed at https://www.dnswl.org/,\n                              no trust\n                             [115.124.30.43 listed in list.dnswl.org]\n -0.0 SPF_PASS               SPF: sender matches SPF record\n  0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record\n -7.5 USER_IN_DEF_SPF_WL     From: address is in the default SPF\n                             white-list\n -0.0 RCVD_IN_MSPIKE_H2      RBL: Average reputation (+2)\n                             [115.124.30.43 listed in wl.mailspike.net]\n -0.5 ENV_AND_HDR_SPF_MATCH  Env and Hdr From used in default SPF WL\n                             Match\n  0.0 UNPARSEABLE_RELAY      Informational: message has unparseable relay\n                             lines",
        "X-BeenThere": "linux-um@lists.infradead.org",
        "X-Mailman-Version": "2.1.34",
        "Precedence": "list",
        "List-Id": "<linux-um.lists.infradead.org>",
        "List-Unsubscribe": "<http://lists.infradead.org/mailman/options/linux-um>,\n <mailto:linux-um-request@lists.infradead.org?subject=unsubscribe>",
        "List-Archive": "<http://lists.infradead.org/pipermail/linux-um/>",
        "List-Post": "<mailto:linux-um@lists.infradead.org>",
        "List-Help": "<mailto:linux-um-request@lists.infradead.org?subject=help>",
        "List-Subscribe": "<http://lists.infradead.org/mailman/listinfo/linux-um>,\n <mailto:linux-um-request@lists.infradead.org?subject=subscribe>",
        "Content-Type": "text/plain; charset=\"us-ascii\"",
        "Content-Transfer-Encoding": "7bit",
        "Sender": "\"linux-um\" <linux-um-bounces@lists.infradead.org>",
        "Errors-To": "linux-um-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org"
    },
    "content": "reset can be divided into the following four steps (example):\n 1. transport: notify the device to reset the queue\n 2. vring:     recycle the buffer submitted\n 3. vring:     reset/resize the vring (may re-alloc)\n 4. transport: mmap vring to device, and enable the queue\n\nIn order to support queue reset, add two callbacks in struct\nvirtio_config_ops to implement steps 1 and 4.\n\nSigned-off-by: Xuan Zhuo <xuanzhuo@linux.alibaba.com>\n---\n include/linux/virtio_config.h | 14 ++++++++++++++\n 1 file changed, 14 insertions(+)",
    "diff": "diff --git a/include/linux/virtio_config.h b/include/linux/virtio_config.h\nindex b47c2e7ed0ee..36ec7be1f480 100644\n--- a/include/linux/virtio_config.h\n+++ b/include/linux/virtio_config.h\n@@ -78,6 +78,18 @@ struct virtio_shm_region {\n  * @set_vq_affinity: set the affinity for a virtqueue (optional).\n  * @get_vq_affinity: get the affinity for a virtqueue (optional).\n  * @get_shm_region: get a shared memory region based on the index.\n+ * @disable_vq_and_reset: reset a queue individually (optional).\n+ *\tvq: the virtqueue\n+ *\tReturns 0 on success or error status\n+ *\tdisable_vq_and_reset will guarantee that the callbacks are disabled and\n+ *\tsynchronized.\n+ *\tExcept for the callback, the caller should guarantee that the vring is\n+ *\tnot accessed by any functions of virtqueue.\n+ * @enable_vq_after_reset: enable a reset queue\n+ *\tvq: the virtqueue\n+ *\tReturns 0 on success or error status\n+ *\tIf disable_vq_and_reset is set, then enable_vq_after_reset must also be\n+ *\tset.\n  */\n typedef void vq_callback_t(struct virtqueue *);\n struct virtio_config_ops {\n@@ -104,6 +116,8 @@ struct virtio_config_ops {\n \t\t\tint index);\n \tbool (*get_shm_region)(struct virtio_device *vdev,\n \t\t\t       struct virtio_shm_region *region, u8 id);\n+\tint (*disable_vq_and_reset)(struct virtqueue *vq);\n+\tint (*enable_vq_after_reset)(struct virtqueue *vq);\n };\n \n /* If driver didn't advertise the feature, it will never appear. */\n",
    "prefixes": [
        "v12",
        "02/40"
    ]
}