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
       r      a request from radcli_request_new().


       flags  a bitwise OR of radcli_request_flags.


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)

radcli                            2026-09-03         radcli_request_perform(3)