Skip to content

Commit c7b67dd

Browse files
yhrcmaiolino
authored andcommitted
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: 4e4d520 ("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>
1 parent c6f1401 commit c7b67dd

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

Documentation/admin-guide/xfs.rst

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,14 @@ When mounting an XFS filesystem, the following options are accepted.
124124
controls the size of each buffer and so is also relevant to
125125
this case.
126126

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+
127135
logbsize=value
128136
Set the size of each in-memory log buffer. The size may be
129137
specified in bytes, or in kilobytes with a "k" suffix.
@@ -143,6 +151,14 @@ When mounting an XFS filesystem, the following options are accepted.
143151
optional, and the log section can be separate from the data
144152
section or contained within it.
145153

154+
max_open_zones=value
155+
Specify the max number of zones to keep open for writing on a
156+
zoned rt device. Many open zones aids file data separation
157+
but may impact performance on HDDs.
158+
159+
If ``max_open_zones`` is not specified, the value is determined
160+
by the capabilities and the size of the zoned rt device.
161+
146162
noalign
147163
Data allocations will not be aligned at stripe unit
148164
boundaries. This is only relevant to filesystems created
@@ -546,6 +562,19 @@ The interesting knobs for XFS workqueues are as follows:
546562
Zoned Filesystems
547563
=================
548564

565+
For zoned file systems, the following attribute is exposed in:
566+
567+
/sys/fs/xfs/<dev>/zoned/
568+
569+
max_open_zones (Min: 1 Default: Varies Max: UINTMAX)
570+
This read-only attribute exposes the maximum number of open zones
571+
available for data placement. The value is determined at mount time and
572+
is limited by the capabilities of the backing zoned device, file system
573+
size and the max_open_zones mount option.
574+
575+
Zoned Filesystems
576+
=================
577+
549578
For zoned file systems, the following attributes are exposed in:
550579

551580
/sys/fs/xfs/<dev>/zoned/

0 commit comments

Comments
 (0)