2 Bacula(R) - The Network Backup Solution
4 Copyright (C) 2000-2017 Kern Sibbald
6 The original author of Bacula is Kern Sibbald, with contributions
7 from many others, a complete list can be found in the file AUTHORS.
9 You may use this file and others of this release according to the
10 license defined in the LICENSE file, which includes the Affero General
11 Public License, v3.0 ("AGPLv3") and some additional permissions and
12 terms pursuant to its AGPLv3 Section 7.
14 This notice must be preserved when any source code is
15 conveyed and/or propagated.
17 Bacula(R) is a registered trademark of Kern Sibbald.
20 * Main configuration file parser for Bacula User Agent
21 * some parts may be split into separate files such as
22 * the schedule configuration (sch_config.c).
24 * Note, the configuration file parser consists of three parts
26 * 1. The generic lexical scanner in lib/lex.c and lib/lex.h
28 * 2. The generic config scanner in lib/parse_config.c and
30 * These files contain the parser code, some utility
31 * routines, and the common store routines (name, int,
34 * 3. The daemon specific file, which contains the Resource
35 * definitions as well as any specific store routines
36 * for the resource records.
38 * Kern Sibbald, January MM, September MM
45 /* Define the first and last resource ID record
46 * types. Note, these should be unique for each
47 * daemon though not a requirement.
49 int32_t r_first = R_FIRST;
50 int32_t r_last = R_LAST;
53 /* Forward referenced subroutines */
56 /* We build the current resource here as we are
57 * scanning the resource configuration definition,
58 * then move it to allocated memory when the resource
62 extern "C" URES res_all; /* declare as C to avoid name mangling by visual c */
65 int32_t res_all_size = sizeof(res_all);
67 /* Definition of records permitted within each
68 * resource with the routine to process the record
71 static RES_ITEM dir_items[] = {
72 {"name", store_name, ITEM(dir_res.hdr.name), 0, ITEM_REQUIRED, 0},
73 {"description", store_str, ITEM(dir_res.hdr.desc), 0, 0, 0},
74 {"dirport", store_pint32, ITEM(dir_res.DIRport), 0, ITEM_DEFAULT, 9101},
75 {"address", store_str, ITEM(dir_res.address), 0, ITEM_REQUIRED, 0},
76 {"password", store_password, ITEM(dir_res.password), 0, 0, 0},
77 {"tlsauthenticate",store_bool, ITEM(dir_res.tls_authenticate), 0, 0, 0},
78 {"tlsenable", store_bool, ITEM(dir_res.tls_enable), 0, 0, 0},
79 {"tlsrequire", store_bool, ITEM(dir_res.tls_require), 0, 0, 0},
80 {"tlscacertificatefile", store_dir, ITEM(dir_res.tls_ca_certfile), 0, 0, 0},
81 {"tlscacertificatedir", store_dir, ITEM(dir_res.tls_ca_certdir), 0, 0, 0},
82 {"tlscertificate", store_dir, ITEM(dir_res.tls_certfile), 0, 0, 0},
83 {"tlskey", store_dir, ITEM(dir_res.tls_keyfile), 0, 0, 0},
84 {"heartbeatinterval", store_time, ITEM(dir_res.heartbeat_interval), 0, ITEM_DEFAULT, 5 * 60},
85 {NULL, NULL, {0}, 0, 0, 0}
88 static RES_ITEM con_items[] = {
89 {"name", store_name, ITEM(con_res.hdr.name), 0, ITEM_REQUIRED, 0},
90 {"description", store_str, ITEM(con_res.hdr.desc), 0, 0, 0},
91 {"password", store_password, ITEM(con_res.password), 0, ITEM_REQUIRED, 0},
92 {"tlsauthenticate",store_bool, ITEM(con_res.tls_authenticate), 0, 0, 0},
93 {"tlsenable", store_bool, ITEM(con_res.tls_enable), 0, 0, 0},
94 {"tlsrequire", store_bool, ITEM(con_res.tls_require), 0, 0, 0},
95 {"tlscacertificatefile", store_dir, ITEM(con_res.tls_ca_certfile), 0, 0, 0},
96 {"tlscacertificatedir", store_dir, ITEM(con_res.tls_ca_certdir), 0, 0, 0},
97 {"tlscertificate", store_dir, ITEM(con_res.tls_certfile), 0, 0, 0},
98 {"tlskey", store_dir, ITEM(con_res.tls_keyfile), 0, 0, 0},
99 {"heartbeatinterval", store_time, ITEM(con_res.heartbeat_interval), 0, ITEM_DEFAULT, 5 * 60},
100 {"director", store_str, ITEM(con_res.director), 0, 0, 0},
101 {"CommCompression", store_bool, ITEM(con_res.comm_compression), 0, ITEM_DEFAULT, true},
102 {NULL, NULL, {0}, 0, 0, 0}
105 static RES_ITEM con_font_items[] = {
106 {"name", store_name, ITEM(con_font.hdr.name), 0, ITEM_REQUIRED, 0},
107 {"description", store_str, ITEM(con_font.hdr.desc), 0, 0, 0},
108 {"font", store_str, ITEM(con_font.fontface), 0, 0, 0},
109 {NULL, NULL, {0}, 0, 0, 0}
114 * This is the master resource definition.
115 * It must have one item for each of the resources.
117 RES_TABLE resources[] = {
118 {"director", dir_items, R_DIRECTOR},
119 {"console", con_items, R_CONSOLE},
120 {"consolefont", con_font_items, R_CONSOLE_FONT},
125 /* Dump contents of resource */
126 void dump_resource(int type, RES *ares, void sendit(void *sock, const char *fmt, ...), void *sock)
129 URES *res = (URES *)ares;
133 printf(_("No record for %d %s\n"), type, res_to_str(type));
136 if (type < 0) { /* no recursion */
142 printf(_("Director: name=%s address=%s DIRport=%d\n"), ares->name,
143 res->dir_res.address, res->dir_res.DIRport);
146 printf(_("Console: name=%s\n"), ares->name);
149 printf(_("ConsoleFont: name=%s font face=%s\n"),
150 ares->name, NPRT(res->con_font.fontface));
153 printf(_("Unknown resource type %d\n"), type);
156 next = GetNextRes(0, (RES *)res);
158 dump_resource(type, next, sendit, sock);
164 * Free memory of resource.
165 * NB, we don't need to worry about freeing any references
166 * to other resources as they will be freed when that
167 * resource chain is traversed. Mainly we worry about freeing
168 * allocated strings (names).
170 void free_resource(RES *sres, int type)
172 URES *res = (URES *)sres;
177 /* common stuff -- free the resource name */
178 if (res->dir_res.hdr.name) {
179 free(res->dir_res.hdr.name);
181 if (res->dir_res.hdr.desc) {
182 free(res->dir_res.hdr.desc);
187 if (res->dir_res.address) {
188 free(res->dir_res.address);
190 if (res->dir_res.tls_ctx) {
191 free_tls_context(res->dir_res.tls_ctx);
193 if (res->dir_res.tls_ca_certfile) {
194 free(res->dir_res.tls_ca_certfile);
196 if (res->dir_res.tls_ca_certdir) {
197 free(res->dir_res.tls_ca_certdir);
199 if (res->dir_res.tls_certfile) {
200 free(res->dir_res.tls_certfile);
202 if (res->dir_res.tls_keyfile) {
203 free(res->dir_res.tls_keyfile);
207 if (res->con_res.password) {
208 free(res->con_res.password);
210 if (res->con_res.tls_ctx) {
211 free_tls_context(res->con_res.tls_ctx);
213 if (res->con_res.tls_ca_certfile) {
214 free(res->con_res.tls_ca_certfile);
216 if (res->con_res.tls_ca_certdir) {
217 free(res->con_res.tls_ca_certdir);
219 if (res->con_res.tls_certfile) {
220 free(res->con_res.tls_certfile);
222 if (res->con_res.tls_keyfile) {
223 free(res->con_res.tls_keyfile);
225 if (res->con_res.director) {
226 free(res->con_res.director);
230 if (res->con_font.fontface) {
231 free(res->con_font.fontface);
235 printf(_("Unknown resource type %d\n"), type);
237 /* Common stuff again -- free the resource, recurse to next one */
243 /* Save the new resource by chaining it into the head list for
244 * the resource. If this is pass 2, we update any resource
245 * pointers (currently only in the Job resource).
247 bool save_resource(CONFIG *config, int type, RES_ITEM *items, int pass)
249 int rindex = type - r_first;
254 * Ensure that all required items are present
256 for (i=0; items[i].name; i++) {
257 if (items[i].flags & ITEM_REQUIRED) {
258 if (!bit_is_set(i, res_all.dir_res.hdr.item_present)) {
259 Mmsg(config->m_errmsg, _("\"%s\" directive is required in \"%s\" resource, but not found.\n"),
260 items[i].name, resources[rindex].name);
266 /* During pass 2, we looked up pointers to all the resources
267 * referrenced in the current resource, , now we
268 * must copy their address from the static record to the allocated
273 /* Resources not containing a resource */
282 Emsg1(M_ERROR, 0, _("Unknown resource type %d\n"), type);
286 /* Note, the resoure name was already saved during pass 1,
287 * so here, we can just release it.
289 if (res_all.dir_res.hdr.name) {
290 free(res_all.dir_res.hdr.name);
291 res_all.dir_res.hdr.name = NULL;
293 if (res_all.dir_res.hdr.desc) {
294 free(res_all.dir_res.hdr.desc);
295 res_all.dir_res.hdr.desc = NULL;
300 /* The following code is only executed during pass 1 */
303 size = sizeof(DIRRES);
306 size = sizeof(CONFONTRES);
309 size = sizeof(CONRES);
312 printf(_("Unknown resource type %d\n"), type);
318 if (!config->insert_res(rindex, size)) {
325 bool parse_bat_config(CONFIG *config, const char *configfile, int exit_code)
327 config->init(configfile, NULL, exit_code, (void *)&res_all, res_all_size,
328 r_first, r_last, resources, &res_head);
329 return config->parse_config();