sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget#/translations/zh_CN/admin-guide/xfsmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/zh_TW/admin-guide/xfsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/it_IT/admin-guide/xfsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ja_JP/admin-guide/xfsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ko_KR/admin-guide/xfsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/pt_BR/admin-guide/xfsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/sp_SP/admin-guide/xfsmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh=/var/lib/git/docbuild/linux/Documentation/admin-guide/xfs.rsthKubhsection)}(hhh](htitle)}(hThe SGI XFS Filesystemh]hThe SGI XFS Filesystem}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hXUXFS is a high performance journaling filesystem which originated on the SGI IRIX platform. It is completely multi-threaded, can support large files and large filesystems, extended attributes, variable block sizes, is extent based, and makes extensive use of Btrees (directories, extents, free space) to aid both performance and scalability.h]hXUXFS is a high performance journaling filesystem which originated on the SGI IRIX platform. It is completely multi-threaded, can support large files and large filesystems, extended attributes, variable block sizes, is extent based, and makes extensive use of Btrees (directories, extents, free space) to aid both performance and scalability.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hRefer to the documentation at https://xfs.wiki.kernel.org/ for further details. This implementation is on-disk compatible with the IRIX version of XFS.h](hRefer to the documentation at }(hhhhhNhNubh reference)}(hhttps://xfs.wiki.kernel.org/h]hhttps://xfs.wiki.kernel.org/}(hhhhhNhNubah}(h]h ]h"]h$]h&]refurihuh1hhhubh^ for further details. This implementation is on-disk compatible with the IRIX version of XFS.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h Mount Optionsh]h Mount Options}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hDWhen mounting an XFS filesystem, the following options are accepted.h]hDWhen mounting an XFS filesystem, the following options are accepted.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh block_quote)}(hX#allocsize=size Sets the buffered I/O end-of-file preallocation size when doing delayed allocation writeout (default size is 64KiB). Valid values for this option are page size (typically 4KiB) through to 1GiB, inclusive, in power-of-2 increments. The default behaviour is for dynamic end-of-file preallocation size, which uses a set of heuristics to optimise the preallocation size based on the current allocation patterns within the file and the access patterns to the file. Specifying a fixed ``allocsize`` value turns off the dynamic behaviour. discard or nodiscard (default) Enable/disable the issuing of commands to let the block device reclaim space freed by the filesystem. This is useful for SSD devices, thinly provisioned LUNs and virtual machine images, but may have a performance impact. Note: It is currently recommended that you use the ``fstrim`` application to ``discard`` unused blocks rather than the ``discard`` mount option because the performance impact of this option is quite severe. grpid/bsdgroups or nogrpid/sysvgroups (default) These options define what group ID a newly created file gets. When ``grpid`` is set, it takes the group ID of the directory in which it is created; otherwise it takes the ``fsgid`` of the current process, unless the directory has the ``setgid`` bit set, in which case it takes the ``gid`` from the parent directory, and also gets the ``setgid`` bit set if it is a directory itself. filestreams Make the data allocator use the filestreams allocation mode across the entire filesystem rather than just on directories configured to use it. inode32 or inode64 (default) When ``inode32`` is specified, it indicates that XFS limits inode creation to locations which will not result in inode numbers with more than 32 bits of significance. When ``inode64`` is specified, it indicates that XFS is allowed to create inodes at any location in the filesystem, including those which will result in inode numbers occupying more than 32 bits of significance. ``inode32`` is provided for backwards compatibility with older systems and applications, since 64 bits inode numbers might cause problems for some applications that cannot handle large inode numbers. If applications are in use which do not handle inode numbers bigger than 32 bits, the ``inode32`` option should be specified. largeio or nolargeio (default) If ``nolargeio`` is specified, the optimal I/O reported in ``st_blksize`` by **stat(2)** will be as small as possible to allow user applications to avoid inefficient read/modify/write I/O. This is typically the page size of the machine, as this is the granularity of the page cache. If ``largeio`` is specified, a filesystem that was created with a ``swidth`` specified will return the ``swidth`` value (in bytes) in ``st_blksize``. If the filesystem does not have a ``swidth`` specified but does specify an ``allocsize`` then ``allocsize`` (in bytes) will be returned instead. Otherwise the behaviour is the same as if ``nolargeio`` was specified. logbufs=value Set the number of in-memory log buffers. Valid numbers range from 2-8 inclusive. The default value is 8 buffers. If the memory cost of 8 log buffers is too high on small systems, then it may be reduced at some cost to performance on metadata intensive workloads. The ``logbsize`` option below controls the size of each buffer and so is also relevant to this case. lifetime (default) or nolifetime Enable data placement based on write life time hints provided by the user. This turns on co-allocation of data of similar life times when statistically favorable to reduce garbage collection cost. These options are only available for zoned rt file systems. logbsize=value Set the size of each in-memory log buffer. The size may be specified in bytes, or in kilobytes with a "k" suffix. Valid sizes for version 1 and version 2 logs are 16384 (16k) and 32768 (32k). Valid sizes for version 2 logs also include 65536 (64k), 131072 (128k) and 262144 (256k). The logbsize must be an integer multiple of the log stripe unit configured at **mkfs(8)** time. The default value for version 1 logs is 32768, while the default value for version 2 logs is MAX(32768, log_sunit). logdev=device and rtdev=device Use an external log (metadata journal) and/or real-time device. An XFS filesystem has up to three parts: a data section, a log section, and a real-time section. The real-time section is optional, and the log section can be separate from the data section or contained within it. max_atomic_write=value Set the maximum size of an atomic write. The size may be specified in bytes, in kilobytes with a "k" suffix, in megabytes with a "m" suffix, or in gigabytes with a "g" suffix. The size cannot be larger than the maximum write size, larger than the size of any allocation group, or larger than the size of a remapping operation that the log can complete atomically. The default value is to set the maximum I/O completion size to allow each CPU to handle one at a time. max_open_zones=value Specify the max number of zones to keep open for writing on a zoned rt device. Many open zones aids file data separation but may impact performance on HDDs. If ``max_open_zones`` is not specified, the value is determined by the capabilities and the size of the zoned rt device. noalign Data allocations will not be aligned at stripe unit boundaries. This is only relevant to filesystems created with non-zero data alignment parameters (``sunit``, ``swidth``) by **mkfs(8)**. norecovery The filesystem will be mounted without running log recovery. If the filesystem was not cleanly unmounted, it is likely to be inconsistent when mounted in ``norecovery`` mode. Some files or directories may not be accessible because of this. Filesystems mounted ``norecovery`` must be mounted read-only or the mount will fail. nouuid Don't check for double mounted file systems using the file system ``uuid``. This is useful to mount LVM snapshot volumes, and often used in combination with ``norecovery`` for mounting read-only snapshots. noquota Forcibly turns off all quota accounting and enforcement within the filesystem. uquota/usrquota/uqnoenforce/quota User disk quota accounting enabled, and limits (optionally) enforced. Refer to **xfs_quota(8)** for further details. gquota/grpquota/gqnoenforce Group disk quota accounting enabled and limits (optionally) enforced. Refer to **xfs_quota(8)** for further details. pquota/prjquota/pqnoenforce Project disk quota accounting enabled and limits (optionally) enforced. Refer to **xfs_quota(8)** for further details. sunit=value and swidth=value Used to specify the stripe unit and width for a RAID device or a stripe volume. "value" must be specified in 512-byte block units. These options are only relevant to filesystems that were created with non-zero data alignment parameters. The ``sunit`` and ``swidth`` parameters specified must be compatible with the existing filesystem alignment characteristics. In general, that means the only valid changes to ``sunit`` are increasing it by a power-of-2 multiple. Valid ``swidth`` values are any integer multiple of a valid ``sunit`` value. Typically the only time these mount options are necessary if after an underlying RAID device has had its geometry modified, such as adding a new disk to a RAID5 lun and reshaping it. swalloc Data allocations will be rounded up to stripe width boundaries when the current end of file is being extended and the file size is larger than the stripe width size. wsync When specified, all filesystem namespace operations are executed synchronously. This ensures that when the namespace operation (create, unlink, etc) completes, the change to the namespace is on stable storage. This is useful in HA setups where failover must not result in clients seeing inconsistent namespace presentation during or after a failover event. errortag=tagname When specified, enables the error inject tag named "tagname" with the default frequency. Can be specified multiple times to enable multiple errortags. Specifying this option on remount will reset the error tag to the default value if it was set to any other value before. This option is only supported when CONFIG_XFS_DEBUG is enabled, and will not be reflected in /proc/self/mounts. h]hdefinition_list)}(hhh](hdefinition_list_item)}(hX$allocsize=size Sets the buffered I/O end-of-file preallocation size when doing delayed allocation writeout (default size is 64KiB). Valid values for this option are page size (typically 4KiB) through to 1GiB, inclusive, in power-of-2 increments. The default behaviour is for dynamic end-of-file preallocation size, which uses a set of heuristics to optimise the preallocation size based on the current allocation patterns within the file and the access patterns to the file. Specifying a fixed ``allocsize`` value turns off the dynamic behaviour. h](hterm)}(hallocsize=sizeh]hallocsize=size}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhK#hj<ubh definition)}(hhh](h)}(hSets the buffered I/O end-of-file preallocation size when doing delayed allocation writeout (default size is 64KiB). Valid values for this option are page size (typically 4KiB) through to 1GiB, inclusive, in power-of-2 increments.h]hSets the buffered I/O end-of-file preallocation size when doing delayed allocation writeout (default size is 64KiB). Valid values for this option are page size (typically 4KiB) through to 1GiB, inclusive, in power-of-2 increments.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjRubh)}(hX,The default behaviour is for dynamic end-of-file preallocation size, which uses a set of heuristics to optimise the preallocation size based on the current allocation patterns within the file and the access patterns to the file. Specifying a fixed ``allocsize`` value turns off the dynamic behaviour.h](hThe default behaviour is for dynamic end-of-file preallocation size, which uses a set of heuristics to optimise the preallocation size based on the current allocation patterns within the file and the access patterns to the file. Specifying a fixed }(hjchhhNhNubhliteral)}(h ``allocsize``h]h allocsize}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjcubh' value turns off the dynamic behaviour.}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjRubeh}(h]h ]h"]h$]h&]uh1jPhj<ubeh}(h]h ]h"]h$]h&]uh1j:hhhK#hj7ubj;)}(hXdiscard or nodiscard (default) Enable/disable the issuing of commands to let the block device reclaim space freed by the filesystem. This is useful for SSD devices, thinly provisioned LUNs and virtual machine images, but may have a performance impact. Note: It is currently recommended that you use the ``fstrim`` application to ``discard`` unused blocks rather than the ``discard`` mount option because the performance impact of this option is quite severe. h](jA)}(hdiscard or nodiscard (default)h]hdiscard or nodiscard (default)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhK.hjubjQ)}(hhh](h)}(hEnable/disable the issuing of commands to let the block device reclaim space freed by the filesystem. This is useful for SSD devices, thinly provisioned LUNs and virtual machine images, but may have a performance impact.h]hEnable/disable the issuing of commands to let the block device reclaim space freed by the filesystem. This is useful for SSD devices, thinly provisioned LUNs and virtual machine images, but may have a performance impact.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hjubh)}(hNote: It is currently recommended that you use the ``fstrim`` application to ``discard`` unused blocks rather than the ``discard`` mount option because the performance impact of this option is quite severe.h](h3Note: It is currently recommended that you use the }(hjhhhNhNubjl)}(h ``fstrim``h]hfstrim}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh application to }(hjhhhNhNubjl)}(h ``discard``h]hdiscard}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh unused blocks rather than the }(hjhhhNhNubjl)}(h ``discard``h]hdiscard}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubhL mount option because the performance impact of this option is quite severe.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK+hjubeh}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhK.hj7ubj;)}(hXgrpid/bsdgroups or nogrpid/sysvgroups (default) These options define what group ID a newly created file gets. When ``grpid`` is set, it takes the group ID of the directory in which it is created; otherwise it takes the ``fsgid`` of the current process, unless the directory has the ``setgid`` bit set, in which case it takes the ``gid`` from the parent directory, and also gets the ``setgid`` bit set if it is a directory itself. h](jA)}(h/grpid/bsdgroups or nogrpid/sysvgroups (default)h]h/grpid/bsdgroups or nogrpid/sysvgroups (default)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhK7hjubjQ)}(hhh]h)}(hX~These options define what group ID a newly created file gets. When ``grpid`` is set, it takes the group ID of the directory in which it is created; otherwise it takes the ``fsgid`` of the current process, unless the directory has the ``setgid`` bit set, in which case it takes the ``gid`` from the parent directory, and also gets the ``setgid`` bit set if it is a directory itself.h](hDThese options define what group ID a newly created file gets. When }(hjhhhNhNubjl)}(h ``grpid``h]hgrpid}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh_ is set, it takes the group ID of the directory in which it is created; otherwise it takes the }(hjhhhNhNubjl)}(h ``fsgid``h]hfsgid}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh6 of the current process, unless the directory has the }(hjhhhNhNubjl)}(h ``setgid``h]hsetgid}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh% bit set, in which case it takes the }(hjhhhNhNubjl)}(h``gid``h]hgid}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh. from the parent directory, and also gets the }(hjhhhNhNubjl)}(h ``setgid``h]hsetgid}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jkhjubh% bit set if it is a directory itself.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhK7hj7ubj;)}(hfilestreams Make the data allocator use the filestreams allocation mode across the entire filesystem rather than just on directories configured to use it. h](jA)}(h filestreamsh]h filestreams}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhK ubah}(h]h ]h"]h$]h&]uh1j hj; ubj )}(hhh]h)}(hSeptember 2030h]hSeptember 2030}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjU ubah}(h]h ]h"]h$]h&]uh1j hj; ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]colsKuh1j hj ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubeh}(h]deprecated-mount-optionsah ]h"]deprecated mount optionsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hRemoved Mount Optionsh]hRemoved Mount Options}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubj )}(hhh]j )}(hhh](j )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubj )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubj )}(hhh]j )}(hhh](j )}(hhh]h)}(hNameh]hName}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hRemovedh]hRemoved}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh](j )}(hhh]h)}(hdelaylog/nodelaylogh]hdelaylog/nodelaylog}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hv4.0h]hv4.0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(h ihashsizeh]h ihashsize}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj5 ubah}(h]h ]h"]h$]h&]uh1j hj2 ubj )}(hhh]h)}(hv4.0h]hv4.0}(hjO hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjL ubah}(h]h ]h"]h$]h&]uh1j hj2 ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hirixsgidh]hirixsgid}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjl ubah}(h]h ]h"]h$]h&]uh1j hji ubj )}(hhh]h)}(hv4.0h]hv4.0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1j hji ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hosyncisdsync/osyncisosynch]hosyncisdsync/osyncisosync}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hv4.0h]hv4.0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hbarrierh]hbarrier}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hv4.19h]hv4.19}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(h nobarrierh]h nobarrier}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hv4.19h]hv4.19}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj( ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(h ikeep/noikeeph]h ikeep/noikeep}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjH ubah}(h]h ]h"]h$]h&]uh1j hjE ubj )}(hhh]h)}(hv6.18h]hv6.18}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj_ ubah}(h]h ]h"]h$]h&]uh1j hjE ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(h attr2/noattr2h]h attr2/noattr2}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj| ubj )}(hhh]h)}(hv6.18h]hv6.18}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj| ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]colsKuh1j hj ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubeh}(h]removed-mount-optionsah ]h"]removed mount optionsah$]h&]uh1hhhhhhhhMubh)}(hhh](h)}(hsysctlsh]hsysctls}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(h;The following sysctls are available for the XFS filesystem:h]h;The following sysctls are available for the XFS filesystem:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj0)}(hXGfs.xfs.stats_clear (Min: 0 Default: 0 Max: 1) Setting this to "1" clears accumulated XFS statistics in /proc/fs/xfs/stat. It then immediately resets to "0". fs.xfs.xfssyncd_centisecs (Min: 100 Default: 3000 Max: 720000) The interval at which the filesystem flushes metadata out to disk and runs internal cache cleanup routines. fs.xfs.filestream_centisecs (Min: 1 Default: 3000 Max: 360000) The interval at which the filesystem ages filestreams cache references and returns timed-out AGs back to the free stream pool. fs.xfs.speculative_prealloc_lifetime (Units: seconds Min: 1 Default: 300 Max: 86400) The interval at which the background scanning for inodes with unused speculative preallocation runs. The scan removes unused preallocation from clean inodes and releases the unused space back to the free pool. fs.xfs.error_level (Min: 0 Default: 3 Max: 11) A volume knob for error reporting when internal errors occur. This will generate detailed messages & backtraces for filesystem shutdowns, for example. Current threshold values are: XFS_ERRLEVEL_OFF: 0 XFS_ERRLEVEL_LOW: 1 XFS_ERRLEVEL_HIGH: 5 fs.xfs.panic_mask (Min: 0 Default: 0 Max: 511) Causes certain error conditions to call BUG(). Value is a bitmask; OR together the tags which represent errors which should cause panics: XFS_NO_PTAG 0 XFS_PTAG_IFLUSH 0x00000001 XFS_PTAG_LOGRES 0x00000002 XFS_PTAG_AILDELETE 0x00000004 XFS_PTAG_ERROR_REPORT 0x00000008 XFS_PTAG_SHUTDOWN_CORRUPT 0x00000010 XFS_PTAG_SHUTDOWN_IOERROR 0x00000020 XFS_PTAG_SHUTDOWN_LOGERROR 0x00000040 XFS_PTAG_FSBLOCK_ZERO 0x00000080 XFS_PTAG_VERIFIER_ERROR 0x00000100 This option is intended for debugging only. fs.xfs.inherit_sync (Min: 0 Default: 1 Max: 1) Setting this to "1" will cause the "sync" flag set by the **xfs_io(8)** chattr command on a directory to be inherited by files in that directory. fs.xfs.inherit_nodump (Min: 0 Default: 1 Max: 1) Setting this to "1" will cause the "nodump" flag set by the **xfs_io(8)** chattr command on a directory to be inherited by files in that directory. fs.xfs.inherit_noatime (Min: 0 Default: 1 Max: 1) Setting this to "1" will cause the "noatime" flag set by the **xfs_io(8)** chattr command on a directory to be inherited by files in that directory. fs.xfs.inherit_nosymlinks (Min: 0 Default: 1 Max: 1) Setting this to "1" will cause the "nosymlinks" flag set by the **xfs_io(8)** chattr command on a directory to be inherited by files in that directory. fs.xfs.inherit_nodefrag (Min: 0 Default: 1 Max: 1) Setting this to "1" will cause the "nodefrag" flag set by the **xfs_io(8)** chattr command on a directory to be inherited by files in that directory. fs.xfs.rotorstep (Min: 1 Default: 1 Max: 256) In "inode32" allocation mode, this option determines how many files the allocator attempts to allocate in the same allocation group before moving to the next allocation group. The intent is to control the rate at which the allocator moves between allocation groups when allocating extents for new files. h]j6)}(hhh](j;)}(hfs.xfs.stats_clear (Min: 0 Default: 0 Max: 1) Setting this to "1" clears accumulated XFS statistics in /proc/fs/xfs/stat. It then immediately resets to "0". h](jA)}(h:fs.xfs.stats_clear (Min: 0 Default: 0 Max: 1)h]h:fs.xfs.stats_clear (Min: 0 Default: 0 Max: 1)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhj ubjQ)}(hhh]h)}(hoSetting this to "1" clears accumulated XFS statistics in /proc/fs/xfs/stat. It then immediately resets to "0".h]hwSetting this to “1” clears accumulated XFS statistics in /proc/fs/xfs/stat. It then immediately resets to “0”.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jPhj ubeh}(h]h ]h"]h$]h&]uh1j:hhhMhj ubj;)}(hfs.xfs.xfssyncd_centisecs (Min: 100 Default: 3000 Max: 720000) The interval at which the filesystem flushes metadata out to disk and runs internal cache cleanup routines. h](jA)}(hDfs.xfs.xfssyncd_centisecs (Min: 100 Default: 3000 Max: 720000)h]hDfs.xfs.xfssyncd_centisecs (Min: 100 Default: 3000 Max: 720000)}(hj' hhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhj# ubjQ)}(hhh]h)}(hkThe interval at which the filesystem flushes metadata out to disk and runs internal cache cleanup routines.h]hkThe interval at which the filesystem flushes metadata out to disk and runs internal cache cleanup routines.}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj5 ubah}(h]h ]h"]h$]h&]uh1jPhj# ubeh}(h]h ]h"]h$]h&]uh1j:hhhMhj ubj;)}(hfs.xfs.filestream_centisecs (Min: 1 Default: 3000 Max: 360000) The interval at which the filesystem ages filestreams cache references and returns timed-out AGs back to the free stream pool. h](jA)}(hBfs.xfs.filestream_centisecs (Min: 1 Default: 3000 Max: 360000)h]hBfs.xfs.filestream_centisecs (Min: 1 Default: 3000 Max: 360000)}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhM#hjR ubjQ)}(hhh]h)}(h~The interval at which the filesystem ages filestreams cache references and returns timed-out AGs back to the free stream pool.h]h~The interval at which the filesystem ages filestreams cache references and returns timed-out AGs back to the free stream pool.}(hjg hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM!hjd ubah}(h]h ]h"]h$]h&]uh1jPhjR ubeh}(h]h ]h"]h$]h&]uh1j:hhhM#hj ubj;)}(hX+fs.xfs.speculative_prealloc_lifetime (Units: seconds Min: 1 Default: 300 Max: 86400) The interval at which the background scanning for inodes with unused speculative preallocation runs. The scan removes unused preallocation from clean inodes and releases the unused space back to the free pool. h](jA)}(h$fs.xfs.speculative_prealloc_lifetimeh]h$fs.xfs.speculative_prealloc_lifetime}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhM*hj ubjQ)}(hhh]h)}(hX(Units: seconds Min: 1 Default: 300 Max: 86400) The interval at which the background scanning for inodes with unused speculative preallocation runs. The scan removes unused preallocation from clean inodes and releases the unused space back to the free pool.h]hX(Units: seconds Min: 1 Default: 300 Max: 86400) The interval at which the background scanning for inodes with unused speculative preallocation runs. The scan removes unused preallocation from clean inodes and releases the unused space back to the free pool.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM&hj ubah}(h]h ]h"]h$]h&]uh1jPhj ubeh}(h]h ]h"]h$]h&]uh1j:hhhM*hj ubj;)}(hXYfs.xfs.error_level (Min: 0 Default: 3 Max: 11) A volume knob for error reporting when internal errors occur. This will generate detailed messages & backtraces for filesystem shutdowns, for example. Current threshold values are: XFS_ERRLEVEL_OFF: 0 XFS_ERRLEVEL_LOW: 1 XFS_ERRLEVEL_HIGH: 5 h](jA)}(h;fs.xfs.error_level (Min: 0 Default: 3 Max: 11)h]h;fs.xfs.error_level (Min: 0 Default: 3 Max: 11)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhM3hj ubjQ)}(hhh](h)}(hA volume knob for error reporting when internal errors occur. This will generate detailed messages & backtraces for filesystem shutdowns, for example. Current threshold values are:h]hA volume knob for error reporting when internal errors occur. This will generate detailed messages & backtraces for filesystem shutdowns, for example. Current threshold values are:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM-hj ubj0)}(hNXFS_ERRLEVEL_OFF: 0 XFS_ERRLEVEL_LOW: 1 XFS_ERRLEVEL_HIGH: 5 h]h)}(hMXFS_ERRLEVEL_OFF: 0 XFS_ERRLEVEL_LOW: 1 XFS_ERRLEVEL_HIGH: 5h]hMXFS_ERRLEVEL_OFF: 0 XFS_ERRLEVEL_LOW: 1 XFS_ERRLEVEL_HIGH: 5}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM1hj ubah}(h]h ]h"]h$]h&]uh1j/hhhM1hj ubeh}(h]h ]h"]h$]h&]uh1jPhj ubeh}(h]h ]h"]h$]h&]uh1j:hhhM3hj ubj;)}(hXfs.xfs.panic_mask (Min: 0 Default: 0 Max: 511) Causes certain error conditions to call BUG(). Value is a bitmask; OR together the tags which represent errors which should cause panics: XFS_NO_PTAG 0 XFS_PTAG_IFLUSH 0x00000001 XFS_PTAG_LOGRES 0x00000002 XFS_PTAG_AILDELETE 0x00000004 XFS_PTAG_ERROR_REPORT 0x00000008 XFS_PTAG_SHUTDOWN_CORRUPT 0x00000010 XFS_PTAG_SHUTDOWN_IOERROR 0x00000020 XFS_PTAG_SHUTDOWN_LOGERROR 0x00000040 XFS_PTAG_FSBLOCK_ZERO 0x00000080 XFS_PTAG_VERIFIER_ERROR 0x00000100 This option is intended for debugging only. h](jA)}(h/error/// h]h)}(h(/sys/fs/xfs//error///h]h(/sys/fs/xfs//error///}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j/hhhMhjhhubj6)}(hhh]j;)}(hXWhere: The short device name of the mounted filesystem. This is the same device name that shows up in XFS kernel error messages as "XFS(): ..." The subsystem the error configuration belongs to. As of 4.9, the defined classes are: - "metadata": applies metadata buffer write IO The individual error handler configurations. h](jA)}(hWhere:h]hWhere:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhjubjQ)}(hhh]j6)}(hhh](j;)}(h The short device name of the mounted filesystem. This is the same device name that shows up in XFS kernel error messages as "XFS(): ..." h](jA)}(hh]h}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhjubjQ)}(hhh]h)}(hThe short device name of the mounted filesystem. This is the same device name that shows up in XFS kernel error messages as "XFS(): ..."h]hThe short device name of the mounted filesystem. This is the same device name that shows up in XFS kernel error messages as “XFS(): ...”}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhMhjubj;)}(h The subsystem the error configuration belongs to. As of 4.9, the defined classes are: - "metadata": applies metadata buffer write IO h](jA)}(hh]h}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhjubjQ)}(hhh](h)}(hUThe subsystem the error configuration belongs to. As of 4.9, the defined classes are:h]hUThe subsystem the error configuration belongs to. As of 4.9, the defined classes are:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubj0)}(h/- "metadata": applies metadata buffer write IO h]h bullet_list)}(hhh]h list_item)}(h-"metadata": applies metadata buffer write IO h]h)}(h,"metadata": applies metadata buffer write IOh]h0“metadata”: applies metadata buffer write IO}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj"ubah}(h]h ]h"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]bullet-uh1jhhhMhjubah}(h]h ]h"]h$]h&]uh1j/hhhMhjubeh}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhMhjubj;)}(h6 The individual error handler configurations. h](jA)}(hh]h}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhjTubjQ)}(hhh]h)}(h,The individual error handler configurations.h]h,The individual error handler configurations.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjfubah}(h]h ]h"]h$]h&]uh1jPhjTubeh}(h]h ]h"]h$]h&]uh1j:hhhMhjubeh}(h]h ]h"]h$]h&]uh1j5hjubah}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhMhjubah}(h]h ]h"]h$]h&]uh1j5hjhhhNhNubh)}(h^Each filesystem has "global" error configuration options defined in their top level directory:h]hbEach filesystem has “global” error configuration options defined in their top level directory:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj0)}(hX/sys/fs/xfs//error/ fail_at_unmount (Min: 0 Default: 1 Max: 1) Defines the filesystem error behavior at unmount time. If set to a value of 1, XFS will override all other error configurations during unmount and replace them with "immediate fail" characteristics. i.e. no retries, no retry timeout. This will always allow unmount to succeed when there are persistent errors present. If set to 0, the configured retry behaviour will continue until all retries and/or timeouts have been exhausted. This will delay unmount completion when there are persistent errors, and it may prevent the filesystem from ever unmounting fully in the case of "retry forever" handler configurations. Note: there is no guarantee that fail_at_unmount can be set while an unmount is in progress. It is possible that the ``sysfs`` entries are removed by the unmounting filesystem before a "retry forever" error handler configuration causes unmount to hang, and hence the filesystem must be configured appropriately before unmount begins to prevent unmount hangs. h](h)}(h/sys/fs/xfs//error/h]h/sys/fs/xfs//error/}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubj6)}(hhh]j;)}(hXfail_at_unmount (Min: 0 Default: 1 Max: 1) Defines the filesystem error behavior at unmount time. If set to a value of 1, XFS will override all other error configurations during unmount and replace them with "immediate fail" characteristics. i.e. no retries, no retry timeout. This will always allow unmount to succeed when there are persistent errors present. If set to 0, the configured retry behaviour will continue until all retries and/or timeouts have been exhausted. This will delay unmount completion when there are persistent errors, and it may prevent the filesystem from ever unmounting fully in the case of "retry forever" handler configurations. Note: there is no guarantee that fail_at_unmount can be set while an unmount is in progress. It is possible that the ``sysfs`` entries are removed by the unmounting filesystem before a "retry forever" error handler configuration causes unmount to hang, and hence the filesystem must be configured appropriately before unmount begins to prevent unmount hangs. h](jA)}(h/error/// max_retries (Min: -1 Default: Varies Max: INTMAX) Defines the allowed number of retries of a specific error before the filesystem will propagate the error. The retry count for a given error context (e.g. a specific metadata buffer) is reset every time there is a successful completion of the operation. Setting the value to "-1" will cause XFS to retry forever for this specific error. Setting the value to "0" will cause XFS to fail immediately when the specific error is reported. Setting the value to "N" (where 0 < N < Max) will make XFS retry the operation "N" times before propagating the error. retry_timeout_seconds (Min: -1 Default: Varies Max: 1 day) Define the amount of time (in seconds) that the filesystem is allowed to retry its operations when the specific error is found. Setting the value to "-1" will allow XFS to retry forever for this specific error. Setting the value to "0" will cause XFS to fail immediately when the specific error is reported. Setting the value to "N" (where 0 < N < Max) will allow XFS to retry the operation for up to "N" seconds before propagating the error. h](h)}(h(/sys/fs/xfs//error///h]h(/sys/fs/xfs//error///}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjCubj6)}(hhh](j;)}(hXqmax_retries (Min: -1 Default: Varies Max: INTMAX) Defines the allowed number of retries of a specific error before the filesystem will propagate the error. The retry count for a given error context (e.g. a specific metadata buffer) is reset every time there is a successful completion of the operation. Setting the value to "-1" will cause XFS to retry forever for this specific error. Setting the value to "0" will cause XFS to fail immediately when the specific error is reported. Setting the value to "N" (where 0 < N < Max) will make XFS retry the operation "N" times before propagating the error. h](jA)}(hEmax_retries (Min: -1 Default: Varies Max: INTMAX)h]hEmax_retries (Min: -1 Default: Varies Max: INTMAX)}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhjXubjQ)}(hhh](h)}(hDefines the allowed number of retries of a specific error before the filesystem will propagate the error. The retry count for a given error context (e.g. a specific metadata buffer) is reset every time there is a successful completion of the operation.h]hDefines the allowed number of retries of a specific error before the filesystem will propagate the error. The retry count for a given error context (e.g. a specific metadata buffer) is reset every time there is a successful completion of the operation.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjjubh)}(hRSetting the value to "-1" will cause XFS to retry forever for this specific error.h]hVSetting the value to “-1” will cause XFS to retry forever for this specific error.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjjubh)}(h`Setting the value to "0" will cause XFS to fail immediately when the specific error is reported.h]hdSetting the value to “0” will cause XFS to fail immediately when the specific error is reported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjjubh)}(hvSetting the value to "N" (where 0 < N < Max) will make XFS retry the operation "N" times before propagating the error.h]h~Setting the value to “N” (where 0 < N < Max) will make XFS retry the operation “N” times before propagating the error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjjubeh}(h]h ]h"]h$]h&]uh1jPhjXubeh}(h]h ]h"]h$]h&]uh1j:hhhMhjUubj;)}(hXretry_timeout_seconds (Min: -1 Default: Varies Max: 1 day) Define the amount of time (in seconds) that the filesystem is allowed to retry its operations when the specific error is found. Setting the value to "-1" will allow XFS to retry forever for this specific error. Setting the value to "0" will cause XFS to fail immediately when the specific error is reported. Setting the value to "N" (where 0 < N < Max) will allow XFS to retry the operation for up to "N" seconds before propagating the error. h](jA)}(hFretry_timeout_seconds (Min: -1 Default: Varies Max: 1 day)h]hFretry_timeout_seconds (Min: -1 Default: Varies Max: 1 day)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhMhjubjQ)}(hhh](h)}(hDefine the amount of time (in seconds) that the filesystem is allowed to retry its operations when the specific error is found.h]hDefine the amount of time (in seconds) that the filesystem is allowed to retry its operations when the specific error is found.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubh)}(hRSetting the value to "-1" will allow XFS to retry forever for this specific error.h]hVSetting the value to “-1” will allow XFS to retry forever for this specific error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubh)}(h`Setting the value to "0" will cause XFS to fail immediately when the specific error is reported.h]hdSetting the value to “0” will cause XFS to fail immediately when the specific error is reported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubh)}(hSetting the value to "N" (where 0 < N < Max) will allow XFS to retry the operation for up to "N" seconds before propagating the error.h]hSetting the value to “N” (where 0 < N < Max) will allow XFS to retry the operation for up to “N” seconds before propagating the error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubeh}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhMhjUubeh}(h]h ]h"]h$]h&]uh1j5hjCubeh}(h]h ]h"]h$]h&]uh1j/hhhMhjhhubh)}(hXs**Note:** The default behaviour for a specific error handler is dependent on both the class and error context. For example, the default values for "metadata/ENODEV" are "0" rather than "-1" so that this error handler defaults to "fail immediately" behaviour. This is done because ENODEV is a fatal, unrecoverable error no matter how many times the metadata IO is retried.h](j)}(h **Note:**h]hNote:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhXz The default behaviour for a specific error handler is dependent on both the class and error context. For example, the default values for “metadata/ENODEV” are “0” rather than “-1” so that this error handler defaults to “fail immediately” behaviour. This is done because ENODEV is a fatal, unrecoverable error no matter how many times the metadata IO is retried.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]error-handlingah ]h"]error handlingah$]h&]uh1hhhhhhhhMyubh)}(hhh](h)}(hWorkqueue Concurrencyh]hWorkqueue Concurrency}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hhhhhMubh)}(hX&XFS uses kernel workqueues to parallelize metadata update processes. This enables it to take advantage of storage hardware that can service many IO operations simultaneously. This interface exposes internal implementation details of XFS, and as such is explicitly not part of any userspace API/ABI guarantee the kernel may give userspace. These are undocumented features of the generic workqueue implementation XFS uses for concurrency, and they are provided here purely for diagnostic and tuning purposes and may change at any time in the future.h]hX&XFS uses kernel workqueues to parallelize metadata update processes. This enables it to take advantage of storage hardware that can service many IO operations simultaneously. This interface exposes internal implementation details of XFS, and as such is explicitly not part of any userspace API/ABI guarantee the kernel may give userspace. These are undocumented features of the generic workqueue implementation XFS uses for concurrency, and they are provided here purely for diagnostic and tuning purposes and may change at any time in the future.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj:hhubh)}(hThe control knobs for a filesystem's workqueues are organized by task at hand and the short name of the data device. They all can be found in:h]hThe control knobs for a filesystem’s workqueues are organized by task at hand and the short name of the data device. They all can be found in:}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj:hhubj0)}(h-/sys/bus/workqueue/devices/${task}!${device} h]h)}(h,/sys/bus/workqueue/devices/${task}!${device}h]h,/sys/bus/workqueue/devices/${task}!${device}}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjgubah}(h]h ]h"]h$]h&]uh1j/hhhMhj:hhubj )}(hhh]j )}(hhh](j )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hjubj )}(hhh]h}(h]h ]h"]h$]h&]colwidthK:uh1j hjubj )}(hhh]j )}(hhh](j )}(hhh]h)}(hTaskh]hTask}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh]h)}(h Descriptionh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1j hjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh](j )}(hhh](j )}(hhh]h)}(hxfs_iwalk-$pidh]hxfs_iwalk-$pid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh]h)}(hQInode scans of the entire filesystem. Currently limited to mount time quotacheck.h]hQInode scans of the entire filesystem. Currently limited to mount time quotacheck.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh](j )}(hhh]h)}(hxfs-gch]hxfs-gc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j hjubj )}(hhh]h)}(hBackground garbage collection of disk space that have been speculatively allocated beyond EOF or for staging copy on write operations.h]hBackground garbage collection of disk space that have been speculatively allocated beyond EOF or for staging copy on write operations.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj-ubah}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]colsKuh1j hjubah}(h]h ]h"]h$]h&]uh1j hj:hhhhhNubh)}(hFor example, the knobs for the quotacheck workqueue for /dev/nvme0n1 would be found in /sys/bus/workqueue/devices/xfs_iwalk-1111!nvme0n1/.h]hFor example, the knobs for the quotacheck workqueue for /dev/nvme0n1 would be found in /sys/bus/workqueue/devices/xfs_iwalk-1111!nvme0n1/.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj:hhubh)}(h8The interesting knobs for XFS workqueues are as follows:h]h8The interesting knobs for XFS workqueues are as follows:}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj:hhubj )}(hhh]j )}(hhh](j )}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1j hj|ubj )}(hhh]h}(h]h ]h"]h$]h&]colwidthK/zoned/ max_open_zones (Min: 1 Default: Varies Max: UINTMAX) This read-only attribute exposes the maximum number of open zones available for data placement. The value is determined at mount time and is limited by the capabilities of the backing zoned device, file system size and the max_open_zones mount option. nr_open_zones (Min: 0 Default: Varies Max: UINTMAX) This read-only attribute exposes the current number of open zones used by the file system. zonegc_low_space (Min: 0 Default: 0 Max: 100) Define a percentage for how much of the unused space that GC should keep available for writing. A high value will reclaim more of the space occupied by unused blocks, creating a larger buffer against write bursts at the cost of increased write amplification. Regardless of this value, garbage collection will always aim to free a minimum amount of blocks to keep max_open_zones open for data placement purposes.h](h)}(h/sys/fs/xfs//zoned/h]h/sys/fs/xfs//zoned/}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM!hjubj6)}(hhh](j;)}(hXEmax_open_zones (Min: 1 Default: Varies Max: UINTMAX) This read-only attribute exposes the maximum number of open zones available for data placement. The value is determined at mount time and is limited by the capabilities of the backing zoned device, file system size and the max_open_zones mount option. h](jA)}(hHmax_open_zones (Min: 1 Default: Varies Max: UINTMAX)h]hHmax_open_zones (Min: 1 Default: Varies Max: UINTMAX)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhM'hjubjQ)}(hhh]h)}(hThis read-only attribute exposes the maximum number of open zones available for data placement. The value is determined at mount time and is limited by the capabilities of the backing zoned device, file system size and the max_open_zones mount option.h]hThis read-only attribute exposes the maximum number of open zones available for data placement. The value is determined at mount time and is limited by the capabilities of the backing zoned device, file system size and the max_open_zones mount option.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM$hjubah}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhM'hjubj;)}(hnr_open_zones (Min: 0 Default: Varies Max: UINTMAX) This read-only attribute exposes the current number of open zones used by the file system. h](jA)}(hHnr_open_zones (Min: 0 Default: Varies Max: UINTMAX)h]hHnr_open_zones (Min: 0 Default: Varies Max: UINTMAX)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhM+hjubjQ)}(hhh]h)}(hZThis read-only attribute exposes the current number of open zones used by the file system.h]hZThis read-only attribute exposes the current number of open zones used by the file system.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM*hj ubah}(h]h ]h"]h$]h&]uh1jPhjubeh}(h]h ]h"]h$]h&]uh1j:hhhM+hjubj;)}(hXzonegc_low_space (Min: 0 Default: 0 Max: 100) Define a percentage for how much of the unused space that GC should keep available for writing. A high value will reclaim more of the space occupied by unused blocks, creating a larger buffer against write bursts at the cost of increased write amplification. Regardless of this value, garbage collection will always aim to free a minimum amount of blocks to keep max_open_zones open for data placement purposes.h](jA)}(h?zonegc_low_space (Min: 0 Default: 0 Max: 100)h]h?zonegc_low_space (Min: 0 Default: 0 Max: 100)}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j@hhhM2hj(ubjQ)}(hhh]h)}(hXDefine a percentage for how much of the unused space that GC should keep available for writing. A high value will reclaim more of the space occupied by unused blocks, creating a larger buffer against write bursts at the cost of increased write amplification. Regardless of this value, garbage collection will always aim to free a minimum amount of blocks to keep max_open_zones open for data placement purposes.h]hXDefine a percentage for how much of the unused space that GC should keep available for writing. A high value will reclaim more of the space occupied by unused blocks, creating a larger buffer against write bursts at the cost of increased write amplification. Regardless of this value, garbage collection will always aim to free a minimum amount of blocks to keep max_open_zones open for data placement purposes.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM.hj:ubah}(h]h ]h"]h$]h&]uh1jPhj(ubeh}(h]h ]h"]h$]h&]uh1j:hhhM2hjubeh}(h]h ]h"]h$]h&]uh1j5hjubeh}(h]h ]h"]h$]h&]uh1j/hhhM!hjhhubeh}(h]zoned-filesystemsah ]h"]zoned filesystemsah$]h&]uh1hhhhhhhhMubeh}(h]the-sgi-xfs-filesystemah ]h"]the sgi xfs filesystemah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jpjmj4 j1 j j j j j j jjjjjjj7j4jjjhjeu nametypes}(jpj4 j j j jjjj7jjhuh}(jmhj1 jj j7 j j j j jj jjjjj4jjj:jeju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.