include/libacl.h

   1 /*
   2   File: libacl.h
   3
   4   (C) 1999, 2000 Andreas Gruenbacher, <a.gruenbacher@computer.org>
   5
   6   This program is free software: you can redistribute it and/or modify it
   7   under the terms of the GNU Lesser General Public License as published by
   8   the Free Software Foundation, either version 2.1 of the License, or
   9   (at your option) any later version.
  10
  11   This program is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License
  17   along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef __ACL_LIBACL_H
  21 #define __ACL_LIBACL_H
  22
  23 #include <sys/acl.h>
  24
  25 #ifdef __cplusplus
  26 extern "C" {
  27 #endif
  28
  29 /* Flags for acl_to_any_text() */
  30
  31 /* Print NO, SOME or ALL effective permissions comments. SOME prints
  32    effective rights comments for entries which have different permissions
  33    than effective permissions.  */
  34 #define TEXT_SOME_EFFECTIVE             0x01
  35 #define TEXT_ALL_EFFECTIVE              0x02
  36
  37 /* Align effective permission comments to column 32 using tabs or
  38    use a single tab. */
  39 #define TEXT_SMART_INDENT               0x04
  40
  41 /* User and group IDs instead of names. */
  42 #define TEXT_NUMERIC_IDS                0x08
  43
  44 /* Only output the first letter of entry types
  45    ("u::rwx" instead of "user::rwx"). */
  46 #define TEXT_ABBREVIATE                 0x10
  47
  48 /* acl_check error codes */
  49
  50 #define ACL_MULTI_ERROR         (0x1000)     /* multiple unique objects */
  51 #define ACL_DUPLICATE_ERROR     (0x2000)     /* duplicate Id's in entries */
  52 #define ACL_MISS_ERROR          (0x3000)     /* missing required entry */
  53 #define ACL_ENTRY_ERROR         (0x4000)     /* wrong entry type */
  54
  55 extern char *acl_to_any_text(acl_t acl, const char *prefix,
  56                              char separator, int options);
  57 extern int acl_cmp(acl_t acl1, acl_t acl2);
  58 extern int acl_check(acl_t acl, int *last);
  59 extern acl_t acl_from_mode(mode_t mode);
  60 extern int acl_equiv_mode(acl_t acl, mode_t *mode_p);
  61 int acl_extended_file(const char *path_p);
  62 int acl_extended_file_nofollow(const char *path_p);
  63 int acl_extended_fd(int fd);
  64 extern int acl_entries(acl_t acl);
  65 extern const char *acl_error(int code);
  66 extern int acl_get_perm(acl_permset_t permset_d, acl_perm_t perm);
  67
  68 /* Copying permissions between files */
  69 struct error_context;
  70 extern int perm_copy_file (const char *, const char *,
  71                             struct error_context *);
  72 extern int perm_copy_fd (const char *, int, const char *, int,
  73                           struct error_context *);
  74
  75 #ifdef __cplusplus
  76 }
  77 #endif
  78
  79 #endif  /* __ACL_LIBACL_H */
  80