{"id":810173,"url":"http://patchwork.ozlabs.org/api/1.2/patches/810173/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170905132908.30931-5-stefanha@redhat.com/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/1.2/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":"<20170905132908.30931-5-stefanha@redhat.com>","list_archive_url":null,"date":"2017-09-05T13:29:08","name":"[PULL,4/4] block: document semantics of bdrv_co_preadv|pwritev","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"243544c0502bd4f849049538fe4734f483e07486","submitter":{"id":17227,"url":"http://patchwork.ozlabs.org/api/1.2/people/17227/?format=json","name":"Stefan Hajnoczi","email":"stefanha@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20170905132908.30931-5-stefanha@redhat.com/mbox/","series":[{"id":1584,"url":"http://patchwork.ozlabs.org/api/1.2/series/1584/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=1584","date":"2017-09-05T13:29:04","name":"[PULL,1/4] qemu.py: make VM() a context manager","version":1,"mbox":"http://patchwork.ozlabs.org/series/1584/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/810173/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/810173/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-mx10.extmail.prod.ext.phx2.redhat.com;\n\tdmarc=none (p=none dis=none) header.from=redhat.com","ext-mx10.extmail.prod.ext.phx2.redhat.com;\n\tspf=fail smtp.mailfrom=stefanha@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 3xmnhW67Wmz9t2S\n\tfor ;\n\tTue, 5 Sep 2017 23:32:43 +1000 (AEST)","from localhost ([::1]:58961 helo=lists.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.71) (envelope-from\n\t)\n\tid 1dpDy5-00032h-Uo\n\tfor incoming@patchwork.ozlabs.org; Tue, 05 Sep 2017 09:32:41 -0400","from eggs.gnu.org ([2001:4830:134:3::10]:51352)\n\tby lists.gnu.org with esmtp (Exim 4.71)\n\t(envelope-from ) id 1dpDv9-0000xb-9y\n\tfor qemu-devel@nongnu.org; Tue, 05 Sep 2017 09:29:44 -0400","from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)\n\t(envelope-from ) id 1dpDv4-00040w-Ll\n\tfor qemu-devel@nongnu.org; Tue, 05 Sep 2017 09:29:39 -0400","from mx1.redhat.com ([209.132.183.28]:35380)\n\tby eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)\n\t(Exim 4.71) (envelope-from ) id 1dpDv4-00040L-EY\n\tfor qemu-devel@nongnu.org; Tue, 05 Sep 2017 09:29:34 -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 542AA25A7AD;\n\tTue, 5 Sep 2017 13:29:33 +0000 (UTC)","from localhost (ovpn-117-180.ams2.redhat.com [10.36.117.180])\n\tby smtp.corp.redhat.com (Postfix) with ESMTP id 0772480C61;\n\tTue, 5 Sep 2017 13:29:21 +0000 (UTC)"],"DMARC-Filter":"OpenDMARC Filter v1.3.2 mx1.redhat.com 542AA25A7AD","From":"Stefan Hajnoczi ","To":"","Date":"Tue, 5 Sep 2017 14:29:08 +0100","Message-Id":"<20170905132908.30931-5-stefanha@redhat.com>","In-Reply-To":"<20170905132908.30931-1-stefanha@redhat.com>","References":"<20170905132908.30931-1-stefanha@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.39]);\n\tTue, 05 Sep 2017 13:29:33 +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] [PULL 4/4] 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":"Peter Maydell ,\n\tStefan Hajnoczi ","Errors-To":"qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org","Sender":"\"Qemu-devel\"\n\t"},"content":"From: \"Daniel P. Berrange\" \n\nReviewed-by: Stefan Hajnoczi \nReviewed-by: Eric Blake \nSigned-off-by: Daniel P. Berrange \nMessage-id: 20170831105456.9558-1-berrange@redhat.com\nSigned-off-by: Stefan Hajnoczi \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":["PULL","4/4"]}