radcli_ctx_read_config - Man Page

#include <radcli/>

radcli_ctx * radcli_ctx_read_config(
    const char  *filename,
    unsigned     flags
);

Parses filename, validates every option, initialises the transport (including the TLS/DTLS handshake for TLS/DTLS transports), and loads the built-in RFC 2865/2866/2869 dictionary plus the file's own dictionary= option, if set  radcli_ctx_read_dictionary() need not be called separately for the common case, unless RADCLI_CTX_NO_BUILTIN_DICT is set in flags. Uses the same file format and recognised options as radcli.h's rc_read_config(), so an existing radiusclient.conf written for the legacy API loads unchanged.

filename

path to the configuration file.

flags

a bitwise OR of radcli_ctx_flags, or 0 for the common case.

the new context, or NULL on failure (missing/unreadable file, invalid option, an unknown flags bit, or transport initialisation failure).

radcli_ctx_apply(3), radcli_ctx_free(3), radcli_ctx_get_opt_int(3), radcli_ctx_get_opt_str(3), radcli_ctx_new(3), radcli_ctx_read_dictionary(3), radcli_ctx_read_dictionary_from_buffer(3), radcli_ctx_set_opt_int(3), radcli_ctx_set_opt_str(3), radcli_ctx_set_secret(3), radcli_ctx_set_tls_psk(3)