| radcli_request_perform(3) | Radius client library | radcli_request_perform(3) |
NAME
radcli_request_perform - Send a request, optionally waiting for the reply.
SYNOPSIS
#include <radcli/>
int radcli_request_perform(
radcli_request *r,
unsigned flags
);
DESCRIPTION
By default (flags == RADCLI_REQUEST_NONE), sends r and waits for the reply. With RADCLI_REQUEST_SENDONLY, transmits r a single time and returns once the packet is handed to the network, without blocking for a reply either as a pure fire-and-forget notification whose outcome the caller does not act on (call radcli_request_free() without ever calling radcli_ctx_dispatch(); radcli.h's rc_acct_async() is the equivalent call in the legacy API), or to read the reply later via radcli_request_done(), driven by the caller's own radcli_ctx_get_poll()/radcli_ctx_dispatch() loop (lib/dae.c).
May be called only once per request; construct a new radcli_request for a retransmission with different content.
PARAMETERS
RETURN VALUE
with RADCLI_REQUEST_NONE: RADCLI_OK if a validated reply was received (see radcli_request_code() for which one), RADCLI_TIMEOUT if none of the server's addresses replied, or RADCLI_ERROR on failure. With RADCLI_REQUEST_SENDONLY: RADCLI_OK once the packet is handed to the network, RADCLI_ERROR on failure (e.g. name resolution or encoding failed); never RADCLI_TIMEOUT.
SEE ALSO
radcli_aaa(3), radcli_request_attrs(3), radcli_request_code(3), radcli_request_done(3), radcli_request_free(3), radcli_request_new(3), radcli_request_server(3)
| 2026-09-03 | radcli |