From nobody Thu Jul 24 23:06:27 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4bp67l3wWWz6231V; Thu, 24 Jul 2025 23:06:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4bp67l2CWLz4Lb4; Thu, 24 Jul 2025 23:06:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1753398387; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=12Qb2yZWy33TqOvNbwgz5sib6e7JJFImEg6uC7AOTVQ=; b=GKW24tDsv4tY+4KCB5pjSNduZpx/BCFRZlCb3mol++v3fYlQ8LkIPdxBQzLVthR7cUQxRH 6M90aefTohA2IhjXinskw/7ZyZNC+gTCZ/CY3tF+NJREJVG4W9YwMDE4g5qVWYiXXVQy5g kB94sK1UVX6V/+Tk5PN7w45GldW6uDTzg0d4mY0ZRhv1bkHnZyjBSjQpM/fvazHzjuQCB9 XEs5b3rkyH2ZsqYs6z3uQJj8xuWazOZ6mHdC3sJ+4gCxEu0ycFjMAtda31WkUOXOIiLFLW kYsRAIyT9lvW9S4xWqPjRI5lLSh1tse6f+/rpbhNiH+gHNoeuJ0a0ieh1bJERg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1753398387; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=12Qb2yZWy33TqOvNbwgz5sib6e7JJFImEg6uC7AOTVQ=; b=oO2+7NTs0+OD/wpFZ3fUrclro6GtRmfN/LJZd60t19fB+kRN1VWN5awduLQrf1/ErHPcM5 QuBkYOXK+Q2ndWkv06atAmxQ6zmH+fr/LKI224wIN0pvTiZJ3/iJIID6W5kAs2goFEZYjr +xjPwGyWwoC1/GxjZV82sPVBAd/pgbL8vo36zaMy7wF7aKOyWek9FYoFENb5Ge0p41Yws/ S2HZzGc0ubHOiQb5WMs+bIPpe/Wn9Sqd5zAizUPWvVn2GZUfr3hFVzZry11PmKh46xIM+8 DG4sN4YgPfpvuIpjdvwSPCDsN/6xyf83iV2ZsVZ+vK9MCzoRelPbWBYA5B6pXQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1753398387; a=rsa-sha256; cv=none; b=WwTD2UnbjuUN1qr2F+XT+NQqRCVqKg5D4/fk9LBsXTphDBP+DLn/DO0fd4cvCfon67ehCr JwHAEXYxZhyycqjilBuKdiq8luCpn+yL2g/iPMAk/DAT/pPXDfz7ifV5N0OVDhKZQ6rFwA oFY3XheBGiB4Nr11sroVTpZFY4yH+mFCyaMiSsEfPq+k3ugv6ozAJv00X0PUBz1OS0gB/X 0+8eABuDL+DOsn1L45VqiaVk+SQMqjz+6ohbaujzSTzaL5tjeFqPAcxJqAoB4X4+4VGqOV RClR+Ngqcm2kvQMGimBWYeJ1M1lHNai5PQwkx9zo72koVpWwLFbBSBuW48UKVQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4bp67l1Fjsz3yn; Thu, 24 Jul 2025 23:06:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 56ON6Rg6032155; Thu, 24 Jul 2025 23:06:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 56ON6RPs032152; Thu, 24 Jul 2025 23:06:27 GMT (envelope-from git) Date: Thu, 24 Jul 2025 23:06:27 GMT Message-Id: <202507242306.56ON6RPs032152@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Rick Macklem Subject: git: c754cdedb380 - main - named_attribute.7: Add a section for ZFS "sa" attributes List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: rmacklem X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c754cdedb3804b7c24b5a0edf6291abeb80f003b Auto-Submitted: auto-generated The branch main has been updated by rmacklem: URL: https://cgit.FreeBSD.org/src/commit/?id=c754cdedb3804b7c24b5a0edf6291abeb80f003b commit c754cdedb3804b7c24b5a0edf6291abeb80f003b Author: Rick Macklem AuthorDate: 2025-07-24 23:03:14 +0000 Commit: Rick Macklem 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 ,