2 * Copyright (c) 2008-2009 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>
50 #define KASSERT(a, b) assert(a)
59 } accmode2mask[] = {{VREAD, ACL_READ_DATA},
60 {VWRITE, ACL_WRITE_DATA},
61 {VAPPEND, ACL_APPEND_DATA},
63 {VREAD_NAMED_ATTRS, ACL_READ_NAMED_ATTRS},
64 {VWRITE_NAMED_ATTRS, ACL_WRITE_NAMED_ATTRS},
65 {VDELETE_CHILD, ACL_DELETE_CHILD},
66 {VREAD_ATTRIBUTES, ACL_READ_ATTRIBUTES},
67 {VWRITE_ATTRIBUTES, ACL_WRITE_ATTRIBUTES},
68 {VDELETE, ACL_DELETE},
69 {VREAD_ACL, ACL_READ_ACL},
70 {VWRITE_ACL, ACL_WRITE_ACL},
71 {VWRITE_OWNER, ACL_WRITE_OWNER},
72 {VSYNCHRONIZE, ACL_SYNCHRONIZE},
76 _access_mask_from_accmode(accmode_t accmode)
78 int access_mask = 0, i;
80 for (i = 0; accmode2mask[i].accmode != 0; i++) {
81 if (accmode & accmode2mask[i].accmode)
82 access_mask |= accmode2mask[i].mask;
86 * VAPPEND is just a modifier for VWRITE; if the caller asked
87 * for 'VAPPEND | VWRITE', we want to check for ACL_APPEND_DATA only.
89 if (access_mask & ACL_APPEND_DATA)
90 access_mask &= ~ACL_WRITE_DATA;
96 * Return 0, iff access is allowed, 1 otherwise.
99 _acl_denies(const struct acl *aclp, int access_mask, struct ucred *cred,
100 int file_uid, int file_gid, int *denied_explicitly)
103 const struct acl_entry *entry;
105 if (denied_explicitly != NULL)
106 *denied_explicitly = 0;
108 KASSERT(aclp->acl_cnt <= ACL_MAX_ENTRIES,
109 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
111 for (i = 0; i < aclp->acl_cnt; i++) {
112 entry = &(aclp->acl_entry[i]);
114 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
115 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
117 if (entry->ae_flags & ACL_ENTRY_INHERIT_ONLY)
119 switch (entry->ae_tag) {
121 if (file_uid != cred->cr_uid)
125 if (entry->ae_id != cred->cr_uid)
129 if (!groupmember(file_gid, cred))
133 if (!groupmember(entry->ae_id, cred))
137 KASSERT(entry->ae_tag == ACL_EVERYONE,
138 ("entry->ae_tag == ACL_EVERYONE"));
141 if (entry->ae_entry_type == ACL_ENTRY_TYPE_DENY) {
142 if (entry->ae_perm & access_mask) {
143 if (denied_explicitly != NULL)
144 *denied_explicitly = 1;
149 access_mask &= ~(entry->ae_perm);
150 if (access_mask == 0)
158 vaccess_acl_nfs4(enum vtype type, uid_t file_uid, gid_t file_gid,
159 struct acl *aclp, accmode_t accmode, struct ucred *cred, int *privused)
161 accmode_t priv_granted = 0;
162 int denied, explicitly_denied, access_mask, is_directory,
165 if (privused != NULL)
168 if (accmode & VADMIN)
172 * Ignore VSYNCHRONIZE permission.
174 accmode &= ~VSYNCHRONIZE;
176 access_mask = _access_mask_from_accmode(accmode);
184 * File owner is always allowed to read and write the ACL
185 * and basic attributes. This is to prevent a situation
186 * where user would change ACL in a way that prevents him
187 * from undoing the change.
189 if (file_uid == cred->cr_uid)
190 access_mask &= ~(ACL_READ_ACL | ACL_WRITE_ACL |
191 ACL_READ_ATTRIBUTES | ACL_WRITE_ATTRIBUTES);
194 * Ignore append permission for regular files; use write
195 * permission instead.
197 if (!is_directory && (access_mask & ACL_APPEND_DATA)) {
198 access_mask &= ~ACL_APPEND_DATA;
199 access_mask |= ACL_WRITE_DATA;
202 denied = _acl_denies(aclp, access_mask, cred, file_uid, file_gid,
206 if (file_uid != cred->cr_uid)
214 * Access failed. Iff it was not denied explicitly and
215 * VEXPLICIT_DENY flag was specified, allow access.
217 if ((accmode & VEXPLICIT_DENY) && explicitly_denied == 0)
220 accmode &= ~VEXPLICIT_DENY;
223 * No match. Try to use privileges, if there are any.
226 if ((accmode & VEXEC) && !priv_check_cred(cred,
228 priv_granted |= VEXEC;
230 if ((accmode & VEXEC) && !priv_check_cred(cred,
232 priv_granted |= VEXEC;
235 if ((accmode & VREAD) && !priv_check_cred(cred, PRIV_VFS_READ, 0))
236 priv_granted |= VREAD;
238 if ((accmode & (VWRITE | VAPPEND | VDELETE_CHILD)) &&
239 !priv_check_cred(cred, PRIV_VFS_WRITE, 0))
240 priv_granted |= (VWRITE | VAPPEND | VDELETE_CHILD);
242 if ((accmode & VADMIN_PERMS) &&
243 !priv_check_cred(cred, PRIV_VFS_ADMIN, 0))
244 priv_granted |= VADMIN_PERMS;
246 if ((accmode & VSTAT_PERMS) &&
247 !priv_check_cred(cred, PRIV_VFS_STAT, 0))
248 priv_granted |= VSTAT_PERMS;
250 if ((accmode & priv_granted) == accmode) {
251 if (privused != NULL)
257 if (accmode & (VADMIN_PERMS | VDELETE_CHILD | VDELETE))
267 _acl_entry_matches(struct acl_entry *entry, acl_tag_t tag, acl_perm_t perm,
268 acl_entry_type_t entry_type)
270 if (entry->ae_tag != tag)
273 if (entry->ae_id != ACL_UNDEFINED_ID)
276 if (entry->ae_perm != perm)
279 if (entry->ae_entry_type != entry_type)
282 if (entry->ae_flags != 0)
288 static struct acl_entry *
289 _acl_append(struct acl *aclp, acl_tag_t tag, acl_perm_t perm,
290 acl_entry_type_t entry_type)
292 struct acl_entry *entry;
294 KASSERT(aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES,
295 ("aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES"));
297 entry = &(aclp->acl_entry[aclp->acl_cnt]);
301 entry->ae_id = ACL_UNDEFINED_ID;
302 entry->ae_perm = perm;
303 entry->ae_entry_type = entry_type;
309 static struct acl_entry *
310 _acl_duplicate_entry(struct acl *aclp, int entry_index)
314 KASSERT(aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES,
315 ("aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES"));
317 for (i = aclp->acl_cnt; i > entry_index; i--)
318 aclp->acl_entry[i] = aclp->acl_entry[i - 1];
322 return (&(aclp->acl_entry[entry_index + 1]));
326 * Calculate trivial ACL in a manner compatible with PSARC/2010/029.
327 * Note that this results in an ACL different from (but semantically
328 * equal to) the "canonical six" trivial ACL computed using algorithm
329 * described in draft-ietf-nfsv4-minorversion1-03.txt, 3.16.6.2.
332 acl_nfs4_trivial_from_mode(struct acl *aclp, mode_t mode)
334 acl_perm_t user_allow_first = 0, user_deny = 0, group_deny = 0;
335 acl_perm_t user_allow, group_allow, everyone_allow;
337 KASSERT(aclp->acl_cnt == 0, ("aclp->acl_cnt == 0"));
339 user_allow = group_allow = everyone_allow = ACL_READ_ACL |
340 ACL_READ_ATTRIBUTES | ACL_READ_NAMED_ATTRS | ACL_SYNCHRONIZE;
341 user_allow |= ACL_WRITE_ACL | ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
342 ACL_WRITE_NAMED_ATTRS;
345 user_allow |= ACL_READ_DATA;
347 user_allow |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
349 user_allow |= ACL_EXECUTE;
352 group_allow |= ACL_READ_DATA;
354 group_allow |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
356 group_allow |= ACL_EXECUTE;
359 everyone_allow |= ACL_READ_DATA;
361 everyone_allow |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
363 everyone_allow |= ACL_EXECUTE;
365 user_deny = ((group_allow | everyone_allow) & ~user_allow);
366 group_deny = everyone_allow & ~group_allow;
367 user_allow_first = group_deny & ~user_deny;
369 if (user_allow_first != 0)
370 _acl_append(aclp, ACL_USER_OBJ, user_allow_first, ACL_ENTRY_TYPE_ALLOW);
372 _acl_append(aclp, ACL_USER_OBJ, user_deny, ACL_ENTRY_TYPE_DENY);
374 _acl_append(aclp, ACL_GROUP_OBJ, group_deny, ACL_ENTRY_TYPE_DENY);
375 _acl_append(aclp, ACL_USER_OBJ, user_allow, ACL_ENTRY_TYPE_ALLOW);
376 _acl_append(aclp, ACL_GROUP_OBJ, group_allow, ACL_ENTRY_TYPE_ALLOW);
377 _acl_append(aclp, ACL_EVERYONE, everyone_allow, ACL_ENTRY_TYPE_ALLOW);
381 acl_nfs4_sync_acl_from_mode(struct acl *aclp, mode_t mode, int file_owner_id)
383 int i, meets, must_append;
384 struct acl_entry *entry, *copy, *previous,
385 *a1, *a2, *a3, *a4, *a5, *a6;
388 const int WRITE = 02;
391 KASSERT(aclp->acl_cnt >= 0, ("aclp->acl_cnt >= 0"));
392 KASSERT(aclp->acl_cnt <= ACL_MAX_ENTRIES,
393 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
396 * NFSv4 Minor Version 1, draft-ietf-nfsv4-minorversion1-03.txt
398 * 3.16.6.3. Applying a Mode to an Existing ACL
404 for (i = 0; i < aclp->acl_cnt; i++) {
405 entry = &(aclp->acl_entry[i]);
408 * 1.1. If the type is neither ALLOW or DENY - skip.
410 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
411 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
415 * 1.2. If ACL_ENTRY_INHERIT_ONLY is set - skip.
417 if (entry->ae_flags & ACL_ENTRY_INHERIT_ONLY)
421 * 1.3. If ACL_ENTRY_FILE_INHERIT or ACL_ENTRY_DIRECTORY_INHERIT
424 if (entry->ae_flags &
425 (ACL_ENTRY_FILE_INHERIT | ACL_ENTRY_DIRECTORY_INHERIT)) {
427 * 1.3.1. A copy of the current ACE is made, and placed
428 * in the ACL immediately following the current
431 copy = _acl_duplicate_entry(aclp, i);
434 * 1.3.2. In the first ACE, the flag
435 * ACL_ENTRY_INHERIT_ONLY is set.
437 entry->ae_flags |= ACL_ENTRY_INHERIT_ONLY;
440 * 1.3.3. In the second ACE, the following flags
442 * ACL_ENTRY_FILE_INHERIT,
443 * ACL_ENTRY_DIRECTORY_INHERIT,
444 * ACL_ENTRY_NO_PROPAGATE_INHERIT.
446 copy->ae_flags &= ~(ACL_ENTRY_FILE_INHERIT |
447 ACL_ENTRY_DIRECTORY_INHERIT |
448 ACL_ENTRY_NO_PROPAGATE_INHERIT);
451 * The algorithm continues on with the second ACE.
458 * 1.4. If it's owner@, group@ or everyone@ entry, clear
459 * ACL_READ_DATA, ACL_WRITE_DATA, ACL_APPEND_DATA
460 * and ACL_EXECUTE. Continue to the next entry.
462 if (entry->ae_tag == ACL_USER_OBJ ||
463 entry->ae_tag == ACL_GROUP_OBJ ||
464 entry->ae_tag == ACL_EVERYONE) {
465 entry->ae_perm &= ~(ACL_READ_DATA | ACL_WRITE_DATA |
466 ACL_APPEND_DATA | ACL_EXECUTE);
471 * 1.5. Otherwise, if the "who" field did not match one
472 * of OWNER@, GROUP@, EVERYONE@:
474 * 1.5.1. If the type is ALLOW, check the preceding ACE.
475 * If it does not meet all of the following criteria:
477 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW)
483 previous = &(aclp->acl_entry[i - 1]);
486 * 1.5.1.1. The type field is DENY,
488 if (previous->ae_entry_type != ACL_ENTRY_TYPE_DENY)
492 * 1.5.1.2. The "who" field is the same as the current
495 * 1.5.1.3. The flag bit ACE4_IDENTIFIER_GROUP
496 * is the same as it is in the current ACE,
497 * and no other flag bits are set,
499 if (previous->ae_id != entry->ae_id ||
500 previous->ae_tag != entry->ae_tag)
503 if (previous->ae_flags)
507 * 1.5.1.4. The mask bits are a subset of the mask bits
508 * of the current ACE, and are also subset of
509 * the following: ACL_READ_DATA,
510 * ACL_WRITE_DATA, ACL_APPEND_DATA, ACL_EXECUTE
512 if (previous->ae_perm & ~(entry->ae_perm))
515 if (previous->ae_perm & ~(ACL_READ_DATA |
516 ACL_WRITE_DATA | ACL_APPEND_DATA | ACL_EXECUTE))
522 * Then the ACE of type DENY, with a who equal
523 * to the current ACE, flag bits equal to
524 * (<current ACE flags> & <ACE_IDENTIFIER_GROUP>)
525 * and no mask bits, is prepended.
528 entry = _acl_duplicate_entry(aclp, i);
530 /* Adjust counter, as we've just added an entry. */
533 previous->ae_tag = entry->ae_tag;
534 previous->ae_id = entry->ae_id;
535 previous->ae_flags = entry->ae_flags;
536 previous->ae_perm = 0;
537 previous->ae_entry_type = ACL_ENTRY_TYPE_DENY;
541 * 1.5.2. The following modifications are made to the prepended
542 * ACE. The intent is to mask the following ACE
543 * to disallow ACL_READ_DATA, ACL_WRITE_DATA,
544 * ACL_APPEND_DATA, or ACL_EXECUTE, based upon the group
545 * permissions of the new mode. As a special case,
546 * if the ACE matches the current owner of the file,
547 * the owner bits are used, rather than the group bits.
548 * This is reflected in the algorithm below.
553 * If ACE4_IDENTIFIER_GROUP is not set, and the "who" field
554 * in ACE matches the owner of the file, we shift amode three
555 * more bits, in order to have the owner permission bits
556 * placed in the three low order bits of amode.
558 if (entry->ae_tag == ACL_USER && entry->ae_id == file_owner_id)
561 if (entry->ae_perm & ACL_READ_DATA) {
563 previous->ae_perm &= ~ACL_READ_DATA;
565 previous->ae_perm |= ACL_READ_DATA;
568 if (entry->ae_perm & ACL_WRITE_DATA) {
570 previous->ae_perm &= ~ACL_WRITE_DATA;
572 previous->ae_perm |= ACL_WRITE_DATA;
575 if (entry->ae_perm & ACL_APPEND_DATA) {
577 previous->ae_perm &= ~ACL_APPEND_DATA;
579 previous->ae_perm |= ACL_APPEND_DATA;
582 if (entry->ae_perm & ACL_EXECUTE) {
584 previous->ae_perm &= ~ACL_EXECUTE;
586 previous->ae_perm |= ACL_EXECUTE;
590 * 1.5.3. If ACE4_IDENTIFIER_GROUP is set in the flags
593 * XXX: This point is not there in the Falkner's draft.
595 if (entry->ae_tag == ACL_GROUP &&
596 entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW) {
597 mode_t extramode, ownermode;
598 extramode = (mode >> 3) & 07;
599 ownermode = mode >> 6;
600 extramode &= ~ownermode;
603 if (extramode & READ) {
604 entry->ae_perm &= ~ACL_READ_DATA;
605 previous->ae_perm &= ~ACL_READ_DATA;
608 if (extramode & WRITE) {
610 ~(ACL_WRITE_DATA | ACL_APPEND_DATA);
612 ~(ACL_WRITE_DATA | ACL_APPEND_DATA);
615 if (extramode & EXEC) {
616 entry->ae_perm &= ~ACL_EXECUTE;
617 previous->ae_perm &= ~ACL_EXECUTE;
624 * 2. If there at least six ACEs, the final six ACEs are examined.
625 * If they are not equal to what we want, append six ACEs.
628 if (aclp->acl_cnt < 6) {
631 a6 = &(aclp->acl_entry[aclp->acl_cnt - 1]);
632 a5 = &(aclp->acl_entry[aclp->acl_cnt - 2]);
633 a4 = &(aclp->acl_entry[aclp->acl_cnt - 3]);
634 a3 = &(aclp->acl_entry[aclp->acl_cnt - 4]);
635 a2 = &(aclp->acl_entry[aclp->acl_cnt - 5]);
636 a1 = &(aclp->acl_entry[aclp->acl_cnt - 6]);
638 if (!_acl_entry_matches(a1, ACL_USER_OBJ, 0,
639 ACL_ENTRY_TYPE_DENY))
641 if (!_acl_entry_matches(a2, ACL_USER_OBJ, ACL_WRITE_ACL |
642 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
643 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_ALLOW))
645 if (!_acl_entry_matches(a3, ACL_GROUP_OBJ, 0,
646 ACL_ENTRY_TYPE_DENY))
648 if (!_acl_entry_matches(a4, ACL_GROUP_OBJ, 0,
649 ACL_ENTRY_TYPE_ALLOW))
651 if (!_acl_entry_matches(a5, ACL_EVERYONE, ACL_WRITE_ACL |
652 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
653 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_DENY))
655 if (!_acl_entry_matches(a6, ACL_EVERYONE, ACL_READ_ACL |
656 ACL_READ_ATTRIBUTES | ACL_READ_NAMED_ATTRS |
657 ACL_SYNCHRONIZE, ACL_ENTRY_TYPE_ALLOW))
662 KASSERT(aclp->acl_cnt + 6 <= ACL_MAX_ENTRIES,
663 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
665 a1 = _acl_append(aclp, ACL_USER_OBJ, 0, ACL_ENTRY_TYPE_DENY);
666 a2 = _acl_append(aclp, ACL_USER_OBJ, ACL_WRITE_ACL |
667 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
668 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_ALLOW);
669 a3 = _acl_append(aclp, ACL_GROUP_OBJ, 0, ACL_ENTRY_TYPE_DENY);
670 a4 = _acl_append(aclp, ACL_GROUP_OBJ, 0, ACL_ENTRY_TYPE_ALLOW);
671 a5 = _acl_append(aclp, ACL_EVERYONE, ACL_WRITE_ACL |
672 ACL_WRITE_OWNER | ACL_WRITE_ATTRIBUTES |
673 ACL_WRITE_NAMED_ATTRS, ACL_ENTRY_TYPE_DENY);
674 a6 = _acl_append(aclp, ACL_EVERYONE, ACL_READ_ACL |
675 ACL_READ_ATTRIBUTES | ACL_READ_NAMED_ATTRS |
676 ACL_SYNCHRONIZE, ACL_ENTRY_TYPE_ALLOW);
678 KASSERT(a1 != NULL && a2 != NULL && a3 != NULL && a4 != NULL &&
679 a5 != NULL && a6 != NULL, ("couldn't append to ACL."));
683 * 3. The final six ACEs are adjusted according to the incoming mode.
686 a2->ae_perm |= ACL_READ_DATA;
688 a1->ae_perm |= ACL_READ_DATA;
690 a2->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
692 a1->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
694 a2->ae_perm |= ACL_EXECUTE;
696 a1->ae_perm |= ACL_EXECUTE;
699 a4->ae_perm |= ACL_READ_DATA;
701 a3->ae_perm |= ACL_READ_DATA;
703 a4->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
705 a3->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
707 a4->ae_perm |= ACL_EXECUTE;
709 a3->ae_perm |= ACL_EXECUTE;
712 a6->ae_perm |= ACL_READ_DATA;
714 a5->ae_perm |= ACL_READ_DATA;
716 a6->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
718 a5->ae_perm |= (ACL_WRITE_DATA | ACL_APPEND_DATA);
720 a6->ae_perm |= ACL_EXECUTE;
722 a5->ae_perm |= ACL_EXECUTE;
726 acl_nfs4_sync_mode_from_acl(mode_t *_mode, const struct acl *aclp)
729 mode_t old_mode = *_mode, mode = 0, seen = 0;
730 const struct acl_entry *entry;
732 KASSERT(aclp->acl_cnt <= ACL_MAX_ENTRIES,
733 ("aclp->acl_cnt <= ACL_MAX_ENTRIES"));
736 * NFSv4 Minor Version 1, draft-ietf-nfsv4-minorversion1-03.txt
738 * 3.16.6.1. Recomputing mode upon SETATTR of ACL
741 for (i = 0; i < aclp->acl_cnt; i++) {
742 entry = &(aclp->acl_entry[i]);
744 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
745 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
748 if (entry->ae_flags & ACL_ENTRY_INHERIT_ONLY)
751 if (entry->ae_tag == ACL_USER_OBJ) {
752 if ((entry->ae_perm & ACL_READ_DATA) &&
753 ((seen & S_IRUSR) == 0)) {
755 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
758 if ((entry->ae_perm & ACL_WRITE_DATA) &&
759 ((seen & S_IWUSR) == 0)) {
761 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
764 if ((entry->ae_perm & ACL_EXECUTE) &&
765 ((seen & S_IXUSR) == 0)) {
767 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
770 } else if (entry->ae_tag == ACL_GROUP_OBJ) {
771 if ((entry->ae_perm & ACL_READ_DATA) &&
772 ((seen & S_IRGRP) == 0)) {
774 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
777 if ((entry->ae_perm & ACL_WRITE_DATA) &&
778 ((seen & S_IWGRP) == 0)) {
780 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
783 if ((entry->ae_perm & ACL_EXECUTE) &&
784 ((seen & S_IXGRP) == 0)) {
786 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
789 } else if (entry->ae_tag == ACL_EVERYONE) {
790 if (entry->ae_perm & ACL_READ_DATA) {
791 if ((seen & S_IRUSR) == 0) {
793 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
796 if ((seen & S_IRGRP) == 0) {
798 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
801 if ((seen & S_IROTH) == 0) {
803 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
807 if (entry->ae_perm & ACL_WRITE_DATA) {
808 if ((seen & S_IWUSR) == 0) {
810 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
813 if ((seen & S_IWGRP) == 0) {
815 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
818 if ((seen & S_IWOTH) == 0) {
820 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
824 if (entry->ae_perm & ACL_EXECUTE) {
825 if ((seen & S_IXUSR) == 0) {
827 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
830 if ((seen & S_IXGRP) == 0) {
832 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
835 if ((seen & S_IXOTH) == 0) {
837 if (entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
844 *_mode = mode | (old_mode & ACL_PRESERVE_MASK);
848 acl_nfs4_compute_inherited_acl(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 <= ACL_MAX_ENTRIES,
858 ("parent_aclp->acl_cnt <= ACL_MAX_ENTRIES"));
861 * NFSv4 Minor Version 1, draft-ietf-nfsv4-minorversion1-03.txt
863 * 3.16.6.2. Applying the mode given to CREATE or OPEN
864 * to an inherited ACL
868 * 1. Form an ACL that is the concatenation of all inheritable ACEs.
870 for (i = 0; i < parent_aclp->acl_cnt; i++) {
871 parent_entry = &(parent_aclp->acl_entry[i]);
872 flags = parent_entry->ae_flags;
875 * Entry is not inheritable at all.
877 if ((flags & (ACL_ENTRY_DIRECTORY_INHERIT |
878 ACL_ENTRY_FILE_INHERIT)) == 0)
882 * We're creating a file, but entry is not inheritable
885 if (!is_directory && (flags & ACL_ENTRY_FILE_INHERIT) == 0)
889 * Entry is inheritable only by files, but has NO_PROPAGATE
890 * flag set, and we're creating a directory, so it wouldn't
891 * propagate to any file in that directory anyway.
894 (flags & ACL_ENTRY_DIRECTORY_INHERIT) == 0 &&
895 (flags & ACL_ENTRY_NO_PROPAGATE_INHERIT))
898 KASSERT(child_aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES,
899 ("child_aclp->acl_cnt + 1 <= ACL_MAX_ENTRIES"));
900 child_aclp->acl_entry[child_aclp->acl_cnt] = *parent_entry;
901 child_aclp->acl_cnt++;
905 * 2. For each entry in the new ACL, adjust its flags, possibly
906 * creating two entries in place of one.
908 for (i = 0; i < child_aclp->acl_cnt; i++) {
909 entry = &(child_aclp->acl_entry[i]);
912 * This is not in the specification, but SunOS
913 * apparently does that.
915 if (((entry->ae_flags & ACL_ENTRY_NO_PROPAGATE_INHERIT) ||
917 entry->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
918 entry->ae_perm &= ~(ACL_WRITE_ACL | ACL_WRITE_OWNER);
921 * 2.A. If the ACL_ENTRY_NO_PROPAGATE_INHERIT is set, or if the object
922 * being created is not a directory, then clear the
923 * following flags: ACL_ENTRY_NO_PROPAGATE_INHERIT,
924 * ACL_ENTRY_FILE_INHERIT, ACL_ENTRY_DIRECTORY_INHERIT,
925 * ACL_ENTRY_INHERIT_ONLY.
927 if (entry->ae_flags & ACL_ENTRY_NO_PROPAGATE_INHERIT ||
929 entry->ae_flags &= ~(ACL_ENTRY_NO_PROPAGATE_INHERIT |
930 ACL_ENTRY_FILE_INHERIT | ACL_ENTRY_DIRECTORY_INHERIT |
931 ACL_ENTRY_INHERIT_ONLY);
934 * Continue on to the next ACE.
940 * 2.B. If the object is a directory and ACL_ENTRY_FILE_INHERIT
941 * is set, but ACL_ENTRY_NO_PROPAGATE_INHERIT is not set, ensure
942 * that ACL_ENTRY_INHERIT_ONLY is set. Continue to the
943 * next ACE. Otherwise...
946 * XXX: Read it again and make sure what does the "otherwise"
950 (entry->ae_flags & ACL_ENTRY_FILE_INHERIT) &&
951 ((entry->ae_flags & ACL_ENTRY_DIRECTORY_INHERIT) == 0)) {
952 entry->ae_flags |= ACL_ENTRY_INHERIT_ONLY;
957 * 2.C. If the type of the ACE is neither ALLOW nor deny,
960 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
961 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
965 * 2.D. Copy the original ACE into a second, adjacent ACE.
967 copy = _acl_duplicate_entry(child_aclp, i);
970 * 2.E. On the first ACE, ensure that ACL_ENTRY_INHERIT_ONLY
973 entry->ae_flags |= ACL_ENTRY_INHERIT_ONLY;
976 * 2.F. On the second ACE, clear the following flags:
977 * ACL_ENTRY_NO_PROPAGATE_INHERIT, ACL_ENTRY_FILE_INHERIT,
978 * ACL_ENTRY_DIRECTORY_INHERIT, ACL_ENTRY_INHERIT_ONLY.
980 copy->ae_flags &= ~(ACL_ENTRY_NO_PROPAGATE_INHERIT |
981 ACL_ENTRY_FILE_INHERIT | ACL_ENTRY_DIRECTORY_INHERIT |
982 ACL_ENTRY_INHERIT_ONLY);
985 * 2.G. On the second ACE, if the type is ALLOW,
986 * an implementation MAY clear the following
987 * mask bits: ACL_WRITE_ACL, ACL_WRITE_OWNER.
989 if (copy->ae_entry_type == ACL_ENTRY_TYPE_ALLOW)
990 copy->ae_perm &= ~(ACL_WRITE_ACL | ACL_WRITE_OWNER);
993 * Increment the counter to skip the copied entry.
999 * 3. To ensure that the mode is honored, apply the algorithm describe
1000 * in Section 2.16.6.3, using the mode that is to be used for file
1003 acl_nfs4_sync_acl_from_mode(child_aclp, mode, file_owner_id);
1008 _acls_are_equal(const struct acl *a, const struct acl *b)
1011 const struct acl_entry *entrya, *entryb;
1013 if (a->acl_cnt != b->acl_cnt)
1016 for (i = 0; i < b->acl_cnt; i++) {
1017 entrya = &(a->acl_entry[i]);
1018 entryb = &(b->acl_entry[i]);
1020 if (entrya->ae_tag != entryb->ae_tag ||
1021 entrya->ae_id != entryb->ae_id ||
1022 entrya->ae_perm != entryb->ae_perm ||
1023 entrya->ae_entry_type != entryb->ae_entry_type ||
1024 entrya->ae_flags != entryb->ae_flags)
1032 * This routine is used to determine whether to remove entry_type attribute
1033 * that stores ACL contents.
1036 acl_nfs4_is_trivial(const struct acl *aclp, int file_owner_id)
1040 struct acl *tmpaclp;
1042 if (aclp->acl_cnt != 6)
1046 * Compute the mode from the ACL, then compute new ACL from that mode.
1047 * If the ACLs are identical, then the ACL is trivial.
1049 * XXX: I guess there is a faster way to do this. However, even
1050 * this slow implementation significantly speeds things up
1051 * for files that don't have any entry_type ACL entries - it's
1052 * critical for performance to not use EA when they are not
1055 tmpaclp = acl_alloc(M_WAITOK | M_ZERO);
1056 acl_nfs4_sync_mode_from_acl(&tmpmode, aclp);
1057 acl_nfs4_sync_acl_from_mode(tmpaclp, tmpmode, file_owner_id);
1058 trivial = _acls_are_equal(aclp, tmpaclp);
1063 #endif /* _KERNEL */
1066 acl_nfs4_check(const struct acl *aclp, int is_directory)
1069 const struct acl_entry *entry;
1072 * The spec doesn't seem to say anything about ACL validity.
1073 * It seems there is not much to do here. There is even no need
1074 * to count "owner@" or "everyone@" (ACL_USER_OBJ and ACL_EVERYONE)
1075 * entries, as there can be several of them and that's perfectly
1076 * valid. There can be none of them too. Really.
1079 if (aclp->acl_cnt > ACL_MAX_ENTRIES || aclp->acl_cnt <= 0)
1082 for (i = 0; i < aclp->acl_cnt; i++) {
1083 entry = &(aclp->acl_entry[i]);
1085 switch (entry->ae_tag) {
1089 if (entry->ae_id != ACL_UNDEFINED_ID)
1095 if (entry->ae_id == ACL_UNDEFINED_ID)
1103 if ((entry->ae_perm | ACL_NFS4_PERM_BITS) != ACL_NFS4_PERM_BITS)
1107 * Disallow ACL_ENTRY_TYPE_AUDIT and ACL_ENTRY_TYPE_ALARM for now.
1109 if (entry->ae_entry_type != ACL_ENTRY_TYPE_ALLOW &&
1110 entry->ae_entry_type != ACL_ENTRY_TYPE_DENY)
1113 if ((entry->ae_flags | ACL_FLAGS_BITS) != ACL_FLAGS_BITS)
1116 /* Disallow unimplemented flags. */
1117 if (entry->ae_flags & (ACL_ENTRY_SUCCESSFUL_ACCESS |
1118 ACL_ENTRY_FAILED_ACCESS))
1121 /* Disallow flags not allowed for ordinary files. */
1122 if (!is_directory) {
1123 if (entry->ae_flags & (ACL_ENTRY_FILE_INHERIT |
1124 ACL_ENTRY_DIRECTORY_INHERIT |
1125 ACL_ENTRY_NO_PROPAGATE_INHERIT | ACL_ENTRY_INHERIT_ONLY))