From 4978ee9a87e5510a56defc3e556c4a2c31a7bdc4 Mon Sep 17 00:00:00 2001 From: rwatson Date: Mon, 19 Mar 2001 18:09:25 +0000 Subject: o POSIX.2c Userland tool support for POSIX.1e ACLs -- getfacl retrieves ACLs from files and directories, and setfacl sets ACLs on files and directories. Submitted by: jedgar Obtained from: TrustedBSD Project --- bin/getfacl/getfacl.1 | 100 +++++++++++++++++++++++++ bin/getfacl/getfacl.c | 201 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 301 insertions(+) create mode 100644 bin/getfacl/getfacl.1 create mode 100644 bin/getfacl/getfacl.c (limited to 'bin/getfacl') diff --git a/bin/getfacl/getfacl.1 b/bin/getfacl/getfacl.1 new file mode 100644 index 0000000..20d0906 --- /dev/null +++ b/bin/getfacl/getfacl.1 @@ -0,0 +1,100 @@ +.\"- +.\" Copyright (c) 2000 Robert N. M. Watson +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd March 30, 2000 +.Dt GETFACL 1 +.Os +.Sh NAME +.Nm getfacl +.Nd Get ACL Information +.Sh SYNOPSIS +.Nm getfacl +.Op Fl d +.Op Ar file ... +.Sh DESCRIPTION +The +.Nm +utility writes discretionary access control information associated with +the specified file(s) to standard output. +If the +.Xr getconf 8 +utility indicates that +.Va {_POSIX_ACL_EXTENDED} +is not in effect for a +.Ar file +then the standard discretionary access permissions are interpreted as +an ACL containing only the required ACL entries. +.Pp +The following option is available: +.Bl -tag -width indent +.It Fl d +The operation applies to the default ACL of a directory instead of the +access ACL. +An error shall be generated if a default ACL cannot be associated with +.Op Ar file . +.El +.Pp +The following operand is available: +.Bl -tag -width indent +.It Ar file +A pathname of a file whose ACL shall be retrieved. +If +.Op Ar file +is not specified, or a +.Op Ar file +is specified as "-", then +.Nm +shall read a list of pathnames, each terminated by one character, +from the standard input. +.El +.Pp +.Sh EXAMPLES +.Pp +.Dl getfacl / +.Pp +Retrieve ACL for the directory "/". +.Pp +.Dl getfacl -d / +.Pp +Retrieve the default ACL for the directory "/", if any. +.Sh SEE ALSO +.Xr setfacl 1 , +.Xr acl 3 , +.Xr getextattr 8 , +.Xr setextattr 8 , +.Xr acl 9 , +.Xr extattr 9 +.Sh STANDARDS +The +.Nm +utility is expected to be IEEE Std 1003.2c compliant. +.Sh HISTORY +Extended Attribute and Access Control List support was developed as part +of the TrustedBSD Project and introduced in +.Fx 5.0 +.Sh AUTHORS +Robert N M Watson diff --git a/bin/getfacl/getfacl.c b/bin/getfacl/getfacl.c new file mode 100644 index 0000000..638d26d --- /dev/null +++ b/bin/getfacl/getfacl.c @@ -0,0 +1,201 @@ +/*- + * Copyright (c) 1999-2001 Robert N M Watson + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * $FreeBSD$ + */ +/* + * getfacl -- POSIX.1e utility to extract ACLs from files and directories + * and send the results to stdout + */ + +#include +#include +#include +#include +#include +#include +#include +#include + +int more_than_one = 0; + +static void +usage(void) +{ + + fprintf(stderr, "getfacl [-d] [files ...]\n"); +} + +static acl_t +acl_from_stat(struct stat sb) +{ + acl_t acl; + + acl = acl_init(3); + if (!acl) + return(NULL); + + acl->acl_entry[0].ae_tag = ACL_USER_OBJ; + acl->acl_entry[0].ae_id = sb.st_uid; + acl->acl_entry[0].ae_perm = 0; + if (sb.st_mode & S_IRUSR) + acl->acl_entry[0].ae_perm |= ACL_PERM_READ; + if (sb.st_mode & S_IWUSR) + acl->acl_entry[0].ae_perm |= ACL_PERM_WRITE; + if (sb.st_mode & S_IXUSR) + acl->acl_entry[0].ae_perm |= ACL_PERM_EXEC; + + acl->acl_entry[1].ae_tag = ACL_GROUP_OBJ; + acl->acl_entry[1].ae_id = sb.st_gid; + acl->acl_entry[1].ae_perm = 0; + if (sb.st_mode & S_IRGRP) + acl->acl_entry[1].ae_perm |= ACL_PERM_READ; + if (sb.st_mode & S_IWGRP) + acl->acl_entry[1].ae_perm |= ACL_PERM_WRITE; + if (sb.st_mode & S_IXGRP) + acl->acl_entry[1].ae_perm |= ACL_PERM_EXEC; + + acl->acl_entry[2].ae_tag = ACL_OTHER_OBJ; + acl->acl_entry[2].ae_id = 0; + acl->acl_entry[2].ae_perm = 0; + if (sb.st_mode & S_IROTH) + acl->acl_entry[2].ae_perm |= ACL_PERM_READ; + if (sb.st_mode & S_IWOTH) + acl->acl_entry[2].ae_perm |= ACL_PERM_WRITE; + if (sb.st_mode & S_IXOTH) + acl->acl_entry[2].ae_perm |= ACL_PERM_EXEC; + + acl->acl_cnt = 3; + + return(acl); +} + +static int +print_acl(char *path, acl_type_t type) +{ + struct stat sb; + acl_t acl; + char *acl_text; + int error; + + error = stat(path, &sb); + if (error == -1) { + perror(path); + return(-1); + } + + if (more_than_one) + printf("\n"); + else + more_than_one++; + + printf("#file:%s\n#owner:%d\n#group:%d\n", path, sb.st_uid, sb.st_gid); + + acl = acl_get_file(path, type); + if (!acl) { + if (errno != EOPNOTSUPP) { + warn("%s", path); + return(-1); + } + errno = 0; + if (type != ACL_TYPE_ACCESS) + return(0); + acl = acl_from_stat(sb); + if (!acl) { + perror("acl_from_stat()"); + return(-1); + } + } + + acl_text = acl_to_text(acl, 0); + if (!acl_text) { + perror(path); + return(-1); + } + + printf("%s", acl_text); + + acl_free(acl); + acl_free(acl_text); + + return(0); +} + +static int +print_acl_from_stdin(acl_type_t type) +{ + char pathname[PATH_MAX]; + int carried_error = 0; + + pathname[sizeof(pathname) - 1] = '\0'; + while (fgets(pathname, sizeof(pathname), stdin)) { + /* remove the \n */ + pathname[strlen(pathname) - 1] = '\0'; + if (print_acl(pathname, type) == -1) { + carried_error = -1; + } + } + + return(carried_error); +} + +int +main(int argc, char *argv[]) +{ + acl_type_t type = ACL_TYPE_ACCESS; + int carried_error = 0; + int ch, error, i; + + while ((ch = getopt(argc, argv, "d")) != -1) + switch(ch) { + case 'd': + type = ACL_TYPE_DEFAULT; + break; + default: + usage(); + return(-1); + } + argc -= optind; + argv += optind; + + if (argc == 0) { + error = print_acl_from_stdin(type); + return(error); + } + + for (i = 0; i < argc; i++) { + if (!strcmp(argv[i], "-")) { + error = print_acl_from_stdin(type); + if (error == -1) + carried_error = -1; + } else { + error = print_acl(argv[i], type); + if (error == -1) + carried_error = -1; + } + } + + return(carried_error); +} -- cgit v1.1