socket_bind6(3diet)

socket_bind63diet

Set the local ip address and port of a socket

Usage

#include <socket.h>

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

Overview

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.

Examples

#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);

Releases

Unchanged in 4 releases since Debian 3.1 (Sarge).

  1. 3.1–6.0

From libowfat-dev 0.28-2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.