radcli_ctx_set_opt_str(3)

💅 radcli_ctx_set_opt_str(3) — the string-option setter, bestie

okay so this is a page straight out of the radcli manual (radius client library, yes that one) and it's literally all about radcli_ctx_set_opt_str — the little function that puts a string into a config option slot and actually double-checks it for you ✨

---

🌸 NAME 🌸

radcli_ctx_set_opt_str — set a string-typed configuration option. that's it, that's the whole job 🎀

---

🦋 SYNOPSIS 🦋

#include <radcli/>

int radcli_ctx_set_opt_str(
    radcli_ctx   *ctx,
    radcli_opt_id opt,
    const char   *val
);

like, she's a three-argument queen and she returns an int, no cap 👑

---

💖 DESCRIPTION 💖

okay so what she does is: she stores val for opt on ctx — but not blindly, bestie, no ma'am 🙈 she validates it against opt's own grammar first. it's giving "trust but verify" energy.

for example, #RADCLI_OPT_AUTHSERVER accepts the "host[:port[:secret]]" form — literally the same shape a config file's authserver line takes. iconic consistency, honestly 🌈

and she's valid for any radcli_opt_id whose RC_OPTION_TABLE type is RADCLI_OPT_TYPE_STR or RADCLI_OPT_TYPE_SRV. 🫶

⚠️ but if your option is RADCLI_OPT_TYPE_INT, she is not the one — use radcli_ctx_set_opt_int() instead. wrong tool, bestie, we've all been there 💀

---

🎀 PARAMETERS 🎀

• ctx — a context from radcli_ctx_new() or radcli_ctx_read_config(). your whole vibe lives in here ✨
• opt — the option to set. pick your fighter 🥊
• val — the value. but heads up: for #RADCLI_OPT_AUTHSERVER / #RADCLI_OPT_ACCTSERVER, the shared secret is better set with radcli_ctx_set_secret() than embedded in this string. keep the secret in its own lane, periodt 🔐

---

🔥 RETURN VALUE 🔥

• 0 — success. slay, it worked 💅
• -1 — failure. and the glow-down reasons are: NULL ctx, opt out of range, wrong type for opt, or an invalid val for opt's grammar. she tells you no and she means it 😭

---

👑 SEE ALSO 👑

the whole friend group, fr fr:

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_config(3), radcli_ctx_read_dictionary(3), radcli_ctx_read_dictionary_from_buffer(3), radcli_ctx_set_opt_int(3), radcli_ctx_set_secret(3), radcli_ctx_set_tls_psk(3) 🌸

---

and that's the tea ☕ this page is from radcli, dated 2026-10-10 — go set some strings responsibly, bestie, mwah 💜✨