acl_get.c revision 108410 
1/*-
2 * Copyright (c) 1999, 2000, 2001, 2002 Robert N. M. Watson
3 * All rights reserved.
4 *
5 * This software was developed by Robert Watson for the TrustedBSD Project.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 *    notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 *    notice, this list of conditions and the following disclaimer in the
14 *    documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
28/*
29 * acl_get_fd - syscall wrapper for retrieving access ACL by fd
30 * acl_get_fd_np - syscall wrapper for retrieving ACL by fd (non-POSIX)
31 * acl_get_file - syscall wrapper for retrieving ACL by filename
32 * acl_get_link_np - syscall wrapper for retrieving ACL by filename (NOFOLLOW)
33 *                   (non-POSIX)
34 * acl_get_perm_np() checks if a permission is in the specified
35 *                   permset (non-POSIX)
36 * acl_get_permset() returns the permission set in the ACL entry
37 * acl_get_qualifier() retrieves the qualifier of the tag from the ACL entry
38 * acl_get_tag_type() returns the tag type for the ACL entry entry_d
39 */
40
41#include <sys/cdefs.h>
42__FBSDID("$FreeBSD: head/lib/libc/posix1e/acl_get.c 108410 2002-12-29 20:47:05Z rwatson $");
43
44#include <sys/types.h>
45#include "namespace.h"
46#include <sys/acl.h>
47#include "un-namespace.h"
48
49#include <errno.h>
50#include <stdlib.h>
51#include <string.h>
52
53acl_t
54acl_get_file(const char *path_p, acl_type_t type)
55{
56	acl_t	aclp;
57	int	error;
58
59	aclp = acl_init(ACL_MAX_ENTRIES);
60	if (aclp == NULL)
61		return (NULL);
62
63	error = __acl_get_file(path_p, type, &aclp->ats_acl);
64	if (error) {
65		acl_free(aclp);
66		return (NULL);
67	}
68
69	return (aclp);
70}
71
72acl_t
73acl_get_link_np(const char *path_p, acl_type_t type)
74{
75	acl_t	aclp;
76	int	error;
77
78	aclp = acl_init(ACL_MAX_ENTRIES);
79	if (aclp == NULL)
80		return (NULL);
81
82	error = __acl_get_link(path_p, type, &aclp->ats_acl);
83	if (error) {
84		acl_free(aclp);
85		return (NULL);
86	}
87
88	return (aclp);
89}
90
91acl_t
92acl_get_fd(int fd)
93{
94	acl_t	aclp;
95	int	error;
96
97	aclp = acl_init(ACL_MAX_ENTRIES);
98	if (aclp == NULL)
99		return (NULL);
100
101	error = ___acl_get_fd(fd, ACL_TYPE_ACCESS, &aclp->ats_acl);
102	if (error) {
103		acl_free(aclp);
104		return (NULL);
105	}
106
107	return (aclp);
108}
109
110acl_t
111acl_get_fd_np(int fd, acl_type_t type)
112{
113	acl_t	aclp;
114	int	error;
115
116	aclp = acl_init(ACL_MAX_ENTRIES);
117	if (aclp == NULL)
118		return (NULL);
119
120	error = ___acl_get_fd(fd, type, &aclp->ats_acl);
121	if (error) {
122		acl_free(aclp);
123		return (NULL);
124	}
125
126	return (aclp);
127}
128
129int
130acl_get_perm_np(acl_permset_t permset_d, acl_perm_t perm)
131{
132
133	if (permset_d == NULL) {
134		errno = EINVAL;
135		return (-1);
136	}
137
138	switch(perm) {
139	case ACL_READ:
140	case ACL_WRITE:
141	case ACL_EXECUTE:
142		if (*permset_d & perm)
143			return (1);
144		break;
145	default:
146		errno = EINVAL;
147		return (-1);
148	}
149
150	return (0);
151}
152
153/*
154 * acl_get_permset() (23.4.17): return via permset_p a descriptor to
155 * the permission set in the ACL entry entry_d.
156 */
157int
158acl_get_permset(acl_entry_t entry_d, acl_permset_t *permset_p)
159{
160
161	if (entry_d == NULL || permset_p == NULL) {
162		errno = EINVAL;
163		return (-1);
164	}
165
166	*permset_p = &entry_d->ae_perm;
167
168	return (0);
169}
170
171/*
172 * acl_get_qualifier() (23.4.18): retrieve the qualifier of the tag
173 * for the ACL entry entry_d.
174 */
175void *
176acl_get_qualifier(acl_entry_t entry_d)
177{
178	uid_t *retval;
179
180	if (entry_d == NULL) {
181		errno = EINVAL;
182		return (NULL);
183	}
184
185	switch(entry_d->ae_tag) {
186	case ACL_USER:
187	case ACL_GROUP:
188		retval = malloc(sizeof(uid_t));
189		if (retval == NULL)
190			return (NULL);
191		*retval = entry_d->ae_id;
192		return (retval);
193	}
194
195	errno = EINVAL;
196	return (NULL);
197}
198
199/*
200 * acl_get_tag_type() (23.4.19): return the tag type for the ACL
201 * entry entry_p.
202 */
203int
204acl_get_tag_type(acl_entry_t entry_d, acl_tag_t *tag_type_p)
205{
206
207	if (entry_d == NULL || tag_type_p == NULL) {
208		errno = EINVAL;
209		return (-1);
210	}
211
212	*tag_type_p = entry_d->ae_tag;
213
214	return (0);
215}
216