Commit 8858e8d9 authored by Damien Le Moal's avatar Damien Le Moal Committed by Jens Axboe
Browse files

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: default avatarDamien Le Moal <damien.lemoal@wdc.com>
Reviewed-by: default avatarJohannes Thumshirn <johannes.thumshirn@wdc.com>
Signed-off-by: default avatarJens Axboe <axboe@kernel.dk>
parent 47ce030b

include/uapi/linux/blkzoned.h

+9 −6
Original line number Diff line number Diff line
@@ -93,12 +93,15 @@ enum blk_zone_report_flags { 
 * @non_seq: Flag indicating that the zone is using non-sequential resources

 *           (for host-aware zoned block devices only).

 * @reset: Flag indicating that a zone reset is recommended.

 * @reserved: Padding to 64 B to match the ZBC/ZAC defined zone descriptor size.

 * @resv: Padding for 8B alignment.

 * @capacity: Zone usable capacity in 512 B sector units

 * @reserved: Padding to 64 B to match the ZBC, ZAC and ZNS defined zone

 *            descriptor size.

 *

 * start, len and wp use the regular 512 B sector unit, regardless of the

 * device logical block size. The overall structure size is 64 B to match the

 * ZBC/ZAC defined zone descriptor and allow support for future additional

 * zone information.

 * start, len, capacity and wp use the regular 512 B sector unit, regardless

 * of the device logical block size. The overall structure size is 64 B to

 * match the ZBC, ZAC and ZNS defined zone descriptor and allow support for

 * future additional zone information.

 */

struct blk_zone {

	__u64	start;		/* Zone start sector */
@@ -118,7 +121,7 @@ struct blk_zone { 
 *

 * @sector: starting sector of report

 * @nr_zones: IN maximum / OUT actual

 * @reserved: padding to 16 byte alignment

 * @flags: one or more flags as defined by enum blk_zone_report_flags.

 * @zones: Space to hold @nr_zones @zones entries on reply.

 *

 * The array of at most @nr_zones must follow this structure in memory.

CRA Git | Maintained and supported by SUSTech CRA and CCSE