qemu/include/block
Hanna Reitz 5a1cfd2150 block: Clarify that @bytes is no limit on *pnum
.bdrv_co_block_status() implementations are free to return a *pnum that
exceeds @bytes, because bdrv_co_block_status() in block/io.c will clamp
*pnum as necessary.

On the other hand, if drivers' implementations return values for *pnum
that are as large as possible, our recently introduced block-status
cache will become more effective.

So, make a note in block_int.h that @bytes is no upper limit for *pnum.

Suggested-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Hanna Reitz <hreitz@redhat.com>
Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
Message-Id: <20210812084148.14458-4-hreitz@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
2021-09-15 15:54:07 +02:00
..
accounting.h
aio_task.h
aio-wait.h
aio.h iothread: add aio-max-batch parameter 2021-07-21 13:47:50 +01:00
block_backup.h
block_int.h block: Clarify that @bytes is no limit on *pnum 2021-09-15 15:54:07 +02:00
block-copy.h block/block-copy: block_copy_state_new(): drop extra arguments 2021-09-01 14:38:08 +02:00
block-hmp-cmds.h
block.h block: introduce bdrv_replace_child_bs() 2021-09-01 12:57:31 +02:00
blockjob_int.h
blockjob.h
dirty-bitmap.h
export.h
fuse.h
nbd.h nbd/client-connection: add option for non-blocking connection attempt 2021-06-18 12:21:22 -05:00
nvme.h hw/nvme: use symbolic names for registers 2021-07-26 21:09:38 +02:00
qapi.h
qdict.h
raw-aio.h
replication.h
snapshot.h
thread-pool.h
throttle-groups.h
write-threshold.h