2 Unix SMB/CIFS implementation.
3 Samba system utilities for ACL support.
4 Copyright (C) Jeremy Allison 2000.
5 Copyright (C) Volker Lendecke 2006
6 Copyright (C) Michael Adam 2006,2008
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include "system/passwd.h"
25 #if defined(HAVE_POSIX_ACLS)
26 #include "modules/vfs_posixacl.h"
29 #if defined(HAVE_TRU64_ACLS)
30 #include "modules/vfs_tru64acl.h"
33 #if defined(HAVE_SOLARIS_ACLS) || defined(HAVE_UNIXWARE_ACLS)
34 #include "modules/vfs_solarisacl.h"
37 #if defined(HAVE_HPUX_ACLS)
38 #include "modules/vfs_hpuxacl.h"
41 #if defined(HAVE_IRIX_ACLS)
42 #include "modules/vfs_irixacl.h"
46 #define DBGC_CLASS DBGC_ACLS
49 * Note that while this code implements sufficient functionality
50 * to support the sys_acl_* interfaces it does not provide all
51 * of the semantics of the POSIX ACL interfaces.
53 * In particular, an ACL entry descriptor (SMB_ACL_ENTRY_T) returned
54 * from a call to sys_acl_get_entry() should not be assumed to be
55 * valid after calling any of the following functions, which may
56 * reorder the entries in the ACL.
63 int sys_acl_get_entry(SMB_ACL_T acl_d, int entry_id, SMB_ACL_ENTRY_T *entry_p)
65 if (entry_id != SMB_ACL_FIRST_ENTRY && entry_id != SMB_ACL_NEXT_ENTRY) {
70 if (entry_p == NULL) {
75 if (entry_id == SMB_ACL_FIRST_ENTRY) {
79 if (acl_d->next < 0) {
84 if (acl_d->next >= acl_d->count) {
88 *entry_p = &acl_d->acl[acl_d->next++];
93 int sys_acl_get_tag_type(SMB_ACL_ENTRY_T entry_d, SMB_ACL_TAG_T *type_p)
95 *type_p = entry_d->a_type;
100 int sys_acl_get_permset(SMB_ACL_ENTRY_T entry_d, SMB_ACL_PERMSET_T *permset_p)
102 *permset_p = &entry_d->a_perm;
107 void *sys_acl_get_qualifier(SMB_ACL_ENTRY_T entry_d)
109 if (entry_d->a_type == SMB_ACL_USER) {
110 return &entry_d->uid;
113 if (entry_d->a_type == SMB_ACL_GROUP) {
114 return &entry_d->gid;
121 int sys_acl_clear_perms(SMB_ACL_PERMSET_T permset_d)
128 int sys_acl_add_perm(SMB_ACL_PERMSET_T permset_d, SMB_ACL_PERM_T perm)
130 if (perm != SMB_ACL_READ && perm != SMB_ACL_WRITE
131 && perm != SMB_ACL_EXECUTE) {
136 if (permset_d == NULL) {
146 int sys_acl_get_perm(SMB_ACL_PERMSET_T permset_d, SMB_ACL_PERM_T perm)
148 return *permset_d & perm;
151 char *sys_acl_to_text(SMB_ACL_T acl_d, ssize_t *len_p)
158 * use an initial estimate of 20 bytes per ACL entry
159 * when allocating memory for the text representation
163 maxlen = 20 * acl_d->count;
164 if ((text = (char *)SMB_MALLOC(maxlen)) == NULL) {
169 for (i = 0; i < acl_d->count; i++) {
170 struct smb_acl_entry *ap = &acl_d->acl[i];
179 switch (ap->a_type) {
181 * for debugging purposes it's probably more
182 * useful to dump unknown tag types rather
183 * than just returning an error
186 slprintf(tagbuf, sizeof(tagbuf)-1, "0x%x",
192 id = uidtoname(ap->uid);
193 case SMB_ACL_USER_OBJ:
198 if ((gr = getgrgid(ap->gid)) == NULL) {
199 slprintf(idbuf, sizeof(idbuf)-1, "%ld",
205 case SMB_ACL_GROUP_OBJ:
219 perms[0] = (ap->a_perm & SMB_ACL_READ) ? 'r' : '-';
220 perms[1] = (ap->a_perm & SMB_ACL_WRITE) ? 'w' : '-';
221 perms[2] = (ap->a_perm & SMB_ACL_EXECUTE) ? 'x' : '-';
224 /* <tag> : <qualifier> : rwx \n \0 */
225 nbytes = strlen(tag) + 1 + strlen(id) + 1 + 3 + 1 + 1;
228 * If this entry would overflow the buffer
229 * allocate enough additional memory for this
230 * entry and an estimate of another 20 bytes
231 * for each entry still to be processed
233 if ((len + nbytes) > maxlen) {
234 maxlen += nbytes + 20 * (acl_d->count - i);
235 if ((text = (char *)SMB_REALLOC(text, maxlen)) == NULL) {
241 slprintf(&text[len], nbytes-1, "%s:%s:%s\n", tag, id, perms);
251 SMB_ACL_T sys_acl_init(int count)
261 * note that since the definition of the structure pointed
262 * to by the SMB_ACL_T includes the first element of the
263 * acl[] array, this actually allocates an ACL with room
264 * for (count+1) entries
266 if ((a = (struct smb_acl_t *)SMB_MALLOC(
267 sizeof(struct smb_acl_t) +
268 count * sizeof(struct smb_acl_entry))) == NULL) {
280 int sys_acl_create_entry(SMB_ACL_T *acl_p, SMB_ACL_ENTRY_T *entry_p)
283 SMB_ACL_ENTRY_T entry_d;
285 if (acl_p == NULL || entry_p == NULL || (acl_d = *acl_p) == NULL) {
290 if (acl_d->count >= acl_d->size) {
295 entry_d = &acl_d->acl[acl_d->count++];
296 entry_d->a_type = SMB_ACL_TAG_INVALID;
305 int sys_acl_set_tag_type(SMB_ACL_ENTRY_T entry_d, SMB_ACL_TAG_T tag_type)
309 case SMB_ACL_USER_OBJ:
311 case SMB_ACL_GROUP_OBJ:
314 entry_d->a_type = tag_type;
324 int sys_acl_set_qualifier(SMB_ACL_ENTRY_T entry_d, void *qual_p)
326 if (entry_d->a_type == SMB_ACL_USER) {
327 entry_d->uid = *((uid_t *)qual_p);
330 if (entry_d->a_type == SMB_ACL_GROUP) {
331 entry_d->gid = *((gid_t *)qual_p);
339 int sys_acl_set_permset(SMB_ACL_ENTRY_T entry_d, SMB_ACL_PERMSET_T permset_d)
341 if (*permset_d & ~(SMB_ACL_READ|SMB_ACL_WRITE|SMB_ACL_EXECUTE)) {
346 entry_d->a_perm = *permset_d;
351 int sys_acl_free_text(char *text)
357 int sys_acl_free_acl(SMB_ACL_T acl_d)
363 int sys_acl_free_qualifier(void *qual, SMB_ACL_TAG_T tagtype)
368 int sys_acl_valid(SMB_ACL_T acl_d)
375 * acl_get_file, acl_get_fd, acl_set_file, acl_set_fd and
376 * sys_acl_delete_def_file are to be redirected to the default
377 * statically-bound acl vfs module, but they are replacable.
380 #if defined(HAVE_POSIX_ACLS)
382 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
383 const char *path_p, SMB_ACL_TYPE_T type)
385 return posixacl_sys_acl_get_file(handle, path_p, type);
388 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
390 return posixacl_sys_acl_get_fd(handle, fsp);
393 int sys_acl_set_file(vfs_handle_struct *handle,
394 const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
396 return posixacl_sys_acl_set_file(handle, name, type, acl_d);
399 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
402 return posixacl_sys_acl_set_fd(handle, fsp, acl_d);
405 int sys_acl_delete_def_file(vfs_handle_struct *handle,
408 return posixacl_sys_acl_delete_def_file(handle, path);
411 #elif defined(HAVE_AIX_ACLS)
413 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
414 const char *path_p, SMB_ACL_TYPE_T type)
416 return aixacl_sys_acl_get_file(handle, path_p, type);
419 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
421 return aixacl_sys_acl_get_fd(handle, fsp);
424 int sys_acl_set_file(vfs_handle_struct *handle,
425 const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
427 return aixacl_sys_acl_set_file(handle, name, type, acl_d);
430 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
433 return aixacl_sys_acl_set_fd(handle, fsp, acl_d);
436 int sys_acl_delete_def_file(vfs_handle_struct *handle,
439 return aixacl_sys_acl_delete_def_file(handle, path);
442 #elif defined(HAVE_TRU64_ACLS)
444 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
445 const char *path_p, SMB_ACL_TYPE_T type)
447 return tru64acl_sys_acl_get_file(handle, path_p, type);
450 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
452 return tru64acl_sys_acl_get_fd(handle, fsp);
455 int sys_acl_set_file(vfs_handle_struct *handle,
456 const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
458 return tru64acl_sys_acl_set_file(handle, name, type, acl_d);
461 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
464 return tru64acl_sys_acl_set_fd(handle, fsp, acl_d);
467 int sys_acl_delete_def_file(vfs_handle_struct *handle,
470 return tru64acl_sys_acl_delete_def_file(handle, path);
473 #elif defined(HAVE_SOLARIS_ACLS) || defined(HAVE_UNIXWARE_ACLS)
475 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
476 const char *path_p, SMB_ACL_TYPE_T type)
478 return solarisacl_sys_acl_get_file(handle, path_p, type);
481 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
483 return solarisacl_sys_acl_get_fd(handle, fsp);
486 int sys_acl_set_file(vfs_handle_struct *handle,
487 const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
489 return solarisacl_sys_acl_set_file(handle, name, type, acl_d);
492 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
495 return solarisacl_sys_acl_set_fd(handle, fsp, acl_d);
498 int sys_acl_delete_def_file(vfs_handle_struct *handle,
501 return solarisacl_sys_acl_delete_def_file(handle, path);
504 #elif defined(HAVE_HPUX_ACLS)
506 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
507 const char *path_p, SMB_ACL_TYPE_T type)
509 return hpuxacl_sys_acl_get_file(handle, path_p, type);
512 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
514 return hpuxacl_sys_acl_get_fd(handle, fsp);
517 int sys_acl_set_file(vfs_handle_struct *handle,
518 const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
520 return hpuxacl_sys_acl_set_file(handle, name, type, acl_d);
523 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
526 return hpuxacl_sys_acl_set_fd(handle, fsp, acl_d);
529 int sys_acl_delete_def_file(vfs_handle_struct *handle,
532 return hpuxacl_sys_acl_delete_def_file(handle, path);
535 #elif defined(HAVE_IRIX_ACLS)
537 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
538 const char *path_p, SMB_ACL_TYPE_T type)
540 return irixacl_sys_acl_get_file(handle, path_p, type);
543 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
545 return irixacl_sys_acl_get_fd(handle, fsp);
548 int sys_acl_set_file(vfs_handle_struct *handle,
549 const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
551 return irixacl_sys_acl_set_file(handle, name, type, acl_d);
554 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
557 return irixacl_sys_acl_set_fd(handle, fsp, acl_d);
560 int sys_acl_delete_def_file(vfs_handle_struct *handle,
563 return irixacl_sys_acl_delete_def_file(handle, path);
568 SMB_ACL_T sys_acl_get_file(vfs_handle_struct *handle,
569 const char *path_p, SMB_ACL_TYPE_T type)
579 SMB_ACL_T sys_acl_get_fd(vfs_handle_struct *handle, files_struct *fsp)
589 int sys_acl_set_file(vfs_handle_struct *handle,
590 const char *name, SMB_ACL_TYPE_T type, SMB_ACL_T acl_d)
600 int sys_acl_set_fd(vfs_handle_struct *handle, files_struct *fsp,
611 int sys_acl_delete_def_file(vfs_handle_struct *handle,
624 /************************************************************************
625 Deliberately outside the ACL defines. Return 1 if this is a "no acls"
627 ************************************************************************/
629 int no_acl_syscall_error(int err)
637 if (err == ENOTSUP) {