{"id":808216,"url":"http://patchwork.ozlabs.org/api/patches/808216/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170831105456.9558-1-berrange@redhat.com/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/projects/14/?format=json","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":"<20170831105456.9558-1-berrange@redhat.com>","list_archive_url":null,"date":"2017-08-31T10:54:56","name":"[v4] block: document semantics of bdrv_co_preadv|pwritev","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"243544c0502bd4f849049538fe4734f483e07486","submitter":{"id":2694,"url":"http://patchwork.ozlabs.org/api/people/2694/?format=json","name":"Daniel P. Berrangé","email":"berrange@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170831105456.9558-1-berrange@redhat.com/mbox/","series":[{"id":807,"url":"http://patchwork.ozlabs.org/api/series/807/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=807","date":"2017-08-31T10:54:56","name":"[v4] block: document semantics of bdrv_co_preadv|pwritev","version":4,"mbox":"http://patchwork.ozlabs.org/series/807/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/808216/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/808216/checks/","tags":{},"related":[],"headers":{"Return-Path":"","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=)","ext-mx01.extmail.prod.ext.phx2.redhat.com;\n\tdmarc=none (p=none dis=none) header.from=redhat.com","ext-mx01.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 3xjgb63sJ0z9sQl\n\tfor ;\n\tThu, 31 Aug 2017 21:47:14 +1000 (AEST)","from localhost ([::1]:55165 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t)\n\tid 1dnNwG-0004rx-Mv\n\tfor incoming@patchwork.ozlabs.org; Thu, 31 Aug 2017 07:47:12 -0400","from eggs.gnu.org ([2001:4830:134:3::10]:47083)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from ) id 1dnN7z-0007c2-Kz\n\tfor qemu-devel@nongnu.org; Thu, 31 Aug 2017 06:55:16 -0400","from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from ) id 1dnN7y-0004Bk-TW\n\tfor qemu-devel@nongnu.org; Thu, 31 Aug 2017 06:55:15 -0400","from mx1.redhat.com ([209.132.183.28]:47622)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from )\n\tid 1dnN7q-00045I-Oy; Thu, 31 Aug 2017 06:55:06 -0400","from smtp.corp.redhat.com\n\t(int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16])\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 C0B7F81E1E;\n\tThu, 31 Aug 2017 10:55:05 +0000 (UTC)","from localhost.localdomain.com (unknown [10.42.22.189])\n\tby smtp.corp.redhat.com (Postfix) with ESMTP id 973399D5C4;\n\tThu, 31 Aug 2017 10:55:02 +0000 (UTC)"],"DMARC-Filter":"OpenDMARC Filter v1.3.2 mx1.redhat.com C0B7F81E1E","From":"\"Daniel P. Berrange\" ","To":"qemu-devel@nongnu.org","Date":"Thu, 31 Aug 2017 11:54:56 +0100","Message-Id":"<20170831105456.9558-1-berrange@redhat.com>","X-Scanned-By":"MIMEDefang 2.79 on 10.5.11.16","X-Greylist":"Sender IP whitelisted, not delayed by milter-greylist-4.5.16\n\t(mx1.redhat.com [10.5.110.25]);\n\tThu, 31 Aug 2017 10:55:05 +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 v4] block: document semantics of\n\tbdrv_co_preadv|pwritev","X-BeenThere":"qemu-devel@nongnu.org","X-Mailman-Version":"2.1.21","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Cc":"Kevin Wolf , qemu-block@nongnu.org,\n\tStefan Hajnoczi , Max Reitz ","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n\t"},"content":"Reviewed-by: Stefan Hajnoczi \nReviewed-by: Eric Blake \nSigned-off-by: Daniel P. Berrange \n---\n\nChanged in v4:\n\n - Fix typo in commit message\n\n include/block/block_int.h | 31 +++++++++++++++++++++++++++++++\n 1 file changed, 31 insertions(+)","diff":"diff --git a/include/block/block_int.h b/include/block/block_int.h\nindex 7571c0aaaf..7816b43a27 100644\n--- a/include/block/block_int.h\n+++ b/include/block/block_int.h\n@@ -146,12 +146,43 @@ struct BlockDriver {\n \n int coroutine_fn (*bdrv_co_readv)(BlockDriverState *bs,\n int64_t sector_num, int nb_sectors, QEMUIOVector *qiov);\n+\n+ /**\n+ * @offset: position in bytes to read at\n+ * @bytes: number of bytes to read\n+ * @qiov: the buffers to fill with read data\n+ * @flags: currently unused, always 0\n+ *\n+ * @offset and @bytes will be a multiple of 'request_alignment',\n+ * but the length of individual @qiov elements does not have to\n+ * be a multiple.\n+ *\n+ * @bytes will always equal the total size of @qiov, and will be\n+ * no larger than 'max_transfer'.\n+ *\n+ * The buffer in @qiov may point directly to guest memory.\n+ */\n int coroutine_fn (*bdrv_co_preadv)(BlockDriverState *bs,\n uint64_t offset, uint64_t bytes, QEMUIOVector *qiov, int flags);\n int coroutine_fn (*bdrv_co_writev)(BlockDriverState *bs,\n int64_t sector_num, int nb_sectors, QEMUIOVector *qiov);\n int coroutine_fn (*bdrv_co_writev_flags)(BlockDriverState *bs,\n int64_t sector_num, int nb_sectors, QEMUIOVector *qiov, int flags);\n+ /**\n+ * @offset: position in bytes to write at\n+ * @bytes: number of bytes to write\n+ * @qiov: the buffers containing data to write\n+ * @flags: zero or more bits allowed by 'supported_write_flags'\n+ *\n+ * @offset and @bytes will be a multiple of 'request_alignment',\n+ * but the length of individual @qiov elements does not have to\n+ * be a multiple.\n+ *\n+ * @bytes will always equal the total size of @qiov, and will be\n+ * no larger than 'max_transfer'.\n+ *\n+ * The buffer in @qiov may point directly to guest memory.\n+ */\n int coroutine_fn (*bdrv_co_pwritev)(BlockDriverState *bs,\n uint64_t offset, uint64_t bytes, QEMUIOVector *qiov, int flags);\n \n","prefixes":["v4"]}