Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

block: fix uapi blkzoned.h comments

Update the kdoc comments for struct blk_zone (capacity field description
missing) and for struct blk_zone_report (flags field description
missing).

Signed-off-by: Damien Le Moal <damien.lemoal@wdc.com>
Reviewed-by: Johannes Thumshirn <johannes.thumshirn@wdc.com>
Signed-off-by: Jens Axboe <axboe@kernel.dk>

authored by

Damien Le Moal and committed by
Jens Axboe
8858e8d9 47ce030b

+9 -6
+9 -6
include/uapi/linux/blkzoned.h
··· 93 93 * @non_seq: Flag indicating that the zone is using non-sequential resources 94 94 * (for host-aware zoned block devices only). 95 95 * @reset: Flag indicating that a zone reset is recommended. 96 - * @reserved: Padding to 64 B to match the ZBC/ZAC defined zone descriptor size. 96 + * @resv: Padding for 8B alignment. 97 + * @capacity: Zone usable capacity in 512 B sector units 98 + * @reserved: Padding to 64 B to match the ZBC, ZAC and ZNS defined zone 99 + * descriptor size. 97 100 * 98 - * start, len and wp use the regular 512 B sector unit, regardless of the 99 - * device logical block size. The overall structure size is 64 B to match the 100 - * ZBC/ZAC defined zone descriptor and allow support for future additional 101 - * zone information. 101 + * start, len, capacity and wp use the regular 512 B sector unit, regardless 102 + * of the device logical block size. The overall structure size is 64 B to 103 + * match the ZBC, ZAC and ZNS defined zone descriptor and allow support for 104 + * future additional zone information. 102 105 */ 103 106 struct blk_zone { 104 107 __u64 start; /* Zone start sector */ ··· 121 118 * 122 119 * @sector: starting sector of report 123 120 * @nr_zones: IN maximum / OUT actual 124 - * @reserved: padding to 16 byte alignment 121 + * @flags: one or more flags as defined by enum blk_zone_report_flags. 125 122 * @zones: Space to hold @nr_zones @zones entries on reply. 126 123 * 127 124 * The array of at most @nr_zones must follow this structure in memory.