1 /*-
2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
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_get_fd - syscall wrapper for retrieving access ACL by fd
32 * acl_get_fd_np - syscall wrapper for retrieving ACL by fd (non-POSIX)
33 * acl_get_file - syscall wrapper for retrieving ACL by filename
34 * acl_get_link_np - syscall wrapper for retrieving ACL by filename (NOFOLLOW)
35 * (non-POSIX)
36 * acl_get_perm_np() checks if a permission is in the specified
37 * permset (non-POSIX)
38 * acl_get_permset() returns the permission set in the ACL entry
39 * acl_get_qualifier() retrieves the qualifier of the tag from the ACL entry
40 * acl_get_tag_type() returns the tag type for the ACL entry entry_d
41 */
42
43 #include <sys/cdefs.h>
44 __FBSDID("$FreeBSD: stable/12/lib/libc/posix1e/acl_get.c 326193 2017-11-25 17:12:48Z pfg $");
45
46 #include <sys/types.h>
47 #include "namespace.h"
48 #include <sys/acl.h>
49 #include "un-namespace.h"
50
51 #include <errno.h>
52 #include <stdio.h>
53 #include <stdlib.h>
54 #include <string.h>
55 #include <unistd.h>
56
57 #include "acl_support.h"
58
59 acl_t
acl_get_file(const char * path_p,acl_type_t type)60 acl_get_file(const char *path_p, acl_type_t type)
61 {
62 acl_t aclp;
63 int error;
64
65 aclp = acl_init(ACL_MAX_ENTRIES);
66 if (aclp == NULL)
67 return (NULL);
68
69 type = _acl_type_unold(type);
70 error = __acl_get_file(path_p, type, &aclp->ats_acl);
71 if (error) {
72 acl_free(aclp);
73 return (NULL);
74 }
75
76 aclp->ats_acl.acl_maxcnt = ACL_MAX_ENTRIES;
77 _acl_brand_from_type(aclp, type);
78
79 return (aclp);
80 }
81
82 acl_t
acl_get_link_np(const char * path_p,acl_type_t type)83 acl_get_link_np(const char *path_p, acl_type_t type)
84 {
85 acl_t aclp;
86 int error;
87
88 aclp = acl_init(ACL_MAX_ENTRIES);
89 if (aclp == NULL)
90 return (NULL);
91
92 type = _acl_type_unold(type);
93 error = __acl_get_link(path_p, type, &aclp->ats_acl);
94 if (error) {
95 acl_free(aclp);
96 return (NULL);
97 }
98
99 aclp->ats_acl.acl_maxcnt = ACL_MAX_ENTRIES;
100 _acl_brand_from_type(aclp, type);
101
102 return (aclp);
103 }
104
105 acl_t
acl_get_fd(int fd)106 acl_get_fd(int fd)
107 {
108 if (fpathconf(fd, _PC_ACL_NFS4) == 1)
109 return (acl_get_fd_np(fd, ACL_TYPE_NFS4));
110
111 return (acl_get_fd_np(fd, ACL_TYPE_ACCESS));
112 }
113
114 acl_t
acl_get_fd_np(int fd,acl_type_t type)115 acl_get_fd_np(int fd, acl_type_t type)
116 {
117 acl_t aclp;
118 int error;
119
120 aclp = acl_init(ACL_MAX_ENTRIES);
121 if (aclp == NULL)
122 return (NULL);
123
124 type = _acl_type_unold(type);
125 error = ___acl_get_fd(fd, type, &aclp->ats_acl);
126 if (error) {
127 acl_free(aclp);
128 return (NULL);
129 }
130
131 aclp->ats_acl.acl_maxcnt = ACL_MAX_ENTRIES;
132 _acl_brand_from_type(aclp, type);
133
134 return (aclp);
135 }
136
137 /*
138 * acl_get_permset() (23.4.17): return via permset_p a descriptor to
139 * the permission set in the ACL entry entry_d.
140 */
141 int
acl_get_permset(acl_entry_t entry_d,acl_permset_t * permset_p)142 acl_get_permset(acl_entry_t entry_d, acl_permset_t *permset_p)
143 {
144
145 if (entry_d == NULL || permset_p == NULL) {
146 errno = EINVAL;
147 return (-1);
148 }
149
150 *permset_p = &entry_d->ae_perm;
151
152 return (0);
153 }
154
155 /*
156 * acl_get_qualifier() (23.4.18): retrieve the qualifier of the tag
157 * for the ACL entry entry_d.
158 */
159 void *
acl_get_qualifier(acl_entry_t entry_d)160 acl_get_qualifier(acl_entry_t entry_d)
161 {
162 uid_t *retval;
163
164 if (entry_d == NULL) {
165 errno = EINVAL;
166 return (NULL);
167 }
168
169 switch(entry_d->ae_tag) {
170 case ACL_USER:
171 case ACL_GROUP:
172 retval = malloc(sizeof(uid_t));
173 if (retval == NULL)
174 return (NULL);
175 *retval = entry_d->ae_id;
176 return (retval);
177 }
178
179 errno = EINVAL;
180 return (NULL);
181 }
182
183 /*
184 * acl_get_tag_type() (23.4.19): return the tag type for the ACL
185 * entry entry_p.
186 */
187 int
acl_get_tag_type(acl_entry_t entry_d,acl_tag_t * tag_type_p)188 acl_get_tag_type(acl_entry_t entry_d, acl_tag_t *tag_type_p)
189 {
190
191 if (entry_d == NULL || tag_type_p == NULL) {
192 errno = EINVAL;
193 return (-1);
194 }
195
196 *tag_type_p = entry_d->ae_tag;
197
198 return (0);
199 }
200
201 int
acl_get_entry_type_np(acl_entry_t entry_d,acl_entry_type_t * entry_type_p)202 acl_get_entry_type_np(acl_entry_t entry_d, acl_entry_type_t *entry_type_p)
203 {
204
205 if (entry_d == NULL || entry_type_p == NULL) {
206 errno = EINVAL;
207 return (-1);
208 }
209
210 if (!_entry_brand_may_be(entry_d, ACL_BRAND_NFS4)) {
211 errno = EINVAL;
212 return (-1);
213 }
214
215 *entry_type_p = entry_d->ae_entry_type;
216
217 return (0);
218 }
219