Network File System Version 4 R. Macklem Internet-Draft FreeBSD Intended status: Standards Track 5 December 2025 Expires: 8 June 2026 POSIX Draft ACL support for Network File System Version 4, Minor Version 2 draft-ietf-nfsv4-posix-acls-00 Abstract This document proposes four new optional file attributes for NFSv4.2 to support POSIX ACLs conforming to the withdrawn POSIX 1003.1e draft 17. Although never ratified, POSIX ACLs are implemented in widely deployed operating systems. Existing attempts to map between NFSv4 and POSIX ACL models have been unsuccessful due to semantic incompatibilities. These new attributes allow servers to expose POSIX ACLs directly, avoiding lossy mapping. Note This note is to be removed before publishing as an RFC. Discussion of this draft occurs on the NFSv4 working group mailing list (nfsv4@ietf.org), archived at https://mailarchive.ietf.org/arch/browse/nfsv4/. Working Group information is available at https://datatracker.ietf.org/wg/nfsv4/ about/. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on 8 June 2026. Macklem Expires 8 June 2026 [Page 1] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 Copyright Notice Copyright (c) 2025 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Requirements Language . . . . . . . . . . . . . . . . . . . . 4 3. Protocol Extension Considerations . . . . . . . . . . . . . . 4 4. POSIX ACL Description . . . . . . . . . . . . . . . . . . . . 4 5. POSIX ACL Considerations . . . . . . . . . . . . . . . . . . 6 6. POSIX ACL vs NFSv4 ACL Considerations . . . . . . . . . . . . 7 7. ACL Related Attribute Atomicity . . . . . . . . . . . . . . . 9 8. OPTIONAL New Attributes - List and Definition References . . 9 9. Definitions of new optional attributes . . . . . . . . . . . 10 9.1. Attribute 89: acl_trueform . . . . . . . . . . . . . . . 10 9.1.1. Rationale . . . . . . . . . . . . . . . . . . . . . . 10 9.2. Attribute 90: acl_trueform_scope . . . . . . . . . . . . 11 9.2.1. Rationale . . . . . . . . . . . . . . . . . . . . . . 11 9.3. Attribute 91: posix_default_acl . . . . . . . . . . . . . 11 9.3.1. Rationale . . . . . . . . . . . . . . . . . . . . . . 12 9.4. Attribute 92: posix_access_acl . . . . . . . . . . . . . 12 9.4.1. Rationale . . . . . . . . . . . . . . . . . . . . . . 13 10. XDR definitions for new attributes . . . . . . . . . . . . . 13 11. Security Considerations . . . . . . . . . . . . . . . . . . . 16 12. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 16 13. Implementation Status . . . . . . . . . . . . . . . . . . . . 16 13.1. FreeBSD NFS server and client . . . . . . . . . . . . . 16 13.2. Linux kernel patch for the NFSv4 client and server . . . 17 14. References . . . . . . . . . . . . . . . . . . . . . . . . . 17 14.1. Normative References . . . . . . . . . . . . . . . . . . 17 14.2. Informational References . . . . . . . . . . . . . . . . 18 Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 18 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 18 Macklem Expires 8 June 2026 [Page 2] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 1. Introduction In response to the very different over-the-wire formats, attempts have been made to map between these two sorts of ACLs. However, because of the large number of semantic differences, implementation experience with mapping between NFSv4 and POSIX ACLs has not been completely successful. For example, if a NFSv4 ACL is applied to a server file via SETATTR on a server that stores POSIX ACLs and then retrieved via GETATTR/READDIR, the ACL will often not be the same, since the mapping algorithm cannot do an exact mapping between them. A server has the option of choosing to use these mapping algorithms and/or support the new attributes proposed by this document to set/ get the POSIX ACLs. In order to provide better support for POSIX ACLs, this document proposes four new attributes as an extension of NFSv4.2 which can be used by SETATTR/OPEN/CREATE and GETATTR/READDIR to handle POSIX ACLs. If a server chooses to support either the acl_trueform or acl_trueform_scope attributes, it MUST support both of them for all file objects on the server. If a server chooses to support either the posix_default_acl or posix_access_acl attributes for a file system, it MUST support both of these attributes for the file system and the acl_trueform and acl_trueform_scope for all file objects on the server. If the server chooses to support posix_default_acl and posix_access_acl for a file system, it MUST support the mode/ mode_umask attributes for the file system. If this extension is implemented, the VERIFY/NVERIFY operations SHOULD be able to compare the acl_trueform and acl_trueform_scope attributes. However, the VERIFY/NVERIFY operations MUST return NFS4ERR_INVAL when comparison of the posix_default_acl and/or posix_access are requested. [RFC8275] describes a new attribute that is an extension to NFSv4.2 related to POSIX ACLs called mode_umask. A server that chooses to support the new attributes described in this document MUST also support the mode_umask attribute as described in [RFC8275]. In addition, issues related to the over-the-wire format of POSIX ACLs and the interactions among the various new attributes and with existing attributes as dealt with in this document. Macklem Expires 8 June 2026 [Page 3] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 For the purpose of this extension, NFSv4 AUDIT/ALARM ACEs are considered to be logically separate from ALLOW/DENY ACEs. These AUDIT/ALARM ACEs are unaffected by this extension. Deletion of a dacl does not imply any changes to the AUDIT/ALARM ACES. For a server that supports AUDIT/ALARM ACEs for a file system, the server SHOULD support the sacl attribute to set/acquire them. The terms acl, dacl and sacl refer to the attributes of the same name described in [RFC8881]. 2. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. 3. Protocol Extension Considerations This document presents an extension to minor version 2 of the NFSv4 protocol as described in [RFC8178]. It describes new OPTIONAL features. NFSv4.2 servers and clients implemented without knowledge of this extension will continue to interoperate with clients and servers that are aware of the extension (whether or not they support it). Note that [RFC7862] does not define NFSv4.2 as non-extensible, so [RFC8178] treats it as an extensible minor version. This Standards Track RFC extends NFSv4.2 but does not update [RFC7862] or [RFC8178]. 4. POSIX ACL Description This section provides a brief description of POSIX ACLs as they are currently implemented by various vendors. The informational reference [Gruenbacher] provides greater detail. A POSIX ACL consists of three or more ACEs. Each ACE has three components: * A tag set to User_obj, User, Group_obj, Group, Mask or Other. * An Id which can be set to a uid or gid and is only meaningful for the User and Group tagged ACEs. * A permission mask with bits for Read, Write and Execute/Examine. The minimal POSIX draft ACL consists of three ACEs. One ACE of each of the following: Macklem Expires 8 June 2026 [Page 4] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 * Tag User_obj, where the permission mask bits correspond directly to MODE4_RUSR, MODE4_WUSR and MODE4_XUSR as described in [RFC8881]. * Tag Group_obj, where the permission mask bits correspond directly to MODE4_RGRP, MODE4_WGRP and MODE4_XGRP as described in [RFC8881]. * Tag Other, where the permission mask bits correspond directly to MODE4_ROTH, MODE4_WOTH and MODE4_XOTH as described in [RFC8881]. An extended POSIX draft ACL consists of the above three ACEs plus one or more User or Group ACES and one Mask ACE. A User or Group ACE provides permissions of a specific POSIX user or group defined by the Id, which is set to the uid or gid, respectively. Note that, although multiple User and Group tagged ACEs are allowed, each User tagged ACE needs to have a different uid Id and each Group tagged ACE needs to have a different gid Id. If any ACE in the ACL allows permission, the permission is granted, except the upper bound on the permission bits for the Group_obj and Group ACEs is defined by the permission bits in the Mask ACE. In other words, the permission bit must be set in both the Group_obj or Group ACE as well as the Mask ACE for permission to be granted. As such, the order of the ACEs does not affect the semantics of the ACL. When the 9 low order bits of the mode attribute (MODE4_RUSR, MODE4_WUSR, MODE4_XUSR, MODE4_RGRP, MODE4_WGRP, MODE4_XGRP, MODE4_ROTH, MODE4_WOTH, MODE4_XOTH) are changed, the POSIX access ACL for the file object also changes. For a minimal POSIX ACL, the permission bits in the ACEs are replaced by bits corresponding directly to the mode bits for the User_obj, Group_obj and Other ACEs, respectively. For an extended attribute, the User_obj and Other permission bits are replaced by the bits corresponding to the user and other mode bits. However, the group mode bits (MODE4_RGRP, MODE4_WGRP, MODE4_XGRP) are used to replace the permission bits in the Mask ACE. limiting the upper bound for the Group_obj and Group ACEs. The reverse occurs when the permission mask for the User_obj, Group_obj or Other ACEs of a minimal ACL occurs. For an extended ACL, the group mode bits are set from the permission mask of the Mask ACE and not the Group_obj ACE. There are two types of POSIX draft ACLs. * An Access ACL which defines access permission for a file object. Macklem Expires 8 June 2026 [Page 5] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 * A Default ACL, which can only be associated with a directory and is the ACL inherited by new file objects created in the directory. A Default ACL does not define access permission for the directory it is associated with. The permission bits for a newly created file object are the intersection of the permission bits in the default ACL and the low order 9 bits of the mode provided at file object creation. As such, a directory can have two ACLs, one of each type. 5. POSIX ACL Considerations The who field is used to represent the Id field of a POSIX ACL. In the who value within the posixace4 structure that appear in these new attributes, the field is interpreted as follows: * For ACEs whose tag field is POSIXACE4_TAG_USER or POSIXACE4_TAG_GROUP the who value is a UTF8-encoded Unicode string, that has the same format as a user or group as represented within other NFSv4 operations and designates the same entity. In these cases, the distinction between users and groups derives from the tag rather than a flag bit, as is done in NFSv4 ACLs. This is in contrast to how the corresponding structures are described in [Gruenbacher], where numeric uids and gids are specified for the Id. * For ACEs whose tag field has other values, the who field is ignored by the receiver and there is no reason for the sender to set it to any particular value. As such, a zero length who string is appropriate. For POSIX ACLs, setting of the low-order nine bits of mode can change the ACL and setting of the POSIX access ACL can change the low-order nine bits of mode. As such, the ordering of setting the attributes related to mode and POSIX ACLs is important. Therefore, in a manner similar to [RFC8881] Section 6.4.1.3, if the low-order nine bits of mode is being set via the mode/mode_set_masked attributes in the same SETATTR as posix_access_acl and/or posix_default_acl attributes, the setting of mode/mode_set_masked MUST be done before setting the POSIX ACL. For [IEEE], when a new object is created in a directory that has a POSIX default ACL on it, the inherited ACL includes the intersection between the mode specified by the POSIX system call and the posixaceperm4 fields of the POSIX default ACL. Therefore, to maintain compatible semantics with the POSIX draft, for NFSv4 operations that create new file objects (OPEN/OPEN4_CREATE, CREATE) Macklem Expires 8 June 2026 [Page 6] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 in a directory that has a POSIX default ACL, the low-order nine bits of the mode MUST be specified by mode_umask in the setable attributes for the operation. (See [RFC8275] for details on how mode_umask is used.) If the posix_access_acl and/or posix_default_acl are also specified in the setable attributes for the operation, the setting of these attributes MUST be done after setting mode_umask and performing any POSIX ACL inheritance. 6. POSIX ACL vs NFSv4 ACL Considerations The model for the ACL(s) stored on a file object and used to determine file access is referred to as the true form. For servers that support the posix_access_acl and posix_default_acl attributes for a file system, each file object will have ACL(s) of one true form at any given time. For servers that return a acl_trueform_scope attribute value other than ACL_SCOPE_FILE_OBJECT, the true form MUST remain uniform for all file objects in the file system (or file server for a scope of ACL_SCOPE_SERVER). However, for servers that return a acl_trueform_scope attribute value of ACL_SCOPE_FILE_OBJECT, the value of acl_trueform can change, due to a SETATTR operation that sets any of the acl/dacl/posix_access_acl/ posix_default_acl attributes. For servers that return a acl_trueform_scope attribute value of ACL_SCOPE_FILE_OBJECT, there might be different acl_trueform values for different file objects in the file system. For servers where the acl_trueform_scope is not ACL_SCOPE_FILE_OBJECT, the client SHOULD only use the attributes for the file system's acl_trueform, if the client supports these extensions. Normally a server where the acl_trueform_scope in not ACL_SCOPE_FILE_OBJECT will only support the attributes used to set the file system's acl_trueform. However, servers that support the NFSv4 ACL to POSIX ACL mapping algorithm, may choose to support the NFSv4 ACLs (acl/dacl) as well as the new attributes defined in this document. If a server implements both the lossy algorithm mapping from NFSv4 ACLs to POSIX ACLs and support for these new attributes, clients may see unusual POSIX ACLs, due to the lossy mapping algorithm. The expired IETF draft [Eriksen] explains the mapping algorithms. For clients that do not support these extensions, if the server supports an acl_trueform_scope of ACL_SCOPE_FILE_OBJECT, the client may set the NFSv4 ACL (acl/dacl) attribute and switch a file object's acl_trueform to ACL_MODEL_NFS4. This is unfortunately unavoidable unless the client supports the acl_trueform attribute and checks this attribute's setting before setting the NFSv4 ACL (acl/dacl) attributes. Macklem Expires 8 June 2026 [Page 7] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 The low-order nine bits of mode SHOULD be synchronized with the true form ACL for the file object. If the true form is ACL_MODEL_NFS4, synchronization is described in [RFC8881]. If the true form is ACL_MODEL_POSIX_DRAFT, synchronization is described in Section 4. If the true form is ACL_MODEL_NONE, there is no ACL to synchronize with and the low-order nine bits of mode are used to control access to the file object. For servers configured to return a acl_trueform_scope attribute value of ACL_SCOPE_FILE_OBJECT and not for any others, the following apply: * The server MUST return a value of ACL_MODEL_NONE for acl_trueform if there is no true form ACL(s) associated with the file object. * The server MUST return a zero length posixace4 array for posix_default_acl and posix_access_acl if the value of acl_trueform for the file object is not ACL_MODEL_POSIX_DRAFT. * Using SETATTR to set a zero length posixace4 array for posix_access_acl (for a file object with a true form ACL of ACL_MODEL_POSIX_DRAFT) will delete the true form ACL(s) from the file object and revert it to ACL_MODEL_NONE. If a server cannot do this, it MUST reply NFS4ERR_INVAL for the SETATTR. * Using SETATTR to set the dacl or acl attribute to any value will result in the object's true form being set to ACL_MODEL_NFS4. In addition, if the object's acl model had been ACL_MODEL_POSIX_DRAFT, any existing POSIX default and access true form ACL(s) are deleted. If a server cannot do this, it MUST reply NFS4ERR_INVAL for the SETATTR. For a client to set ALARM/ AUDIT ACEs without causing any change in a file object's true form, it will need to perform a SETATTR of the sacl attribute and not the acl attribute. * Using SETATTR to set a posix_default_acl or posix_access_acl of non-zero length posixace4 array (for a file object with a true form ACL not ACL_MODEL_POSIX_DRAFT) will result in the object's acl model being set to ACL_MODEL_POSIX_DRAFT. In addition, if the object's acl model had been ACL_MODEL_NFS4, any dacl (all ALLOW/ DENY ACEs) will be deleted from the stored ACL. If a server cannot do this, it MUST reply NFS4ERR_INVAL for the SETATTR. As noted above, any AUDIT/ALARM ACEs stored for the file object are not affected. For all other configurations of acl_trueform_scope and a acl_trueform of ACL_MODEL_POSIX_DRAFT, the server MUST always return at least a minimal POSIX ACL for posix_access_acl, if that attribute is supported for the file object's file system. A server that is Macklem Expires 8 June 2026 [Page 8] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 configured for a acl_trueform_scope other than ACL_SCOPE_FILE_OBJECT MUST NOT support the posix_default_acl and posix_access_acl unless the true form for the file system is ACL_MODEL_POSIX_DRAFT. If a client does a SETATTR of a zero length posixace4 array for posix_access_acl and the acl_trueform_scope is anything other than ACL_SCOPE_FILE_OBJECT, the server MUST reply NFS4ERR_INVAL. For all acl_trueform_scope configurations, if the acl/dacl attribute(s) are specified in the same setable attributes bitmap as the posix_default_acl/posix_access_acl attribute(s), the server MUST reply NFS4ERR_INVAL. 7. ACL Related Attribute Atomicity For servers that choose to implement the extensions described in this document, the following semantics with respect to ACL related attributes SHOULD be implemented. To ensure a reply to operations that return attributes (GETATTR/ READDIR) provide consistent results when multiple ACL related attributes (acl/dacl/posix_access_acl/posix_default_acl/acl_trueform/mode/ mode_set_masked) are acquired, the server SHOULD acquire the reply values for these attributes atomically with respect to any SETATTR of any of these attributes. For this purpose, atomically means that no SETATTR of any of the above ACL related attributes can be performed during acquisition of the attribute values for a given file object. 8. OPTIONAL New Attributes - List and Definition References The list of New OPTIONAL attributes appears in Table 1. The meaning of the columns of the table are: Name: The name of the attribute. Id: The number assigned to the attribute. Data Type: The XDR data type of the attribute. Acc: Access allowed to the attribute. R means read-only. RW means read/write. Defined in: The section of this specification that describes the attribute. Macklem Expires 8 June 2026 [Page 9] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 +====================+====+=============+=====+=============+ | Name | Id | Data Type | Acc | Defined in: | +====================+====+=============+=====+=============+ | acl_trueform | 89 | aclmodel4 | R | Section 9.1 | +--------------------+----+-------------+-----+-------------+ | acl_trueform_scope | 90 | aclscope4 | R | Section 9.2 | +--------------------+----+-------------+-----+-------------+ | posix_default_acl | 91 | posixace4<> | RW | Section 9.3 | +--------------------+----+-------------+-----+-------------+ | posix_access_acl | 92 | posixace4<> | RW | Section 9.4 | +--------------------+----+-------------+-----+-------------+ Table 1 9. Definitions of new optional attributes 9.1. Attribute 89: acl_trueform This attribute is a read-only attribute that describes which ACL model (NFSv4 vs POSIX) is used for ACL(s) stored on the file object (its true form) on the NFSv4.2 server. The value of this attribute can also be ACL_MODEL_NONE to indicate that no true form ACL is stored for this file object. It is a per-file system object attribute. 9.1.1. Rationale For a server that returns ACL_SCOPE_FILE_OBJECT for acl_trueform_scope, this attribute can be acquired in the same GETATTR as other ACL related attributes (acl/dacl/posix_access_acl/ posix_default_acl), so that the client knows which ACL attribute(s) are for the true form. For a server that returns a value other than ACL_SCOPE_FILE_OBJECT for acl_trueform_scope, this attribute need only be acquired once per file system (or for the entire mount). The reply value can then be used by the client to determine whether to GETATTR/READDIR of the acl/dacl attribute(s) or the posix_default_acl/posix_access_acl attribute(s) to avoid the server doing mapping between the true form and the requested form for the attribute. Macklem Expires 8 June 2026 [Page 10] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 9.2. Attribute 90: acl_trueform_scope Although the acl_trueform attribute is defined as a per-file system object attribute, some servers will be configured to provide the same acl_trueform reply for all file objects on either a file system or all file objects that share the same server owner (ie. per server). This attribute is a read-only attribute that describes what the actual scope of the acl_trueform attribute is for the file server. It MUST reflect the most specific scope supported across all file systems exported by the server. For example, if any exported file system supports ACL_SCOPE_FILE_OBJECT, the server MUST NOT report ACL_SCOPE_SERVER nor ACL_SCOPE_FILE_SYSTEM. It is a per server attribute. 9.2.1. Rationale For a value of ACL_SCOPE_FILE_OBJECT, the acl_trueform attribute can be acquired in the same GETATTR as other ACL related attributes (acl/dacl/posix_access_acl/posix_default_acl), so that the client knows which ACL attribute(s) are for the true form. For a value other than ACL_SCOPE_FILE_OBJECT, the acl_trueform attribute allows the client to choose whether to use the acl/dacl attribute or the posix_access_acl/posix_default_acl attributes when doing GETATTR/SETATTR/READDIR/OPEN/CREATE for servers that choose to support both the acl/dacl and posix_default_acl/posix_access_acl attributes for a file system. 9.3. Attribute 91: posix_default_acl This attribute specifies the POSIX default ACL for a directory. For the posixacetag4 values of POSIXACE4_TAG_USER_OBJ, POSIXACE4_TAG_GROUP_OBJ, POSIXACE4_TAG_MASK and POSIXACE4_TAG_OTHER the who field SHOULD be of zero length and MUST be ignored by the receiver. For the posixacetag4 values of POSIXACE4_TAG_USER and POSIXACE4_TAG_GROUP, the who field MUST be in the same format as would be used for the owner or owner_group attribute, respectively. If the server cannot translate the who string into a valid user or group, the server MUST reply NFS4ERR_BADOWNER. Since a POSIX default ACL only applies to directories, a SETATTR/OPEN/CREATE of the posix_default_acl for a non-directory object MUST reply NFS4ERR_INVAL. If SETATTR of a POSIX ACL for a non-zero length posixace4 array does not have one ACE for each of POSIXACE4_TAG_USER_OBJ, POSIXACE4_TAG_GROUP_OBJ and POSIXACE4_TAG_OTHER, the SETATTR of the ACL MUST reply NFS4ERR_INVAL. If SETATTR of a POSIX extended ACL does not have a POSIXACE4_TAG_MASK Macklem Expires 8 June 2026 [Page 11] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 ACE, the SETATTR of the ACL MUST reply NFS4ERR_INVAL. This attribute cannot be specified for the VERIFY or NVERIFY operations. If a client does so, the server MUST reply NFS4ERR_INVAL. For file servers that reply ACL_SCOPE_FILE_OBJECT for the acl_trueform_scope attribute, a successful setting of this attribute sets the value of acl_trueform to ACL_MODEL_POSIX_DRAFT. In addition, if the object's acl model had been ACL_MODEL_NFS4, any dacl (all ALLOW/DENY ACEs) will be deleted from the stored ACL. As noted above, any AUDIT/ALARM ACEs stored for the file object are not affected. Doing a SETATTR for a posix_default_acl of a zero length posixace4 array deletes the POSIX default ACL, if one exists. For file servers that reply ACL_SCOPE_FILE_OBJECT for the acl_trueform attribute and no POSIX access ACL exists for the directory, this SETATTR might set the file object's acl_trueform to ACL_MODEL_NONE. If a directory does not have a POSIX default ACL, a GETATTR/READDIR for the posix_default_acl attribute will reply with a posixace4 array of zero length. This attribute is a per-file system object attribute. 9.3.1. Rationale Without this optional attribute, for a file object whose true form is ACL_MODEL_POSIX_DRAFT, the server must map a NFSv4 ACL into a POSIX default ACL. It also must somehow combine the POSIX default ACL used for inheritance with the POSIX access ACL used for access control to the directory itself during the mapping, since a directory file object can only have, at most, one NFSv4 ACL. 9.4. Attribute 92: posix_access_acl This attribute specifies the POSIX access ACL for a file object. For a GETATTR/READDIR, if the acl_trueform is ACL_MODEL_NONE, the server MUST return a zero length posixace4 array. For the posixacetag4 values of POSIXACE4_TAG_USER_OBJ, POSIXACE4_TAG_GROUP_OBJ, POSIXACE4_TAG_MASK and POSIXACE4_TAG_OTHER the who field SHOULD be of zero length and MUST be ignored by the receiver. For the posixacetag4 values of POSIXACE4_TAG_USER and POSIXACE4_TAG_GROUP, the who field MUST be in the same format as would be used for the owner or owner_group attribute, respectively. If the server cannot translate the who string into a valid user or group, the server MUST reply NFS4ERR_BADOWNER. Macklem Expires 8 June 2026 [Page 12] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 For file servers that reply ACL_SCOPE_FILE_OBJECT for the acl_trueform_scope attribute, a successful setting of this attribute sets the value of acl_trueform to ACL_MODEL_POSIX_DRAFT. In addition, if the object's acl model had been ACL_MODEL_NFS4, any dacl (all ALLOW/DENY ACEs) will be deleted from the stored ACL. As noted above, any AUDIT/ALARM ACEs stored for the file object are not affected. For file servers that reply ACL_SCOPE_FILE_OBJECT for the acl_trueform_scope attribute, a successful SETATTR of a posix_access_acl with a posixace4 array of zero length deletes any POSIX access ACL stored on the file object. The deletion results in the file object having a acl_trueform value of ACL_MODEL_NONE. It also deletes any POSIX default ACL stored for the object, if it is a directory. For file servers that do not reply ACL_SCOPE_FILE_OBJECT for the acl_trueform_scope attribute, a server MUST reply NFS4ERR_INVAL for a SETATTR of a posix_access_acl with a posixace4 array of zero length. If SETATTR of a POSIX ACL does not have one ACE for each of POSIXACE4_TAG_USER_OBJ, POSIXACE4_TAG_GROUP_OBJ and POSIXACE4_TAG_OTHER, the SETATTR of the ACL MUST reply NFS4ERR_INVAL. If SETATTR of a POSIX extended ACL does not have a POSIXACE4_TAG_MASK ACE, the SETATTR of the ACL MUST reply NFS4ERR_INVAL. This attribute cannot be specified for the VERIFY or NVERIFY operations. If a client does so, the server MUST reply NFS4ERR_INVAL. This attribute is a per-file system object attribute. 9.4.1. Rationale Without this optional attribute, for a file object whose true form is ACL_MODEL_POSIX_DRAFT, the server must map a NFSv4 ACL into a POSIX access ACL. 10. XDR definitions for new attributes This document contains the External Data Representation (XDR) [RFC4506] description of the new OPTIONAL ACL related attributes. The XDR description is embedded in this document in a way that makes it simple for the reader to extract into a ready-to-compile form. The reader can feed this document into the following shell script to produce the machine-readable XDR description of the flexible file layout type: Macklem Expires 8 June 2026 [Page 13] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 #!/bin/sh grep '^ *///' $* | sed 's?^ */// ??' | sed 's?^ *///$??' That is, if the above script is stored in a file called "extract.sh" and this document is in a file called "spec.txt", then the reader can do: sh extract.sh < spec.txt > posix_acl_prot.x The effect of the script is to remove leading white space from each line, plus a sentinel sequence of "///". The embedded XDR file header follows. Note that the XDR code contained in this document depends on types from the NFSv4.1 and the nfs4_prot.x file [RFC5662]. This includes both nfs type utf8str_mixed, as well as the more generic type uint32_t. Macklem Expires 8 June 2026 [Page 14] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 /// enum aclmodel4 { /// ACL_MODEL_NFS4 = 1, /// ACL_MODEL_POSIX_DRAFT = 2, /// ACL_MODEL_NONE = 3 /// }; /// /// enum aclscope4 { /// ACL_SCOPE_FILE_OBJECT = 1, /// ACL_SCOPE_FILE_SYSTEM = 2, /// ACL_SCOPE_SERVER = 3 /// }; /// /// enum posixacetag4 { /// POSIXACE4_TAG_USER_OBJ = 1, /// POSIXACE4_TAG_USER = 2, /// POSIXACE4_TAG_GROUP_OBJ = 3, /// POSIXACE4_TAG_GROUP = 4, /// POSIXACE4_TAG_MASK = 5, /// POSIXACE4_TAG_OTHER = 6 /// }; /// /// typedef uint32_t posixaceperm4; /// /// /* Bit definitions for posixaceperm4. */ /// const POSIXACE4_PERM_EXECUTE = 0x00000001; /// const POSIXACE4_PERM_WRITE = 0x00000002; /// const POSIXACE4_PERM_READ = 0x00000004; /// /// struct posixace4 { /// posixacetag4 tag; /// posixaceperm4 perm; /// utf8str_mixed who; /// }; /// /// %/* /// % * New for POSIX ACL extension /// % */ /// const FATTR4_ACL_TRUEFORM = 89; /// const FATTR4_ACL_TRUEFORM_SCOPE = 90; /// const FATTR4_POSIX_DEFAULT_ACL = 91; /// const FATTR4_POSIX_ACCESS_ACL = 92; Macklem Expires 8 June 2026 [Page 15] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 11. Security Considerations ACLs are used to provide finer grained access control for file objects, which can be used to improve file system security. If the acl_trueform for a file object is ACL_MODEL_POSIX_DRAFT, these new attributes allow a client to set ACLs accurately, which should improve file system security when ACLs are used. 12. IANA Considerations This document has no IANA actions. 13. Implementation Status This section is to be removed before publishing as an RFC. This section records the status of known implementations of the protocol defined by this specification at the time of posting of this Internet-Draft. The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs. Please note that the listing of any individual implementation here does not imply endorsement by the IETF. Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors. This is not intended as, and must not be construed to be, a catalog of available implementations or their features. Readers are advised to note that other implementations may exist. 13.1. FreeBSD NFS server and client This section is to be removed before publishing as an RFC. Organization: FreeBSD Project URL: https://www.freebsd.org Maturity: Experimental software based on the current document. Coverage: The posix_default_acl and posix_access_acl attributes described in this document were implemented for a UFS file system configured to store POSIX ACLs as its true form. This experimental implementation does not explore the case of ACL_SCOPE_FILE_OBJECT. Licensing: BSD Macklem Expires 8 June 2026 [Page 16] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 Implementation experience: The setfacl and getfacl commands appeared to function correctly. 13.2. Linux kernel patch for the NFSv4 client and server This section is to be removed before publishing as an RFC. URL: https://people.freebsd.org/~rmacklem/linux-posixacl.patch Maturity: Experimental software based on the current document. Coverage: The patch provides the Linux internal inode operations for get_acl and set_acl. This allows the getfacl(1) and setfacl(1) commands to work against a server that implements these extensions. It also provides the internal modifications that allow the knfsd to handle the attributes described in this extension. Licensing: GPL Implementation experience: The setfacl and getfacl commands appeared to function correctly, when tested against the experimental FreeBSD server noted above. The same tests also worked against a patched Linux knfsd. ACLs with many ACEs have been tested and work. 14. References 14.1. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC4506] Eisler, M., Ed., "XDR: External Data Representation Standard", STD 67, RFC 4506, DOI 10.17487/RFC4506, May 2006, . [RFC5662] Shepler, S., Ed., Eisler, M., Ed., and D. Noveck, Ed., "Network File System (NFS) Version 4 Minor Version 1 External Data Representation Standard (XDR) Description", RFC 5662, DOI 10.17487/RFC5662, January 2010, . [RFC7862] Haynes, T., "Network File System (NFS) Version 4 Minor Version 2 Protocol", RFC 7862, DOI 10.17487/RFC7862, November 2016, . Macklem Expires 8 June 2026 [Page 17] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . [RFC8178] Noveck, D., "Rules for NFSv4 Extensions and Minor Versions", RFC 8178, DOI 10.17487/RFC8178, July 2017, . [RFC8275] Fields, J. and A. Gruenbacher, "Allowing Inheritable NFSv4 Access Control Entries to Override the Umask", RFC 8275, DOI 10.17487/RFC8275, December 2017, . [RFC8881] Noveck, D., Ed. and C. Lever, "Network File System (NFS) Version 4 Minor Version 1 Protocol", RFC 8881, DOI 10.17487/RFC8881, August 2020, . 14.2. Informational References [Eriksen] Eriksen, M. and J. Fields, "Mapping Between NFSv4 and Posix Draft ACLs", August 2006. [Gruenbacher] Grünbacher, A., "POSIX Access Control Lists on Linux", Proceedings of the FREENIX Track: 2003 USENIX Annual Technical Conference, pp. 259-272, ISBN 1-931971-11-0, January 2003. [IEEE] Institute of Electrical and Electronics Engineers, "IEEE 1003.1e and 1003.2c: Draft Standard for Information Technology--Portable Operating System Interface (POSIX)--Part 1: System Application Program Interface (API) and Part 2: Shell and Utilities, draft 17", October 1997. Acknowledgments Thanks go to David Noveck for pointing out that a per-file object scope for acl_trueform_scope was useful and to Frank Filz for noting that IBM's GPFS already does this. David Noveck also helped greatly with editorial corrections. Thanks also goes to Pali Rohár for assorted corrections, particularly with respect to the setting of a zero length NFSv4 ACL. Author's Address Macklem Expires 8 June 2026 [Page 18] Internet-Draft POSIX Draft ACL support for NFSv4.2 December 2025 Rick Macklem FreeBSD Project Canada Email: rmacklem@uoguelph.ca Macklem Expires 8 June 2026 [Page 19]