The branch main has been updated by rmacklem:
URL:
https://cgit.FreeBSD.org/src/commit/?id=c754cdedb3804b7c24b5a0edf6291abeb80f003b
commit c754cdedb3804b7c24b5a0edf6291abeb80f003b
Author: Rick Macklem <rmack...@freebsd.org>
AuthorDate: 2025-07-24 23:03:14 +0000
Commit: Rick Macklem <rmack...@freebsd.org>
CommitDate: 2025-07-24 23:03:14 +0000
named_attribute.7: Add a section for ZFS "sa" attributes
On ZFS, extended attributes with small values
(as in number of bytes) that are created when
xattr is set to "sa" will only be visible via extattr(2)
and not as named attributes.
This man page patch documents the above.
This is a content change.
Reviewed by: kib
Differential Revision: https://reviews.freebsd.org/D51444
---
share/man/man7/named_attribute.7 | 23 +++++++++++++++++++++--
1 file changed, 21 insertions(+), 2 deletions(-)
diff --git a/share/man/man7/named_attribute.7 b/share/man/man7/named_attribute.7
index 7cd778620357..4080dfce2fab 100644
--- a/share/man/man7/named_attribute.7
+++ b/share/man/man7/named_attribute.7
@@ -3,7 +3,7 @@
.\"
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
-.Dd July 3, 2025
+.Dd July 20, 2025
.Dt NAMED_ATTRIBUTE 7
.Os
.Sh NAME
@@ -122,7 +122,7 @@ Although the named attribute machanism might require
different internal
implementation
of extended attributes within a file system, both ZFS and NFSv4 provide
both mechanisms, which can be used interchangeably to manipulate
-extended attributes, but with a couple of limitations.
+extended attributes, but with a few limitations.
.Bl -bullet
.It
The
@@ -135,6 +135,24 @@ The named attribute interface does not support system
namespace
extended attributes and,
as such, system namespace extended attributes must be manipulated via
.Xr extattr 2 .
+.It
+For ZFS, if an extended attribute with a value
+that is a small length in bytes is created when the ZFS
+.Dv xattr
+property is set to
+.Dq sa ,
+that extended attribute is only visible via
+.Xr extattr 2
+and not as a named attribute.
+Archiving/de-archiving the file via
+.Xr tar 1
+after setting the
+.Dv xattr
+property to
+.Dq dir
+will make the attribute(s) visible as both named attributes
+and via
+.Xr extattr 2 .
.El
.Pp
The named attribute mechanism/system call interface provides certain
@@ -259,6 +277,7 @@ enters the named attribute directory for the file object
.Sh SEE ALSO
.Xr bash 1 ,
.Xr runat 1 ,
+.Xr tar 1 ,
.Xr chdir 2 ,
.Xr extattr 2 ,
.Xr lseek 2 ,
