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  EXPORT char *acl_to_any_text(acl_t acl, const char *prefix,
      56  			     char separator, int options);
      57  EXPORT int acl_cmp(acl_t acl1, acl_t acl2);
      58  EXPORT int acl_check(acl_t acl, int *last);
      59  EXPORT acl_t acl_from_mode(mode_t mode);
      60  EXPORT int acl_equiv_mode(acl_t acl, mode_t *mode_p);
      61  EXPORT int acl_extended_file(const char *path_p);
      62  EXPORT int acl_extended_file_nofollow(const char *path_p);
      63  EXPORT int acl_extended_fd(int fd);
      64  EXPORT int acl_entries(acl_t acl);
      65  EXPORT const char *acl_error(int code);
      66  EXPORT int acl_get_perm(acl_permset_t permset_d, acl_perm_t perm);
      67  
      68  /* Copying permissions between files */
      69  struct error_context;
      70  EXPORT int perm_copy_file (const char *, const char *,
      71  			    struct error_context *);
      72  EXPORT 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