trusty (3) ipsec_isanyaddr.3.gz

NAME

       ipsec_anyaddr,     ipsec_isanyaddr,     ipsec_unspecaddr,     ipsec_isunspecaddr,     ipsec_loopbackaddr,
       ipsec_isloopbackaddr - get and test for addresses of type "any", "unspecified"  and  loopback  get  "any"
       address

SYNOPSIS

       #include <freeswan.h>

       const char *anyaddr(int af, ip_address *dst);
       int isanyaddr(const ip_address *src);
       const char *unspecaddr(int af, ip_address *dst);
       int isunspecaddr(const ip_address *src);
       const char *loopbackaddr(int af, ip_address *dst);
       int isloopbackaddr(const ip_address *src);

DESCRIPTION

       These functions fill in, and test for, special values of the ip_address type.

       Anyaddr  fills in the destination *dst with the ``any'' address of address family af (normally AF_INET or
       AF_INET6).  The IPv4 ``any'' address is the one embodied in the old INADDR_ANY macro.

       Isanyaddr returns 1 if the src address equals the ``any'' address, and 0 otherwise.

       Similarly, unspecaddr supplies, and isunspecaddr tests for, the ``unspecified'' address, which may be the
       same as the ``any'' address.

       Similarly, loopbackaddr supplies, and islookbackaddr tests for, the loopback address.

       Anyaddr,  unspecaddr,  and  loopbackaddr  return NULL for success and a pointer to a string-literal error
       message for failure; see DIAGNOSTICS.

SEE ALSO

       inet(3), ipsec_addrtot(3), ipsec_sameaddr(3)

DIAGNOSTICS

       Fatal errors in the address-supplying functions are: unknown address family.

HISTORY

       Written for the FreeS/WAN project by Henry Spencer.

                                                   8 Sept 2000                                  IPSEC_ANYADDR(3)