Tweaking the license text a bit more.
[rsync/rsync.git] / lib / sysacls.h
index 808ecf0..d22f995 100644 (file)
@@ -1,23 +1,22 @@
-/* 
-   Unix SMB/Netbios implementation.
-   Version 2.2.x
-   Portable SMB ACL interface
-   Copyright (C) Jeremy Allison 2000
-   
-   This program is free software; you can redistribute it and/or modify
-   it under the terms of the GNU General Public License as published by
-   the Free Software Foundation; either version 2 of the License, or
-   (at your option) any later version.
-   
-   This program is distributed in the hope that it will be useful,
-   but WITHOUT ANY WARRANTY; without even the implied warranty of
-   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-   GNU General Public License for more details.
-   
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, write to the Free Software
-   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
-*/
+/*
+ * Unix SMB/Netbios implementation.
+ * Version 2.2.x
+ * Portable SMB ACL interface
+ * Copyright (C) Jeremy Allison 2000
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * with this program; if not, visit the http://fsf.org website.
+ */
 
 #ifdef SUPPORT_ACLS
 
 
 #ifdef SUPPORT_ACLS
 
 #define SMB_ACL_TAG_T          acl_tag_t
 #define SMB_ACL_TYPE_T         acl_type_t
 #define SMB_ACL_PERMSET_T      acl_permset_t
 #define SMB_ACL_TAG_T          acl_tag_t
 #define SMB_ACL_TYPE_T         acl_type_t
 #define SMB_ACL_PERMSET_T      acl_permset_t
-#define SMB_ACL_PERM_T         acl_perm_t
-#define SMB_ACL_READ           ACL_READ
-#define SMB_ACL_WRITE          ACL_WRITE
-#define SMB_ACL_EXECUTE                ACL_EXECUTE
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACL_USER
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACL_USER
 #define SMB_ACL_TYPE_ACCESS    ACL_TYPE_ACCESS
 #define SMB_ACL_TYPE_DEFAULT   ACL_TYPE_DEFAULT
 
 #define SMB_ACL_TYPE_ACCESS    ACL_TYPE_ACCESS
 #define SMB_ACL_TYPE_DEFAULT   ACL_TYPE_DEFAULT
 
+#define SMB_ACL_VALID_NAME_BITS        (4 | 2 | 1)
+#define SMB_ACL_VALID_OBJ_BITS (4 | 2 | 1)
+
+#define SMB_ACL_NEED_SORT
+
 #elif defined HAVE_TRU64_ACLS
 
 /* This is for DEC/Compaq Tru64 UNIX */
 #elif defined HAVE_TRU64_ACLS
 
 /* This is for DEC/Compaq Tru64 UNIX */
 #define SMB_ACL_TAG_T          acl_tag_t
 #define SMB_ACL_TYPE_T         acl_type_t
 #define SMB_ACL_PERMSET_T      acl_permset_t
 #define SMB_ACL_TAG_T          acl_tag_t
 #define SMB_ACL_TYPE_T         acl_type_t
 #define SMB_ACL_PERMSET_T      acl_permset_t
-#define SMB_ACL_PERM_T         acl_perm_t
-#define SMB_ACL_READ           ACL_READ
-#define SMB_ACL_WRITE          ACL_WRITE
-#define SMB_ACL_EXECUTE                ACL_EXECUTE
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACL_USER
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACL_USER
 #define SMB_ACL_TYPE_ACCESS    ACL_TYPE_ACCESS
 #define SMB_ACL_TYPE_DEFAULT   ACL_TYPE_DEFAULT
 
 #define SMB_ACL_TYPE_ACCESS    ACL_TYPE_ACCESS
 #define SMB_ACL_TYPE_DEFAULT   ACL_TYPE_DEFAULT
 
+#define SMB_ACL_VALID_NAME_BITS        (4 | 2 | 1)
+#define SMB_ACL_VALID_OBJ_BITS (4 | 2 | 1)
+
+#define SMB_ACL_NEED_SORT
+
 #elif defined HAVE_UNIXWARE_ACLS || defined HAVE_SOLARIS_ACLS
 #elif defined HAVE_UNIXWARE_ACLS || defined HAVE_SOLARIS_ACLS
-/*
- * Donated by Michael Davidson <md@sco.COM> for UnixWare / OpenUNIX.
- * Modified by Toomas Soome <tsoome@ut.ee> for Solaris.
- */
+
+/* Donated by Michael Davidson <md@sco.COM> for UnixWare / OpenUNIX.
+ * Modified by Toomas Soome <tsoome@ut.ee> for Solaris.  */
 
 /* SVR4.2 ES/MP ACLs */
 typedef int SMB_ACL_TAG_T;
 typedef int SMB_ACL_TYPE_T;
 typedef ushort *SMB_ACL_PERMSET_T;
 
 /* SVR4.2 ES/MP ACLs */
 typedef int SMB_ACL_TAG_T;
 typedef int SMB_ACL_TYPE_T;
 typedef ushort *SMB_ACL_PERMSET_T;
-typedef ushort SMB_ACL_PERM_T;
-#define SMB_ACL_READ           4
-#define SMB_ACL_WRITE          2
-#define SMB_ACL_EXECUTE                1
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           USER
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           USER
@@ -132,15 +128,18 @@ typedef struct acl *SMB_ACL_ENTRY_T;
 #define SMB_ACL_TYPE_ACCESS    0
 #define SMB_ACL_TYPE_DEFAULT   1
 
 #define SMB_ACL_TYPE_ACCESS    0
 #define SMB_ACL_TYPE_DEFAULT   1
 
+#define SMB_ACL_VALID_NAME_BITS        (4 | 2 | 1)
+#define SMB_ACL_VALID_OBJ_BITS (4 | 2 | 1)
+
+#define SMB_ACL_NEED_SORT
+
 #ifdef __CYGWIN__
 #define SMB_ACL_LOSES_SPECIAL_MODE_BITS
 #endif
 
 #elif defined HAVE_HPUX_ACLS
 
 #ifdef __CYGWIN__
 #define SMB_ACL_LOSES_SPECIAL_MODE_BITS
 #endif
 
 #elif defined HAVE_HPUX_ACLS
 
-/*
- * Based on the Solaris & UnixWare code.
- */
+/* Based on the Solaris & UnixWare code. */
 
 #undef GROUP
 #include <sys/aclv.h>
 
 #undef GROUP
 #include <sys/aclv.h>
@@ -149,10 +148,6 @@ typedef struct acl *SMB_ACL_ENTRY_T;
 typedef int SMB_ACL_TAG_T;
 typedef int SMB_ACL_TYPE_T;
 typedef ushort *SMB_ACL_PERMSET_T;
 typedef int SMB_ACL_TAG_T;
 typedef int SMB_ACL_TYPE_T;
 typedef ushort *SMB_ACL_PERMSET_T;
-typedef ushort SMB_ACL_PERM_T;
-#define SMB_ACL_READ           4
-#define SMB_ACL_WRITE          2
-#define SMB_ACL_EXECUTE                1
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           USER
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           USER
@@ -177,15 +172,18 @@ typedef struct acl *SMB_ACL_ENTRY_T;
 #define SMB_ACL_TYPE_ACCESS    0
 #define SMB_ACL_TYPE_DEFAULT   1
 
 #define SMB_ACL_TYPE_ACCESS    0
 #define SMB_ACL_TYPE_DEFAULT   1
 
+#define SMB_ACL_VALID_NAME_BITS        (4 | 2 | 1)
+#define SMB_ACL_VALID_OBJ_BITS (4 | 2 | 1)
+
+#define SMB_ACL_NEED_SORT
+
 #elif defined HAVE_IRIX_ACLS
 
 #elif defined HAVE_IRIX_ACLS
 
+/* IRIX ACLs */
+
 #define SMB_ACL_TAG_T          acl_tag_t
 #define SMB_ACL_TYPE_T         acl_type_t
 #define SMB_ACL_PERMSET_T      acl_permset_t
 #define SMB_ACL_TAG_T          acl_tag_t
 #define SMB_ACL_TYPE_T         acl_type_t
 #define SMB_ACL_PERMSET_T      acl_permset_t
-#define SMB_ACL_PERM_T         acl_perm_t
-#define SMB_ACL_READ           ACL_READ
-#define SMB_ACL_WRITE          ACL_WRITE
-#define SMB_ACL_EXECUTE                ACL_EXECUTE
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACL_USER
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACL_USER
@@ -209,6 +207,11 @@ typedef struct SMB_ACL_T {
 #define SMB_ACL_TYPE_ACCESS    ACL_TYPE_ACCESS
 #define SMB_ACL_TYPE_DEFAULT   ACL_TYPE_DEFAULT
 
 #define SMB_ACL_TYPE_ACCESS    ACL_TYPE_ACCESS
 #define SMB_ACL_TYPE_DEFAULT   ACL_TYPE_DEFAULT
 
+#define SMB_ACL_VALID_NAME_BITS        (4 | 2 | 1)
+#define SMB_ACL_VALID_OBJ_BITS (4 | 2 | 1)
+
+#define SMB_ACL_NEED_SORT
+
 #elif defined HAVE_AIX_ACLS
 
 /* Donated by Medha Date, mdate@austin.ibm.com, for IBM */
 #elif defined HAVE_AIX_ACLS
 
 /* Donated by Medha Date, mdate@austin.ibm.com, for IBM */
@@ -236,10 +239,6 @@ struct new_acl_entry{
  
 #define SMB_ACL_TAG_T          unsigned short
 #define SMB_ACL_TYPE_T         int
  
 #define SMB_ACL_TAG_T          unsigned short
 #define SMB_ACL_TYPE_T         int
-#define SMB_ACL_PERM_T         uint
-#define SMB_ACL_READ           S_IRUSR
-#define SMB_ACL_WRITE          S_IWUSR
-#define SMB_ACL_EXECUTE                S_IXUSR
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACEID_USER
 
 /* Types of ACLs. */
 #define SMB_ACL_USER           ACEID_USER
@@ -256,61 +255,34 @@ struct new_acl_entry{
 #define SMB_ACL_TYPE_ACCESS    0
 #define SMB_ACL_TYPE_DEFAULT   1
 
 #define SMB_ACL_TYPE_ACCESS    0
 #define SMB_ACL_TYPE_DEFAULT   1
 
-#else /* No ACLs. */
-
-/* No ACLS - fake it. */
-#define SMB_ACL_TAG_T          int
-#define SMB_ACL_TYPE_T         int
-#define SMB_ACL_PERMSET_T      mode_t
-#define SMB_ACL_PERM_T         mode_t
-#define SMB_ACL_READ           S_IRUSR
-#define SMB_ACL_WRITE          S_IWUSR
-#define SMB_ACL_EXECUTE                S_IXUSR
-
-/* Types of ACLs. */
-#define SMB_ACL_USER           0
-#define SMB_ACL_USER_OBJ       1
-#define SMB_ACL_GROUP          2
-#define SMB_ACL_GROUP_OBJ      3
-#define SMB_ACL_OTHER          4
-#define SMB_ACL_MASK           5
+#define SMB_ACL_VALID_NAME_BITS        (4 | 2 | 1)
+#define SMB_ACL_VALID_OBJ_BITS (4 | 2 | 1)
 
 
-typedef struct SMB_ACL_T {
-       int dummy;
-} *SMB_ACL_T;
+#define SMB_ACL_NEED_SORT
 
 
-typedef struct SMB_ACL_ENTRY_T {
-       int dummy;
-} *SMB_ACL_ENTRY_T;
+#else
 
 
-#define SMB_ACL_FIRST_ENTRY    0
-#define SMB_ACL_NEXT_ENTRY     1
+/* Unknown platform. */
 
 
-#define SMB_ACL_TYPE_ACCESS    0
-#define SMB_ACL_TYPE_DEFAULT   1
+#error Cannot handle ACLs on this platform!
 
 
-#endif /* No ACLs. */
+#endif
 
 int sys_acl_get_entry(SMB_ACL_T the_acl, int entry_id, SMB_ACL_ENTRY_T *entry_p);
 int sys_acl_get_tag_type(SMB_ACL_ENTRY_T entry_d, SMB_ACL_TAG_T *tag_type_p);
 
 int sys_acl_get_entry(SMB_ACL_T the_acl, int entry_id, SMB_ACL_ENTRY_T *entry_p);
 int sys_acl_get_tag_type(SMB_ACL_ENTRY_T entry_d, SMB_ACL_TAG_T *tag_type_p);
-int sys_acl_get_permset(SMB_ACL_ENTRY_T entry_d, SMB_ACL_PERMSET_T *permset_p);
+int sys_acl_get_access_bits(SMB_ACL_ENTRY_T entry_d, uint32 *bits);
 void *sys_acl_get_qualifier(SMB_ACL_ENTRY_T entry_d);
 SMB_ACL_T sys_acl_get_file(const char *path_p, SMB_ACL_TYPE_T type);
 SMB_ACL_T sys_acl_get_fd(int fd);
 void *sys_acl_get_qualifier(SMB_ACL_ENTRY_T entry_d);
 SMB_ACL_T sys_acl_get_file(const char *path_p, SMB_ACL_TYPE_T type);
 SMB_ACL_T sys_acl_get_fd(int fd);
-int sys_acl_clear_perms(SMB_ACL_PERMSET_T permset);
-int sys_acl_add_perm(SMB_ACL_PERMSET_T permset, SMB_ACL_PERM_T perm);
-int sys_acl_get_perm(SMB_ACL_PERMSET_T permset, SMB_ACL_PERM_T perm);
-char *sys_acl_to_text(SMB_ACL_T the_acl, ssize_t *plen);
 SMB_ACL_T sys_acl_init(int count);
 int sys_acl_create_entry(SMB_ACL_T *pacl, SMB_ACL_ENTRY_T *pentry);
 int sys_acl_set_tag_type(SMB_ACL_ENTRY_T entry, SMB_ACL_TAG_T tagtype);
 int sys_acl_set_qualifier(SMB_ACL_ENTRY_T entry, void *qual);
 SMB_ACL_T sys_acl_init(int count);
 int sys_acl_create_entry(SMB_ACL_T *pacl, SMB_ACL_ENTRY_T *pentry);
 int sys_acl_set_tag_type(SMB_ACL_ENTRY_T entry, SMB_ACL_TAG_T tagtype);
 int sys_acl_set_qualifier(SMB_ACL_ENTRY_T entry, void *qual);
-int sys_acl_set_permset(SMB_ACL_ENTRY_T entry, SMB_ACL_PERMSET_T permset);
+int sys_acl_set_access_bits(SMB_ACL_ENTRY_T entry, uint32 bits);
 int sys_acl_valid(SMB_ACL_T theacl);
 int sys_acl_set_file(const char *name, SMB_ACL_TYPE_T acltype, SMB_ACL_T theacl);
 int sys_acl_set_fd(int fd, SMB_ACL_T theacl);
 int sys_acl_delete_def_file(const char *name);
 int sys_acl_valid(SMB_ACL_T theacl);
 int sys_acl_set_file(const char *name, SMB_ACL_TYPE_T acltype, SMB_ACL_T theacl);
 int sys_acl_set_fd(int fd, SMB_ACL_T theacl);
 int sys_acl_delete_def_file(const char *name);
-int sys_acl_free_text(char *text);
 int sys_acl_free_acl(SMB_ACL_T the_acl);
 int sys_acl_free_qualifier(void *qual, SMB_ACL_TAG_T tagtype);
 int no_acl_syscall_error(int err);
 int sys_acl_free_acl(SMB_ACL_T the_acl);
 int sys_acl_free_qualifier(void *qual, SMB_ACL_TAG_T tagtype);
 int no_acl_syscall_error(int err);