rc_new(3)

💖 rc_new — bestie edition 💖

okay so you know how the radcli Radius client library is a whole thing? yeah. this is one of its little guys. it lives in the Radius client library manual, section 3, and it's genuinely the most low-effort slay in the whole API. no cap.

---

✨ NAME ✨

rc_new —

and that's it. that's the whole name line. the original page literally leaves the description blank, so bestie, we're not inventing one. it's giving mysterious. it's giving main character who refuses to introduce herself. 🎀

---

🌸 SYNOPSIS 🌸

first, you gotta pull in the header:

#include <radcli/radcli.h>

then you call the girl herself:

rc_handle * rc_new(
    void
);

no arguments. none. zero. she takes void and she takes it proudly. 💅

---

🦋 DESCRIPTION 🦋

rc_new initialises a new Radius Client handle. that's the entire job description. she clocks in, she makes you a shiny fresh handle, she does not elaborate further. 🫶

if you're building anything with the Radius client library, this is like. step one. the vibe check before the vibe check. you can't do the rest of the rc_* function family until you've got yourself a handle, and this is where the handle comes from. ✨

---

🎀 RETURN VALUE 🎀

she hands you back a brand new rc_handle. 🎁

⚠️ important bestie!!! when you're done with it, you gotta free it with rc_destroy. it's not a "set it and forget it" situation, it's a "clean up after yourself" situation. no leaking, that's so not the move. 😭

---

🌈 SEE ALSO 🌈

the whole friend group. the entire group chat. every single one of these, fr fr:

• radcli.h(3)
• 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_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_check_tls(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_get_srcaddr(3)
• rc_getport(3)
• rc_mksid(3)
• rc_new(3)
• rc_openlog(3)
• rc_own_hostname(3)
• rc_read_config(3)
• rc_read_dictionary(3)
• rc_read_dictionary_from_buffer(3)
• rc_send_server(3)
• rc_setdebug(3)
• rc_test_config(3)
• rc_tls_fd(3)

(yes, rc_new(3) is in there linking to herself. self-love icon behavior honestly. 👑)

---

and that's the page!! this one dropped on 2023-01-29, brought to you by the fine people behind radcli 💖 thanks for coming to my ted talk, now go rc_destroy your handles like a responsible queen. mwah. 🦋✨