radcli_ctx_read_config(3)

🌸 NAME

Okay so this is radcli_ctx_read_config(3), from the Radius client library manual, and it's the create-a-context-by-parsing-a-config-file function. Fr fr it's the main, recommended way to configure radcli. 💖

---

✨ SYNOPSIS

#include <radcli/>

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

---

💅 DESCRIPTION

It parses filename, validates every single option, initialises the transport — including the TLS/DTLS handshake for TLS/DTLS transports, no cap — and loads the built-in RFC 2865/2866/2869 dictionary plus the file's own dictionary= option, if set. That means radcli_ctx_read_dictionary() need not be called separately for the common case, unless RADCLI_CTX_NO_BUILTIN_DICT is set in flags. ✨

It 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. Iconic behavior, honestly. 🦋

---

🎀 PARAMETERS

• filename — path to the configuration file. Simple as that. 🍓
• flags — a bitwise OR of radcli_ctx_flags, or 0 for the common case. Slay. 👑

---

🫶 RETURN VALUE

Returns the new context, or NULL on failure (missing/unreadable file, invalid option, an unknown flags bit, or transport initialisation failure). Like, if something's off, you get NULL, not a vibe. 😭

---

👀 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)

---

That's the whole page, bestie. This absolute icon ships with radcli, dated 2026-10-10, and its page is radcli_ctx_read_config(3). Periodt. 💜