/*
- * security_descriptor.h
+ * security_descriptor.h - declarations for Windows security descriptor format
*
- * The author dedicates this file to the public domain.
- * You can do whatever you want with this file.
+ * Copyright 2022 Eric Biggers
+ *
+ * Permission is hereby granted, free of charge, to any person
+ * obtaining a copy of this software and associated documentation
+ * files (the "Software"), to deal in the Software without
+ * restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following
+ * conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
*/
#ifndef _WIMLIB_SECURITY_DESCRIPTOR_H
#define wimlib_SE_RM_CONTROL_VALID 0x4000
#define wimlib_SE_SELF_RELATIVE 0x8000
+/* Windows NT security identifier (user or group) */
+typedef struct {
+
+ u8 revision;
+ u8 sub_authority_count;
+
+ /* Identifies the authority that issued the SID */
+ u8 identifier_authority[6];
+
+ le32 sub_authority[];
+} _packed_attribute wimlib_SID;
+
+/* Header of a Windows NT access control list */
+typedef struct {
+ /* ACL_REVISION or ACL_REVISION_DS */
+ u8 revision;
+
+ /* padding */
+ u8 sbz1;
+
+ /* Total size of the ACL, including all access control entries */
+ le16 acl_size;
+
+ /* Number of access control entry structures that follow the ACL
+ * structure */
+ le16 ace_count;
+
+ /* padding */
+ le16 sbz2;
+} _packed_attribute wimlib_ACL;
+
+#define wimlib_ACCESS_ALLOWED_ACE_TYPE 0
+#define wimlib_ACCESS_DENIED_ACE_TYPE 1
+#define wimlib_SYSTEM_AUDIT_ACE_TYPE 2
+
/* Header of a Windows NT access control entry */
typedef struct {
/* Type of ACE */
typedef struct {
wimlib_ACE_HEADER hdr;
le32 mask;
- le32 sid_start;
+ wimlib_SID sid;
} _packed_attribute wimlib_ACCESS_ALLOWED_ACE;
/* Windows NT access control entry to deny rights to a user or group */
typedef struct {
wimlib_ACE_HEADER hdr;
le32 mask;
- le32 sid_start;
+ wimlib_SID sid;
} _packed_attribute wimlib_ACCESS_DENIED_ACE;
/* Windows NT access control entry to audit access to the object */
typedef struct {
wimlib_ACE_HEADER hdr;
le32 mask;
- le32 sid_start;
+ wimlib_SID sid;
} _packed_attribute wimlib_SYSTEM_AUDIT_ACE;
-
-/* Header of a Windows NT access control list */
-typedef struct {
- /* ACL_REVISION or ACL_REVISION_DS */
- u8 revision;
-
- /* padding */
- u8 sbz1;
-
- /* Total size of the ACL, including all access control entries */
- le16 acl_size;
-
- /* Number of access control entry structures that follow the ACL
- * structure */
- le16 ace_count;
-
- /* padding */
- le16 sbz2;
-} _packed_attribute wimlib_ACL;
-
-/* Windows NT security identifier (user or group) */
-typedef struct {
-
- u8 revision;
- u8 sub_authority_count;
-
- /* Identifies the authority that issued the SID */
- u8 identifier_authority[6];
-
- le32 sub_authority[];
-} _packed_attribute wimlib_SID;
-
-#endif
+#endif /* _WIMLIB_SECURITY_DESCRIPTOR_H */