main_config.c File Reference

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

#include <freeradius-devel/server/cf_file.h>
#include <freeradius-devel/server/cf_util.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/module.h>
#include <freeradius-devel/server/util.h>
#include <freeradius-devel/server/virtual_servers.h>
#include <freeradius-devel/unlang/xlat.h>
#include <freeradius-devel/util/conf.h>
#include <freeradius-devel/util/debug.h>
#include <freeradius-devel/util/dict.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/token.h>
#include <freeradius-devel/util/pair_legacy.h>
#include <freeradius-devel/unlang/xlat_func.h>
#include <sys/stat.h>
#include <pwd.h>
#include <grp.h>
#include <unistd.h>
#include <sys/types.h>

Include dependency graph for main_config.c:

Go to the source code of this file.

Functions
static int	_dlhandle_free (void **dl_handle)
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_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)
bool	main_config_migrate_option_get (char const *name)
void	main_config_name_set_default (main_config_t *config, char const *name, bool overwrite_config)
	Set the server name.
int	main_config_parse_option (char const *value)
void	main_config_raddb_dir_set (main_config_t *config, char const *name)
	Set the global radius config directory.
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
static fr_table_num_ordered_t	config_arg_table []
static size_t	config_arg_table_len = NUM_ELEMENTS(config_arg_table)
fr_log_t	debug_log = { .fd = -1, .dst = L_DST_NULL }
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	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 []
bool	tmpl_require_enum_prefix
static xlat_arg_parser_t const	xlat_config_args []

Detailed Description

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

Id

251f10bcbd4705e7d4c615361fecae39b87b4967

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.

Function Documentation

_dlhandle_free()

static int _dlhandle_free ( void **  dl_handle )

static

Definition at line 1032 of file main_config.c.

Here is the caller graph for this function:

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 324 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 1449 of file main_config.c.

Here is the call graph for this function:

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 372 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 1010 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 998 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 923 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 902 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 884 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 1425 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 1471 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 1043 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_migrate_option_get()

bool main_config_migrate_option_get

(

char const *

name

)

Definition at line 1551 of file main_config.c.

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 850 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_parse_option()

int main_config_parse_option

(

char const *

value

)

Definition at line 1514 of file main_config.c.

Here is the call graph for this function:

Here is the caller graph for this function:

main_config_raddb_dir_set()

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

Set the global radius config directory.

Parameters

[in]	config	to alter.
[in]	name	to set as dir root e.g. /usr/local/etc/raddb.

Definition at line 869 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 354 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 403 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 417 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 435 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 487 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 463 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 312 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 336 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 507 of file main_config.c.

Here is the call graph for this function:

Variable Documentation

config_arg_table

fr_table_num_ordered_t config_arg_table[]

static

Initial value:

= {
        { L("rewrite_update"),           offsetof(main_config_t, rewrite_update) },
        { L("forbid_update"),            offsetof(main_config_t, forbid_update) },
        { L("require_enum_prefix"),      offsetof(main_config_t, require_enum_prefix) },
        { L("v3_enum_names"),            offsetof(main_config_t, require_enum_prefix) },
}

Definition at line 1499 of file main_config.c.

config_arg_table_len

size_t config_arg_table_len = NUM_ELEMENTS(config_arg_table)

static

Definition at line 1505 of file main_config.c.

debug_log

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

Definition at line 73 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 = "no" },
        CONF_PARSER_TERMINATOR
}

Definition at line 105 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 124 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 211 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 133 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 151 of file main_config.c.

main_config

main_config_t const* main_config

Main server configuration.

Global configuration singleton.

Definition at line 69 of file main_config.c.

migrate_config

const conf_parser_t migrate_config[]

static

Initial value:

= {
        { FR_CONF_OFFSET_FLAGS("rewrite_update", CONF_FLAG_HIDDEN, main_config_t, rewrite_update) },
        { FR_CONF_OFFSET_FLAGS("forbid_update", CONF_FLAG_HIDDEN, main_config_t, forbid_update) },
 
        
 
        CONF_PARSER_TERMINATOR
}

Definition at line 192 of file main_config.c.

resources

const conf_parser_t resources[]

static

Initial value:

= {
        
        { FR_CONF_OFFSET_TYPE_FLAGS("talloc_pool_size", FR_TYPE_SIZE, CONF_FLAG_HIDDEN, main_config_t, talloc_pool_size), .func = talloc_pool_size_parse },                     
        { FR_CONF_OFFSET_FLAGS("talloc_memory_report", CONF_FLAG_HIDDEN, main_config_t, talloc_memory_report) },                                                
        CONF_PARSER_TERMINATOR
}

Definition at line 160 of file main_config.c.

security_config

const conf_parser_t security_config[]

static

Initial value:

= {
 
 
 
 
        { FR_CONF_OFFSET("chroot", main_config_t, chroot_dir) },
        { FR_CONF_OFFSET("allow_core_dumps", main_config_t, allow_core_dumps), .dflt = "no" },
 
 
 
 
 
 
 
 
 
        CONF_PARSER_TERMINATOR
}

Definition at line 271 of file main_config.c.

server_config

const conf_parser_t server_config[]

static

Definition at line 218 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 290 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 171 of file main_config.c.

tmpl_require_enum_prefix

bool tmpl_require_enum_prefix

extern

Definition at line 49 of file tmpl_tokenize.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 561 of file main_config.c.