radcli_avp_add_username(3)   Radius client library  radcli_avp_add_username(3)

NAME
       radcli_avp_add_username - Append a User-Name AVP, appending a realm as
       "username@realm" unless username already contains one.

SYNOPSIS
       #include <radcli/>

       int radcli_avp_add_username(
           radcli_avp_list   *list,
           const radcli_ctx  *ctx,
           const char        *username,
           const char        *realm
       );

DESCRIPTION
       Written for callers (e.g. an application reading its own
       "default_realm" config knob) that need to send "username@realm" only
       when the caller- supplied username didn't already come with a realm
       attached. Passing realm as NULL reaches for ctx's own "default_realm"
       configuration option, so an application whose realm policy is just
       "whatever this

       ctx's config file says" never needs to read that option out itself.

PARAMETERS
       list   destination list.


       ctx    a context with a dictionary defining User-Name (any
              radcli_ctx_new()/radcli_ctx_read_config() context qualifies).


       username
              the username; used as-is if it already contains '@'.


       realm  realm to append if username has no '@': NULL uses ctx's own
              "default_realm" configuration option (no realm appended if that
              option is unset or empty); "" explicitly suppresses appending a
              realm even if "default_realm" is configured; any other string is
              used verbatim.


RETURN VALUE
       0 on success, -1 on failure (no User-Name attribute in ctx's
       dictionary, allocation failure, or as radcli_avp_add_str()).

SEE ALSO
       radcli_avp_add_bytes(3), radcli_avp_add_bytes_by_num(3),
       radcli_avp_add_gigawords64(3), radcli_avp_add_gigawords64_by_num(3),
       radcli_avp_add_ip4(3), radcli_avp_add_ip4_by_num(3),
       radcli_avp_add_ip4prefix(3), radcli_avp_add_ip4prefix_by_num(3),
       radcli_avp_add_ip6(3), radcli_avp_add_ip6_by_num(3),
       radcli_avp_add_str(3), radcli_avp_add_str_by_num(3),
       radcli_avp_add_uint32(3), radcli_avp_add_uint32_by_num(3),
       radcli_avp_add_uint64(3), radcli_avp_add_uint64_by_num(3),
       radcli_avp_concat_str(3), radcli_avp_concat_str_by_num(3),
       radcli_avp_def(3), radcli_avp_get(3), radcli_avp_get_by_num(3),
       radcli_avp_get_bytes(3), radcli_avp_get_bytes_by_num(3),
       radcli_avp_get_cstr(3), radcli_avp_get_cstr_by_num(3),
       radcli_avp_get_gigawords64(3), radcli_avp_get_gigawords64_by_num(3),
       radcli_avp_get_ip4prefix(3), radcli_avp_get_ip4prefix_by_num(3),
       radcli_avp_get_ip6(3), radcli_avp_get_ip6_by_num(3),
       radcli_avp_get_uint32(3), radcli_avp_get_uint32_by_num(3),
       radcli_avp_get_uint64(3), radcli_avp_get_uint64_by_num(3),
       radcli_avp_iter_next(3), radcli_avp_list_error(3),
       radcli_avp_list_free(3), radcli_avp_list_iter(3),
       radcli_avp_list_new(3)

radcli                            2026-09-03        radcli_avp_add_username(3)