rc_avpair_remove(3)

💖 rc_avpair_remove(3) 💖

okay so this one lives in the Radius client library (that's the manual section it hangs out in, bestie), and it's literally the "delete this one thing off the list" function. short page, but she's important.

---

✨ NAME ✨

rc_avpair_remove —

ngl the description slot on this one is straight-up empty. that's not me skipping it, that's genuinely how the page is written. the name, then a dash, then vibes. iconic honestly.

---

🌸 SYNOPSIS 🌸

#include <radcli/radcli.h>

void rc_avpair_remove(
    VALUE_PAIR  **list,
    uint32_t      attrid,
    uint32_t      vendorspec
);

---

💅 DESCRIPTION 💅

so what she does: removes an attribute-value pair from the given list. that's it. that's the job. one pair, gone, poof. 🦋

and if you wanna know what the data inside one of those pairs is supposed to look like? go read rc_avpair_assign(). she's got the format tea. 👑

---

🎀 PARAMETERS 🎀

• list — a VALUE_PAIR array of values. this is your little collection of pairs, and yeah she takes it as a pointer-to-pointer so she can actually rearrange it.
• attrid — the attribute of the pair you're removing, like e.g. PW_USER_NAME. tell her which one you want yeeted. 🫶
• vendorspec — the vendor ID, but only in case of a vendor specific value. otherwise? 0. no vendor, no drama. 💀

---

🌈 STRUCTURES 🌈

⚠️ ok listen. avoid using this structure directly. do not be the main character who touches it raw. use the rc_avpair_get_ functions instead. periodt.

struct rc_value_pair {
  char                   name[RC_NAME_LENGTH+1];      // attribute name if known.
  uint64_t               attribute; // attribute numeric value of type rc_attr_id including vendor; use VENDOR() and ATTRID() to separate.
  rc_attr_type           type;      // attribute type.
  uint32_t               lvalue;    // attribute value if type is PW_TYPE_INTEGER, PW_TYPE_DATE or PW_TYPE_IPADDR.
  char                   strvalue[AUTH_STRING_LEN+1];  // contains attribute value in other cases.
  struct rc_value_pair  *next;
  char                   pad[32];       // unused pad
};

that pad[32] at the bottom? unused. just sitting there. she's decorative. 🎀

---

🦋 SEE ALSO 🦋

the whole bestie squad, 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), rc_avpair_assign()

(yeah that last one has no (3) on it, and yeah i kept it exactly like that, don't @ me 🫶)

---

💖 and that's the page!! brought to you by radcli, dated 2023-01-29, and yeah she really is rc_avpair_remove(3) 💖