1 /*
2  *  Unix SMB/CIFS implementation.
3  *  Group Policy Object Support
4  *  Copyright (C) Guenther Deschner 2005-2008 (from samba 3 gpo.h)
5  *  Copyright (C) Wilco Baan Hofman 2010
6  *
7  *  This program is free software; you can redistribute it and/or modify
8  *  it under the terms of the GNU General Public License as published by
9  *  the Free Software Foundation; either version 3 of the License, or
10  *  (at your option) any later version.
11  *
12  *  This program is distributed in the hope that it will be useful,
13  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  *  GNU General Public License for more details.
16  *
17  *  You should have received a copy of the GNU General Public License
18  *  along with this program; if not, see <http://www.gnu.org/licenses/>.
19  */
20 
21 #ifndef __POLICY_H__
22 #define __POLICY_H__
23 
24 #define GPLINK_OPT_DISABLE		(1 << 0)
25 #define GPLINK_OPT_ENFORCE		(1 << 1)
26 
27 #define GPO_FLAG_USER_DISABLE		(1 << 0)
28 #define GPO_FLAG_MACHINE_DISABLE	(1 << 1)
29 
30 struct security_token;
31 struct nbt_dc_name;
32 
33 enum gpo_inheritance {
34 	GPO_INHERIT = 0,
35 	GPO_BLOCK_INHERITANCE = 1,
36 };
37 
38 struct gp_context {
39 	struct ldb_context *ldb_ctx;
40 	struct loadparm_context *lp_ctx;
41 	struct cli_credentials *credentials;
42 	struct tevent_context *ev_ctx;
43 	struct smbcli_state *cli;
44 	struct nbt_dc_name *active_dc;
45 };
46 
47 struct gp_object {
48 	uint32_t version;
49 	uint32_t flags;
50 	const char *display_name;
51 	const char *name;
52 	const char *dn;
53 	const char *file_sys_path;
54 	struct security_descriptor *security_descriptor;
55 };
56 
57 
58 struct gp_link {
59 	uint32_t options;
60 	const char *dn;
61 };
62 
63 struct gp_ini_param {
64 	char *name;
65 	char *value;
66 };
67 
68 struct gp_ini_section {
69 	char *name;
70 	uint16_t num_params;
71 	struct gp_ini_param *params;
72 };
73 
74 struct gp_ini_context {
75 	uint16_t num_sections;
76 	struct gp_ini_section *sections;
77 };
78 
79 NTSTATUS gp_init(TALLOC_CTX *mem_ctx,
80 				struct loadparm_context *lp_ctx,
81 				struct cli_credentials *creds,
82 				struct tevent_context *ev_ctx,
83 				struct gp_context **gp_ctx);
84 
85 
86 /* LDAP functions */
87 NTSTATUS gp_list_all_gpos(struct gp_context *gp_ctx, struct gp_object ***ret);
88 NTSTATUS gp_get_gplinks(struct gp_context *gp_ctx, const char *req_dn, struct gp_link ***ret);
89 NTSTATUS gp_list_gpos(struct gp_context *gp_ctx, struct security_token *token, const char ***ret);
90 
91 NTSTATUS gp_get_gpo_info(struct gp_context *gp_ctx, const char *dn_str, struct gp_object **ret);
92 
93 
94 NTSTATUS gp_get_gplink_options(TALLOC_CTX *mem_ctx, uint32_t flags, const char ***ret);
95 NTSTATUS gp_get_gpo_flags(TALLOC_CTX *mem_ctx, uint32_t flags, const char ***ret);
96 
97 NTSTATUS gp_set_gplink(struct gp_context *gp_ctx, const char *dn_str, struct gp_link *gplink);
98 NTSTATUS gp_del_gplink(struct gp_context *gp_ctx, const char *dn_str, const char *gp_dn);
99 NTSTATUS gp_get_inheritance(struct gp_context *gp_ctx, const char *dn_str, enum gpo_inheritance *inheritance);
100 NTSTATUS gp_set_inheritance(struct gp_context *gp_ctx, const char *dn_str, enum gpo_inheritance inheritance);
101 
102 NTSTATUS gp_create_ldap_gpo(struct gp_context *gp_ctx, struct gp_object *gpo);
103 NTSTATUS gp_set_ads_acl (struct gp_context *gp_ctx, const char *dn_str, const struct security_descriptor *sd);
104 NTSTATUS gp_push_gpo (struct gp_context *gp_ctx, const char *local_path, struct gp_object *gpo);
105 NTSTATUS gp_set_ldap_gpo(struct gp_context *gp_ctx, struct gp_object *gpo);
106 
107 /* File system functions */
108 NTSTATUS gp_fetch_gpt (struct gp_context *gp_ctx, struct gp_object *gpo, const char **path);
109 NTSTATUS gp_create_gpt(struct gp_context *gp_ctx, const char *name, const char *file_sys_path);
110 NTSTATUS gp_set_gpt_security_descriptor(struct gp_context *gp_ctx, struct gp_object *gpo, struct security_descriptor *sd);
111 NTSTATUS gp_push_gpt(struct gp_context *gp_ctx, const char *local_path,
112                      const char *file_sys_path);
113 
114 /* Ini functions */
115 NTSTATUS gp_parse_ini(TALLOC_CTX *mem_ctx, struct gp_context *gp_ctx, const char *filename, struct gp_ini_context **ret);
116 NTSTATUS gp_get_ini_string(struct gp_ini_context *ini, const char *section, const char *name, char **ret);
117 NTSTATUS gp_get_ini_uint(struct gp_ini_context *ini, const char *section, const char *name, uint32_t *ret);
118 
119 /* Managing functions */
120 NTSTATUS gp_create_gpo (struct gp_context *gp_ctx, const char *display_name, struct gp_object **ret);
121 NTSTATUS gp_create_gpt_security_descriptor (TALLOC_CTX *mem_ctx, struct security_descriptor *ds_sd, struct security_descriptor **ret);
122 NTSTATUS gp_set_acl (struct gp_context *gp_ctx, const char *dn_str, const struct security_descriptor *sd);
123 uint32_t gp_ads_to_dir_access_mask(uint32_t access_mask);
124 
125 #endif
126