Page MenuHomeFreeBSD
Differential D58736

acl(9): expound on NFSv4 constants' meanings
Needs ReviewPublic
Actions

Authored by ngie on Aug 9 2026, 4:56 AM.
Tags
None
Referenced Files
Unknown Object (File)
Sat, Sep 12, 6:43 AM
Unknown Object (File)
Fri, Sep 11, 9:29 PM
Unknown Object (File)
Wed, Sep 9, 11:07 PM
Unknown Object (File)
Wed, Sep 9, 12:34 PM
Unknown Object (File)
Fri, Sep 4, 2:22 PM
Unknown Object (File)
Fri, Sep 4, 2:20 PM
Unknown Object (File)
Thu, Aug 27, 2:49 AM
Unknown Object (File)
Wed, Aug 26, 5:37 PM
View All 23 Files
Subscribers
asomers
imp
pjd
ziaee

Details

Reviewers
rmacklem
Group Reviewers
docs
Summary

This change adds missing documentation for various NFSv4 constants
supported by acl(9).

MFC after: 1 week

Test Plan

This missing documentation was discovered when reviewing APIs for pjdfstest: a PR put out by @asomers with a test that handles fine-grained NFSv4 ACL testing.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 75489
Build 72372: arc lint + arc unit

Event Timeline

ngie created this revision.Aug 9 2026, 4:56 AM
Herald added subscribers: ziaee, imp. · View Herald TranscriptAug 9 2026, 4:56 AM
ngie requested review of this revision.Aug 9 2026, 4:56 AM
Harbormaster completed remote builds in B75471: Diff 183709.Aug 9 2026, 4:56 AM
ngie edited the test plan for this revision. (Show Details)Aug 9 2026, 4:58 AM
ngie added a reviewer: docs.
ngie added subscribers: asomers, pjd.
ngie updated this revision to Diff 183748.Aug 9 2026, 11:23 PM

Handled typo separately in :main for cleanliness.

Harbormaster completed remote builds in B75489: Diff 183748.Aug 9 2026, 11:23 PM
ngie retitled this revision from acl(9): fix a typo and expound on constants' meanings to acl(9): expound on NFSv4 constants' meanings.Aug 9 2026, 11:24 PM
ngie edited the summary of this revision. (Show Details)
mhorne added a reviewer: rmacklem.Aug 11 2026, 2:35 PM
ngie added a comment.Tue, Sep 8, 3:17 PM

@rmacklem : ping?

rmacklem added a comment.Tue, Sep 8, 3:42 PM

These definitions should be taken verbatim from the
RFC (8881). To be honest, the only folk who actually
know what they mean work for Microsoft.
(NFSv4 ACLs are based on Windows ACLs and what
is in the RFC is taken verbatim from a Microsoft
document.)

For example, ACL_DELETE can apply to regular files
as well as directories. Now, for a POSIX system, does
it refer to deletion of a link or deletion of the file when
the last link is removed? (The most recent RFC, which is
8881 does handle this. Older ones did not. Hint, Windows
doesn't have multiple hard links, so removal of a name is
the same as removal of the file's data.)

Revision Contents
Changeset List

PathSize
share/
man/
man9/
9 lines

Diff 183748

View Options

share/man/man9/acl.9

Loading...