Add Group Policy extension infrastructure.
[sfrench/samba-autobuild/.git] / source / include / gpo.h
1 /*
2  *  Unix SMB/CIFS implementation.
3  *  Group Policy Object Support
4  *  Copyright (C) Guenther Deschner 2005-2008
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 3 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 enum GPO_LINK_TYPE {
21         GP_LINK_UNKOWN  = 0,
22         GP_LINK_MACHINE = 1,
23         GP_LINK_SITE    = 2,
24         GP_LINK_DOMAIN  = 3,
25         GP_LINK_OU      = 4,
26         GP_LINK_LOCAL   = 5 /* for convenience */
27 };
28
29 /* GPO_OPTIONS */
30 #define GPO_FLAG_DISABLE        0x00000001
31 #define GPO_FLAG_FORCE          0x00000002
32
33 /* GPO_LIST_FLAGS */
34 #define GPO_LIST_FLAG_MACHINE   0x00000001
35 #define GPO_LIST_FLAG_SITEONLY  0x00000002
36
37 /* following flags from http://support.microsoft.com/kb/312164/EN-US/ */
38 #define GPO_INFO_FLAG_MACHINE                   0x00000001
39 #define GPO_INFO_FLAG_BACKGROUND                0x00000010
40 #define GPO_INFO_FLAG_SLOWLINK                  0x00000020
41 #define GPO_INFO_FLAG_VERBOSE                   0x00000040
42 #define GPO_INFO_FLAG_NOCHANGES                 0x00000080
43 #define GPO_INFO_FLAG_LINKTRANSITION            0x00000100
44 #define GPO_INFO_FLAG_LOGRSOP_TRANSITION        0x00000200
45 #define GPO_INFO_FLAG_FORCED_REFRESH            0x00000400
46 #define GPO_INFO_FLAG_SAFEMODE_BOOT             0x00000800
47
48 #define GPO_VERSION_USER(x) (x >> 16)
49 #define GPO_VERSION_MACHINE(x) (x & 0xffff)
50
51 struct GROUP_POLICY_OBJECT {
52         uint32_t options;       /* GPFLAGS_* */
53         uint32_t version;
54         const char *ds_path;
55         const char *file_sys_path;
56         const char *display_name;
57         const char *name;
58         const char *link;
59         enum GPO_LINK_TYPE link_type;
60         const char *user_extensions;
61         const char *machine_extensions;
62         SEC_DESC *security_descriptor;
63         struct GROUP_POLICY_OBJECT *next, *prev;
64 };
65
66 /* the following is seen on the DS (see adssearch.pl for details) */
67
68 /* the type field in a 'gPLink', the same as GPO_FLAG ? */
69 #define GPO_LINK_OPT_NONE       0x00000000
70 #define GPO_LINK_OPT_DISABLED   0x00000001
71 #define GPO_LINK_OPT_ENFORCED   0x00000002
72
73 /* GPO_LINK_OPT_ENFORCED takes precedence over GPOPTIONS_BLOCK_INHERITANCE */
74
75 /* 'gPOptions', maybe a bitmask as well */
76 enum GPO_INHERIT {
77         GPOPTIONS_INHERIT               = 0,
78         GPOPTIONS_BLOCK_INHERITANCE     = 1
79 };
80
81 /* 'flags' in a 'groupPolicyContainer' object */
82 #define GPFLAGS_ALL_ENABLED                     0x00000000
83 #define GPFLAGS_USER_SETTINGS_DISABLED          0x00000001
84 #define GPFLAGS_MACHINE_SETTINGS_DISABLED       0x00000002
85 #define GPFLAGS_ALL_DISABLED (GPFLAGS_USER_SETTINGS_DISABLED | \
86                               GPFLAGS_MACHINE_SETTINGS_DISABLED)
87
88 struct GP_LINK {
89         const char *gp_link;    /* raw link name */
90         uint32_t gp_opts;               /* inheritance options GPO_INHERIT */
91         uint32_t num_links;     /* number of links */
92         char **link_names;      /* array of parsed link names */
93         uint32_t *link_opts;    /* array of parsed link opts GPO_LINK_OPT_* */
94 };
95
96 struct GP_EXT {
97         const char *gp_extension;       /* raw extension name */
98         uint32_t num_exts;
99         char **extensions;
100         char **extensions_guid;
101         char **snapins;
102         char **snapins_guid;
103         struct GP_EXT *next, *prev;
104 };
105
106 #define GPO_CACHE_DIR "gpo_cache"
107 #define GPT_INI "GPT.INI"
108 #define GPO_REFRESH_INTERVAL 60*90
109
110 #define GPO_REG_STATE_MACHINE "State\\Machine"
111
112 enum gp_reg_action {
113         GP_REG_ACTION_NONE = 0,
114         GP_REG_ACTION_ADD_VALUE = 1,
115         GP_REG_ACTION_ADD_KEY = 2,
116         GP_REG_ACTION_DEL_VALUES = 3,
117         GP_REG_ACTION_DEL_VALUE = 4,
118         GP_REG_ACTION_DEL_ALL_VALUES = 5,
119         GP_REG_ACTION_DEL_KEYS = 6,
120         GP_REG_ACTION_SEC_KEY_SET = 7,
121         GP_REG_ACTION_SEC_KEY_RESET = 8
122 };
123
124 struct gp_registry_entry {
125         enum gp_reg_action action;
126         const char *key;
127         const char *value;
128         struct registry_value *data;
129 };
130
131 struct gp_registry_value {
132         const char *value;
133         struct registry_value *data;
134 };
135
136 struct gp_registry_entry2 {
137         enum gp_reg_action action;
138         const char *key;
139         size_t num_values;
140         struct gp_registry_value **values;
141 };
142
143 struct gp_registry_entries {
144         size_t num_entries;
145         struct gp_registry_entry **entries;
146 };
147
148 struct gp_registry_context {
149         const struct nt_user_token *token;
150         const char *path;
151         struct registry_key *curr_key;
152 };
153
154 #define GP_EXT_GUID_SECURITY "827D319E-6EAC-11D2-A4EA-00C04F79F83A"
155 #define GP_EXT_GUID_REGISTRY "35378EAC-683F-11D2-A89A-00C04FBBCFA2"
156 #define GP_EXT_GUID_SCRIPTS  "42B5FAAE-6536-11D2-AE5A-0000F87571E3"
157
158 #include "libgpo/gpext/gpext.h"