ipsec_portof (3) - Linux Manuals

ipsec_portof: get port field of an ip_address, set port field of an ip_address, get pointer to internal sockaddr of an ip_address, get length of internal sockaddr of an ip_address

NAME

ipsec_portof, ipsec_setportof, ipsec_sockaddrof, ipsec_sockaddrlenof - get port field of an ip_address, set port field of an ip_address, get pointer to internal sockaddr of an ip_address, get length of internal sockaddr of an ip_address

SYNOPSIS

#include <libreswan.h>

int portof(const ip_address *src);
void setportof(int port, ip_address *dst);
struct sockaddr *sockaddrof(ip_address *src);
size_t sockaddrlenof(const ip_address *src);

DESCRIPTION

The <libreswan.h> internal type ip_address contains one of the sockaddr types internally. Reliance on this feature is discouraged, but it may occasionally be necessary. These functions provide low-level tools for this purpose.

Portof and setportof respectively read and write the port-number field of the internal sockaddr. The values are in network byte order.

Sockaddrof returns a pointer to the internal sockaddr, for passing to other functions.

Sockaddrlenof reports the size of the internal sockaddr, for use in storage allocation.

DIAGNOSTICS

Portof returns -1, sockaddrof returns NULL, and sockaddrlenof returns 0 if an unknown address family is found within the ip_address.

HISTORY

Written for the FreeS/WAN project by Henry Spencer.

BUGS

These functions all depend on low-level details of the ip_address type, which are in principle subject to change. Avoid using them unless really necessary.

SEE ALSO

inet(3), ipsec_initaddr(3)

Pages related to ipsec_portof

  • ipsec_anyaddr (3) - get and test for addresses of type &quot;any&quot;, &quot;unspecified&quot; and loopback
  • ipsec_atoaddr (3) - convert Internet addresses and Subnet masks to and from ASCII
  • ipsec_atoasr (3) - convert ASCII to Internet address, subnet, or range, convert Internet address range to ASCII
  • ipsec_atoul (3) - convert unsigned-long numbers to and from ASCII
  • ipsec_goodmask (3) - check if Internet subnet mask is valid, convert Internet subnet mask to bit count, convert bit count to Internet subnet mask
  • ipsec_initaddr (3) - initialize an ip_address, get address type of an ip_address, get length of address within an ip_address, get copy of address within an ip_address, get pointer to address within an ip_address
  • ipsec_initsubnet (3) - initialize an ip_subnet, initialize a singleton ip_subnet, get address type of an ip_subnet, convert subnet mask to bit count, get base address of an ip_subnet, get subnet mask of an ip_subnet
  • ipsec_rangetosubnet (3) - convert address range to subnet
  • ipsec_sameaddr (3) - do comparisons for addresses, subnets, SA IDs and address families
  • ipsec_subnetof (3) - given Internet address and subnet mask return subnet number, host part, broadcast address