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.
129 	by the user. This turns on co-allocation of data of similar
136 	Set the size of each in-memory log buffer.  The size may be
148 	Use an external log (metadata journal) and/or real-time device.
150 	section, and a real-time section.  The real-time section is
165 	with non-zero data alignment parameters (``sunit``, ``swidth``) by
173 	Filesystems mounted ``norecovery`` must be mounted read-only or
180 	read-only snapshots.
183 	Forcibly turns off all quota accounting and enforcement
200 	or a stripe volume.  "value" must be specified in 512-byte
202 	that were created with non-zero data alignment parameters.
207 	increasing it by a power-of-2 multiple. Valid ``swidth`` values
221 	When specified, all filesystem namespace operations are
235 Because of this, the V4 format is deprecated.  All users should upgrade
259 Mounting ascii-ci filesystem    September 2030
294 	references and returns timed-out AGs back to the free stream
308 	A volume knob for error reporting when internal errors occur.
318 	OR together the tags which represent errors which should cause panics:
405  -failure speed:
409 	or simply retry forever.
411  -error classes:
416  -error handlers:
420 error handler works independently - the first condition met by an error handler
425 dependent - it may cause a shut down in the case of an unrecoverable error,
444 		- "metadata": applies metadata buffer write IO
458 	If set to a value of 1, XFS will override all other error configurations
460 	i.e. no retries, no retry timeout. This will always allow unmount to
461 	succeed when there are persistent errors present.
463 	If set to 0, the configured retry behaviour will continue until all
465 	completion when there are persistent errors, and it may prevent the
466 	filesystem from ever unmounting fully in the case of "retry forever"
471 	removed by the unmounting filesystem before a "retry forever" error
477 propagation behaviour for specific errors. There is also a "default" error
478 handler defined, which defines the behaviour for all errors that don't have
479 specific handlers defined. Where multiple retry constraints are configured for
480 a single error, the first retry configuration that expires will cause the error
485   max_retries			(Min: -1  Default: Varies  Max: INTMAX)
487 	the filesystem will propagate the error. The retry count for a given
491 	Setting the value to "-1" will cause XFS to retry forever for this
497 	Setting the value to "N" (where 0 < N < Max) will make XFS retry the
500   retry_timeout_seconds		(Min:  -1  Default:  Varies  Max: 1 day)
502 	allowed to retry its operations when the specific error is
505 	Setting the value to "-1" will allow XFS to retry forever for this
511 	Setting the value to "N" (where 0 < N < Max) will allow XFS to retry the
516 "metadata/ENODEV" are "0" rather than "-1" so that this error handler defaults
533 and the short name of the data device.  They all can be found in:
540   xfs_iwalk-$pid  Inode scans of the entire filesystem. Currently limited to
542   xfs-gc          Background garbage collection of disk space that have been
548 found in /sys/bus/workqueue/devices/xfs_iwalk-1111!nvme0n1/.
570 	This read-only attribute exposes the maximum number of open zones