rc_read_config(3)            Radius client library           rc_read_config(3)

NAME
       rc_read_config - Read the global config file.

SYNOPSIS
       #include <radcli/>

       rc_handle * rc_read_config(
           char const  *filename
       );

DESCRIPTION
       This is the primary way to initialise radcli. Loads the configuration
       file, initialises the transport (including TLS/DTLS handshake when
       applicable), and returns an opaque handle for use in subsequent calls.
       The format is compatible with radiusclient-ng and freeradius-client.

       Standard RFC 2865/2866/2869 attributes are built into the library; the
       dictionary option is only needed for vendor-specific attributes.

       Recognised configuration options:

       acctserver: accounting server; same format as authserver.

       namespace: Linux network namespace name to use for socket operations.

       tls-verify-hostname: set to false to skip server hostname verification
       (not recommended).

       require-message-authenticator: set to no to accept responses that lack
       the Message-Authenticator attribute. Enabled by default per draft-ietf-
       radext-deprecating-radius-10 (CVE-2024-3596 / BLAST RADIUS); only
       disable for legacy servers that predate RFC 3579. Has no effect over
       RADIUS/TLS or RADIUS/DTLS, where this mitigation is never enforced, per
       draft-ietf-radext-deprecating-radius-10 Section 4.

       clientdebug: debug verbosity level (integer; 0 = off).

PARAMETERS
       filename
              path to the configuration file.


RETURN VALUE
       new rc_handle on success, NULL on failure.

SEE ALSO
       rc_aaa(3), rc_aaa_ctx(3), rc_aaa_ctx_free(3), rc_aaa_ctx_get_secret(3),
       rc_aaa_ctx_get_vector(3), rc_aaa_ctx_server(3), rc_acct(3),
       rc_acct_async(3), rc_acct_proxy(3), rc_add_config(3),
       rc_apply_config(3), rc_auth(3), rc_auth_proxy(3), rc_avpair_add(3),
       rc_avpair_assign(3), rc_avpair_copy(3), rc_avpair_free(3),
       rc_avpair_gen(3), rc_avpair_get(3), rc_avpair_get_attr(3),
       rc_avpair_get_in6(3), rc_avpair_get_raw(3), rc_avpair_get_uint32(3),
       rc_avpair_insert(3), rc_avpair_log(3), rc_avpair_new(3),
       rc_avpair_next(3), rc_avpair_parse(3), rc_avpair_remove(3),
       rc_avpair_tostr(3), rc_buildreq(3), rc_check(3), rc_conf_int(3),
       rc_conf_srv(3), rc_conf_str(3), rc_config_free(3), rc_config_init(3),
       rc_destroy(3), rc_dict_addattr(3), rc_dict_addval(3),
       rc_dict_addvend(3), rc_dict_findattr(3), rc_dict_findval(3),
       rc_dict_findvend(3), rc_dict_free(3), rc_dict_getattr(3),
       rc_dict_getval(3), rc_dict_getvend(3), rc_find_server_addr(3),
       rc_get_socket_type(3), rc_new(3), rc_read_dictionary(3),
       rc_read_dictionary_from_buffer(3), rc_send_server(3), rc_test_config(3)

radcli                            2026-08-19                 rc_read_config(3)