2 * Copyright (c) 2008-2010 Edward Tomasz NapieraĆa <trasz@FreeBSD.org>
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * ACL support routines specific to NFSv4 access control lists. These are
29 * utility routines for code common across file systems implementing NFSv4
34 #include <sys/cdefs.h>
35 __FBSDID("$FreeBSD$");
37 #include <sys/param.h>
38 #include <sys/systm.h>
39 #include <sys/mount.h>
41 #include <sys/vnode.h>
42 #include <sys/errno.h>
44 #include <sys/sysctl.h>
51 #define KASSERT(a, b) assert(a)
58 static void acl_nfs4_trivial_from_mode(struct acl *aclp, mode_t mode);
60 static int acl_nfs4_old_semantics = 0;
62 SYSCTL_INT(_vfs, OID_AUTO, acl_nfs4_old_semantics, CTLFLAG_RW,
63 &acl_nfs4_old_semantics, 0, "Use pre-PSARC/2010/029 NFSv4 ACL semantics");
68 } accmode2mask[] = {{VREAD, ACL_READ_DATA},
69 {VWRITE, ACL_WRITE_DATA},
70 {VAPPEND, ACL_APPEND_DATA},
72 {VREAD_NAMED_ATTRS, ACL_READ_NAMED_ATTRS},
73 {VWRITE_NAMED_ATTRS, ACL_WRITE_NAMED_ATTRS},
74 {VDELETE_CHILD, ACL_DELETE_CHILD},
75 {VREAD_ATTRIBUTES, ACL_READ_ATTRIBUTES},
76 {VWRITE_ATTRIBUTES, ACL_WRITE_ATTRIBUTES},
77 {VDELETE, ACL_DELETE},
78 {VREAD_ACL, ACL_READ_ACL},
79 {VWRITE_ACL, ACL_WRITE_ACL},
80 {VWRITE_OWNER, ACL_WRITE_OWNER},
81 {VSYNCHRONIZE, ACL_SYNCHRONIZE},
85 _access_mask_from_accmode(accmode_t accmode)
87 int access_mask = 0, i;
89 for (i = 0; accmode2mask[i].accmode != 0; i++) {
90 if (accmode & accmode2mask[i].accmode)
91 access_mask |= accmode2mask[i].mask;
95 * VAPPEND is just a modifier for VWRITE; if the caller asked
96 * for 'VAPPEND | VWRITE', we want to check for ACL_APPEND_DATA only.
98 if (access_mask & ACL_APPEND_DATA)
99 access_mask &= ~ACL_WRITE_DATA;
101 return (access_mask);
105 * Return 0, iff access is allowed, 1 otherwise.
108 _acl_denies(const struct acl *aclp, int access_mask, struct ucred *cred,
109 int file_uid, int file_gid, int *denied_explicitly)
112 const struct acl_entry *entry;
114 if (denied_explicitly != NULL)
115 *denied_explicitly = 0;
117 KASSERT(aclp->acl_cnt > 0, ("aclp->acl_cnt > 0"));
118 KASSERT(aclp->acl_cnt <= ACL_MAX_ENTRIES,
119 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
121 for (i = 0; i < aclp->acl_cnt; i++) {
122 entry = &(aclp->acl_entry[i]);
124 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
125 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
127 if (entry->ae_flags & ACL_ENTRY_INHERIT_ONLY)
129 switch (entry->ae_tag) {
131 if (file_uid != cred->cr_uid)
135 if (entry->ae_id != cred->cr_uid)
139 if (!groupmember(file_gid, cred))
143 if (!groupmember(entry->ae_id, cred))
147 KASSERT(entry->ae_tag == ACL_EVERYONE,
148 ("entry->ae_tag == ACL_EVERYONE"));
151 if (entry->ae_entry_type == ACL_ENTRY_TYPE_DENY) {
152 if (entry->ae_perm & access_mask) {
153 if (denied_explicitly != NULL)
154 *denied_explicitly = 1;
159 access_mask &= ~(entry->ae_perm);
160 if (access_mask == 0)
168 vaccess_acl_nfs4(enum vtype type, uid_t file_uid, gid_t file_gid,
169 struct acl *aclp, accmode_t accmode, struct ucred *cred, int *privused)
171 accmode_t priv_granted = 0;
172 int denied, explicitly_denied, access_mask, is_directory,
174 mode_t file_mode = 0;
176 KASSERT((accmode & ~(VEXEC | VWRITE | VREAD | VADMIN | VAPPEND |
177 VEXPLICIT_DENY | VREAD_NAMED_ATTRS | VWRITE_NAMED_ATTRS |
178 VDELETE_CHILD | VREAD_ATTRIBUTES | VWRITE_ATTRIBUTES | VDELETE |
179 VREAD_ACL | VWRITE_ACL | VWRITE_OWNER | VSYNCHRONIZE)) == 0,
180 ("invalid bit in accmode"));
181 KASSERT((accmode & VAPPEND) == 0 || (accmode & VWRITE),
182 ("VAPPEND without VWRITE"));
184 if (privused != NULL)
187 if (accmode & VADMIN)
191 * Ignore VSYNCHRONIZE permission.
193 accmode &= ~VSYNCHRONIZE;
195 access_mask = _access_mask_from_accmode(accmode);
203 * File owner is always allowed to read and write the ACL
204 * and basic attributes. This is to prevent a situation
205 * where user would change ACL in a way that prevents him
206 * from undoing the change.
208 if (file_uid == cred->cr_uid)
209 access_mask &= ~(ACL_READ_ACL | ACL_WRITE_ACL |
210 ACL_READ_ATTRIBUTES | ACL_WRITE_ATTRIBUTES);
213 * Ignore append permission for regular files; use write
214 * permission instead.
216 if (!is_directory && (access_mask & ACL_APPEND_DATA)) {
217 access_mask &= ~ACL_APPEND_DATA;
218 access_mask |= ACL_WRITE_DATA;
221 denied = _acl_denies(aclp, access_mask, cred, file_uid, file_gid,
225 if (file_uid != cred->cr_uid)
230 * For VEXEC, ensure that at least one execute bit is set for
231 * non-directories. We have to check the mode here to stay
232 * consistent with execve(2). See the test in
233 * exec_check_permissions().
235 acl_nfs4_sync_mode_from_acl(&file_mode, aclp);
236 if (!denied && !is_directory && (accmode & VEXEC) &&
237 (file_mode & (S_IXUSR | S_IXGRP | S_IXOTH)) == 0)
244 * Access failed. Iff it was not denied explicitly and
245 * VEXPLICIT_DENY flag was specified, allow access.
247 if ((accmode & VEXPLICIT_DENY) && explicitly_denied == 0)
250 accmode &= ~VEXPLICIT_DENY;
253 * No match. Try to use privileges, if there are any.
256 if ((accmode & VEXEC) && !priv_check_cred(cred,
258 priv_granted |= VEXEC;
261 * Ensure that at least one execute bit is on. Otherwise,
262 * a privileged user will always succeed, and we don't want
263 * this to happen unless the file really is executable.
265 if ((accmode & VEXEC) && (file_mode &
266 (S_IXUSR | S_IXGRP | S_IXOTH)) != 0 &&
267 !priv_check_cred(cred, PRIV_VFS_EXEC, 0))
268 priv_granted |= VEXEC;
271 if ((accmode & VREAD) && !priv_check_cred(cred, PRIV_VFS_READ, 0))
272 priv_granted |= VREAD;
274 if ((accmode & (VWRITE | VAPPEND | VDELETE_CHILD)) &&
275 !priv_check_cred(cred, PRIV_VFS_WRITE, 0))
276 priv_granted |= (VWRITE | VAPPEND | VDELETE_CHILD);
278 if ((accmode & VADMIN_PERMS) &&
279 !priv_check_cred(cred, PRIV_VFS_ADMIN, 0))
280 priv_granted |= VADMIN_PERMS;
282 if ((accmode & VSTAT_PERMS) &&
283 !priv_check_cred(cred, PRIV_VFS_STAT, 0))
284 priv_granted |= VSTAT_PERMS;
286 if ((accmode & priv_granted) == accmode) {
287 if (privused != NULL)
293 if (accmode & (VADMIN_PERMS | VDELETE_CHILD | VDELETE))
303 _acl_entry_matches(struct acl_entry *entry, acl_tag_t tag, acl_perm_t perm,
304 acl_entry_type_t entry_type)
306 if (entry->ae_tag != tag)
309 if (entry->ae_id != ACL_UNDEFINED_ID)
312 if (entry->ae_perm != perm)
315 if (entry->ae_entry_type != entry_type)
318 if (entry->ae_flags != 0)
324 static struct acl_entry *
325 _acl_append(struct acl *aclp, acl_tag_t tag, acl_perm_t perm,
326 acl_entry_type_t entry_type)
328 struct acl_entry *entry;
330 KASSERT(aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES,
331 ("aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES"));
333 entry = &(aclp->acl_entry[aclp->acl_cnt]);
337 entry->ae_id = ACL_UNDEFINED_ID;
338 entry->ae_perm = perm;
339 entry->ae_entry_type = entry_type;
345 static struct acl_entry *
346 _acl_duplicate_entry(struct acl *aclp, int entry_index)
350 KASSERT(aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES,
351 ("aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES"));
353 for (i = aclp->acl_cnt; i > entry_index; i--)
354 aclp->acl_entry[i] = aclp->acl_entry[i - 1];
358 return (&(aclp->acl_entry[entry_index + 1]));
362 acl_nfs4_sync_acl_from_mode_draft(struct acl *aclp, mode_t mode,
365 int i, meets, must_append;
366 struct acl_entry *entry, *copy, *previous,
367 *a1, *a2, *a3, *a4, *a5, *a6;
370 const int WRITE = 02;
373 KASSERT(aclp->acl_cnt <= ACL_MAX_ENTRIES,
374 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
377 * NFSv4 Minor Version 1, draft-ietf-nfsv4-minorversion1-03.txt
379 * 3.16.6.3. Applying a Mode to an Existing ACL
385 for (i = 0; i < aclp->acl_cnt; i++) {
386 entry = &(aclp->acl_entry[i]);
389 * 1.1. If the type is neither ALLOW or DENY - skip.
391 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
392 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
396 * 1.2. If ACL_ENTRY_INHERIT_ONLY is set - skip.
398 if (entry->ae_flags & ACL_ENTRY_INHERIT_ONLY)
402 * 1.3. If ACL_ENTRY_FILE_INHERIT or ACL_ENTRY_DIRECTORY_INHERIT
405 if (entry->ae_flags &
406 (ACL_ENTRY_FILE_INHERIT | ACL_ENTRY_DIRECTORY_INHERIT)) {
408 * 1.3.1. A copy of the current ACE is made, and placed
409 * in the ACL immediately following the current
412 copy = _acl_duplicate_entry(aclp, i);
415 * 1.3.2. In the first ACE, the flag
416 * ACL_ENTRY_INHERIT_ONLY is set.
418 entry->ae_flags |= ACL_ENTRY_INHERIT_ONLY;
421 * 1.3.3. In the second ACE, the following flags
423 * ACL_ENTRY_FILE_INHERIT,
424 * ACL_ENTRY_DIRECTORY_INHERIT,
425 * ACL_ENTRY_NO_PROPAGATE_INHERIT.
427 copy->ae_flags &= ~(ACL_ENTRY_FILE_INHERIT |
428 ACL_ENTRY_DIRECTORY_INHERIT |
429 ACL_ENTRY_NO_PROPAGATE_INHERIT);
432 * The algorithm continues on with the second ACE.
439 * 1.4. If it's owner@, group@ or everyone@ entry, clear
440 * ACL_READ_DATA, ACL_WRITE_DATA, ACL_APPEND_DATA
441 * and ACL_EXECUTE. Continue to the next entry.
443 if (entry->ae_tag == ACL_USER_OBJ ||
444 entry->ae_tag == ACL_GROUP_OBJ ||
445 entry->ae_tag == ACL_EVERYONE) {
446 entry->ae_perm &= ~(ACL_READ_DATA | ACL_WRITE_DATA |
447 ACL_APPEND_DATA | ACL_EXECUTE);
452 * 1.5. Otherwise, if the "who" field did not match one
453 * of OWNER@, GROUP@, EVERYONE@:
455 * 1.5.1. If the type is ALLOW, check the preceding ACE.
456 * If it does not meet all of the following criteria:
458 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW)
464 previous = &(aclp->acl_entry[i - 1]);
467 * 1.5.1.1. The type field is DENY,
469 if (previous->ae_entry_type != ACL_ENTRY_TYPE_DENY)
473 * 1.5.1.2. The "who" field is the same as the current
476 * 1.5.1.3. The flag bit ACE4_IDENTIFIER_GROUP
477 * is the same as it is in the current ACE,
478 * and no other flag bits are set,
480 if (previous->ae_id != entry->ae_id ||
481 previous->ae_tag != entry->ae_tag)
484 if (previous->ae_flags)
488 * 1.5.1.4. The mask bits are a subset of the mask bits
489 * of the current ACE, and are also subset of
490 * the following: ACL_READ_DATA,
491 * ACL_WRITE_DATA, ACL_APPEND_DATA, ACL_EXECUTE
493 if (previous->ae_perm & ~(entry->ae_perm))
496 if (previous->ae_perm & ~(ACL_READ_DATA |
497 ACL_WRITE_DATA | ACL_APPEND_DATA | ACL_EXECUTE))
503 * Then the ACE of type DENY, with a who equal
504 * to the current ACE, flag bits equal to
505 * (<current ACE flags> & <ACE_IDENTIFIER_GROUP>)
506 * and no mask bits, is prepended.
509 entry = _acl_duplicate_entry(aclp, i);
511 /* Adjust counter, as we've just added an entry. */
514 previous->ae_tag = entry->ae_tag;
515 previous->ae_id = entry->ae_id;
516 previous->ae_flags = entry->ae_flags;
517 previous->ae_perm = 0;
518 previous->ae_entry_type = ACL_ENTRY_TYPE_DENY;
522 * 1.5.2. The following modifications are made to the prepended
523 * ACE. The intent is to mask the following ACE
524 * to disallow ACL_READ_DATA, ACL_WRITE_DATA,
525 * ACL_APPEND_DATA, or ACL_EXECUTE, based upon the group
526 * permissions of the new mode. As a special case,
527 * if the ACE matches the current owner of the file,
528 * the owner bits are used, rather than the group bits.
529 * This is reflected in the algorithm below.
534 * If ACE4_IDENTIFIER_GROUP is not set, and the "who" field
535 * in ACE matches the owner of the file, we shift amode three
536 * more bits, in order to have the owner permission bits
537 * placed in the three low order bits of amode.
539 if (entry->ae_tag == ACL_USER && entry->ae_id == file_owner_id)
542 if (entry->ae_perm & ACL_READ_DATA) {
544 previous->ae_perm &= ~ACL_READ_DATA;
546 previous->ae_perm |= ACL_READ_DATA;
549 if (entry->ae_perm & ACL_WRITE_DATA) {
551 previous->ae_perm &= ~ACL_WRITE_DATA;
553 previous->ae_perm |= ACL_WRITE_DATA;
556 if (entry->ae_perm & ACL_APPEND_DATA) {
558 previous->ae_perm &= ~ACL_APPEND_DATA;
560 previous->ae_perm |= ACL_APPEND_DATA;
563 if (entry->ae_perm & ACL_EXECUTE) {
565 previous->ae_perm &= ~ACL_EXECUTE;
567 previous->ae_perm |= ACL_EXECUTE;
571 * 1.5.3. If ACE4_IDENTIFIER_GROUP is set in the flags
574 * XXX: This point is not there in the Falkner's draft.
576 if (entry->ae_tag == ACL_GROUP &&
577 entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW) {
578 mode_t extramode, ownermode;
579 extramode = (mode >> 3) & 07;
580 ownermode = mode >> 6;
581 extramode &= ~ownermode;
584 if (extramode & READ) {
585 entry->ae_perm &= ~ACL_READ_DATA;
586 previous->ae_perm &= ~ACL_READ_DATA;
589 if (extramode & WRITE) {
591 ~(ACL_WRITE_DATA | ACL_APPEND_DATA);
593 ~(ACL_WRITE_DATA | ACL_APPEND_DATA);
596 if (extramode & EXEC) {
597 entry->ae_perm &= ~ACL_EXECUTE;
598 previous->ae_perm &= ~ACL_EXECUTE;
605 * 2. If there at least six ACEs, the final six ACEs are examined.
606 * If they are not equal to what we want, append six ACEs.
609 if (aclp->acl_cnt < 6) {
612 a6 = &(aclp->acl_entry[aclp->acl_cnt - 1]);
613 a5 = &(aclp->acl_entry[aclp->acl_cnt - 2]);
614 a4 = &(aclp->acl_entry[aclp->acl_cnt - 3]);
615 a3 = &(aclp->acl_entry[aclp->acl_cnt - 4]);
616 a2 = &(aclp->acl_entry[aclp->acl_cnt - 5]);
617 a1 = &(aclp->acl_entry[aclp->acl_cnt - 6]);
619 if (!_acl_entry_matches(a1, ACL_USER_OBJ, 0,
620 ACL_ENTRY_TYPE_DENY))
622 if (!_acl_entry_matches(a2, ACL_USER_OBJ, ACL_WRITE_ACL |
623 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
624 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_ALLOW))
626 if (!_acl_entry_matches(a3, ACL_GROUP_OBJ, 0,
627 ACL_ENTRY_TYPE_DENY))
629 if (!_acl_entry_matches(a4, ACL_GROUP_OBJ, 0,
630 ACL_ENTRY_TYPE_ALLOW))
632 if (!_acl_entry_matches(a5, ACL_EVERYONE, ACL_WRITE_ACL |
633 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
634 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_DENY))
636 if (!_acl_entry_matches(a6, ACL_EVERYONE, ACL_READ_ACL |
637 ACL_READ_ATTRIBUTES | ACL_READ_NAMED_ATTRS |
638 ACL_SYNCHRONIZE, ACL_ENTRY_TYPE_ALLOW))
643 KASSERT(aclp->acl_cnt + 6 <= ACL_MAX_ENTRIES,
644 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
646 a1 = _acl_append(aclp, ACL_USER_OBJ, 0, ACL_ENTRY_TYPE_DENY);
647 a2 = _acl_append(aclp, ACL_USER_OBJ, ACL_WRITE_ACL |
648 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
649 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_ALLOW);
650 a3 = _acl_append(aclp, ACL_GROUP_OBJ, 0, ACL_ENTRY_TYPE_DENY);
651 a4 = _acl_append(aclp, ACL_GROUP_OBJ, 0, ACL_ENTRY_TYPE_ALLOW);
652 a5 = _acl_append(aclp, ACL_EVERYONE, ACL_WRITE_ACL |
653 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
654 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_DENY);
655 a6 = _acl_append(aclp, ACL_EVERYONE, ACL_READ_ACL |
656 ACL_READ_ATTRIBUTES | ACL_READ_NAMED_ATTRS |
657 ACL_SYNCHRONIZE, ACL_ENTRY_TYPE_ALLOW);
659 KASSERT(a1 != NULL && a2 != NULL && a3 != NULL && a4 != NULL &&
660 a5 != NULL && a6 != NULL, ("couldn't append to ACL."));
664 * 3. The final six ACEs are adjusted according to the incoming mode.
667 a2->ae_perm |= ACL_READ_DATA;
669 a1->ae_perm |= ACL_READ_DATA;
671 a2->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
673 a1->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
675 a2->ae_perm |= ACL_EXECUTE;
677 a1->ae_perm |= ACL_EXECUTE;
680 a4->ae_perm |= ACL_READ_DATA;
682 a3->ae_perm |= ACL_READ_DATA;
684 a4->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
686 a3->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
688 a4->ae_perm |= ACL_EXECUTE;
690 a3->ae_perm |= ACL_EXECUTE;
693 a6->ae_perm |= ACL_READ_DATA;
695 a5->ae_perm |= ACL_READ_DATA;
697 a6->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
699 a5->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
701 a6->ae_perm |= ACL_EXECUTE;
703 a5->ae_perm |= ACL_EXECUTE;
708 acl_nfs4_sync_acl_from_mode(struct acl *aclp, mode_t mode,
712 if (acl_nfs4_old_semantics)
713 acl_nfs4_sync_acl_from_mode_draft(aclp, mode, file_owner_id);
715 acl_nfs4_trivial_from_mode(aclp, mode);
720 acl_nfs4_sync_mode_from_acl(mode_t *_mode, const struct acl *aclp)
723 mode_t old_mode = *_mode, mode = 0, seen = 0;
724 const struct acl_entry *entry;
726 KASSERT(aclp->acl_cnt > 0, ("aclp->acl_cnt > 0"));
727 KASSERT(aclp->acl_cnt <= ACL_MAX_ENTRIES,
728 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
731 * NFSv4 Minor Version 1, draft-ietf-nfsv4-minorversion1-03.txt
733 * 3.16.6.1. Recomputing mode upon SETATTR of ACL
736 for (i = 0; i < aclp->acl_cnt; i++) {
737 entry = &(aclp->acl_entry[i]);
739 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
740 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
743 if (entry->ae_flags & ACL_ENTRY_INHERIT_ONLY)
746 if (entry->ae_tag == ACL_USER_OBJ) {
747 if ((entry->ae_perm & ACL_READ_DATA) &&
748 ((seen & S_IRUSR) == 0)) {
750 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
753 if ((entry->ae_perm & ACL_WRITE_DATA) &&
754 ((seen & S_IWUSR) == 0)) {
756 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
759 if ((entry->ae_perm & ACL_EXECUTE) &&
760 ((seen & S_IXUSR) == 0)) {
762 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
765 } else if (entry->ae_tag == ACL_GROUP_OBJ) {
766 if ((entry->ae_perm & ACL_READ_DATA) &&
767 ((seen & S_IRGRP) == 0)) {
769 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
772 if ((entry->ae_perm & ACL_WRITE_DATA) &&
773 ((seen & S_IWGRP) == 0)) {
775 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
778 if ((entry->ae_perm & ACL_EXECUTE) &&
779 ((seen & S_IXGRP) == 0)) {
781 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
784 } else if (entry->ae_tag == ACL_EVERYONE) {
785 if (entry->ae_perm & ACL_READ_DATA) {
786 if ((seen & S_IRUSR) == 0) {
788 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
791 if ((seen & S_IRGRP) == 0) {
793 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
796 if ((seen & S_IROTH) == 0) {
798 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
802 if (entry->ae_perm & ACL_WRITE_DATA) {
803 if ((seen & S_IWUSR) == 0) {
805 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
808 if ((seen & S_IWGRP) == 0) {
810 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
813 if ((seen & S_IWOTH) == 0) {
815 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
819 if (entry->ae_perm & ACL_EXECUTE) {
820 if ((seen & S_IXUSR) == 0) {
822 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
825 if ((seen & S_IXGRP) == 0) {
827 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
830 if ((seen & S_IXOTH) == 0) {
832 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
839 *_mode = mode | (old_mode & ACL_PRESERVE_MASK);
844 * Calculate inherited ACL in a manner compatible with NFSv4 Minor Version 1,
845 * draft-ietf-nfsv4-minorversion1-03.txt.
848 acl_nfs4_compute_inherited_acl_draft(const struct acl *parent_aclp,
849 struct acl *child_aclp, mode_t mode, int file_owner_id,
853 const struct acl_entry *parent_entry;
854 struct acl_entry *entry, *copy;
856 KASSERT(child_aclp->acl_cnt == 0, ("child_aclp->acl_cnt == 0"));
857 KASSERT(parent_aclp->acl_cnt > 0, ("parent_aclp->acl_cnt > 0"));
858 KASSERT(parent_aclp->acl_cnt <= ACL_MAX_ENTRIES,
859 ("parent_aclp->acl_cnt <= ACL_MAX_ENTRIES"));
862 * NFSv4 Minor Version 1, draft-ietf-nfsv4-minorversion1-03.txt
864 * 3.16.6.2. Applying the mode given to CREATE or OPEN
865 * to an inherited ACL
869 * 1. Form an ACL that is the concatenation of all inheritable ACEs.
871 for (i = 0; i < parent_aclp->acl_cnt; i++) {
872 parent_entry = &(parent_aclp->acl_entry[i]);
873 flags = parent_entry->ae_flags;
876 * Entry is not inheritable at all.
878 if ((flags & (ACL_ENTRY_DIRECTORY_INHERIT |
879 ACL_ENTRY_FILE_INHERIT)) == 0)
883 * We're creating a file, but entry is not inheritable
886 if (!is_directory && (flags & ACL_ENTRY_FILE_INHERIT) == 0)
890 * Entry is inheritable only by files, but has NO_PROPAGATE
891 * flag set, and we're creating a directory, so it wouldn't
892 * propagate to any file in that directory anyway.
895 (flags & ACL_ENTRY_DIRECTORY_INHERIT) == 0 &&
896 (flags & ACL_ENTRY_NO_PROPAGATE_INHERIT))
899 KASSERT(child_aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES,
900 ("child_aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES"));
901 child_aclp->acl_entry[child_aclp->acl_cnt] = *parent_entry;
902 child_aclp->acl_cnt++;
906 * 2. For each entry in the new ACL, adjust its flags, possibly
907 * creating two entries in place of one.
909 for (i = 0; i < child_aclp->acl_cnt; i++) {
910 entry = &(child_aclp->acl_entry[i]);
913 * This is not in the specification, but SunOS
914 * apparently does that.
916 if (((entry->ae_flags & ACL_ENTRY_NO_PROPAGATE_INHERIT) ||
918 entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
919 entry->ae_perm &= ~(ACL_WRITE_ACL | ACL_WRITE_OWNER);
922 * 2.A. If the ACL_ENTRY_NO_PROPAGATE_INHERIT is set, or if the object
923 * being created is not a directory, then clear the
924 * following flags: ACL_ENTRY_NO_PROPAGATE_INHERIT,
925 * ACL_ENTRY_FILE_INHERIT, ACL_ENTRY_DIRECTORY_INHERIT,
926 * ACL_ENTRY_INHERIT_ONLY.
928 if (entry->ae_flags & ACL_ENTRY_NO_PROPAGATE_INHERIT ||
930 entry->ae_flags &= ~(ACL_ENTRY_NO_PROPAGATE_INHERIT |
931 ACL_ENTRY_FILE_INHERIT | ACL_ENTRY_DIRECTORY_INHERIT |
932 ACL_ENTRY_INHERIT_ONLY);
935 * Continue on to the next ACE.
941 * 2.B. If the object is a directory and ACL_ENTRY_FILE_INHERIT
942 * is set, but ACL_ENTRY_NO_PROPAGATE_INHERIT is not set, ensure
943 * that ACL_ENTRY_INHERIT_ONLY is set. Continue to the
944 * next ACE. Otherwise...
947 * XXX: Read it again and make sure what does the "otherwise"
951 (entry->ae_flags & ACL_ENTRY_FILE_INHERIT) &&
952 ((entry->ae_flags & ACL_ENTRY_DIRECTORY_INHERIT) == 0)) {
953 entry->ae_flags |= ACL_ENTRY_INHERIT_ONLY;
958 * 2.C. If the type of the ACE is neither ALLOW nor deny,
961 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
962 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
966 * 2.D. Copy the original ACE into a second, adjacent ACE.
968 copy = _acl_duplicate_entry(child_aclp, i);
971 * 2.E. On the first ACE, ensure that ACL_ENTRY_INHERIT_ONLY
974 entry->ae_flags |= ACL_ENTRY_INHERIT_ONLY;
977 * 2.F. On the second ACE, clear the following flags:
978 * ACL_ENTRY_NO_PROPAGATE_INHERIT, ACL_ENTRY_FILE_INHERIT,
979 * ACL_ENTRY_DIRECTORY_INHERIT, ACL_ENTRY_INHERIT_ONLY.
981 copy->ae_flags &= ~(ACL_ENTRY_NO_PROPAGATE_INHERIT |
982 ACL_ENTRY_FILE_INHERIT | ACL_ENTRY_DIRECTORY_INHERIT |
983 ACL_ENTRY_INHERIT_ONLY);
986 * 2.G. On the second ACE, if the type is ALLOW,
987 * an implementation MAY clear the following
988 * mask bits: ACL_WRITE_ACL, ACL_WRITE_OWNER.
990 if (copy->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
991 copy->ae_perm &= ~(ACL_WRITE_ACL | ACL_WRITE_OWNER);
994 * Increment the counter to skip the copied entry.
1000 * 3. To ensure that the mode is honored, apply the algorithm describe
1001 * in Section 2.16.6.3, using the mode that is to be used for file
1004 acl_nfs4_sync_acl_from_mode(child_aclp, mode, file_owner_id);
1006 #endif /* _KERNEL */
1009 * Populate the ACL with entries inherited from parent_aclp.
1012 acl_nfs4_inherit_entries(const struct acl *parent_aclp,
1013 struct acl *child_aclp, mode_t mode, int file_owner_id,
1017 const struct acl_entry *parent_entry;
1018 struct acl_entry *entry;
1020 KASSERT(parent_aclp->acl_cnt > 0, ("parent_aclp->acl_cnt > 0"));
1021 KASSERT(parent_aclp->acl_cnt <= ACL_MAX_ENTRIES,
1022 ("parent_aclp->acl_cnt <= ACL_MAX_ENTRIES"));
1024 for (i = 0; i < parent_aclp->acl_cnt; i++) {
1025 parent_entry = &(parent_aclp->acl_entry[i]);
1026 flags = parent_entry->ae_flags;
1027 tag = parent_entry->ae_tag;
1030 * Don't inherit owner@, group@, or everyone@ entries.
1032 if (tag == ACL_USER_OBJ || tag == ACL_GROUP_OBJ ||
1033 tag == ACL_EVERYONE)
1037 * Entry is not inheritable at all.
1039 if ((flags & (ACL_ENTRY_DIRECTORY_INHERIT |
1040 ACL_ENTRY_FILE_INHERIT)) == 0)
1044 * We're creating a file, but entry is not inheritable
1047 if (!is_directory && (flags & ACL_ENTRY_FILE_INHERIT) == 0)
1051 * Entry is inheritable only by files, but has NO_PROPAGATE
1052 * flag set, and we're creating a directory, so it wouldn't
1053 * propagate to any file in that directory anyway.
1056 (flags & ACL_ENTRY_DIRECTORY_INHERIT) == 0 &&
1057 (flags & ACL_ENTRY_NO_PROPAGATE_INHERIT))
1061 * Entry qualifies for being inherited.
1063 KASSERT(child_aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES,
1064 ("child_aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES"));
1065 entry = &(child_aclp->acl_entry[child_aclp->acl_cnt]);
1066 *entry = *parent_entry;
1067 child_aclp->acl_cnt++;
1069 entry->ae_flags &= ~ACL_ENTRY_INHERIT_ONLY;
1072 * If the type of the ACE is neither ALLOW nor DENY,
1073 * then leave it as it is and proceed to the next one.
1075 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
1076 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
1080 * If the ACL_ENTRY_NO_PROPAGATE_INHERIT is set, or if
1081 * the object being created is not a directory, then clear
1082 * the following flags: ACL_ENTRY_NO_PROPAGATE_INHERIT,
1083 * ACL_ENTRY_FILE_INHERIT, ACL_ENTRY_DIRECTORY_INHERIT,
1084 * ACL_ENTRY_INHERIT_ONLY.
1086 if (entry->ae_flags & ACL_ENTRY_NO_PROPAGATE_INHERIT ||
1088 entry->ae_flags &= ~(ACL_ENTRY_NO_PROPAGATE_INHERIT |
1089 ACL_ENTRY_FILE_INHERIT | ACL_ENTRY_DIRECTORY_INHERIT |
1090 ACL_ENTRY_INHERIT_ONLY);
1094 * If the object is a directory and ACL_ENTRY_FILE_INHERIT
1095 * is set, but ACL_ENTRY_DIRECTORY_INHERIT is not set, ensure
1096 * that ACL_ENTRY_INHERIT_ONLY is set.
1099 (entry->ae_flags & ACL_ENTRY_FILE_INHERIT) &&
1100 ((entry->ae_flags & ACL_ENTRY_DIRECTORY_INHERIT) == 0)) {
1101 entry->ae_flags |= ACL_ENTRY_INHERIT_ONLY;
1104 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW &&
1105 (entry->ae_flags & ACL_ENTRY_INHERIT_ONLY) == 0) {
1107 * Some permissions must never be inherited.
1109 entry->ae_perm &= ~(ACL_WRITE_ACL | ACL_WRITE_OWNER |
1110 ACL_WRITE_NAMED_ATTRS | ACL_WRITE_ATTRIBUTES);
1113 * Others must be masked according to the file mode.
1115 if ((mode & S_IRGRP) == 0)
1116 entry->ae_perm &= ~ACL_READ_DATA;
1117 if ((mode & S_IWGRP) == 0)
1119 ~(ACL_WRITE_DATA | ACL_APPEND_DATA);
1120 if ((mode & S_IXGRP) == 0)
1121 entry->ae_perm &= ~ACL_EXECUTE;
1127 * Calculate inherited ACL in a manner compatible with PSARC/2010/029.
1128 * It's also being used to calculate a trivial ACL, by inheriting from
1132 acl_nfs4_compute_inherited_acl_psarc(const struct acl *parent_aclp,
1133 struct acl *aclp, mode_t mode, int file_owner_id, int is_directory)
1135 acl_perm_t user_allow_first = 0, user_deny = 0, group_deny = 0;
1136 acl_perm_t user_allow, group_allow, everyone_allow;
1138 KASSERT(aclp->acl_cnt == 0, ("aclp->acl_cnt == 0"));
1140 user_allow = group_allow = everyone_allow = ACL_READ_ACL |
1141 ACL_READ_ATTRIBUTES | ACL_READ_NAMED_ATTRS | ACL_SYNCHRONIZE;
1142 user_allow |= ACL_WRITE_ACL | ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
1143 ACL_WRITE_NAMED_ATTRS;
1146 user_allow |= ACL_READ_DATA;
1148 user_allow |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
1150 user_allow |= ACL_EXECUTE;
1153 group_allow |= ACL_READ_DATA;
1155 group_allow |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
1157 group_allow |= ACL_EXECUTE;
1160 everyone_allow |= ACL_READ_DATA;
1162 everyone_allow |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
1164 everyone_allow |= ACL_EXECUTE;
1166 user_deny = ((group_allow | everyone_allow) & ~user_allow);
1167 group_deny = everyone_allow & ~group_allow;
1168 user_allow_first = group_deny & ~user_deny;
1170 if (user_allow_first != 0)
1171 _acl_append(aclp, ACL_USER_OBJ, user_allow_first,
1172 ACL_ENTRY_TYPE_ALLOW);
1174 _acl_append(aclp, ACL_USER_OBJ, user_deny,
1175 ACL_ENTRY_TYPE_DENY);
1176 if (group_deny != 0)
1177 _acl_append(aclp, ACL_GROUP_OBJ, group_deny,
1178 ACL_ENTRY_TYPE_DENY);
1180 if (parent_aclp != NULL)
1181 acl_nfs4_inherit_entries(parent_aclp, aclp, mode,
1182 file_owner_id, is_directory);
1184 _acl_append(aclp, ACL_USER_OBJ, user_allow, ACL_ENTRY_TYPE_ALLOW);
1185 _acl_append(aclp, ACL_GROUP_OBJ, group_allow, ACL_ENTRY_TYPE_ALLOW);
1186 _acl_append(aclp, ACL_EVERYONE, everyone_allow, ACL_ENTRY_TYPE_ALLOW);
1191 acl_nfs4_compute_inherited_acl(const struct acl *parent_aclp,
1192 struct acl *child_aclp, mode_t mode, int file_owner_id,
1196 if (acl_nfs4_old_semantics)
1197 acl_nfs4_compute_inherited_acl_draft(parent_aclp, child_aclp,
1198 mode, file_owner_id, is_directory);
1200 acl_nfs4_compute_inherited_acl_psarc(parent_aclp, child_aclp,
1201 mode, file_owner_id, is_directory);
1203 #endif /* _KERNEL */
1206 * Calculate trivial ACL in a manner compatible with PSARC/2010/029.
1207 * Note that this results in an ACL different from (but semantically
1208 * equal to) the "canonical six" trivial ACL computed using algorithm
1209 * described in draft-ietf-nfsv4-minorversion1-03.txt, 3.16.6.2.
1212 acl_nfs4_trivial_from_mode(struct acl *aclp, mode_t mode)
1216 acl_nfs4_compute_inherited_acl_psarc(NULL, aclp, mode, -1, -1);
1221 * This routine is used by libc to implement acl_strip_np(3)
1222 * and acl_is_trivial_np(3).
1225 acl_nfs4_trivial_from_mode_libc(struct acl *aclp, int mode, int canonical_six)
1230 acl_nfs4_sync_acl_from_mode_draft(aclp, mode, -1);
1232 acl_nfs4_trivial_from_mode(aclp, mode);
1234 #endif /* !_KERNEL */
1238 _acls_are_equal(const struct acl *a, const struct acl *b)
1241 const struct acl_entry *entrya, *entryb;
1243 if (a->acl_cnt != b->acl_cnt)
1246 for (i = 0; i < b->acl_cnt; i++) {
1247 entrya = &(a->acl_entry[i]);
1248 entryb = &(b->acl_entry[i]);
1250 if (entrya->ae_tag != entryb->ae_tag ||
1251 entrya->ae_id != entryb->ae_id ||
1252 entrya->ae_perm != entryb->ae_perm ||
1253 entrya->ae_entry_type != entryb->ae_entry_type ||
1254 entrya->ae_flags != entryb->ae_flags)
1262 * This routine is used to determine whether to remove extended attribute
1263 * that stores ACL contents.
1266 acl_nfs4_is_trivial(const struct acl *aclp, int file_owner_id)
1270 struct acl *tmpaclp;
1272 if (aclp->acl_cnt > 6)
1276 * Compute the mode from the ACL, then compute new ACL from that mode.
1277 * If the ACLs are identical, then the ACL is trivial.
1279 * XXX: I guess there is a faster way to do this. However, even
1280 * this slow implementation significantly speeds things up
1281 * for files that don't have non-trivial ACLs - it's critical
1282 * for performance to not use EA when they are not needed.
1284 * First try the PSARC/2010/029 semantics.
1286 tmpaclp = acl_alloc(M_WAITOK | M_ZERO);
1287 acl_nfs4_sync_mode_from_acl(&tmpmode, aclp);
1288 acl_nfs4_trivial_from_mode(tmpaclp, tmpmode);
1289 trivial = _acls_are_equal(aclp, tmpaclp);
1296 * Check if it's a draft-ietf-nfsv4-minorversion1-03.txt trivial ACL.
1298 tmpaclp->acl_cnt = 0;
1299 acl_nfs4_sync_acl_from_mode_draft(tmpaclp, tmpmode, file_owner_id);
1300 trivial = _acls_are_equal(aclp, tmpaclp);
1305 #endif /* _KERNEL */
1308 acl_nfs4_check(const struct acl *aclp, int is_directory)
1311 const struct acl_entry *entry;
1314 * The spec doesn't seem to say anything about ACL validity.
1315 * It seems there is not much to do here. There is even no need
1316 * to count "owner@" or "everyone@" (ACL_USER_OBJ and ACL_EVERYONE)
1317 * entries, as there can be several of them and that's perfectly
1318 * valid. There can be none of them too. Really.
1321 if (aclp->acl_cnt > ACL_MAX_ENTRIES || aclp->acl_cnt <= 0)
1324 for (i = 0; i < aclp->acl_cnt; i++) {
1325 entry = &(aclp->acl_entry[i]);
1327 switch (entry->ae_tag) {
1331 if (entry->ae_id != ACL_UNDEFINED_ID)
1337 if (entry->ae_id == ACL_UNDEFINED_ID)
1345 if ((entry->ae_perm | ACL_NFS4_PERM_BITS) != ACL_NFS4_PERM_BITS)
1349 * Disallow ACL_ENTRY_TYPE_AUDIT and ACL_ENTRY_TYPE_ALARM for now.
1351 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
1352 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
1355 if ((entry->ae_flags | ACL_FLAGS_BITS) != ACL_FLAGS_BITS)
1358 /* Disallow unimplemented flags. */
1359 if (entry->ae_flags & (ACL_ENTRY_SUCCESSFUL_ACCESS |
1360 ACL_ENTRY_FAILED_ACCESS))
1363 /* Disallow flags not allowed for ordinary files. */
1364 if (!is_directory) {
1365 if (entry->ae_flags & (ACL_ENTRY_FILE_INHERIT |
1366 ACL_ENTRY_DIRECTORY_INHERIT |
1367 ACL_ENTRY_NO_PROPAGATE_INHERIT | ACL_ENTRY_INHERIT_ONLY))