socket_bind6 - Man Page

set the local IP address and port of a socket

Syntax

#include <socket.h>

int socket_bind6(int s, char ip[16], uint16 port,
                uint32 scope_id);

Description

socket_bind6 sets the local IP address and TCP/UDP port of a TCP/UDP socket s to ip and port respectively.

If the IP address is ::, the operating system chooses a local IP address.  If port is 0, the operating system chooses a port.

Normally socket_bind6 returns 0. If anything goes wrong, socket_bind6 returns -1, setting errno appropriately.

The scope_id should normally be zero, but for link-local addresses it specifies the interface number on which to bind.  The interface number for a given network interface name can be found with socket_getifidx.

Example

 #include <socket.h>

 int s;
 char ip[16];
 uint16 p;
 uint32 scope_id;

 s = socket_tcp6();
 socket_bind6(s,ip,p,scope_id);
 socket_connect6(s,ip,p);

See Also

socket_bind4(3), socket_getifidx(3)

Referenced By

socket_bind4(3), socket_bind4_reuse(3), socket_bind6_reuse(3), socket_sctp4(3), socket_sctp4b(3), socket_sctp6(3), socket_sctp6b(3), socket_tcp4(3), socket_tcp4b(3), socket_tcp6(3), socket_tcp6b(3), socket_udp4(3), socket_udp6(3).