radcli_avp_list_error(3)

📦 version 2.0.1, in arch rolling

💅 radcli_avp_list_error — ok so bestie, did anything break?

hey bestie 🫶 this is a page from the Radius client library man pages, and it's a short one but honestly iconic. It's radcli_avp_list_error(3) and it's your one-shot vibe check for a list of AVPs. Let's go ✨

🌸 NAME

radcli_avp_list_error — check whether any radcli_avp_add_*() / _by_num() call on list has ever failed. Ever. Like, in its whole life. 👑

✨ SYNOPSIS

#include <radcli/>

int radcli_avp_list_error(
    const radcli_avp_list  *list
);

🎀 DESCRIPTION

okay so here's the situation. The absolute second any add call on a given list fails, that list remembers it. And not in a "haha whatever, moving on" way — it's sticky: it remembers the first failure, not just the most recent one. 💀

Why does that matter? Because it lets you build a whole request as a flat sequence of add calls, no per-call check, and then just check once, right here, before sending. Bestie, do you understand what that saves you? It saves you from this ~6-line block:

if (radcli_avp_add_...(...) != 0) { log; abort; }

...repeated at every single call site 😭 — when there is honestly only one realistic recovery action anyway (abort the whole request), no matter which attribute failed to add. It's giving "why are we like this". So we don't do that anymore. 🦋

Now, important: this function is purely observational. It does not change any radcli_avp_add_*()'s own behavior. Not even a little. Every add call is still attempted and still returns its own 0/-1 exactly as it would if this function didn't exist — even after an earlier add on the same list has already failed. So if you're a caller who checks each call individually, or you're deliberately testing that one bad attribute gets rejected before you add others (the way tests/avp.c does), you see no difference. None. Zero. Nada. 🙈

This function just adds a second, aggregate way to notice a failure that already happened — for the caller who'd rather check once than at every call site. Main character energy tbh. 👑

🧚 PARAMETERS

  • list — the list to check. And listen: NULL counts as an error (there's nothing to build onto, bestie). This matches how every radcli_avp_add_*() already treats a NULL list as failure, which means you do not need a separate if (list == NULL) check right after radcli_avp_list_new() before you start relying on this. Slay, one less line. 💅

🌈 RETURN VALUE

non-zero if list is NULL or any add call on it has ever failed, 0 otherwise. That's it. That's the whole return value. ⭐

🔥 SEE ALSO

the whole friend group, fr fr:

💖 real talk: if you're checking every single add call by hand, this page is literally your sign to stop. check once, bestie. live your life. 🦋

k bye, this page is from radcli, dated 2026-10-10 — go off, you absolute icon 🌟💜

📦 where this page comes from