Documentation/admin-guide/xfs.rst

1 .. SPDX-License-Identifier: GPL-2.0
8 on the SGI IRIX platform.  It is completely multi-threaded, can
15 for further details.  This implementation is on-disk compatible
25 	Sets the buffered I/O end-of-file preallocation size when
28 	through to 1GiB, inclusive, in power-of-2 increments.
30 	The default behaviour is for dynamic end-of-file
40 	on-disk.  When the new form is used for the first time when
42 	attributes) the on-disk superblock feature bit field will be
45 	The default behaviour is determined by the on-disk feature
116 	Set the number of in-memory log buffers.  Valid numbers
117 	range from 2-8 inclusive.
128 	Set the size of each in-memory log buffer.  The size may be
137 	default value for version 2 logs is MAX(32768, log_sunit).
140 	Use an external log (metadata journal) and/or real-time device.
142 	section, and a real-time section.  The real-time section is
149 	with non-zero data alignment parameters (``sunit``, ``swidth``) by
157 	Filesystems mounted ``norecovery`` must be mounted read-only or
164 	read-only snapshots.
184 	or a stripe volume.  "value" must be specified in 512-byte
186 	that were created with non-zero data alignment parameters.
191 	increasing it by a power-of-2 multiple. Valid ``swidth`` values
243 Mounting ascii-ci filesystem    September 2030
268   fs.xfs.stats_clear		(Min: 0  Default: 0  Max: 1)
272   fs.xfs.xfssyncd_centisecs	(Min: 100  Default: 3000  Max: 720000)
276   fs.xfs.filestream_centisecs	(Min: 1  Default: 3000  Max: 360000)
278 	references and returns timed-out AGs back to the free stream
282 	(Units: seconds   Min: 1  Default: 300  Max: 86400)
291   fs.xfs.error_level		(Min: 0  Default: 3  Max: 11)
300   fs.xfs.panic_mask		(Min: 0  Default: 0  Max: 511)
317   fs.xfs.irix_symlink_mode	(Min: 0  Default: 0  Max: 1)
321   fs.xfs.irix_sgid_inherit	(Min: 0  Default: 0  Max: 1)
328   fs.xfs.inherit_sync		(Min: 0  Default: 1  Max: 1)
333   fs.xfs.inherit_nodump		(Min: 0  Default: 1  Max: 1)
338   fs.xfs.inherit_noatime	(Min: 0  Default: 1  Max: 1)
343   fs.xfs.inherit_nosymlinks	(Min: 0  Default: 1  Max: 1)
348   fs.xfs.inherit_nodefrag	(Min: 0  Default: 1  Max: 1)
353   fs.xfs.rotorstep		(Min: 1  Default: 1  Max: 256)
389  -failure speed:
392 	immediately, after a defined number of retries, after a set time period,
395  -error classes:
400  -error handlers:
404 error handler works independently - the first condition met by an error handler
409 dependent - it may cause a shut down in the case of an unrecoverable error,
428 		- "metadata": applies metadata buffer write IO
439   fail_at_unmount		(Min:  0  Default:  1  Max: 1)
444 	i.e. no retries, no retry timeout. This will always allow unmount to
448 	retries and/or timeouts have been exhausted. This will delay unmount
469   max_retries			(Min: -1  Default: Varies  Max: INTMAX)
470 	Defines the allowed number of retries of a specific error before
475 	Setting the value to "-1" will cause XFS to retry forever for this
481 	Setting the value to "N" (where 0 < N < Max) will make XFS retry the
484   retry_timeout_seconds		(Min:  -1  Default:  Varies  Max: 1 day)
489 	Setting the value to "-1" will allow XFS to retry forever for this
495 	Setting the value to "N" (where 0 < N < Max) will allow XFS to retry the
500 "metadata/ENODEV" are "0" rather than "-1" so that this error handler defaults
524   xfs_iwalk-$pid  Inode scans of the entire filesystem. Currently limited to
526   xfs-gc          Background garbage collection of disk space that have been
532 found in /sys/bus/workqueue/devices/xfs_iwalk-1111!nvme0n1/.