linux.git/Documentation/ABI/testing/sysfs-block, branch master

docs: sysfs-block: move to stable directory

2022-01-10T01:59:10+00:00

The block layer sysfs ABI is widely used by userspace software and is
considered stable.

Reviewed-by: Martin K. Petersen 
Reviewed-by: Bart Van Assche 
Signed-off-by: Eric Biggers 
Link: https://lore.kernel.org/r/20211209003833.6396-2-ebiggers@kernel.org
Signed-off-by: Jens Axboe

block: add documentation for inflight

2021-10-19T21:03:42+00:00

Complements v2.6.32 commit a9327cac440b ("Seperate read and write
statistics of in_flight requests") and commit 316d315bffa4 ("block:
Seperate read and write statistics of in_flight requests v2").

Signed-off-by: Steffen Maier 
Reviewed-by: Jens Axboe 
Link: https://lore.kernel.org/r/20211019130230.77594-1-maier@linux.ibm.com
Signed-off-by: Jonathan Corbet

block: export diskseq in sysfs

2021-08-02T19:37:28+00:00

Add a new sysfs handle to export the new diskseq value.
Place it in /block//diskseq and document it.

    $ grep . /sys/class/block/*/diskseq
    /sys/class/block/loop0/diskseq:13
    /sys/class/block/loop1/diskseq:14
    /sys/class/block/loop2/diskseq:5
    /sys/class/block/loop3/diskseq:6
    /sys/class/block/ram0/diskseq:1
    /sys/class/block/ram1/diskseq:2
    /sys/class/block/vda/diskseq:7

Reviewed-by: Christoph Hellwig 
Signed-off-by: Matteo Croce 
Tested-by: Luca Boccassi 
Link: https://lore.kernel.org/r/20210712230530.29323-5-mcroce@linux.microsoft.com
Signed-off-by: Jens Axboe

docs: ABI: testing: make the files compatible with ReST output

2020-10-30T12:07:01+00:00

Some files over there won't parse well by Sphinx.

Fix them.

Acked-by: Jonathan Cameron  # for IIO
Acked-by: Fabrice Gasnier 
Acked-by: Jonathan Corbet 
Signed-off-by: Mauro Carvalho Chehab 
Link: https://lore.kernel.org/r/58cf3c2d611e0197fb215652719ebd82ca2658db.1604042072.git.mchehab+huawei@kernel.org
Signed-off-by: Greg Kroah-Hartman

block: add max_active_zones to blk-sysfs

2020-07-15T20:26:11+00:00

Add a new max_active zones definition in the sysfs documentation.
This definition will be common for all devices utilizing the zoned block
device support in the kernel.

Export max_active_zones according to this new definition for NVMe Zoned
Namespace devices, ZAC ATA devices (which are treated as SCSI devices by
the kernel), and ZBC SCSI devices.

Add the new max_active_zones member to struct request_queue, rather
than as a queue limit, since this property cannot be split across stacking
drivers.

For SCSI devices, even though max active zones is not part of the ZBC/ZAC
spec, export max_active_zones as 0, signifying "no limit".

Signed-off-by: Niklas Cassel 
Reviewed-by: Javier González 
Reviewed-by: Damien Le Moal 
Reviewed-by: Johannes Thumshirn 
Reviewed-by: Martin K. Petersen 
Signed-off-by: Jens Axboe

block: add max_open_zones to blk-sysfs

2020-07-15T20:26:11+00:00

Add a new max_open_zones definition in the sysfs documentation.
This definition will be common for all devices utilizing the zoned block
device support in the kernel.

Export max open zones according to this new definition for NVMe Zoned
Namespace devices, ZAC ATA devices (which are treated as SCSI devices by
the kernel), and ZBC SCSI devices.

Add the new max_open_zones member to struct request_queue, rather
than as a queue limit, since this property cannot be split across stacking
drivers.

Signed-off-by: Niklas Cassel 
Reviewed-by: Javier González 
Reviewed-by: Damien Le Moal 
Reviewed-by: Johannes Thumshirn 
Reviewed-by: Martin K. Petersen 
Signed-off-by: Jens Axboe

block: add iostat counters for flush requests

2019-11-21T16:06:47+00:00

Requests that triggers flushing volatile writeback cache to disk (barriers)
have significant effect to overall performance.

Block layer has sophisticated engine for combining several flush requests
into one. But there is no statistics for actual flushes executed by disk.
Requests which trigger flushes usually are barriers - zero-size writes.

This patch adds two iostat counters into /sys/class/block/$dev/stat and
/proc/diskstats - count of completed flush requests and their total time.

Signed-off-by: Konstantin Khlebnikov 
Signed-off-by: Jens Axboe

docs: admin-guide: add a series of orphaned documents

2019-07-15T14:03:02+00:00

There are lots of documents that belong to the admin-guide but
are on random places (most under Documentation root dir).

Move them to the admin guide.

Signed-off-by: Mauro Carvalho Chehab 
Acked-by: Alexandre Belloni 
Acked-by: Bartlomiej Zolnierkiewicz

block: add documentation for io_timeout

2019-01-05T02:19:51+00:00

Add documentation for /sys/block//queue/io_timeout.

Reviewed-by: Bart Van Assche 
Signed-off-by: Weiping Zhang 
Signed-off-by: Jens Axboe

block: update sysfs documentation

2018-12-17T02:53:06+00:00

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 
Signed-off-by: Jens Axboe