get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 808144,
    "url": "http://patchwork.ozlabs.org/api/patches/808144/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20170831094643.22567-1-berrange@redhat.com/",
    "project": {
        "id": 14,
        "url": "http://patchwork.ozlabs.org/api/projects/14/?format=api",
        "name": "QEMU Development",
        "link_name": "qemu-devel",
        "list_id": "qemu-devel.nongnu.org",
        "list_email": "qemu-devel@nongnu.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": "",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20170831094643.22567-1-berrange@redhat.com>",
    "list_archive_url": null,
    "date": "2017-08-31T09:46:43",
    "name": "[v2] io: add new qio_channel_{readv, writev, read, write}_all functions",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "7d9f53cc41c27dd3295fdcf62c77a41d9da39ef6",
    "submitter": {
        "id": 2694,
        "url": "http://patchwork.ozlabs.org/api/people/2694/?format=api",
        "name": "Daniel P. Berrangé",
        "email": "berrange@redhat.com"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20170831094643.22567-1-berrange@redhat.com/mbox/",
    "series": [
        {
            "id": 777,
            "url": "http://patchwork.ozlabs.org/api/series/777/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=777",
            "date": "2017-08-31T09:46:43",
            "name": "[v2] io: add new qio_channel_{readv, writev, read, write}_all functions",
            "version": 2,
            "mbox": "http://patchwork.ozlabs.org/series/777/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/808144/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/808144/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>",
        "X-Original-To": "incoming@patchwork.ozlabs.org",
        "Delivered-To": "patchwork-incoming@bilbo.ozlabs.org",
        "Authentication-Results": [
            "ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=nongnu.org\n\t(client-ip=2001:4830:134:3::11; helo=lists.gnu.org;\n\tenvelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n\treceiver=<UNKNOWN>)",
            "ext-mx02.extmail.prod.ext.phx2.redhat.com;\n\tdmarc=none (p=none dis=none) header.from=redhat.com",
            "ext-mx02.extmail.prod.ext.phx2.redhat.com;\n\tspf=fail smtp.mailfrom=berrange@redhat.com"
        ],
        "Received": [
            "from lists.gnu.org (lists.gnu.org [IPv6:2001:4830:134:3::11])\n\t(using TLSv1 with cipher AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 3xjcx25JfVz9t16\n\tfor <incoming@patchwork.ozlabs.org>;\n\tThu, 31 Aug 2017 19:47:34 +1000 (AEST)",
            "from localhost ([::1]:54694 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>)\n\tid 1dnM4S-00049Q-SN\n\tfor incoming@patchwork.ozlabs.org; Thu, 31 Aug 2017 05:47:32 -0400",
            "from eggs.gnu.org ([2001:4830:134:3::10]:59433)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from <berrange@redhat.com>) id 1dnM3w-000490-TU\n\tfor qemu-devel@nongnu.org; Thu, 31 Aug 2017 05:47:02 -0400",
            "from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from <berrange@redhat.com>) id 1dnM3q-0003IH-64\n\tfor qemu-devel@nongnu.org; Thu, 31 Aug 2017 05:47:00 -0400",
            "from mx1.redhat.com ([209.132.183.28]:57954)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from <berrange@redhat.com>) id 1dnM3p-0003I8-To\n\tfor qemu-devel@nongnu.org; Thu, 31 Aug 2017 05:46:54 -0400",
            "from smtp.corp.redhat.com\n\t(int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14])\n\t(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby mx1.redhat.com (Postfix) with ESMTPS id D7CEA883AE\n\tfor <qemu-devel@nongnu.org>; Thu, 31 Aug 2017 09:46:52 +0000 (UTC)",
            "from localhost.localdomain.com (unknown [10.42.22.189])\n\tby smtp.corp.redhat.com (Postfix) with ESMTP id 4684BB32AB;\n\tThu, 31 Aug 2017 09:46:51 +0000 (UTC)"
        ],
        "DMARC-Filter": "OpenDMARC Filter v1.3.2 mx1.redhat.com D7CEA883AE",
        "From": "\"Daniel P. Berrange\" <berrange@redhat.com>",
        "To": "qemu-devel@nongnu.org",
        "Date": "Thu, 31 Aug 2017 10:46:43 +0100",
        "Message-Id": "<20170831094643.22567-1-berrange@redhat.com>",
        "X-Scanned-By": "MIMEDefang 2.79 on 10.5.11.14",
        "X-Greylist": "Sender IP whitelisted, not delayed by milter-greylist-4.5.16\n\t(mx1.redhat.com [10.5.110.26]);\n\tThu, 31 Aug 2017 09:46:53 +0000 (UTC)",
        "X-detected-operating-system": "by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]\n\t[fuzzy]",
        "X-Received-From": "209.132.183.28",
        "Subject": "[Qemu-devel] [PATCH v2] io: add new qio_channel_{readv, writev, read,\n\twrite}_all functions",
        "X-BeenThere": "qemu-devel@nongnu.org",
        "X-Mailman-Version": "2.1.21",
        "Precedence": "list",
        "List-Id": "<qemu-devel.nongnu.org>",
        "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n\t<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>",
        "List-Archive": "<http://lists.nongnu.org/archive/html/qemu-devel/>",
        "List-Post": "<mailto:qemu-devel@nongnu.org>",
        "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>",
        "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n\t<mailto:qemu-devel-request@nongnu.org?subject=subscribe>",
        "Cc": "Paolo Bonzini <pbonzini@redhat.com>, Juan Quintela <quintela@redhat.com>",
        "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org",
        "Sender": "\"Qemu-devel\"\n\t<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>"
    },
    "content": "These functions wait until they are able to read / write the full\nrequested data buffer(s).\n\nSigned-off-by: Daniel P. Berrange <berrange@redhat.com>\n---\n\nChanged in v2:\n\n - Remove 'coroutine_fn' annotation (Stefan)\n - Fix docs typos (Eric)\n - Remove bogus error overwriting (Eric)\n\n include/io/channel.h       |  90 +++++++++++++++++++++++++++++++++++++++\n io/channel.c               |  94 +++++++++++++++++++++++++++++++++++++++++\n tests/io-channel-helpers.c | 102 ++++-----------------------------------------\n 3 files changed, 193 insertions(+), 93 deletions(-)",
    "diff": "diff --git a/include/io/channel.h b/include/io/channel.h\nindex 54f3dc252f..8f25893c45 100644\n--- a/include/io/channel.h\n+++ b/include/io/channel.h\n@@ -269,6 +269,58 @@ ssize_t qio_channel_writev_full(QIOChannel *ioc,\n                                 Error **errp);\n \n /**\n+ * qio_channel_readv_all:\n+ * @ioc: the channel object\n+ * @iov: the array of memory regions to read data into\n+ * @niov: the length of the @iov array\n+ * @errp: pointer to a NULL-initialized error object\n+ *\n+ * Read data from the IO channel, storing it in the\n+ * memory regions referenced by @iov. Each element\n+ * in the @iov will be fully populated with data\n+ * before the next one is used. The @niov parameter\n+ * specifies the total number of elements in @iov.\n+ *\n+ * The function will wait for all requested data\n+ * to be read, yielding from the current coroutine\n+ * if required.\n+ *\n+ * If end-of-file occurs before all requested data\n+ * has been read, an error will be reported.\n+ *\n+ * Returns: 0 if all bytes were read, or -1 on error\n+ */\n+int qio_channel_readv_all(QIOChannel *ioc,\n+                          const struct iovec *iov,\n+                          size_t niov,\n+                          Error **errp);\n+\n+\n+/**\n+ * qio_channel_writev_all:\n+ * @ioc: the channel object\n+ * @iov: the array of memory regions to write data from\n+ * @niov: the length of the @iov array\n+ * @errp: pointer to a NULL-initialized error object\n+ *\n+ * Write data to the IO channel, reading it from the\n+ * memory regions referenced by @iov. Each element\n+ * in the @iov will be fully sent, before the next\n+ * one is used. The @niov parameter specifies the\n+ * total number of elements in @iov.\n+ *\n+ * The function will wait for all requested data\n+ * to be written, yielding from the current coroutine\n+ * if required.\n+ *\n+ * Returns: 0 if all bytes were written, or -1 on error\n+ */\n+int qio_channel_writev_all(QIOChannel *ioc,\n+                           const struct iovec *iov,\n+                           size_t niov,\n+                           Error **erp);\n+\n+/**\n  * qio_channel_readv:\n  * @ioc: the channel object\n  * @iov: the array of memory regions to read data into\n@@ -331,6 +383,44 @@ ssize_t qio_channel_write(QIOChannel *ioc,\n                           Error **errp);\n \n /**\n+ * qio_channel_read_all:\n+ * @ioc: the channel object\n+ * @buf: the memory region to read data into\n+ * @buflen: the number of bytes to @buf\n+ * @errp: pointer to a NULL-initialized error object\n+ *\n+ * Reads @buflen bytes into @buf, possibly blocking or (if the\n+ * channel is non-blocking) yielding from the current coroutine\n+ * multiple times until the entire content is read. If end-of-file\n+ * occurs it will return an error rather than a short-read. Otherwise\n+ * behaves as qio_channel_read().\n+ *\n+ * Returns: 0 if all bytes were read, or -1 on error\n+ */\n+int qio_channel_read_all(QIOChannel *ioc,\n+                         char *buf,\n+                         size_t buflen,\n+                         Error **errp);\n+/**\n+ * qio_channel_write_all:\n+ * @ioc: the channel object\n+ * @buf: the memory region to write data into\n+ * @buflen: the number of bytes to @buf\n+ * @errp: pointer to a NULL-initialized error object\n+ *\n+ * Writes @buflen bytes from @buf, possibly blocking or (if the\n+ * channel is non-blocking) yielding from the current coroutine\n+ * multiple times until the entire content is written.  Otherwise\n+ * behaves as qio_channel_write().\n+ *\n+ * Returns: 0 if all bytes were written, or -1 on error\n+ */\n+int qio_channel_write_all(QIOChannel *ioc,\n+                          const char *buf,\n+                          size_t buflen,\n+                          Error **errp);\n+\n+/**\n  * qio_channel_set_blocking:\n  * @ioc: the channel object\n  * @enabled: the blocking flag state\ndiff --git a/io/channel.c b/io/channel.c\nindex 1cfb8b33a2..5e8c2f0a91 100644\n--- a/io/channel.c\n+++ b/io/channel.c\n@@ -22,6 +22,7 @@\n #include \"io/channel.h\"\n #include \"qapi/error.h\"\n #include \"qemu/main-loop.h\"\n+#include \"qemu/iov.h\"\n \n bool qio_channel_has_feature(QIOChannel *ioc,\n                              QIOChannelFeature feature)\n@@ -85,6 +86,79 @@ ssize_t qio_channel_writev_full(QIOChannel *ioc,\n }\n \n \n+\n+int qio_channel_readv_all(QIOChannel *ioc,\n+                          const struct iovec *iov,\n+                          size_t niov,\n+                          Error **errp)\n+{\n+    int ret = -1;\n+    struct iovec *local_iov = g_new(struct iovec, niov);\n+    struct iovec *local_iov_head = local_iov;\n+    unsigned int nlocal_iov = niov;\n+\n+    nlocal_iov = iov_copy(local_iov, nlocal_iov,\n+                          iov, niov,\n+                          0, iov_size(iov, niov));\n+\n+    while (nlocal_iov > 0) {\n+        ssize_t len;\n+        len = qio_channel_readv(ioc, local_iov, nlocal_iov, errp);\n+        if (len == QIO_CHANNEL_ERR_BLOCK) {\n+            qio_channel_wait(ioc, G_IO_IN);\n+            continue;\n+        } else if (len < 0) {\n+            goto cleanup;\n+        } else if (len == 0) {\n+            error_setg(errp,\n+                       \"Unexpected end-of-file before all bytes were read\");\n+            goto cleanup;\n+        }\n+\n+        iov_discard_front(&local_iov, &nlocal_iov, len);\n+    }\n+\n+    ret = 0;\n+\n+ cleanup:\n+    g_free(local_iov_head);\n+    return ret;\n+}\n+\n+int qio_channel_writev_all(QIOChannel *ioc,\n+                           const struct iovec *iov,\n+                           size_t niov,\n+                           Error **errp)\n+{\n+    int ret = -1;\n+    struct iovec *local_iov = g_new(struct iovec, niov);\n+    struct iovec *local_iov_head = local_iov;\n+    unsigned int nlocal_iov = niov;\n+\n+    nlocal_iov = iov_copy(local_iov, nlocal_iov,\n+                          iov, niov,\n+                          0, iov_size(iov, niov));\n+\n+    while (nlocal_iov > 0) {\n+        ssize_t len;\n+        len = qio_channel_writev(ioc, local_iov, nlocal_iov, errp);\n+        if (len == QIO_CHANNEL_ERR_BLOCK) {\n+            qio_channel_wait(ioc, G_IO_OUT);\n+            continue;\n+        }\n+        if (len < 0) {\n+            goto cleanup;\n+        }\n+\n+        iov_discard_front(&local_iov, &nlocal_iov, len);\n+    }\n+\n+    ret = 0;\n+ cleanup:\n+    g_free(local_iov_head);\n+    return ret;\n+}\n+\n ssize_t qio_channel_readv(QIOChannel *ioc,\n                           const struct iovec *iov,\n                           size_t niov,\n@@ -123,6 +197,26 @@ ssize_t qio_channel_write(QIOChannel *ioc,\n }\n \n \n+int qio_channel_read_all(QIOChannel *ioc,\n+                         char *buf,\n+                         size_t buflen,\n+                         Error **errp)\n+{\n+    struct iovec iov = { .iov_base = buf, .iov_len = buflen };\n+    return qio_channel_readv_all(ioc, &iov, 1, errp);\n+}\n+\n+\n+int qio_channel_write_all(QIOChannel *ioc,\n+                          const char *buf,\n+                          size_t buflen,\n+                          Error **errp)\n+{\n+    struct iovec iov = { .iov_base = (char *)buf, .iov_len = buflen };\n+    return qio_channel_writev_all(ioc, &iov, 1, errp);\n+}\n+\n+\n int qio_channel_set_blocking(QIOChannel *ioc,\n                               bool enabled,\n                               Error **errp)\ndiff --git a/tests/io-channel-helpers.c b/tests/io-channel-helpers.c\nindex 05e5579cf8..5430e1389d 100644\n--- a/tests/io-channel-helpers.c\n+++ b/tests/io-channel-helpers.c\n@@ -21,6 +21,7 @@\n #include \"qemu/osdep.h\"\n #include \"io-channel-helpers.h\"\n #include \"qapi/error.h\"\n+#include \"qemu/iov.h\"\n \n struct QIOChannelTest {\n     QIOChannel *src;\n@@ -37,77 +38,17 @@ struct QIOChannelTest {\n };\n \n \n-static void test_skip_iovec(struct iovec **iov,\n-                            size_t *niov,\n-                            size_t skip,\n-                            struct iovec *old)\n-{\n-    size_t offset = 0;\n-    size_t i;\n-\n-    for (i = 0; i < *niov; i++) {\n-        if (skip < (*iov)[i].iov_len) {\n-            old->iov_len = (*iov)[i].iov_len;\n-            old->iov_base = (*iov)[i].iov_base;\n-\n-            (*iov)[i].iov_len -= skip;\n-            (*iov)[i].iov_base += skip;\n-            break;\n-        } else {\n-            skip -= (*iov)[i].iov_len;\n-\n-            if (i == 0 && old->iov_base) {\n-                (*iov)[i].iov_len = old->iov_len;\n-                (*iov)[i].iov_base = old->iov_base;\n-                old->iov_len = 0;\n-                old->iov_base = NULL;\n-            }\n-\n-            offset++;\n-        }\n-    }\n-\n-    *iov = *iov + offset;\n-    *niov -= offset;\n-}\n-\n-\n /* This thread sends all data using iovecs */\n static gpointer test_io_thread_writer(gpointer opaque)\n {\n     QIOChannelTest *data = opaque;\n-    struct iovec *iov = data->inputv;\n-    size_t niov = data->niov;\n-    struct iovec old = { 0 };\n \n     qio_channel_set_blocking(data->src, data->blocking, NULL);\n \n-    while (niov) {\n-        ssize_t ret;\n-        ret = qio_channel_writev(data->src,\n-                                 iov,\n-                                 niov,\n-                                 &data->writeerr);\n-        if (ret == QIO_CHANNEL_ERR_BLOCK) {\n-            if (data->blocking) {\n-                error_setg(&data->writeerr,\n-                           \"Unexpected I/O blocking\");\n-                break;\n-            } else {\n-                qio_channel_wait(data->src,\n-                                 G_IO_OUT);\n-                continue;\n-            }\n-        } else if (ret < 0) {\n-            break;\n-        } else if (ret == 0) {\n-            error_setg(&data->writeerr,\n-                       \"Unexpected zero length write\");\n-            break;\n-        }\n-\n-        test_skip_iovec(&iov, &niov, ret, &old);\n-    }\n+    qio_channel_writev_all(data->src,\n+                           data->inputv,\n+                           data->niov,\n+                           &data->writeerr);\n \n     return NULL;\n }\n@@ -117,38 +58,13 @@ static gpointer test_io_thread_writer(gpointer opaque)\n static gpointer test_io_thread_reader(gpointer opaque)\n {\n     QIOChannelTest *data = opaque;\n-    struct iovec *iov = data->outputv;\n-    size_t niov = data->niov;\n-    struct iovec old = { 0 };\n \n     qio_channel_set_blocking(data->dst, data->blocking, NULL);\n \n-    while (niov) {\n-        ssize_t ret;\n-\n-        ret = qio_channel_readv(data->dst,\n-                                iov,\n-                                niov,\n-                                &data->readerr);\n-\n-        if (ret == QIO_CHANNEL_ERR_BLOCK) {\n-            if (data->blocking) {\n-                error_setg(&data->readerr,\n-                           \"Unexpected I/O blocking\");\n-                break;\n-            } else {\n-                qio_channel_wait(data->dst,\n-                                 G_IO_IN);\n-                continue;\n-            }\n-        } else if (ret < 0) {\n-            break;\n-        } else if (ret == 0) {\n-            break;\n-        }\n-\n-        test_skip_iovec(&iov, &niov, ret, &old);\n-    }\n+    qio_channel_readv_all(data->dst,\n+                          data->outputv,\n+                          data->niov,\n+                          &data->readerr);\n \n     return NULL;\n }\n",
    "prefixes": [
        "v2"
    ]
}