]>
git.ipfire.org Git - thirdparty/bird.git/blob - conf/conf.c
2 * BIRD Internet Routing Daemon -- Configuration File Handling
4 * (c) 1998--2000 Martin Mares <mj@ucw.cz>
6 * Can be freely distributed and used under the terms of the GNU GPL.
10 * DOC: Configuration manager
12 * Configuration of BIRD is complex, yet straightforward. There are three
13 * modules taking care of the configuration: config manager (which takes care
14 * of storage of the config information and controls switching between configs),
15 * lexical analyzer and parser.
17 * The configuration manager stores each config as a &config structure
18 * accompanied by a linear pool from which all information associated
19 * with the config and pointed to by the &config structure is allocated.
21 * There can exist up to four different configurations at one time: an active
22 * one (pointed to by @config), configuration we are just switching from
23 * (@old_config), one queued for the next reconfiguration (@future_config;
24 * if it's non-%NULL and the user wants to reconfigure once again, we just
25 * free the previous queued config and replace it with the new one) and
26 * finally a config being parsed (@new_config).
28 * Loading of new configuration is very simple: just call config_alloc()
29 * to get a new &config structure, then use config_parse() to parse a
30 * configuration file and fill all fields of the structure
31 * and finally ask the config manager to switch to the new
32 * config by calling config_commit().
34 * CLI commands are parsed in a very similar way -- there is also a stripped-down
35 * &config structure associated with them and they are lex-ed and parsed by the
36 * same functions, only a special fake token is prepended before the command
37 * text to make the parser recognize only the rules corresponding to CLI commands.
45 #include "nest/bird.h"
46 #include "nest/route.h"
47 #include "nest/protocol.h"
48 #include "nest/iface.h"
49 #include "lib/resource.h"
50 #include "lib/string.h"
51 #include "lib/event.h"
52 #include "lib/timer.h"
53 #include "conf/conf.h"
54 #include "filter/filter.h"
56 static jmp_buf conf_jmpbuf
;
58 struct config
*config
, *new_config
, *old_config
, *future_config
;
59 static event
*config_event
;
60 int shutting_down
, future_type
;
61 bird_clock_t boot_time
;
64 * config_alloc - allocate a new configuration
65 * @name: name of the config
67 * This function creates new &config structure, attaches a resource
68 * pool and a linear memory pool to it and makes it available for
69 * further use. Returns a pointer to the structure.
72 config_alloc(byte
*name
)
74 pool
*p
= rp_new(&root_pool
, "Config");
75 linpool
*l
= lp_new(p
, 4080);
76 struct config
*c
= lp_allocz(l
, sizeof(struct config
));
78 c
->mrtdump_file
= -1; /* Hack, this should be sysdep-specific */
81 c
->file_name
= cfg_strdup(name
);
83 c
->tf_base
.fmt1
= c
->tf_log
.fmt1
= "%d-%m-%Y %T";
91 * config_parse - parse a configuration
94 * config_parse() reads input by calling a hook function pointed to
95 * by @cf_read_hook and parses it according to the configuration
96 * grammar. It also calls all the preconfig and postconfig hooks
97 * before, resp. after parsing.
99 * Result: 1 if the config has been parsed successfully, 0 if any
100 * error has occurred (such as anybody calling cf_error()) and
101 * the @err_msg field has been set to the error message.
104 config_parse(struct config
*c
)
106 DBG("Parsing configuration file `%s'\n", c
->file_name
);
109 if (setjmp(conf_jmpbuf
))
116 protos_postconfig(c
);
117 if (EMPTY_LIST(c
->protos
))
118 cf_error("No protocol is specified in the config file");
121 cf_error("Router ID must be configured manually on IPv6 routers");
127 * cli_parse - parse a CLI command
128 * @c: temporary config structure
130 * cli_parse() is similar to config_parse(), but instead of a configuration,
131 * it parses a CLI command. See the CLI module for more information.
134 cli_parse(struct config
*c
)
137 c
->sym_fallback
= config
->sym_hash
;
139 if (setjmp(conf_jmpbuf
))
147 * config_free - free a configuration
148 * @c: configuration to be freed
150 * This function takes a &config structure and frees all resources
151 * associated with it.
154 config_free(struct config
*c
)
160 config_add_obstacle(struct config
*c
)
162 DBG("+++ adding obstacle %d\n", c
->obstacle_count
);
167 config_del_obstacle(struct config
*c
)
169 DBG("+++ deleting obstacle %d\n", c
->obstacle_count
);
171 if (!c
->obstacle_count
)
173 ASSERT(config_event
);
174 ev_schedule(config_event
);
179 global_commit(struct config
*new, struct config
*old
)
184 if (!ipa_equal(old
->listen_bgp_addr
, new->listen_bgp_addr
) ||
185 (old
->listen_bgp_port
!= new->listen_bgp_port
) ||
186 (old
->listen_bgp_flags
!= new->listen_bgp_flags
))
187 log(L_WARN
"Reconfiguration of BGP listening socket not implemented, please restart BIRD.");
190 new->router_id
= old
->router_id
;
191 if (new->router_id
!= old
->router_id
)
197 config_do_commit(struct config
*c
, int type
)
199 int force_restart
, nobs
;
203 config
= new_config
= c
;
205 old_config
->obstacle_count
++;
207 DBG("sysdep_commit\n");
208 force_restart
= sysdep_commit(c
, old_config
);
209 DBG("global_commit\n");
210 force_restart
|= global_commit(c
, old_config
);
212 rt_commit(c
, old_config
);
213 DBG("protos_commit\n");
214 protos_commit(c
, old_config
, force_restart
, type
);
215 new_config
= NULL
; /* Just to be sure nobody uses that now */
217 nobs
= --old_config
->obstacle_count
;
220 DBG("do_commit finished with %d obstacles remaining\n", nobs
);
225 config_done(void *unused UNUSED
)
229 DBG("config_done\n");
232 if (config
->shutdown
)
233 sysdep_shutdown_done();
234 log(L_INFO
"Reconfigured");
237 config_free(old_config
);
243 future_config
= NULL
;
244 log(L_INFO
"Reconfiguring to queued configuration");
245 if (!config_do_commit(c
, future_type
))
251 * config_commit - commit a configuration
252 * @c: new configuration
253 * @type: type of reconfiguration (RECONFIG_SOFT or RECONFIG_HARD)
255 * When a configuration is parsed and prepared for use, the
256 * config_commit() function starts the process of reconfiguration.
257 * It checks whether there is already a reconfiguration in progress
258 * in which case it just queues the new config for later processing.
259 * Else it notifies all modules about the new configuration by calling
260 * their commit() functions which can either accept it immediately
261 * or call config_add_obstacle() to report that they need some time
262 * to complete the reconfiguration. After all such obstacles are removed
263 * using config_del_obstacle(), the old configuration is freed and
264 * everything runs according to the new one.
266 * Result: %CONF_DONE if the configuration has been accepted immediately,
267 * %CONF_PROGRESS if it will take some time to switch to it, %CONF_QUEUED
268 * if it's been queued due to another reconfiguration being in progress now
269 * or %CONF_SHUTDOWN if BIRD is in shutdown mode and no new configurations
273 config_commit(struct config
*c
, int type
)
275 if (!config
) /* First-time configuration */
277 config_do_commit(c
, RECONFIG_HARD
);
280 if (old_config
) /* Reconfiguration already in progress */
282 if (shutting_down
== 2)
284 log(L_INFO
"New configuration discarded due to shutdown");
286 return CONF_SHUTDOWN
;
290 log(L_INFO
"Queueing new configuration, ignoring the one already queued");
291 config_free(future_config
);
294 log(L_INFO
"Queued new configuration");
301 log(L_INFO
"Reconfiguring");
303 if (config_do_commit(c
, type
))
310 config_event
= ev_new(&root_pool
);
311 config_event
->hook
= config_done
;
313 return CONF_PROGRESS
;
317 * order_shutdown - order BIRD shutdown
319 * This function initiates shutdown of BIRD. It's accomplished by asking
320 * for switching to an empty configuration.
329 log(L_INFO
"Shutting down");
330 c
= lp_alloc(config
->mem
, sizeof(struct config
));
331 memcpy(c
, config
, sizeof(struct config
));
332 init_list(&c
->protos
);
333 init_list(&c
->tables
);
336 config_commit(c
, RECONFIG_HARD
);
341 * cf_error - report a configuration error
342 * @msg: printf-like format string
344 * cf_error() can be called during execution of config_parse(), that is
345 * from the parser, a preconfig hook or a postconfig hook, to report an
346 * error in the configuration.
349 cf_error(char *msg
, ...)
355 if (bvsnprintf(buf
, sizeof(buf
), msg
, args
) < 0)
356 strcpy(buf
, "<bug: error message too long>");
357 new_config
->err_msg
= cfg_strdup(buf
);
358 new_config
->err_lino
= conf_lino
;
359 longjmp(conf_jmpbuf
, 1);
363 * cfg_strdup - copy a string to config memory
366 * cfg_strdup() creates a new copy of the string in the memory
367 * pool associated with the configuration being currently parsed.
368 * It's often used when a string literal occurs in the configuration
369 * and we want to preserve it for further use.
374 int l
= strlen(c
) + 1;
375 char *z
= cfg_allocu(l
);