162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/alignment_offset
262306a36Sopenharmony_ciDate:		April 2009
362306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
462306a36Sopenharmony_ciDescription:
562306a36Sopenharmony_ci		Storage devices may report a physical block size that is
662306a36Sopenharmony_ci		bigger than the logical block size (for instance a drive
762306a36Sopenharmony_ci		with 4KB physical sectors exposing 512-byte logical
862306a36Sopenharmony_ci		blocks to the operating system).  This parameter
962306a36Sopenharmony_ci		indicates how many bytes the beginning of the device is
1062306a36Sopenharmony_ci		offset from the disk's natural alignment.
1162306a36Sopenharmony_ci
1262306a36Sopenharmony_ci
1362306a36Sopenharmony_ciWhat:		/sys/block/<disk>/discard_alignment
1462306a36Sopenharmony_ciDate:		May 2011
1562306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
1662306a36Sopenharmony_ciDescription:
1762306a36Sopenharmony_ci		Devices that support discard functionality may
1862306a36Sopenharmony_ci		internally allocate space in units that are bigger than
1962306a36Sopenharmony_ci		the exported logical block size. The discard_alignment
2062306a36Sopenharmony_ci		parameter indicates how many bytes the beginning of the
2162306a36Sopenharmony_ci		device is offset from the internal allocation unit's
2262306a36Sopenharmony_ci		natural alignment.
2362306a36Sopenharmony_ci
2462306a36Sopenharmony_ci
2562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/diskseq
2662306a36Sopenharmony_ciDate:		February 2021
2762306a36Sopenharmony_ciContact:	Matteo Croce <mcroce@microsoft.com>
2862306a36Sopenharmony_ciDescription:
2962306a36Sopenharmony_ci		The /sys/block/<disk>/diskseq files reports the disk
3062306a36Sopenharmony_ci		sequence number, which is a monotonically increasing
3162306a36Sopenharmony_ci		number assigned to every drive.
3262306a36Sopenharmony_ci		Some devices, like the loop device, refresh such number
3362306a36Sopenharmony_ci		every time the backing file is changed.
3462306a36Sopenharmony_ci		The value type is 64 bit unsigned.
3562306a36Sopenharmony_ci
3662306a36Sopenharmony_ci
3762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/inflight
3862306a36Sopenharmony_ciDate:		October 2009
3962306a36Sopenharmony_ciContact:	Jens Axboe <axboe@kernel.dk>, Nikanth Karthikesan <knikanth@suse.de>
4062306a36Sopenharmony_ciDescription:
4162306a36Sopenharmony_ci		Reports the number of I/O requests currently in progress
4262306a36Sopenharmony_ci		(pending / in flight) in a device driver. This can be less
4362306a36Sopenharmony_ci		than the number of requests queued in the block device queue.
4462306a36Sopenharmony_ci		The report contains 2 fields: one for read requests
4562306a36Sopenharmony_ci		and one for write requests.
4662306a36Sopenharmony_ci		The value type is unsigned int.
4762306a36Sopenharmony_ci		Cf. Documentation/block/stat.rst which contains a single value for
4862306a36Sopenharmony_ci		requests in flight.
4962306a36Sopenharmony_ci		This is related to /sys/block/<disk>/queue/nr_requests
5062306a36Sopenharmony_ci		and for SCSI device also its queue_depth.
5162306a36Sopenharmony_ci
5262306a36Sopenharmony_ci
5362306a36Sopenharmony_ciWhat:		/sys/block/<disk>/integrity/device_is_integrity_capable
5462306a36Sopenharmony_ciDate:		July 2014
5562306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
5662306a36Sopenharmony_ciDescription:
5762306a36Sopenharmony_ci		Indicates whether a storage device is capable of storing
5862306a36Sopenharmony_ci		integrity metadata. Set if the device is T10 PI-capable.
5962306a36Sopenharmony_ci
6062306a36Sopenharmony_ci
6162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/integrity/format
6262306a36Sopenharmony_ciDate:		June 2008
6362306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
6462306a36Sopenharmony_ciDescription:
6562306a36Sopenharmony_ci		Metadata format for integrity capable block device.
6662306a36Sopenharmony_ci		E.g. T10-DIF-TYPE1-CRC.
6762306a36Sopenharmony_ci
6862306a36Sopenharmony_ci
6962306a36Sopenharmony_ciWhat:		/sys/block/<disk>/integrity/protection_interval_bytes
7062306a36Sopenharmony_ciDate:		July 2015
7162306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
7262306a36Sopenharmony_ciDescription:
7362306a36Sopenharmony_ci		Describes the number of data bytes which are protected
7462306a36Sopenharmony_ci		by one integrity tuple. Typically the device's logical
7562306a36Sopenharmony_ci		block size.
7662306a36Sopenharmony_ci
7762306a36Sopenharmony_ci
7862306a36Sopenharmony_ciWhat:		/sys/block/<disk>/integrity/read_verify
7962306a36Sopenharmony_ciDate:		June 2008
8062306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
8162306a36Sopenharmony_ciDescription:
8262306a36Sopenharmony_ci		Indicates whether the block layer should verify the
8362306a36Sopenharmony_ci		integrity of read requests serviced by devices that
8462306a36Sopenharmony_ci		support sending integrity metadata.
8562306a36Sopenharmony_ci
8662306a36Sopenharmony_ci
8762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/integrity/tag_size
8862306a36Sopenharmony_ciDate:		June 2008
8962306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
9062306a36Sopenharmony_ciDescription:
9162306a36Sopenharmony_ci		Number of bytes of integrity tag space available per
9262306a36Sopenharmony_ci		512 bytes of data.
9362306a36Sopenharmony_ci
9462306a36Sopenharmony_ci
9562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/integrity/write_generate
9662306a36Sopenharmony_ciDate:		June 2008
9762306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
9862306a36Sopenharmony_ciDescription:
9962306a36Sopenharmony_ci		Indicates whether the block layer should automatically
10062306a36Sopenharmony_ci		generate checksums for write requests bound for
10162306a36Sopenharmony_ci		devices that support receiving integrity metadata.
10262306a36Sopenharmony_ci
10362306a36Sopenharmony_ci
10462306a36Sopenharmony_ciWhat:		/sys/block/<disk>/<partition>/alignment_offset
10562306a36Sopenharmony_ciDate:		April 2009
10662306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
10762306a36Sopenharmony_ciDescription:
10862306a36Sopenharmony_ci		Storage devices may report a physical block size that is
10962306a36Sopenharmony_ci		bigger than the logical block size (for instance a drive
11062306a36Sopenharmony_ci		with 4KB physical sectors exposing 512-byte logical
11162306a36Sopenharmony_ci		blocks to the operating system).  This parameter
11262306a36Sopenharmony_ci		indicates how many bytes the beginning of the partition
11362306a36Sopenharmony_ci		is offset from the disk's natural alignment.
11462306a36Sopenharmony_ci
11562306a36Sopenharmony_ci
11662306a36Sopenharmony_ciWhat:		/sys/block/<disk>/<partition>/discard_alignment
11762306a36Sopenharmony_ciDate:		May 2011
11862306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
11962306a36Sopenharmony_ciDescription:
12062306a36Sopenharmony_ci		Devices that support discard functionality may
12162306a36Sopenharmony_ci		internally allocate space in units that are bigger than
12262306a36Sopenharmony_ci		the exported logical block size. The discard_alignment
12362306a36Sopenharmony_ci		parameter indicates how many bytes the beginning of the
12462306a36Sopenharmony_ci		partition is offset from the internal allocation unit's
12562306a36Sopenharmony_ci		natural alignment.
12662306a36Sopenharmony_ci
12762306a36Sopenharmony_ci
12862306a36Sopenharmony_ciWhat:		/sys/block/<disk>/<partition>/stat
12962306a36Sopenharmony_ciDate:		February 2008
13062306a36Sopenharmony_ciContact:	Jerome Marchand <jmarchan@redhat.com>
13162306a36Sopenharmony_ciDescription:
13262306a36Sopenharmony_ci		The /sys/block/<disk>/<partition>/stat files display the
13362306a36Sopenharmony_ci		I/O statistics of partition <partition>. The format is the
13462306a36Sopenharmony_ci		same as the format of /sys/block/<disk>/stat.
13562306a36Sopenharmony_ci
13662306a36Sopenharmony_ci
13762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/add_random
13862306a36Sopenharmony_ciDate:		June 2010
13962306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
14062306a36Sopenharmony_ciDescription:
14162306a36Sopenharmony_ci		[RW] This file allows to turn off the disk entropy contribution.
14262306a36Sopenharmony_ci		Default value of this file is '1'(on).
14362306a36Sopenharmony_ci
14462306a36Sopenharmony_ci
14562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/chunk_sectors
14662306a36Sopenharmony_ciDate:		September 2016
14762306a36Sopenharmony_ciContact:	Hannes Reinecke <hare@suse.com>
14862306a36Sopenharmony_ciDescription:
14962306a36Sopenharmony_ci		[RO] chunk_sectors has different meaning depending on the type
15062306a36Sopenharmony_ci		of the disk. For a RAID device (dm-raid), chunk_sectors
15162306a36Sopenharmony_ci		indicates the size in 512B sectors of the RAID volume stripe
15262306a36Sopenharmony_ci		segment. For a zoned block device, either host-aware or
15362306a36Sopenharmony_ci		host-managed, chunk_sectors indicates the size in 512B sectors
15462306a36Sopenharmony_ci		of the zones of the device, with the eventual exception of the
15562306a36Sopenharmony_ci		last zone of the device which may be smaller.
15662306a36Sopenharmony_ci
15762306a36Sopenharmony_ci
15862306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/crypto/
15962306a36Sopenharmony_ciDate:		February 2022
16062306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
16162306a36Sopenharmony_ciDescription:
16262306a36Sopenharmony_ci		The presence of this subdirectory of /sys/block/<disk>/queue/
16362306a36Sopenharmony_ci		indicates that the device supports inline encryption.  This
16462306a36Sopenharmony_ci		subdirectory contains files which describe the inline encryption
16562306a36Sopenharmony_ci		capabilities of the device.  For more information about inline
16662306a36Sopenharmony_ci		encryption, refer to Documentation/block/inline-encryption.rst.
16762306a36Sopenharmony_ci
16862306a36Sopenharmony_ci
16962306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/crypto/max_dun_bits
17062306a36Sopenharmony_ciDate:		February 2022
17162306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
17262306a36Sopenharmony_ciDescription:
17362306a36Sopenharmony_ci		[RO] This file shows the maximum length, in bits, of data unit
17462306a36Sopenharmony_ci		numbers accepted by the device in inline encryption requests.
17562306a36Sopenharmony_ci
17662306a36Sopenharmony_ci
17762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/crypto/modes/<mode>
17862306a36Sopenharmony_ciDate:		February 2022
17962306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
18062306a36Sopenharmony_ciDescription:
18162306a36Sopenharmony_ci		[RO] For each crypto mode (i.e., encryption/decryption
18262306a36Sopenharmony_ci		algorithm) the device supports with inline encryption, a file
18362306a36Sopenharmony_ci		will exist at this location.  It will contain a hexadecimal
18462306a36Sopenharmony_ci		number that is a bitmask of the supported data unit sizes, in
18562306a36Sopenharmony_ci		bytes, for that crypto mode.
18662306a36Sopenharmony_ci
18762306a36Sopenharmony_ci		Currently, the crypto modes that may be supported are:
18862306a36Sopenharmony_ci
18962306a36Sopenharmony_ci		   * AES-256-XTS
19062306a36Sopenharmony_ci		   * AES-128-CBC-ESSIV
19162306a36Sopenharmony_ci		   * Adiantum
19262306a36Sopenharmony_ci
19362306a36Sopenharmony_ci		For example, if a device supports AES-256-XTS inline encryption
19462306a36Sopenharmony_ci		with data unit sizes of 512 and 4096 bytes, the file
19562306a36Sopenharmony_ci		/sys/block/<disk>/queue/crypto/modes/AES-256-XTS will exist and
19662306a36Sopenharmony_ci		will contain "0x1200".
19762306a36Sopenharmony_ci
19862306a36Sopenharmony_ci
19962306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/crypto/num_keyslots
20062306a36Sopenharmony_ciDate:		February 2022
20162306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
20262306a36Sopenharmony_ciDescription:
20362306a36Sopenharmony_ci		[RO] This file shows the number of keyslots the device has for
20462306a36Sopenharmony_ci		use with inline encryption.
20562306a36Sopenharmony_ci
20662306a36Sopenharmony_ci
20762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/dax
20862306a36Sopenharmony_ciDate:		June 2016
20962306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
21062306a36Sopenharmony_ciDescription:
21162306a36Sopenharmony_ci		[RO] This file indicates whether the device supports Direct
21262306a36Sopenharmony_ci		Access (DAX), used by CPU-addressable storage to bypass the
21362306a36Sopenharmony_ci		pagecache.  It shows '1' if true, '0' if not.
21462306a36Sopenharmony_ci
21562306a36Sopenharmony_ci
21662306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/discard_granularity
21762306a36Sopenharmony_ciDate:		May 2011
21862306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
21962306a36Sopenharmony_ciDescription:
22062306a36Sopenharmony_ci		[RO] Devices that support discard functionality may internally
22162306a36Sopenharmony_ci		allocate space using units that are bigger than the logical
22262306a36Sopenharmony_ci		block size. The discard_granularity parameter indicates the size
22362306a36Sopenharmony_ci		of the internal allocation unit in bytes if reported by the
22462306a36Sopenharmony_ci		device. Otherwise the discard_granularity will be set to match
22562306a36Sopenharmony_ci		the device's physical block size. A discard_granularity of 0
22662306a36Sopenharmony_ci		means that the device does not support discard functionality.
22762306a36Sopenharmony_ci
22862306a36Sopenharmony_ci
22962306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/discard_max_bytes
23062306a36Sopenharmony_ciDate:		May 2011
23162306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
23262306a36Sopenharmony_ciDescription:
23362306a36Sopenharmony_ci		[RW] While discard_max_hw_bytes is the hardware limit for the
23462306a36Sopenharmony_ci		device, this setting is the software limit. Some devices exhibit
23562306a36Sopenharmony_ci		large latencies when large discards are issued, setting this
23662306a36Sopenharmony_ci		value lower will make Linux issue smaller discards and
23762306a36Sopenharmony_ci		potentially help reduce latencies induced by large discard
23862306a36Sopenharmony_ci		operations.
23962306a36Sopenharmony_ci
24062306a36Sopenharmony_ci
24162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/discard_max_hw_bytes
24262306a36Sopenharmony_ciDate:		July 2015
24362306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
24462306a36Sopenharmony_ciDescription:
24562306a36Sopenharmony_ci		[RO] Devices that support discard functionality may have
24662306a36Sopenharmony_ci		internal limits on the number of bytes that can be trimmed or
24762306a36Sopenharmony_ci		unmapped in a single operation.  The `discard_max_hw_bytes`
24862306a36Sopenharmony_ci		parameter is set by the device driver to the maximum number of
24962306a36Sopenharmony_ci		bytes that can be discarded in a single operation.  Discard
25062306a36Sopenharmony_ci		requests issued to the device must not exceed this limit.  A
25162306a36Sopenharmony_ci		`discard_max_hw_bytes` value of 0 means that the device does not
25262306a36Sopenharmony_ci		support discard functionality.
25362306a36Sopenharmony_ci
25462306a36Sopenharmony_ci
25562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/discard_zeroes_data
25662306a36Sopenharmony_ciDate:		May 2011
25762306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
25862306a36Sopenharmony_ciDescription:
25962306a36Sopenharmony_ci		[RO] Will always return 0.  Don't rely on any specific behavior
26062306a36Sopenharmony_ci		for discards, and don't read this file.
26162306a36Sopenharmony_ci
26262306a36Sopenharmony_ci
26362306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/dma_alignment
26462306a36Sopenharmony_ciDate:		May 2022
26562306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
26662306a36Sopenharmony_ciDescription:
26762306a36Sopenharmony_ci		Reports the alignment that user space addresses must have to be
26862306a36Sopenharmony_ci		used for raw block device access with O_DIRECT and other driver
26962306a36Sopenharmony_ci		specific passthrough mechanisms.
27062306a36Sopenharmony_ci
27162306a36Sopenharmony_ci
27262306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/fua
27362306a36Sopenharmony_ciDate:		May 2018
27462306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
27562306a36Sopenharmony_ciDescription:
27662306a36Sopenharmony_ci		[RO] Whether or not the block driver supports the FUA flag for
27762306a36Sopenharmony_ci		write requests.  FUA stands for Force Unit Access. If the FUA
27862306a36Sopenharmony_ci		flag is set that means that write requests must bypass the
27962306a36Sopenharmony_ci		volatile cache of the storage device.
28062306a36Sopenharmony_ci
28162306a36Sopenharmony_ci
28262306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/hw_sector_size
28362306a36Sopenharmony_ciDate:		January 2008
28462306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
28562306a36Sopenharmony_ciDescription:
28662306a36Sopenharmony_ci		[RO] This is the hardware sector size of the device, in bytes.
28762306a36Sopenharmony_ci
28862306a36Sopenharmony_ci
28962306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/independent_access_ranges/
29062306a36Sopenharmony_ciDate:		October 2021
29162306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
29262306a36Sopenharmony_ciDescription:
29362306a36Sopenharmony_ci		[RO] The presence of this sub-directory of the
29462306a36Sopenharmony_ci		/sys/block/xxx/queue/ directory indicates that the device is
29562306a36Sopenharmony_ci		capable of executing requests targeting different sector ranges
29662306a36Sopenharmony_ci		in parallel. For instance, single LUN multi-actuator hard-disks
29762306a36Sopenharmony_ci		will have an independent_access_ranges directory if the device
29862306a36Sopenharmony_ci		correctly advertises the sector ranges of its actuators.
29962306a36Sopenharmony_ci
30062306a36Sopenharmony_ci		The independent_access_ranges directory contains one directory
30162306a36Sopenharmony_ci		per access range, with each range described using the sector
30262306a36Sopenharmony_ci		(RO) attribute file to indicate the first sector of the range
30362306a36Sopenharmony_ci		and the nr_sectors (RO) attribute file to indicate the total
30462306a36Sopenharmony_ci		number of sectors in the range starting from the first sector of
30562306a36Sopenharmony_ci		the range.  For example, a dual-actuator hard-disk will have the
30662306a36Sopenharmony_ci		following independent_access_ranges entries.::
30762306a36Sopenharmony_ci
30862306a36Sopenharmony_ci			$ tree /sys/block/<disk>/queue/independent_access_ranges/
30962306a36Sopenharmony_ci			/sys/block/<disk>/queue/independent_access_ranges/
31062306a36Sopenharmony_ci			|-- 0
31162306a36Sopenharmony_ci			|   |-- nr_sectors
31262306a36Sopenharmony_ci			|   `-- sector
31362306a36Sopenharmony_ci			`-- 1
31462306a36Sopenharmony_ci			    |-- nr_sectors
31562306a36Sopenharmony_ci			    `-- sector
31662306a36Sopenharmony_ci
31762306a36Sopenharmony_ci		The sector and nr_sectors attributes use 512B sector unit,
31862306a36Sopenharmony_ci		regardless of the actual block size of the device. Independent
31962306a36Sopenharmony_ci		access ranges do not overlap and include all sectors within the
32062306a36Sopenharmony_ci		device capacity. The access ranges are numbered in increasing
32162306a36Sopenharmony_ci		order of the range start sector, that is, the sector attribute
32262306a36Sopenharmony_ci		of range 0 always has the value 0.
32362306a36Sopenharmony_ci
32462306a36Sopenharmony_ci
32562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/io_poll
32662306a36Sopenharmony_ciDate:		November 2015
32762306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
32862306a36Sopenharmony_ciDescription:
32962306a36Sopenharmony_ci		[RW] When read, this file shows whether polling is enabled (1)
33062306a36Sopenharmony_ci		or disabled (0).  Writing '0' to this file will disable polling
33162306a36Sopenharmony_ci		for this device.  Writing any non-zero value will enable this
33262306a36Sopenharmony_ci		feature.
33362306a36Sopenharmony_ci
33462306a36Sopenharmony_ci
33562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/io_poll_delay
33662306a36Sopenharmony_ciDate:		November 2016
33762306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
33862306a36Sopenharmony_ciDescription:
33962306a36Sopenharmony_ci		[RW] This was used to control what kind of polling will be
34062306a36Sopenharmony_ci		performed.  It is now fixed to -1, which is classic polling.
34162306a36Sopenharmony_ci		In this mode, the CPU will repeatedly ask for completions
34262306a36Sopenharmony_ci		without giving up any time.
34362306a36Sopenharmony_ci		<deprecated>
34462306a36Sopenharmony_ci
34562306a36Sopenharmony_ci
34662306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/io_timeout
34762306a36Sopenharmony_ciDate:		November 2018
34862306a36Sopenharmony_ciContact:	Weiping Zhang <zhangweiping@didiglobal.com>
34962306a36Sopenharmony_ciDescription:
35062306a36Sopenharmony_ci		[RW] io_timeout is the request timeout in milliseconds. If a
35162306a36Sopenharmony_ci		request does not complete in this time then the block driver
35262306a36Sopenharmony_ci		timeout handler is invoked. That timeout handler can decide to
35362306a36Sopenharmony_ci		retry the request, to fail it or to start a device recovery
35462306a36Sopenharmony_ci		strategy.
35562306a36Sopenharmony_ci
35662306a36Sopenharmony_ci
35762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/iostats
35862306a36Sopenharmony_ciDate:		January 2009
35962306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
36062306a36Sopenharmony_ciDescription:
36162306a36Sopenharmony_ci		[RW] This file is used to control (on/off) the iostats
36262306a36Sopenharmony_ci		accounting of the disk.
36362306a36Sopenharmony_ci
36462306a36Sopenharmony_ci
36562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/logical_block_size
36662306a36Sopenharmony_ciDate:		May 2009
36762306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
36862306a36Sopenharmony_ciDescription:
36962306a36Sopenharmony_ci		[RO] This is the smallest unit the storage device can address.
37062306a36Sopenharmony_ci		It is typically 512 bytes.
37162306a36Sopenharmony_ci
37262306a36Sopenharmony_ci
37362306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_active_zones
37462306a36Sopenharmony_ciDate:		July 2020
37562306a36Sopenharmony_ciContact:	Niklas Cassel <niklas.cassel@wdc.com>
37662306a36Sopenharmony_ciDescription:
37762306a36Sopenharmony_ci		[RO] For zoned block devices (zoned attribute indicating
37862306a36Sopenharmony_ci		"host-managed" or "host-aware"), the sum of zones belonging to
37962306a36Sopenharmony_ci		any of the zone states: EXPLICIT OPEN, IMPLICIT OPEN or CLOSED,
38062306a36Sopenharmony_ci		is limited by this value. If this value is 0, there is no limit.
38162306a36Sopenharmony_ci
38262306a36Sopenharmony_ci		If the host attempts to exceed this limit, the driver should
38362306a36Sopenharmony_ci		report this error with BLK_STS_ZONE_ACTIVE_RESOURCE, which user
38462306a36Sopenharmony_ci		space may see as the EOVERFLOW errno.
38562306a36Sopenharmony_ci
38662306a36Sopenharmony_ci
38762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_discard_segments
38862306a36Sopenharmony_ciDate:		February 2017
38962306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
39062306a36Sopenharmony_ciDescription:
39162306a36Sopenharmony_ci		[RO] The maximum number of DMA scatter/gather entries in a
39262306a36Sopenharmony_ci		discard request.
39362306a36Sopenharmony_ci
39462306a36Sopenharmony_ci
39562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_hw_sectors_kb
39662306a36Sopenharmony_ciDate:		September 2004
39762306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
39862306a36Sopenharmony_ciDescription:
39962306a36Sopenharmony_ci		[RO] This is the maximum number of kilobytes supported in a
40062306a36Sopenharmony_ci		single data transfer.
40162306a36Sopenharmony_ci
40262306a36Sopenharmony_ci
40362306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_integrity_segments
40462306a36Sopenharmony_ciDate:		September 2010
40562306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
40662306a36Sopenharmony_ciDescription:
40762306a36Sopenharmony_ci		[RO] Maximum number of elements in a DMA scatter/gather list
40862306a36Sopenharmony_ci		with integrity data that will be submitted by the block layer
40962306a36Sopenharmony_ci		core to the associated block driver.
41062306a36Sopenharmony_ci
41162306a36Sopenharmony_ci
41262306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_open_zones
41362306a36Sopenharmony_ciDate:		July 2020
41462306a36Sopenharmony_ciContact:	Niklas Cassel <niklas.cassel@wdc.com>
41562306a36Sopenharmony_ciDescription:
41662306a36Sopenharmony_ci		[RO] For zoned block devices (zoned attribute indicating
41762306a36Sopenharmony_ci		"host-managed" or "host-aware"), the sum of zones belonging to
41862306a36Sopenharmony_ci		any of the zone states: EXPLICIT OPEN or IMPLICIT OPEN, is
41962306a36Sopenharmony_ci		limited by this value. If this value is 0, there is no limit.
42062306a36Sopenharmony_ci
42162306a36Sopenharmony_ci
42262306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_sectors_kb
42362306a36Sopenharmony_ciDate:		September 2004
42462306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
42562306a36Sopenharmony_ciDescription:
42662306a36Sopenharmony_ci		[RW] This is the maximum number of kilobytes that the block
42762306a36Sopenharmony_ci		layer will allow for a filesystem request. Must be smaller than
42862306a36Sopenharmony_ci		or equal to the maximum size allowed by the hardware. Write 0
42962306a36Sopenharmony_ci		to use default kernel settings.
43062306a36Sopenharmony_ci
43162306a36Sopenharmony_ci
43262306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_segment_size
43362306a36Sopenharmony_ciDate:		March 2010
43462306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
43562306a36Sopenharmony_ciDescription:
43662306a36Sopenharmony_ci		[RO] Maximum size in bytes of a single element in a DMA
43762306a36Sopenharmony_ci		scatter/gather list.
43862306a36Sopenharmony_ci
43962306a36Sopenharmony_ci
44062306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/max_segments
44162306a36Sopenharmony_ciDate:		March 2010
44262306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
44362306a36Sopenharmony_ciDescription:
44462306a36Sopenharmony_ci		[RO] Maximum number of elements in a DMA scatter/gather list
44562306a36Sopenharmony_ci		that is submitted to the associated block driver.
44662306a36Sopenharmony_ci
44762306a36Sopenharmony_ci
44862306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/minimum_io_size
44962306a36Sopenharmony_ciDate:		April 2009
45062306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
45162306a36Sopenharmony_ciDescription:
45262306a36Sopenharmony_ci		[RO] Storage devices may report a granularity or preferred
45362306a36Sopenharmony_ci		minimum I/O size which is the smallest request the device can
45462306a36Sopenharmony_ci		perform without incurring a performance penalty.  For disk
45562306a36Sopenharmony_ci		drives this is often the physical block size.  For RAID arrays
45662306a36Sopenharmony_ci		it is often the stripe chunk size.  A properly aligned multiple
45762306a36Sopenharmony_ci		of minimum_io_size is the preferred request size for workloads
45862306a36Sopenharmony_ci		where a high number of I/O operations is desired.
45962306a36Sopenharmony_ci
46062306a36Sopenharmony_ci
46162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/nomerges
46262306a36Sopenharmony_ciDate:		January 2010
46362306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
46462306a36Sopenharmony_ciDescription:
46562306a36Sopenharmony_ci		[RW] Standard I/O elevator operations include attempts to merge
46662306a36Sopenharmony_ci		contiguous I/Os. For known random I/O loads these attempts will
46762306a36Sopenharmony_ci		always fail and result in extra cycles being spent in the
46862306a36Sopenharmony_ci		kernel. This allows one to turn off this behavior on one of two
46962306a36Sopenharmony_ci		ways: When set to 1, complex merge checks are disabled, but the
47062306a36Sopenharmony_ci		simple one-shot merges with the previous I/O request are
47162306a36Sopenharmony_ci		enabled. When set to 2, all merge tries are disabled. The
47262306a36Sopenharmony_ci		default value is 0 - which enables all types of merge tries.
47362306a36Sopenharmony_ci
47462306a36Sopenharmony_ci
47562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/nr_requests
47662306a36Sopenharmony_ciDate:		July 2003
47762306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
47862306a36Sopenharmony_ciDescription:
47962306a36Sopenharmony_ci		[RW] This controls how many requests may be allocated in the
48062306a36Sopenharmony_ci		block layer for read or write requests. Note that the total
48162306a36Sopenharmony_ci		allocated number may be twice this amount, since it applies only
48262306a36Sopenharmony_ci		to reads or writes (not the accumulated sum).
48362306a36Sopenharmony_ci
48462306a36Sopenharmony_ci		To avoid priority inversion through request starvation, a
48562306a36Sopenharmony_ci		request queue maintains a separate request pool per each cgroup
48662306a36Sopenharmony_ci		when CONFIG_BLK_CGROUP is enabled, and this parameter applies to
48762306a36Sopenharmony_ci		each such per-block-cgroup request pool.  IOW, if there are N
48862306a36Sopenharmony_ci		block cgroups, each request queue may have up to N request
48962306a36Sopenharmony_ci		pools, each independently regulated by nr_requests.
49062306a36Sopenharmony_ci
49162306a36Sopenharmony_ci
49262306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/nr_zones
49362306a36Sopenharmony_ciDate:		November 2018
49462306a36Sopenharmony_ciContact:	Damien Le Moal <damien.lemoal@wdc.com>
49562306a36Sopenharmony_ciDescription:
49662306a36Sopenharmony_ci		[RO] nr_zones indicates the total number of zones of a zoned
49762306a36Sopenharmony_ci		block device ("host-aware" or "host-managed" zone model). For
49862306a36Sopenharmony_ci		regular block devices, the value is always 0.
49962306a36Sopenharmony_ci
50062306a36Sopenharmony_ci
50162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/optimal_io_size
50262306a36Sopenharmony_ciDate:		April 2009
50362306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
50462306a36Sopenharmony_ciDescription:
50562306a36Sopenharmony_ci		[RO] Storage devices may report an optimal I/O size, which is
50662306a36Sopenharmony_ci		the device's preferred unit for sustained I/O.  This is rarely
50762306a36Sopenharmony_ci		reported for disk drives.  For RAID arrays it is usually the
50862306a36Sopenharmony_ci		stripe width or the internal track size.  A properly aligned
50962306a36Sopenharmony_ci		multiple of optimal_io_size is the preferred request size for
51062306a36Sopenharmony_ci		workloads where sustained throughput is desired.  If no optimal
51162306a36Sopenharmony_ci		I/O size is reported this file contains 0.
51262306a36Sopenharmony_ci
51362306a36Sopenharmony_ci
51462306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/physical_block_size
51562306a36Sopenharmony_ciDate:		May 2009
51662306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
51762306a36Sopenharmony_ciDescription:
51862306a36Sopenharmony_ci		[RO] This is the smallest unit a physical storage device can
51962306a36Sopenharmony_ci		write atomically.  It is usually the same as the logical block
52062306a36Sopenharmony_ci		size but may be bigger.  One example is SATA drives with 4KB
52162306a36Sopenharmony_ci		sectors that expose a 512-byte logical block size to the
52262306a36Sopenharmony_ci		operating system.  For stacked block devices the
52362306a36Sopenharmony_ci		physical_block_size variable contains the maximum
52462306a36Sopenharmony_ci		physical_block_size of the component devices.
52562306a36Sopenharmony_ci
52662306a36Sopenharmony_ci
52762306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/read_ahead_kb
52862306a36Sopenharmony_ciDate:		May 2004
52962306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
53062306a36Sopenharmony_ciDescription:
53162306a36Sopenharmony_ci		[RW] Maximum number of kilobytes to read-ahead for filesystems
53262306a36Sopenharmony_ci		on this block device.
53362306a36Sopenharmony_ci
53462306a36Sopenharmony_ci
53562306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/rotational
53662306a36Sopenharmony_ciDate:		January 2009
53762306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
53862306a36Sopenharmony_ciDescription:
53962306a36Sopenharmony_ci		[RW] This file is used to stat if the device is of rotational
54062306a36Sopenharmony_ci		type or non-rotational type.
54162306a36Sopenharmony_ci
54262306a36Sopenharmony_ci
54362306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/rq_affinity
54462306a36Sopenharmony_ciDate:		September 2008
54562306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
54662306a36Sopenharmony_ciDescription:
54762306a36Sopenharmony_ci		[RW] If this option is '1', the block layer will migrate request
54862306a36Sopenharmony_ci		completions to the cpu "group" that originally submitted the
54962306a36Sopenharmony_ci		request. For some workloads this provides a significant
55062306a36Sopenharmony_ci		reduction in CPU cycles due to caching effects.
55162306a36Sopenharmony_ci
55262306a36Sopenharmony_ci		For storage configurations that need to maximize distribution of
55362306a36Sopenharmony_ci		completion processing setting this option to '2' forces the
55462306a36Sopenharmony_ci		completion to run on the requesting cpu (bypassing the "group"
55562306a36Sopenharmony_ci		aggregation logic).
55662306a36Sopenharmony_ci
55762306a36Sopenharmony_ci
55862306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/scheduler
55962306a36Sopenharmony_ciDate:		October 2004
56062306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
56162306a36Sopenharmony_ciDescription:
56262306a36Sopenharmony_ci		[RW] When read, this file will display the current and available
56362306a36Sopenharmony_ci		IO schedulers for this block device. The currently active IO
56462306a36Sopenharmony_ci		scheduler will be enclosed in [] brackets. Writing an IO
56562306a36Sopenharmony_ci		scheduler name to this file will switch control of this block
56662306a36Sopenharmony_ci		device to that new IO scheduler. Note that writing an IO
56762306a36Sopenharmony_ci		scheduler name to this file will attempt to load that IO
56862306a36Sopenharmony_ci		scheduler module, if it isn't already present in the system.
56962306a36Sopenharmony_ci
57062306a36Sopenharmony_ci
57162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/stable_writes
57262306a36Sopenharmony_ciDate:		September 2020
57362306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
57462306a36Sopenharmony_ciDescription:
57562306a36Sopenharmony_ci		[RW] This file will contain '1' if memory must not be modified
57662306a36Sopenharmony_ci		while it is being used in a write request to this device.  When
57762306a36Sopenharmony_ci		this is the case and the kernel is performing writeback of a
57862306a36Sopenharmony_ci		page, the kernel will wait for writeback to complete before
57962306a36Sopenharmony_ci		allowing the page to be modified again, rather than allowing
58062306a36Sopenharmony_ci		immediate modification as is normally the case.  This
58162306a36Sopenharmony_ci		restriction arises when the device accesses the memory multiple
58262306a36Sopenharmony_ci		times where the same data must be seen every time -- for
58362306a36Sopenharmony_ci		example, once to calculate a checksum and once to actually write
58462306a36Sopenharmony_ci		the data.  If no such restriction exists, this file will contain
58562306a36Sopenharmony_ci		'0'.  This file is writable for testing purposes.
58662306a36Sopenharmony_ci
58762306a36Sopenharmony_ci
58862306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/throttle_sample_time
58962306a36Sopenharmony_ciDate:		March 2017
59062306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
59162306a36Sopenharmony_ciDescription:
59262306a36Sopenharmony_ci		[RW] This is the time window that blk-throttle samples data, in
59362306a36Sopenharmony_ci		millisecond.  blk-throttle makes decision based on the
59462306a36Sopenharmony_ci		samplings. Lower time means cgroups have more smooth throughput,
59562306a36Sopenharmony_ci		but higher CPU overhead. This exists only when
59662306a36Sopenharmony_ci		CONFIG_BLK_DEV_THROTTLING_LOW is enabled.
59762306a36Sopenharmony_ci
59862306a36Sopenharmony_ci
59962306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/virt_boundary_mask
60062306a36Sopenharmony_ciDate:		April 2021
60162306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
60262306a36Sopenharmony_ciDescription:
60362306a36Sopenharmony_ci		[RO] This file shows the I/O segment memory alignment mask for
60462306a36Sopenharmony_ci		the block device.  I/O requests to this device will be split
60562306a36Sopenharmony_ci		between segments wherever either the memory address of the end
60662306a36Sopenharmony_ci		of the previous segment or the memory address of the beginning
60762306a36Sopenharmony_ci		of the current segment is not aligned to virt_boundary_mask + 1
60862306a36Sopenharmony_ci		bytes.
60962306a36Sopenharmony_ci
61062306a36Sopenharmony_ci
61162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/wbt_lat_usec
61262306a36Sopenharmony_ciDate:		November 2016
61362306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
61462306a36Sopenharmony_ciDescription:
61562306a36Sopenharmony_ci		[RW] If the device is registered for writeback throttling, then
61662306a36Sopenharmony_ci		this file shows the target minimum read latency. If this latency
61762306a36Sopenharmony_ci		is exceeded in a given window of time (see wb_window_usec), then
61862306a36Sopenharmony_ci		the writeback throttling will start scaling back writes. Writing
61962306a36Sopenharmony_ci		a value of '0' to this file disables the feature. Writing a
62062306a36Sopenharmony_ci		value of '-1' to this file resets the value to the default
62162306a36Sopenharmony_ci		setting.
62262306a36Sopenharmony_ci
62362306a36Sopenharmony_ci
62462306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/write_cache
62562306a36Sopenharmony_ciDate:		April 2016
62662306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
62762306a36Sopenharmony_ciDescription:
62862306a36Sopenharmony_ci		[RW] When read, this file will display whether the device has
62962306a36Sopenharmony_ci		write back caching enabled or not. It will return "write back"
63062306a36Sopenharmony_ci		for the former case, and "write through" for the latter. Writing
63162306a36Sopenharmony_ci		to this file can change the kernels view of the device, but it
63262306a36Sopenharmony_ci		doesn't alter the device state. This means that it might not be
63362306a36Sopenharmony_ci		safe to toggle the setting from "write back" to "write through",
63462306a36Sopenharmony_ci		since that will also eliminate cache flushes issued by the
63562306a36Sopenharmony_ci		kernel.
63662306a36Sopenharmony_ci
63762306a36Sopenharmony_ci
63862306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/write_same_max_bytes
63962306a36Sopenharmony_ciDate:		January 2012
64062306a36Sopenharmony_ciContact:	Martin K. Petersen <martin.petersen@oracle.com>
64162306a36Sopenharmony_ciDescription:
64262306a36Sopenharmony_ci		[RO] Some devices support a write same operation in which a
64362306a36Sopenharmony_ci		single data block can be written to a range of several
64462306a36Sopenharmony_ci		contiguous blocks on storage. This can be used to wipe areas on
64562306a36Sopenharmony_ci		disk or to initialize drives in a RAID configuration.
64662306a36Sopenharmony_ci		write_same_max_bytes indicates how many bytes can be written in
64762306a36Sopenharmony_ci		a single write same command. If write_same_max_bytes is 0, write
64862306a36Sopenharmony_ci		same is not supported by the device.
64962306a36Sopenharmony_ci
65062306a36Sopenharmony_ci
65162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/write_zeroes_max_bytes
65262306a36Sopenharmony_ciDate:		November 2016
65362306a36Sopenharmony_ciContact:	Chaitanya Kulkarni <chaitanya.kulkarni@wdc.com>
65462306a36Sopenharmony_ciDescription:
65562306a36Sopenharmony_ci		[RO] Devices that support write zeroes operation in which a
65662306a36Sopenharmony_ci		single request can be issued to zero out the range of contiguous
65762306a36Sopenharmony_ci		blocks on storage without having any payload in the request.
65862306a36Sopenharmony_ci		This can be used to optimize writing zeroes to the devices.
65962306a36Sopenharmony_ci		write_zeroes_max_bytes indicates how many bytes can be written
66062306a36Sopenharmony_ci		in a single write zeroes command. If write_zeroes_max_bytes is
66162306a36Sopenharmony_ci		0, write zeroes is not supported by the device.
66262306a36Sopenharmony_ci
66362306a36Sopenharmony_ci
66462306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/zone_append_max_bytes
66562306a36Sopenharmony_ciDate:		May 2020
66662306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
66762306a36Sopenharmony_ciDescription:
66862306a36Sopenharmony_ci		[RO] This is the maximum number of bytes that can be written to
66962306a36Sopenharmony_ci		a sequential zone of a zoned block device using a zone append
67062306a36Sopenharmony_ci		write operation (REQ_OP_ZONE_APPEND). This value is always 0 for
67162306a36Sopenharmony_ci		regular block devices.
67262306a36Sopenharmony_ci
67362306a36Sopenharmony_ci
67462306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/zone_write_granularity
67562306a36Sopenharmony_ciDate:		January 2021
67662306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
67762306a36Sopenharmony_ciDescription:
67862306a36Sopenharmony_ci		[RO] This indicates the alignment constraint, in bytes, for
67962306a36Sopenharmony_ci		write operations in sequential zones of zoned block devices
68062306a36Sopenharmony_ci		(devices with a zoned attributed that reports "host-managed" or
68162306a36Sopenharmony_ci		"host-aware"). This value is always 0 for regular block devices.
68262306a36Sopenharmony_ci
68362306a36Sopenharmony_ci
68462306a36Sopenharmony_ciWhat:		/sys/block/<disk>/queue/zoned
68562306a36Sopenharmony_ciDate:		September 2016
68662306a36Sopenharmony_ciContact:	Damien Le Moal <damien.lemoal@wdc.com>
68762306a36Sopenharmony_ciDescription:
68862306a36Sopenharmony_ci		[RO] zoned indicates if the device is a zoned block device and
68962306a36Sopenharmony_ci		the zone model of the device if it is indeed zoned.  The
69062306a36Sopenharmony_ci		possible values indicated by zoned are "none" for regular block
69162306a36Sopenharmony_ci		devices and "host-aware" or "host-managed" for zoned block
69262306a36Sopenharmony_ci		devices. The characteristics of host-aware and host-managed
69362306a36Sopenharmony_ci		zoned block devices are described in the ZBC (Zoned Block
69462306a36Sopenharmony_ci		Commands) and ZAC (Zoned Device ATA Command Set) standards.
69562306a36Sopenharmony_ci		These standards also define the "drive-managed" zone model.
69662306a36Sopenharmony_ci		However, since drive-managed zoned block devices do not support
69762306a36Sopenharmony_ci		zone commands, they will be treated as regular block devices and
69862306a36Sopenharmony_ci		zoned will report "none".
69962306a36Sopenharmony_ci
70062306a36Sopenharmony_ci
70162306a36Sopenharmony_ciWhat:		/sys/block/<disk>/hidden
70262306a36Sopenharmony_ciDate:		March 2023
70362306a36Sopenharmony_ciContact:	linux-block@vger.kernel.org
70462306a36Sopenharmony_ciDescription:
70562306a36Sopenharmony_ci		[RO] the block device is hidden. it doesn’t produce events, and
70662306a36Sopenharmony_ci		can’t be opened from userspace or using blkdev_get*.
70762306a36Sopenharmony_ci		Used for the underlying components of multipath devices.
70862306a36Sopenharmony_ci
70962306a36Sopenharmony_ci
71062306a36Sopenharmony_ciWhat:		/sys/block/<disk>/stat
71162306a36Sopenharmony_ciDate:		February 2008
71262306a36Sopenharmony_ciContact:	Jerome Marchand <jmarchan@redhat.com>
71362306a36Sopenharmony_ciDescription:
71462306a36Sopenharmony_ci		The /sys/block/<disk>/stat files displays the I/O
71562306a36Sopenharmony_ci		statistics of disk <disk>. They contain 11 fields:
71662306a36Sopenharmony_ci
71762306a36Sopenharmony_ci		==  ==============================================
71862306a36Sopenharmony_ci		 1  reads completed successfully
71962306a36Sopenharmony_ci		 2  reads merged
72062306a36Sopenharmony_ci		 3  sectors read
72162306a36Sopenharmony_ci		 4  time spent reading (ms)
72262306a36Sopenharmony_ci		 5  writes completed
72362306a36Sopenharmony_ci		 6  writes merged
72462306a36Sopenharmony_ci		 7  sectors written
72562306a36Sopenharmony_ci		 8  time spent writing (ms)
72662306a36Sopenharmony_ci		 9  I/Os currently in progress
72762306a36Sopenharmony_ci		10  time spent doing I/Os (ms)
72862306a36Sopenharmony_ci		11  weighted time spent doing I/Os (ms)
72962306a36Sopenharmony_ci		12  discards completed
73062306a36Sopenharmony_ci		13  discards merged
73162306a36Sopenharmony_ci		14  sectors discarded
73262306a36Sopenharmony_ci		15  time spent discarding (ms)
73362306a36Sopenharmony_ci		16  flush requests completed
73462306a36Sopenharmony_ci		17  time spent flushing (ms)
73562306a36Sopenharmony_ci		==  ==============================================
73662306a36Sopenharmony_ci
73762306a36Sopenharmony_ci		For more details refer Documentation/admin-guide/iostats.rst
738