.\" File automatically generated by doxy2man0.3
.\" Generation date: Thu Sep 3 2026
.TH rc_aaa 3 2026-09-03 "radcli" "Radius client library"
.SH "NAME"
rc_aaa \- Builds an authentication/accounting request for port id nas_port with the value_pairs send and submits it to a server.
.SH SYNOPSIS
.nf
.B #include <radcli/>
.sp
\fBint rc_aaa\fP(
    \fBrc_handle        *\fP\fIrh\fP,
    \fBuint32_t          \fP\fInas_port\fP,
    \fBVALUE_PAIR       *\fP\fIsend\fP,
    \fBVALUE_PAIR      **\fP\fIreceived\fP,
    \fBchar             *\fP\fImsg\fP,
    \fBint               \fP\fIadd_nas_port\fP,
    \fBrc_standard_codes \fP\fIrequest_type\fP
);
.fi
.SH DESCRIPTION
.SH PARAMETERS
.TP
.B rh
a handle to parsed configuration. 

.TP
.B nas_port
the physical NAS port number to use (may be zero). 

.TP
.B send
a VALUE_PAIR array of values (e.g., PW_USER_NAME). 

.TP
.B received
an allocated array of received values. 

.TP
.B msg
must be an array of PW_MAX_MSG_SIZE or NULL; will contain the concatenation of any PW_REPLY_MESSAGE received. 

.TP
.B add_nas_port
this should be zero; if non-zero it will include PW_NAS_PORT in sent pairs. 

.TP
.B request_type
one of standard RADIUS codes (e.g., PW_ACCESS_REQUEST). 

.SH RETURN VALUE
.PP
received value_pairs in received, messages from the server in msg and OK_RC (0) on success, CHALLENGE_RC (3) on Access-Challenge received, negative on failure as return value. 
.SH SEE ALSO
.PP
.nh
.ad l
\fIrc_aaa_ctx\fP(3), \fIrc_aaa_ctx_free\fP(3), \fIrc_aaa_ctx_get_secret\fP(3), \fIrc_aaa_ctx_get_vector\fP(3), \fIrc_aaa_ctx_server\fP(3), \fIrc_acct\fP(3), \fIrc_acct_async\fP(3), \fIrc_acct_proxy\fP(3), \fIrc_auth\fP(3), \fIrc_auth_proxy\fP(3), \fIrc_avpair_add\fP(3), \fIrc_avpair_assign\fP(3), \fIrc_avpair_copy\fP(3), \fIrc_avpair_free\fP(3), \fIrc_avpair_gen\fP(3), \fIrc_avpair_get\fP(3), \fIrc_avpair_get_attr\fP(3), \fIrc_avpair_get_in6\fP(3), \fIrc_avpair_get_raw\fP(3), \fIrc_avpair_get_uint32\fP(3), \fIrc_avpair_insert\fP(3), \fIrc_avpair_log\fP(3), \fIrc_avpair_new\fP(3), \fIrc_avpair_next\fP(3), \fIrc_avpair_parse\fP(3), \fIrc_avpair_remove\fP(3), \fIrc_avpair_tostr\fP(3), \fIrc_buildreq\fP(3), \fIrc_check\fP(3), \fIrc_dict_addattr\fP(3), \fIrc_dict_addval\fP(3), \fIrc_dict_addvend\fP(3), \fIrc_dict_findattr\fP(3), \fIrc_dict_findval\fP(3), \fIrc_dict_findvend\fP(3), \fIrc_dict_getattr\fP(3), \fIrc_dict_getval\fP(3), \fIrc_dict_getvend\fP(3), \fIrc_send_server\fP(3)
.ad
.hy