On 12/16/18 4:54 PM, Damien Le Moal wrote: > Jens, > > On 2018/11/30 14:36, Damien Le Moal wrote: >> Add the description of the zoned, nr_zones and chunk_sectors sysfs queue >> attributes to Documentation/block/queue-sysfs.txt. The description of >> the zoned and chunk_sector attributes are mostly copied from >> ABI/testing/sysfs-block (added a typo fix). While at it, also fix a >> typo in the description of the io_poll_delay attribute. >> >> nr_zones description is also added to ABI/testing/sysfs-block and >> contact email address updated for the zoned attribute. >> >> Signed-off-by: Damien Le Moal <[email protected]> >> --- >> Documentation/ABI/testing/sysfs-block | 12 +++++++++-- >> Documentation/block/queue-sysfs.txt | 29 ++++++++++++++++++++++++++- >> 2 files changed, 38 insertions(+), 3 deletions(-) >> >> diff --git a/Documentation/ABI/testing/sysfs-block >> b/Documentation/ABI/testing/sysfs-block >> index dea212db9df3..7710d4022b19 100644 >> --- a/Documentation/ABI/testing/sysfs-block >> +++ b/Documentation/ABI/testing/sysfs-block >> @@ -244,7 +244,7 @@ Description: >> >> What: /sys/block/<disk>/queue/zoned >> Date: September 2016 >> -Contact: Damien Le Moal <[email protected]> >> +Contact: Damien Le Moal <[email protected]> >> Description: >> zoned indicates if the device is a zoned block device >> and the zone model of the device if it is indeed zoned. >> @@ -259,6 +259,14 @@ Description: >> zone commands, they will be treated as regular block >> devices and zoned will report "none". >> >> +What: /sys/block/<disk>/queue/nr_zones >> +Date: November 2018 >> +Contact: Damien Le Moal <[email protected]> >> +Description: >> + nr_zones indicates the total number of zones of a zoned block >> + device ("host-aware" or "host-managed" zone model). For regular >> + block devices, the value is always 0. >> + >> What: /sys/block/<disk>/queue/chunk_sectors >> Date: September 2016 >> Contact: Hannes Reinecke <[email protected]> >> @@ -268,6 +276,6 @@ Description: >> indicates the size in 512B sectors of the RAID volume >> stripe segment. For a zoned block device, either >> host-aware or host-managed, chunk_sectors indicates the >> - size of 512B sectors of the zones of the device, with >> + size in 512B sectors of the zones of the device, with >> the eventual exception of the last zone of the device >> which may be smaller. >> diff --git a/Documentation/block/queue-sysfs.txt >> b/Documentation/block/queue-sysfs.txt >> index 2c1e67058fd3..39e286d7afc9 100644 >> --- a/Documentation/block/queue-sysfs.txt >> +++ b/Documentation/block/queue-sysfs.txt >> @@ -64,7 +64,7 @@ guess, the kernel will put the process issuing IO to sleep >> for an amount >> of time, before entering a classic poll loop. This mode might be a >> little slower than pure classic polling, but it will be more efficient. >> If set to a value larger than 0, the kernel will put the process issuing >> -IO to sleep for this amont of microseconds before entering classic >> +IO to sleep for this amount of microseconds before entering classic >> polling. >> >> iostats (RW) >> @@ -194,4 +194,31 @@ blk-throttle makes decision based on the samplings. >> Lower time means cgroups >> have more smooth throughput, but higher CPU overhead. This exists only when >> CONFIG_BLK_DEV_THROTTLING_LOW is enabled. >> >> +zoned (RO) >> +---------- >> +This indicates if the device is a zoned block device and the zone model of >> the >> +device if it is indeed zoned. The possible values indicated by zoned are >> +"none" for regular block devices and "host-aware" or "host-managed" for >> zoned >> +block devices. The characteristics of host-aware and host-managed zoned >> block >> +devices are described in the ZBC (Zoned Block Commands) and ZAC >> +(Zoned Device ATA Command Set) standards. These standards also define the >> +"drive-managed" zone model. However, since drive-managed zoned block devices >> +do not support zone commands, they will be treated as regular block devices >> +and zoned will report "none". >> + >> +nr_zones (RO) >> +------------- >> +For zoned block devices (zoned attribute indicating "host-managed" or >> +"host-aware"), this indicates the total number of zones of the device. >> +This is always 0 for regular block devices. >> + >> +chunk_sectors (RO) >> +------------------ >> +This has different meaning depending on the type of the block device. >> +For a RAID device (dm-raid), chunk_sectors indicates the size in 512B >> sectors >> +of the RAID volume stripe segment. For a zoned block device, either >> host-aware >> +or host-managed, chunk_sectors indicates the size in 512B sectors of the >> zones >> +of the device, with the eventual exception of the last zone of the device >> which >> +may be smaller. >> + >> Jens Axboe <[email protected]>, February 2009 >> > > Ping... > > As Johannes suggested, you may also want to update your email address (I did > not > do so as this is somewhat personal information).
Thanks, added. I'll see if I can remember to update that part... -- Jens Axboe
