xref: /freebsd/lib/libc/posix1e/acl_valid.c (revision 06c3fb27)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson
5  * All rights reserved.
6  *
7  * This software was developed by Robert Watson for the TrustedBSD Project.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  */
30 /*
31  * acl_valid -- POSIX.1e ACL check routine
32  */
33 
34 #include <sys/types.h>
35 #include "namespace.h"
36 #include <sys/acl.h>
37 #include "un-namespace.h"
38 #include <sys/errno.h>
39 #include <stdlib.h>
40 
41 #include "acl_support.h"
42 
43 /*
44  * acl_valid: accepts an ACL, returns 0 on valid ACL, -1 for invalid,
45  * and errno set to EINVAL.
46  *
47  * Implemented by calling the acl_check routine in acl_support, which
48  * requires ordering.  We call acl_support's _posix1e_acl_sort to make this
49  * true.  POSIX.1e allows acl_valid() to reorder the ACL as it sees fit.
50  *
51  * This call is deprecated, as it doesn't ask whether the ACL is valid
52  * for a particular target.  However, this call is standardized, unlike
53  * the other two forms.
54  */
55 int
56 acl_valid(acl_t acl)
57 {
58 	int	error;
59 
60 	if (acl == NULL) {
61 		errno = EINVAL;
62 		return (-1);
63 	}
64 	if (!_acl_brand_may_be(acl, ACL_BRAND_POSIX)) {
65 		errno = EINVAL;
66 		return (-1);
67 	}
68 	_posix1e_acl_sort(acl);
69 	error = _posix1e_acl_check(acl);
70 	if (error) {
71 		errno = error;
72 		return (-1);
73 	} else {
74 		return (0);
75 	}
76 }
77 
78 int
79 acl_valid_file_np(const char *pathp, acl_type_t type, acl_t acl)
80 {
81 
82 	if (pathp == NULL || acl == NULL) {
83 		errno = EINVAL;
84 		return (-1);
85 	}
86 	type = _acl_type_unold(type);
87 	if (_posix1e_acl(acl, type))
88 		_posix1e_acl_sort(acl);
89 
90 	return (__acl_aclcheck_file(pathp, type, &acl->ats_acl));
91 }
92 
93 int
94 acl_valid_link_np(const char *pathp, acl_type_t type, acl_t acl)
95 {
96 
97 	if (pathp == NULL || acl == NULL) {
98 		errno = EINVAL;
99 		return (-1);
100 	}
101 	type = _acl_type_unold(type);
102 	if (_posix1e_acl(acl, type))
103 		_posix1e_acl_sort(acl);
104 
105 	return (__acl_aclcheck_link(pathp, type, &acl->ats_acl));
106 }
107 
108 int
109 acl_valid_fd_np(int fd, acl_type_t type, acl_t acl)
110 {
111 
112 	if (acl == NULL) {
113 		errno = EINVAL;
114 		return (-1);
115 	}
116 	type = _acl_type_unold(type);
117 	if (_posix1e_acl(acl, type))
118 		_posix1e_acl_sort(acl);
119 
120 	acl->ats_cur_entry = 0;
121 
122 	return (___acl_aclcheck_fd(fd, type, &acl->ats_acl));
123 }
124