radcli_ctx_read_config(3)    Radius client library   radcli_ctx_read_config(3)

NAME
       radcli_ctx_read_config - Create a context by parsing a config file  the
       main, recommended way to configure radcli.

SYNOPSIS
       #include <radcli/>

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

DESCRIPTION
       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.

PARAMETERS
       filename
              path to the configuration file.


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


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

SEE ALSO
       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)

radcli                            2026-09-03         radcli_ctx_read_config(3)