main_config.c File Reference

Handle the main server's (radiusd) configuration. More...

#include <freeradius-devel/server/cf_file.h>
#include <freeradius-devel/server/client.h>
#include <freeradius-devel/server/dependency.h>
#include <freeradius-devel/server/main_config.h>
#include <freeradius-devel/server/map_proc.h>
#include <freeradius-devel/server/modpriv.h>
#include <freeradius-devel/server/util.h>
#include <freeradius-devel/server/virtual_servers.h>
#include <freeradius-devel/util/conf.h>
#include <freeradius-devel/util/file.h>
#include <freeradius-devel/util/hw.h>
#include <freeradius-devel/util/perm.h>
#include <freeradius-devel/util/sem.h>
#include <freeradius-devel/util/pair_legacy.h>
#include <freeradius-devel/unlang/xlat_func.h>

Include dependency graph for main_config.c:

Go to the source code of this file.

Macros
#define	fr_override_list_foreach(_list_head, _iter)    for (fr_override_t *JOIN(_next,_iter), *_iter = fr_override_list_head(_list_head); JOIN(_next,_iter) = fr_override_list_next(_list_head, _iter), _iter != NULL; _iter = JOIN(_next,_iter))

Functions
static int	_dlhandle_free (void **dl_handle)
typedef	FR_DLIST_HEAD (fr_override_list)
static int	hostname_lookups_parse (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
void	hup_logfile (main_config_t *config)
static int	lib_dir_on_read (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
static int	lib_dir_on_read (UNUSED TALLOC_CTX *ctx, UNUSED void *out, UNUSED void *parent, CONF_ITEM *ci, UNUSED conf_parser_t const *rule)
main_config_t *	main_config_alloc (TALLOC_CTX *ctx)
	Allocate a main_config_t struct, setting defaults.
void	main_config_confdir_set (main_config_t *config, char const *name)
	Set the global radius config directory.
void	main_config_dict_dir_set (main_config_t *config, char const *name)
	Set the global dictionary directory.
int	main_config_exclusive_proc (main_config_t *config)
	Check to see if we're the only process using this configuration file (or PID file if specified)
int	main_config_exclusive_proc_child (UNUSED main_config_t const *config)
	Increment the semaphore in the child process so that it's not released when the parent exits.
void	main_config_exclusive_proc_done (UNUSED main_config_t const *config)
	Clean up the semaphore when the main config is freed.
int	main_config_free (main_config_t **config)
void	main_config_hup (main_config_t *config)
int	main_config_init (main_config_t *config)
void	main_config_name_set_default (main_config_t *config, char const *name, bool overwrite_config)
	Set the server name.
int	main_config_save_override (char const *str)
static int	max_request_time_parse (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
static int	name_parse (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
	Configured server name takes precedence over default values.
static int	num_networks_parse (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
static uint32_t	num_workers_auto (main_config_t *conf, CONF_ITEM *parent)
static int	num_workers_dflt (CONF_PAIR **out, void *parent, CONF_SECTION *cs, fr_token_t quote, conf_parser_t const *rule)
static int	num_workers_parse (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
static int	reverse_lookups_parse (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
static int	talloc_pool_size_parse (TALLOC_CTX *ctx, void *out, void *parent, CONF_ITEM *ci, conf_parser_t const *rule)
static xlat_action_t	xlat_config (TALLOC_CTX *ctx, fr_dcursor_t *out, UNUSED xlat_ctx_t const *xctx, request_t *request, fr_value_box_list_t *in)
	xlat to get config values
static int	xlat_config_escape (UNUSED request_t *request, fr_value_box_t *vb, UNUSED void *uctx)

Variables
fr_log_t	debug_log = { .fd = -1, .dst = L_DST_NULL }
	fr_override_t
static const conf_parser_t	initial_log_config []
static const conf_parser_t	initial_server_config []
static const conf_parser_t	interpret_config []
static const conf_parser_t	lib_dir_on_read_config []
static const conf_parser_t	log_config []
main_config_t const *	main_config
	Main server configuration.
static const conf_parser_t	migrate_config []
static const conf_parser_t	request_config []
static const conf_parser_t	request_reuse_config []
static const conf_parser_t	resources []
static const conf_parser_t	security_config []
static const conf_parser_t	server_config []
static const conf_parser_t	switch_users_config []
static const conf_parser_t	thread_config []
static xlat_arg_parser_t const	xlat_config_args []

Detailed Description

Handle the main server's (radiusd) configuration.

Id

e8ad6461b3f75c975227a64c0f180cabfeff2359

Copyright

2002,2006-2007 The FreeRADIUS server project

2002 Alan DeKok (aland.nosp@m.@fre.nosp@m.eradi.nosp@m.us.o.nosp@m.rg)

Definition in file main_config.c.

Macro Definition Documentation

fr_override_list_foreach

#define fr_override_list_foreach	(		_list_head,
			_iter
	)		for (fr_override_t *JOIN(_next,_iter), *_iter = fr_override_list_head(_list_head); JOIN(_next,_iter) = fr_override_list_next(_list_head, _iter), _iter != NULL; _iter = JOIN(_next,_iter))

Definition at line 79 of file main_config.c.

Function Documentation

_dlhandle_free()

static int _dlhandle_free ( void **  dl_handle )

static

Definition at line 1024 of file main_config.c.

Here is the caller graph for this function:

FR_DLIST_HEAD()

typedef FR_DLIST_HEAD

(

fr_override_list

)

< must not be 'const'

Definition at line 66 of file main_config.c.

hostname_lookups_parse()

static int hostname_lookups_parse ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

Definition at line 335 of file main_config.c.

Here is the call graph for this function:

hup_logfile()

void hup_logfile

(

main_config_t *

config

)

Definition at line 1435 of file main_config.c.

Here is the caller graph for this function:

lib_dir_on_read() [1/2]

static int lib_dir_on_read ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

lib_dir_on_read() [2/2]

static int lib_dir_on_read ( UNUSED TALLOC_CTX *  ctx, UNUSED void *  out, UNUSED void *  parent, CONF_ITEM *  ci, UNUSED conf_parser_t const *  rule  )

static

Definition at line 383 of file main_config.c.

Here is the call graph for this function:

main_config_alloc()

main_config_t * main_config_alloc

(

TALLOC_CTX *

ctx

)

Allocate a main_config_t struct, setting defaults.

Definition at line 1000 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_confdir_set()

void main_config_confdir_set	(	main_config_t *	config,
		char const *	name
	)

Set the global radius config directory.

Parameters

[in]	config	to alter.
[in]	name	to set as main configuration directory.

Definition at line 859 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_dict_dir_set()

void main_config_dict_dir_set	(	main_config_t *	config,
		char const *	name
	)

Set the global dictionary directory.

Parameters

[in]	config	to alter.
[in]	name	to set as dict dir root e.g. /usr/local/share/freeradius.

Definition at line 988 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_exclusive_proc()

int main_config_exclusive_proc

(

main_config_t *

config

)

Check to see if we're the only process using this configuration file (or PID file if specified)

Parameters

[in]

config

specifying the path to the main config file.

Returns

• 1 if another process is running with this config file
• 0 if no other process is running with this config file.
• -1 on error.

Definition at line 913 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_exclusive_proc_child()

int main_config_exclusive_proc_child

(

UNUSED main_config_t const *

config

)

Increment the semaphore in the child process so that it's not released when the parent exits.

Parameters

[in]

config

specifying the path to the main config file.

Returns

• 0 on success.
• -1 on failure.

Definition at line 892 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_exclusive_proc_done()

void main_config_exclusive_proc_done

(

UNUSED main_config_t const *

config

)

Clean up the semaphore when the main config is freed.

This helps with permissions issues if the user is switching between running the process under something like systemd and running it under debug mode.

Definition at line 874 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_free()

int main_config_free

(

main_config_t **

config

)

Definition at line 1411 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_hup()

void main_config_hup

(

main_config_t *

config

)

Definition at line 1457 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_init()

int main_config_init

(

main_config_t *

config

)

Definition at line 1035 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_name_set_default()

void main_config_name_set_default	(	main_config_t *	config,
		char const *	name,
		bool	overwrite_config
	)

Set the server name.

Note

Will only add pair if one does not already exist

Parameters

[in]	config	to alter.
[in]	name	to set e.g. "radiusd".
[in]	overwrite_config	replace any CONF_PAIRs with this value.

Definition at line 840 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_save_override()

int main_config_save_override

(

char const *

str

)

Definition at line 1492 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

max_request_time_parse()

static int max_request_time_parse ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

Definition at line 365 of file main_config.c.

Here is the call graph for this function:

name_parse()

static int name_parse ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

Configured server name takes precedence over default values.

Definition at line 414 of file main_config.c.

Here is the call graph for this function:

num_networks_parse()

static int num_networks_parse ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

Definition at line 428 of file main_config.c.

Here is the call graph for this function:

num_workers_auto()

static uint32_t num_workers_auto ( main_config_t *  conf, CONF_ITEM *  parent  )

inlinestatic

Definition at line 446 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

num_workers_dflt()

static int num_workers_dflt ( CONF_PAIR **  out, void *  parent, CONF_SECTION *  cs, fr_token_t  quote, conf_parser_t const *  rule  )

static

Definition at line 498 of file main_config.c.

Here is the call graph for this function:

num_workers_parse()

static int num_workers_parse ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

Definition at line 474 of file main_config.c.

Here is the call graph for this function:

reverse_lookups_parse()

static int reverse_lookups_parse ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

Definition at line 323 of file main_config.c.

Here is the call graph for this function:

talloc_pool_size_parse()

static int talloc_pool_size_parse ( TALLOC_CTX *  ctx, void *  out, void *  parent, CONF_ITEM *  ci, conf_parser_t const *  rule  )

static

Definition at line 347 of file main_config.c.

Here is the call graph for this function:

xlat_config_escape()

static int xlat_config_escape ( UNUSED request_t *  request, fr_value_box_t *  vb, UNUSED void *  uctx  )

static

Definition at line 518 of file main_config.c.

Here is the call graph for this function:

Variable Documentation

debug_log

fr_log_t debug_log = { .fd = -1, .dst = L_DST_NULL }

Definition at line 60 of file main_config.c.

fr_override_t

fr_override_t

Definition at line 75 of file main_config.c.

initial_log_config

const conf_parser_t initial_log_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET("destination", main_config_t, log_dest), .dflt = "file" },
        { FR_CONF_OFFSET("syslog_facility", main_config_t, syslog_facility), .dflt = "daemon",
                .func = cf_table_parse_int,
                        .uctx = &(cf_table_parse_ctx_t){
                                .table = syslog_facility_table,
                                .len = &syslog_facility_table_len
                        }
                },
        { FR_CONF_OFFSET("local_state_dir", main_config_t, local_state_dir), .dflt = "${prefix}/var"},
        { FR_CONF_OFFSET("logdir", main_config_t, log_dir), .dflt = "${local_state_dir}/log"},
        { FR_CONF_OFFSET("file", main_config_t, log_file), .dflt = "${logdir}/radius.log" },
        { FR_CONF_OFFSET("suppress_secrets", main_config_t, suppress_secrets), .dflt = "yes" },
        CONF_PARSER_TERMINATOR
}

Definition at line 113 of file main_config.c.

initial_server_config

const conf_parser_t initial_server_config[]

static

Initial value:

= {
        { FR_CONF_POINTER("log", 0, CONF_FLAG_SUBSECTION, NULL), .subcs = (void const *) initial_log_config },
 
        CONF_PARSER_TERMINATOR
}

Definition at line 132 of file main_config.c.

interpret_config

const conf_parser_t interpret_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET_FLAGS("countup_instructions", CONF_FLAG_HIDDEN, main_config_t, ins_countup) },
        { FR_CONF_OFFSET_FLAGS("max_instructions", CONF_FLAG_HIDDEN, main_config_t, ins_max) },
        CONF_PARSER_TERMINATOR
}

Definition at line 205 of file main_config.c.

lib_dir_on_read_config

const conf_parser_t lib_dir_on_read_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET("prefix", main_config_t, prefix), .dflt = "/usr/local" },
 
        { FR_CONF_OFFSET("use_utc", main_config_t, log_dates_utc) },
        { FR_CONF_OFFSET_IS_SET("timestamp", FR_TYPE_BOOL, 0, main_config_t, log_timestamp) },
 
        { FR_CONF_OFFSET("libdir", main_config_t, lib_dir), .dflt = "${prefix}/lib",
          .on_read = lib_dir_on_read },
 
        CONF_PARSER_TERMINATOR
}

Definition at line 141 of file main_config.c.

log_config

const conf_parser_t log_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET("colourise", main_config_t, do_colourise) },
        { FR_CONF_OFFSET("line_number", main_config_t, log_line_number) },
        { FR_CONF_OFFSET("timestamp", main_config_t, log_timestamp) },
        { FR_CONF_OFFSET("use_utc", main_config_t, log_dates_utc) },
        CONF_PARSER_TERMINATOR
}

Definition at line 159 of file main_config.c.

main_config

main_config_t const* main_config

Main server configuration.

Global configuration singleton.

Definition at line 56 of file main_config.c.

migrate_config

const conf_parser_t migrate_config[]

static

Initial value:

= {
        CONF_PARSER_TERMINATOR
}

Definition at line 197 of file main_config.c.

request_config

const conf_parser_t request_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET("max", main_config_t, worker.max_requests), .dflt = "0" },
        { FR_CONF_OFFSET("timeout", main_config_t, worker.max_request_time), .dflt = STRINGIFY(MAX_REQUEST_TIME), .func = max_request_time_parse },
        { FR_CONF_OFFSET_TYPE_FLAGS("talloc_pool_size", FR_TYPE_SIZE, CONF_FLAG_HIDDEN, main_config_t, worker.reuse.child_pool_size), .func = talloc_pool_size_parse },                 
        { FR_CONF_OFFSET_SUBSECTION("reuse", 0, main_config_t, worker.reuse, request_reuse_config) },
        CONF_PARSER_TERMINATOR
}

Definition at line 217 of file main_config.c.

request_reuse_config

const conf_parser_t request_reuse_config[]

static

Initial value:

= {
        FR_SLAB_CONFIG_CONF_PARSER
        CONF_PARSER_TERMINATOR
}

Definition at line 212 of file main_config.c.

resources

const conf_parser_t resources[]

static

Initial value:

= {
        
        { FR_CONF_OFFSET_FLAGS("talloc_memory_report", CONF_FLAG_HIDDEN, main_config_t, talloc_memory_report) }, 
        { FR_CONF_OFFSET_FLAGS("talloc_skip_cleanup", CONF_FLAG_HIDDEN, main_config_t, talloc_skip_cleanup) }, 
        CONF_PARSER_TERMINATOR
}

Definition at line 168 of file main_config.c.

security_config

const conf_parser_t security_config[]

static

Initial value:

= {
 
 
 
 
        { FR_CONF_OFFSET("allow_core_dumps", main_config_t, allow_core_dumps), .dflt = "no" },
 
 
 
 
 
 
 
 
 
        { FR_CONF_OFFSET_IS_SET("chdir", FR_TYPE_STRING, 0, main_config_t, chdir), },
 
        CONF_PARSER_TERMINATOR
}

Definition at line 281 of file main_config.c.

server_config

const conf_parser_t server_config[]

static

Definition at line 225 of file main_config.c.

switch_users_config

const conf_parser_t switch_users_config[]

static

Initial value:

= {
        { FR_CONF_POINTER("security", 0, CONF_FLAG_SUBSECTION, NULL), .subcs = (void const *) security_config },
 
        { FR_CONF_OFFSET("name", main_config_t, name), .func = name_parse },                                                    
 
        { FR_CONF_OFFSET("prefix", main_config_t, prefix), .dflt = "/usr/local" },
        { FR_CONF_OFFSET("local_state_dir", main_config_t, local_state_dir), .dflt = "${prefix}/var"},
 
        { FR_CONF_OFFSET("run_dir", main_config_t, run_dir), .dflt = "${local_state_dir}/run/${name}"},
 
        
 
 
 
 
        { FR_CONF_DEPRECATED("chroot", main_config_t, NULL) },
        { FR_CONF_DEPRECATED("allow_core_dumps", main_config_t, NULL) },
        CONF_PARSER_TERMINATOR
}

Definition at line 301 of file main_config.c.

thread_config

const conf_parser_t thread_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET("num_networks", main_config_t, max_networks), .dflt = STRINGIFY(1),
          .func = num_networks_parse },
        { FR_CONF_OFFSET("num_workers", main_config_t, max_workers), .dflt = STRINGIFY(0),
          .func = num_workers_parse, .dflt_func = num_workers_dflt },
 
        { FR_CONF_OFFSET_TYPE_FLAGS("stats_interval", FR_TYPE_TIME_DELTA, CONF_FLAG_HIDDEN, main_config_t, stats_interval) },
 
 
 
 
 
 
        CONF_PARSER_TERMINATOR
}

Definition at line 178 of file main_config.c.

xlat_config_args

xlat_arg_parser_t const xlat_config_args[]

static

Initial value:

= {
        { .required = true, .concat = true, .type = FR_TYPE_STRING, .always_escape = true, .func = xlat_config_escape },
        XLAT_ARG_PARSER_TERMINATOR
}

Definition at line 579 of file main_config.c.