bind2addrsel Subroutine

Purpose

Binds a socket to an address according to address selection preferences.

Library

Library (libc.a)

Syntax

#include <netinet/in.h>
int bind2addrsel(int socket,const struct sockaddr *dstaddr, socklen_t dstaddrlen)

Description

When establishing a communication with a distant address, AIX® uses a address selection algorithm to define what local address will be used to communicate with a distant address. This algorithm uses a set of ordered rules (RFC 3484) to choose this local address. Some of these rules use the type of address for this selection. By default, public addresses are preferred over temporary addresses; CGA addresses are preferred over non CGA addresses; home addresses are preferred over care-of addresses. An application may prefer the use other preference choices (for example use a temporary address rather that a public address) for the rules using the type of address. If these rules are applied, these preferences will be used. The application can express these preferences using a setsockopt call with the IPV6_ADDR_PREFERENCES option and a combination of the following flags:

• IPV6_PREFER_SRC_HOME: prefer addresses reachable from a Home source address
• IPV6_PREFER_SRC_COA: prefer addresses reachable from a Care-of source address
• IPV6_PREFER_SRC_TMP: prefer addresses reachable from a temporary address
• IPV6_PREFER_SRC_PUBLIC: the prefer addresses reachable from a public source address
• IPV6_PREFER_SRC_CGA: the prefer addresses reachable from a Cryptographically Generated Address (CGA) source address
• IPV6_PREFER_SRC_NONCGA: the prefer addresses reachable from a non-CGA source address

The application will then call bind2addrsel. bind2addrsel binds a socket to a local address selected to communicate with the given destination address according to the address selection preferences.

Parameters

Return Values

Upon successful completion, the subroutine returns 0

If unsuccessful, the subroutine returns -1 and errno is set accordingly: