[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 3/6] sysemu/block-backend: Document blk_read()/blk_pwrite()
From: |
Philippe Mathieu-Daudé |
Subject: |
[PATCH 3/6] sysemu/block-backend: Document blk_read()/blk_pwrite() |
Date: |
Mon, 4 May 2020 11:46:38 +0200 |
The blk_read()/blk_pwrite() return value is not obvious,
document it.
Signed-off-by: Philippe Mathieu-Daudé <address@hidden>
---
include/sysemu/block-backend.h | 24 ++++++++++++++++++++++++
1 file changed, 24 insertions(+)
diff --git a/include/sysemu/block-backend.h b/include/sysemu/block-backend.h
index f2dcf63ae3..823b8e94a7 100644
--- a/include/sysemu/block-backend.h
+++ b/include/sysemu/block-backend.h
@@ -153,7 +153,31 @@ BlockAIOCB *blk_aio_pwrite_zeroes(BlockBackend *blk,
int64_t offset,
int bytes, BdrvRequestFlags flags,
BlockCompletionFunc *cb, void *opaque);
int blk_make_zero(BlockBackend *blk, BdrvRequestFlags flags);
+
+/**
+ * blk_pread:
+ *
+ * @blk - the block backend where the buffer content is going to be read from
+ * @offset: position in bytes to read at
+ * @buf: the data buffer
+ * @bytes: number of bytes to read
+ *
+ * Returns: the number of bytes read on success, or a negative errno otherwise.
+ */
int blk_pread(BlockBackend *blk, int64_t offset, void *buf, int bytes);
+
+/**
+ * blk_pwrite:
+ *
+ * @blk - the block backend where the buffer content is going to be written to
+ * @offset: position in bytes to write at
+ * @buf: the data buffer
+ * @bytes: number of bytes of @buf to write
+ * @flags: request flags
+ *
+ * Returns: the number of bytes consumed on success,
+ * or a negative errno otherwise.
+ */
int blk_pwrite(BlockBackend *blk, int64_t offset, const void *buf, int bytes,
BdrvRequestFlags flags);
int64_t blk_getlength(BlockBackend *blk);
--
2.21.3
- [PATCH 0/6] block/nvme: Align block pages queue to host page size, Philippe Mathieu-Daudé, 2020/05/04
- [PATCH 1/6] qemu/osdep: Document qemu_memalign() and friends, Philippe Mathieu-Daudé, 2020/05/04
- [PATCH 2/6] qemu/bitmap: Document bitmap_new() returned pointer, Philippe Mathieu-Daudé, 2020/05/04
- [PATCH 3/6] sysemu/block-backend: Document blk_read()/blk_pwrite(),
Philippe Mathieu-Daudé <=
- [PATCH 4/6] block/block: Document BlockSizes fields, Philippe Mathieu-Daudé, 2020/05/04
- [PATCH 5/6] block/nvme: Align block pages queue to host page size, Philippe Mathieu-Daudé, 2020/05/04
- Re: [PATCH 5/6] block/nvme: Align block pages queue to host page size, Philippe Mathieu-Daudé, 2020/05/05
- [RFC PATCH 6/6] hw/block/nvme: Make device target agnostic, Philippe Mathieu-Daudé, 2020/05/04