radcli_avp...efix_by_num(3)

💅 radcli_avp_get_ip4prefix_by_num — from the radcli Radius client library 💅

okay so bestie, we're in section 3 of the radcli manual, and today's main character is radcli_avp_get_ip4prefix_by_num. what does it do? it looks up an attribute that's typed as an IPv4 prefix, finds it by its legacy numeric ID, and then reads its first occurrence. that's it, that's the whole vibe. 🦋

---

✨ NAME ✨

radcli_avp_get_ip4prefix_by_num — look up an IPv4-prefix-typed attribute by legacy numeric ID and read its first occurrence. 🎀

---

🌸 SYNOPSIS 🌸

#include <radcli/>

int radcli_avp_get_ip4prefix_by_num(
    const radcli_avp_list  *list,
    const radcli_ctx       *ctx,
    uint32_t                attrid,
    uint32_t                vendor,
    struct in_addr         *out,
    unsigned               *prefix
);

copy it, paste it, don't retype it by hand, i'm begging 🙈

---

🧚 DESCRIPTION 🧚

so here's the thing. the original page has this whole DESCRIPTION heading and then... nothing. a void. silence. a little mystery ✨ — the actual deets are chilling down in PARAMETERS and RETURN VALUE, so go read those, that's where the plot is. iykyk 💜

---

👑 PARAMETERS 👑

like, literally every single one, in order, no skips:

• list — the list you're searching through. your haystack, basically. 🍓
• ctx — a context that has a dictionary loaded. yes, it needs the dictionary. no, you can't skip it. 🫶
• attrid — the attribute ID. this is either a PW_* constant, or a vendor type ID when vendor is non-zero. 🔥
• vendor — the vendor PEN, or 0 for a standard attribute. zeros are allowed here bestie, it's not a red flag. ⭐
• out — where the address gets written. and get this: it may be NULL. iconic, honestly. 💅
• prefix — where the prefix length gets written. this one may be NULL too. flexible queen energy. 🌈

---

💀 RETURN VALUE 💀

• 0 — success. slay. we ate. 👑
• -1 — failure. and the failure cases are: no such attribute, no occurrence, or the same thing as radcli_avp_get_ip4prefix() does. 😭

ngl, when you see that -1, check which of those three it was before you start spiralling. it's giving "three different problems, one exit code." 💀

---

🦋 SEE ALSO 🦋

the whole friend group, fr fr:

• radcli_avp_get_by_num(3)
• radcli_avp_get_bytes_by_num(3)
• radcli_avp_get_cstr_by_num(3)
• radcli_avp_get_ip6_by_num(3)
• radcli_avp_get_uint32_by_num(3)
• radcli_avp_get_uint64_by_num(3)

---

and that's the page!! 🎀✨ it's from radcli (that's the source, keep it in your notes bestie), dated 2026-10-10 — the page itself is literally titled radcli_avp...efix_by_num(3) and lives in the radcli manual. drink some water, close your NULL pointers, and go read the rest of section 3. mwah. 💖🫶🌸