radcli_request_done3
Report r's outcome once radcli_ctx_dispatch() has resolved it a pure state query, performing no i/o of its own.
Usage
#include <radcli/>
int radcli_request_done(
radcli_request *r
);
Overview
Since REQ-NET2-SEND-016/013, r shares ctx's request socket/session with every other concurrently in-flight RADCLI_REQUEST_SENDONLY request, and radcli_ctx_dispatch() is what actually drives it to completion (draining replies, retransmitting, expiring on timeout) this call never performs I/O itself, so polling it any number of times between radcli_ctx_dispatch() calls is free. The terminal result is reported once; the reply then stays readable with radcli_request_code()/_attrs().
Parameters
r-
a request radcli_request_perform(r, RADCLI_REQUEST_SENDONLY) returned RADCLI_OK for.
Return value
RADCLI_AGAIN if still waiting (call radcli_ctx_get_poll()/ radcli_ctx_dispatch() and try again), RADCLI_OK if a validated reply was received (read it with radcli_request_code()/_attrs(), same as radcli_request_perform()), RADCLI_TIMEOUT if retries are exhausted, or RADCLI_ERROR on failure, if r was never sent with RADCLI_REQUEST_SENDONLY, or if its terminal result was already returned.