NAME

       ipsec_sameaddr,     ipsec_addrcmp,     ipsec_samesubnet,     ipsec_addrinsubnet,    ipsec_subnetinsubnet,
       ipsec_subnetishost,  ipsec_samesaid,  ipsec_sameaddrtype,  ipsec_samesubnettype  -  do  comparisons   for
       addresses, subnets, SA IDs and address families

SYNOPSIS

       #include <freeswan.h>

       int sameaddr(const ip_address *a, const ip_address *b);
       int addrcmp(const ip_address *a, const ip_address *b);
       int samesubnet(const ip_subnet *a, const ip_subnet *b);
       int addrinsubnet(const ip_address *a, const ip_subnet *s);
       int subnetinsubnet(const ip_subnet *a, const ip_subnet *b);
       int subnetishost(const ip_subnet *s);
       int samesaid(const ip_said *a, const ip_said *b);
       int sameaddrtype(const ip_address *a, const ip_address *b);
       int samesubnettype(const ip_subnet *a, const ip_subnet *b);

DESCRIPTION

       These functions do various comparisons and tests on the ip_address type and ip_subnet types.

       Sameaddr  returns  non-zero  if addresses a and b are identical, and 0 otherwise.  Addresses of different
       families are never identical.

       Addrcmp returns -1, 0, or 1 respectively if address a is less than, equal to, or greater than b.  If they
       are not of the same address family, they are never equal; the ordering reported in this case is arbitrary
       (and probably not useful) but consistent.

       Samesubnet returns non-zero if subnets a and b are identical, and  0  otherwise.   Subnets  of  different
       address families are never identical.

       Addrinsubnet  returns  non-zero  if  address  a  is within subnet s and 0 otherwise.  An address is never
       within a subnet of a different address family.

       Subnetinsubnet returns non-zero if subnet a is a subset of subnet b and 0 otherwise.  A subnet is  deemed
       to be a subset of itself.  A subnet is never a subset of another subnet if their address families differ.

       Subnetishost returns non-zero if subnet s is in fact only a single host, and 0 otherwise.

       Samesaid returns non-zero if SA IDs a and b are identical, and 0 otherwise.

       Sameaddrtype returns non-zero if addresses a and b are of the same address family, and 0 otherwise.

       Samesubnettype returns non-zero if subnets a and b are of the same address family, and 0 otherwise.

SEE ALSO

       inet(3), ipsec_initaddr(3)

HISTORY

       Written for the FreeS/WAN project by Henry Spencer.

                                                   28 Nov 2000                                 IPSEC_SAMEADDR(3)