radcli_request_done(3)

💅 radcli_request_done — bestie, is my request done yet?

okay so this is a page from the Radius client library manpage set, and honestly it's a short one but it's important, so let's get into it 🫶

✨ NAME ✨

radcli_request_done — reports r's outcome once radcli_ctx_dispatch() has resolved it. It's a pure state query, like literally just asking "are we there yet?" — it performs no I/O of its own. 🎀

---

🌸 SYNOPSIS 🌸

#include <radcli/>

int radcli_request_done(
    radcli_request  *r
);

🦋 DESCRIPTION 🦋

Okay so here's the lore. Since REQ-NET2-SEND-016/013, r shares ctx's request socket/session with every other concurrently in-flight RADCLI_REQUEST_SENDONLY request — they're all carpooling in the same socket, basically 🚗💨 — and radcli_ctx_dispatch() is the thing that actually drives it to completion (draining replies, retransmitting, expiring on timeout). So radcli_request_done() is not doing any of that work itself. It never performs I/O, periodt. Which means polling it any number of times between radcli_ctx_dispatch() calls is free — spam it as much as you want, it costs you nothing 💅

The terminal result is reported once. After that, the reply stays readable with radcli_request_code() / _attrs(), so you don't lose access to it or anything. 🌈

---

💜 PARAMETERS 💜

• r — a request that radcli_request_perform(r, RADCLI_REQUEST_SENDONLY) returned RADCLI_OK for. That's the entry ticket, no ticket no ride 🎟️

---

👑 RETURN VALUE 👑

• RADCLI_AGAIN — still waiting 😭 call radcli_ctx_get_poll() / radcli_ctx_dispatch() and try again.
• RADCLI_OK — a validated reply was received! 🎉 read it with radcli_request_code() / _attrs(), same as radcli_request_perform().
• RADCLI_TIMEOUT — retries are exhausted 💀
• RADCLI_ERROR — on failure, or if r was never sent with RADCLI_REQUEST_SENDONLY, or if its terminal result was already returned. Basically the "girl what" response 🙈

---

⭐ SEE ALSO ⭐

• radcli_aaa(3)
• radcli_request_attrs(3)
• radcli_request_code(3)
• radcli_request_free(3)
• radcli_request_new(3)
• radcli_request_perform(3)
• radcli_request_server(3)

---

and that's the whole page, bestie 🍓 this one's from the radcli source, dated 2026-10-10 — go forth and poll responsibly, mwah 💖✨