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

Configure Feed

Select the types of activity you want to include in your feed.

xfs: document zoned rt specifics in admin-guide

Document the lifetime, nolifetime and max_open_zones mount options
added for zoned rt file systems.

Also add documentation describing the max_open_zones sysfs attribute
exposed in /sys/fs/xfs/<dev>/zoned/

Fixes: 4e4d52075577 ("xfs: add the zoned space allocator")
Signed-off-by: Hans Holmberg <hans.holmberg@wdc.com>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Reviewed-by: Darrick J. Wong <djwong@kernel.org>
Signed-off-by: Carlos Maiolino <cem@kernel.org>

authored by

Hans Holmberg and committed by
Carlos Maiolino c7b67ddc c6f1401b

+29
+29
Documentation/admin-guide/xfs.rst
··· 124 124 controls the size of each buffer and so is also relevant to 125 125 this case. 126 126 127 + lifetime (default) or nolifetime 128 + Enable data placement based on write life time hints provided 129 + by the user. This turns on co-allocation of data of similar 130 + life times when statistically favorable to reduce garbage 131 + collection cost. 132 + 133 + These options are only available for zoned rt file systems. 134 + 127 135 logbsize=value 128 136 Set the size of each in-memory log buffer. The size may be 129 137 specified in bytes, or in kilobytes with a "k" suffix. ··· 150 142 section, and a real-time section. The real-time section is 151 143 optional, and the log section can be separate from the data 152 144 section or contained within it. 145 + 146 + max_open_zones=value 147 + Specify the max number of zones to keep open for writing on a 148 + zoned rt device. Many open zones aids file data separation 149 + but may impact performance on HDDs. 150 + 151 + If ``max_open_zones`` is not specified, the value is determined 152 + by the capabilities and the size of the zoned rt device. 153 153 154 154 noalign 155 155 Data allocations will not be aligned at stripe unit ··· 558 542 nice Relative priority of scheduling the threads. These are the 559 543 same nice levels that can be applied to userspace processes. 560 544 ============ =========== 545 + 546 + Zoned Filesystems 547 + ================= 548 + 549 + For zoned file systems, the following attribute is exposed in: 550 + 551 + /sys/fs/xfs/<dev>/zoned/ 552 + 553 + max_open_zones (Min: 1 Default: Varies Max: UINTMAX) 554 + This read-only attribute exposes the maximum number of open zones 555 + available for data placement. The value is determined at mount time and 556 + is limited by the capabilities of the backing zoned device, file system 557 + size and the max_open_zones mount option. 561 558 562 559 Zoned Filesystems 563 560 =================