radcli_avp_add_ip4prefix(3)  Radius client library radcli_avp_add_ip4prefix(3)

NAME
       radcli_avp_add_ip4prefix - Append an IPv4-prefix-typed attribute.

SYNOPSIS
       #include <radcli/>

       int radcli_avp_add_ip4prefix(
           radcli_avp_list        *list,
           const radcli_attr_def  *def,
           struct in_addr          value,
           unsigned                prefix
       );

DESCRIPTION
       The RFC 8044 SS3.9 wire format is built internally: a reserved zero
       octet, the prefix length, and the 4-octet address.

       A dedicated function rather than a prefix parameter on
       radcli_avp_add_ip4(): unlike radcli_avp_add_ip6() (which took a prefix
       parameter from its introduction), radcli_avp_add_ip4() already shipped
       without one, with real callers; adding one now would force every
       existing caller to update for a type most of them don't use.

PARAMETERS
       list   destination list.


       def    the attribute; must be RADCLI_TYPE_IPV4PREFIX.


       value  the address.


       prefix the prefix length (0-32).


RETURN VALUE
       0 on success, -1 on failure (wrong type, prefix out of range, or as
       radcli_avp_add_bytes()).

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_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_add_username(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_ip4prefix(3)