2f51560ffe0a749a4a98010466d4231951f26fdb
[wimlib] / include / wimlib / security.h
1 #ifndef _WIMLIB_SECURITY_H
2 #define _WIMLIB_SECURITY_H
3
4 #include "wimlib/rbtree.h"
5 #include "wimlib/types.h"
6
7 /* Red-black tree that maps SHA1 message digests of security descriptors to
8  * security IDs, which are themselves indices into the table of security
9  * descriptors in the 'struct wim_security_data'. */
10 struct wim_sd_set {
11         struct wim_security_data *sd;
12         struct rb_root rb_root;
13         int32_t orig_num_entries;
14 };
15
16 /* Table of security descriptors for a WIM image. */
17 struct wim_security_data {
18         /* The total length of the security data, in bytes.  If there are no
19          * security descriptors, this field, when read from the on-disk metadata
20          * resource, may be either 8 (which is correct) or 0 (which is
21          * interpreted as 8). */
22         u32 total_length;
23
24         /* The number of security descriptors in the array @descriptors. */
25         u32 num_entries;
26
27         /* Array of sizes of the descriptors, in bytes, in the array
28          * @descriptors. */
29         size_t *sizes;
30
31         /* Array of pointers to the security descriptors in the
32          * SECURITY_DESCRIPTOR_RELATIVE format. */
33         u8 **descriptors;
34 };
35
36 extern void
37 destroy_sd_set(struct wim_sd_set *sd_set, bool rollback);
38
39 extern int
40 lookup_sd(struct wim_sd_set *set, const u8 hash[]);
41
42 extern int
43 sd_set_add_sd(struct wim_sd_set *sd_set, const char descriptor[],
44               size_t size);
45
46 extern int
47 init_sd_set(struct wim_sd_set *sd_set, struct wim_security_data *sd);
48
49 extern struct wim_security_data *
50 new_wim_security_data(void);
51
52 extern int
53 read_wim_security_data(const u8 metadata_resource[], size_t
54                        metadata_resource_len, struct wim_security_data **sd_p);
55
56 extern u8 *
57 write_wim_security_data(const struct wim_security_data * restrict sd, u8 *
58                         restrict p);
59
60 extern void
61 print_wim_security_data(const struct wim_security_data *sd);
62
63 extern void
64 free_wim_security_data(struct wim_security_data *sd);
65
66 #endif /* _WIMLIB_SECURITY_H */