aboutsummaryrefslogtreecommitdiffstats
path: root/man/man7/zfsprops.7
diff options
context:
space:
mode:
authorGeorge Melikov <[email protected]>2024-09-23 19:50:48 +0300
committerGitHub <[email protected]>2024-09-23 09:50:48 -0700
commite419a63bf4cd6abb58e392b4341a8057c4481dba (patch)
tree6a8b925294254e0ecb310fc1b564abe78fd28802 /man/man7/zfsprops.7
parent1d84c9eb661802e81dde6677e3c38ecdfe0bda6c (diff)
xattr dataset prop: change defaults to sa
It's the main recommendation to set xattr=sa even in man pages, so let's set it by default. xattr=sa don't use feature flag, so in the worst case we'll have non-readable xattrs by other non-openzfs platforms. Non-overridden default `xattr` prop of existing pools will automatically use `sa` after this commit too. Reviewed-by: Brian Behlendorf <[email protected]> Signed-off-by: George Melikov <[email protected]> Closes #15147
Diffstat (limited to 'man/man7/zfsprops.7')
-rw-r--r--man/man7/zfsprops.712
1 files changed, 7 insertions, 5 deletions
diff --git a/man/man7/zfsprops.7 b/man/man7/zfsprops.7
index a3ae4d877..f33b663d1 100644
--- a/man/man7/zfsprops.7
+++ b/man/man7/zfsprops.7
@@ -1971,14 +1971,13 @@ enabled for virus scanning to occur.
The default value is
.Sy off .
This property is not used by OpenZFS.
-.It Sy xattr Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy sa
+.It Sy xattr Ns = Ns Sy on Ns | Ns Sy off Ns | Ns Sy dir Ns | Ns Sy sa
Controls whether extended attributes are enabled for this file system.
Two styles of extended attributes are supported: either directory-based
or system-attribute-based.
.Pp
-The default value of
-.Sy on
-enables directory-based extended attributes.
+Directory-based extended attributes can be enabled by setting the value to
+.Sy dir .
This style of extended attribute imposes no practical limit
on either the size or number of attributes which can be set on a file.
Although under Linux the
@@ -1991,7 +1990,10 @@ This is the most compatible
style of extended attribute and is supported by all ZFS implementations.
.Pp
System-attribute-based xattrs can be enabled by setting the value to
-.Sy sa .
+.Sy sa
+(default and equal to
+.Sy on
+) .
The key advantage of this type of xattr is improved performance.
Storing extended attributes as system attributes
significantly decreases the amount of disk I/O required.