Eric Blake 4c41cb4955 block: Update comments on BDRV_BLOCK_* meanings ... We had some conflicting documentation: a nice 8-way table that described all possible combinations of DATA, ZERO, and OFFSET_VALID, contrasted with text that implied that OFFSET_VALID always meant raw data could be read directly. Furthermore, the text refers a lot to bs->file, even though the interface was updated back in 67a0fd2a to let the driver pass back a specific BDS (not necessarily bs->file). As the 8-way table is the intended semantics, simplify the rest of the text to get rid of the confusion. ALLOCATED is always set by the block layer for convenience (drivers do not have to worry about it). RAW is used only internally, but by more than the raw driver. Document these additional items on the driver callback. Suggested-by: Max Reitz <mreitz@redhat.com> Signed-off-by: Eric Blake <eblake@redhat.com> Reviewed-by: Max Reitz <mreitz@redhat.com> Message-id: 20170507000552.20847-4-eblake@redhat.com Signed-off-by: Max Reitz <mreitz@redhat.com>		2017-05-11 14:28:06 +02:00
..
accounting.h	Use scripts/clean-includes to drop redundant qemu/typedefs.h	2016-03-22 22:20:16 +01:00
aio.h	async: Introduce aio_co_enter	2017-04-11 20:07:15 +08:00
block.h	block: Update comments on BDRV_BLOCK_* meanings	2017-05-11 14:28:06 +02:00
block_backup.h	Backup: export interfaces for extra serialization	2016-09-13 11:00:56 +01:00
block_int.h	block: Update comments on BDRV_BLOCK_* meanings	2017-05-11 14:28:06 +02:00
blockjob.h	blockjob: Factor out block_job_remove_all_bdrv()	2017-02-28 20:40:37 +01:00
blockjob_int.h	blockjob: Add permissions to block_job_create()	2017-02-28 20:40:37 +01:00
dirty-bitmap.h	block: More operations for meta dirty bitmap	2016-10-24 17:56:07 +02:00
nbd.h	sockets: Limit SocketAddressLegacy to external interfaces	2017-05-09 09:14:40 +02:00
qapi.h	block/qapi: Use blk_enable_write_cache()	2016-03-30 12:16:02 +02:00
raw-aio.h	linux-aio: share one LinuxAioState within an AioContext	2016-07-18 15:09:31 +01:00
scsi.h	* SCSI scanner support	2016-07-14 13:44:06 +01:00
snapshot.h	include: Clean up includes	2016-02-23 12:43:05 +00:00
thread-pool.h	Clean up decorations and whitespace around header guards	2016-07-12 16:20:46 +02:00
throttle-groups.h	block: Move I/O throttling configuration functions to BlockBackend	2016-05-19 16:45:30 +02:00
write-threshold.h	Use scripts/clean-includes to drop redundant qemu/typedefs.h	2016-03-22 22:20:16 +01:00