Comment on page

9.2. bind()

将一个 socket 关联到一个 IP address 及 port number 函数原型
#include <sys/types.h>
#include <sys/socket.h>
int bind(int sockfd, struct sockaddr *my_addr, socklen_t addrlen);
说明
当远程机器想要连接到你的服务器程序时,他需要两项信息:IP address 及 port number。
而 bind() call 可以让你做这件事。
首先你要先调用 getaddrinfo() 载入 struct sockaddr,以取得 destination address(目地地址)与 port 的信息。然后你调用 socket() 以取得一个 socket descriptor,接着将这个 socket 与 address 传递给 bind(),然后 IP address 跟 port 就会很神奇的跟 socket 绑在一起了(使用真的法术)!
如果你不知道你计算机的 IP address、或你知道你的计算机只有一个 IP address、或你不在意要用计算机上的哪个 IP address 时,你可以单纯地将 getaddrinfo() 的 hints.ai_flags 参数设置为 AI_PASSIVE,这里所做的事情就是将特别的值填入 struct sockaddr 的 IP address 字段,以告诉 bind() 说它应该要自动填入这个主机的 IP address。
什么?将什么特别的值填入 struct sockaddr 的 IP address 字段就可以让它自动填上目前主机的 address 呢?
我会告诉你的,但是请记住这只适用于你手动填入 struct sockaddr 时,如果不是,请依据上述方式,使用 getaddrinfo() 返回的结果。在 IPv4 中, struct sockaddr_in 结构的 sin_addr.s_addr 会设置为 INADDR_ANY;而在 IPv6 中, struct sockaddr_in6 结构的 sin6_addr 字段会从全局变量 in6addr_any 载入。或者,若你正宣告一个新的 struct in6_addr,你可以将它初始为 IN6ADDR_ANY_INIT。
最后,addrlen 参数应该设置为 my_addr 的大小。
返回值
成功时返回零,或者错误时返回 -1(并依据错误设置 errno) 范例
// 用现代化的 getaddrinfo() 方式:
struct addrinfo hints, *res;
int sockfd;
// 首先,用 getaddrinfo() 加载地址结构数据:
memset(&hints, 0, sizeof hints);
hints.ai_family = AF_UNSPEC; // 使用 IPv4 或 IPv6,两者皆可
hints.ai_socktype = SOCK_STREAM;
hints.ai_flags = AI_PASSIVE; // 帮我填上我的 IP
getaddrinfo(NULL, "3490", &hints, &res);
// 建立 socket:
//(这边是简化版,照理你应该要查看 "res" linked list 的每个成员,并进行错误检查!)
sockfd = socket(res->ai_family, res->ai_socktype, res->ai_protocol);
// 将 sockfd 绑定(bind)到我们传递给 getaddrinfo() 的那个 port:
bind(sockfd, res->ai_addr, res->ai_addrlen);
// 手动封装 struct 的范例,IPv4
struct sockaddr_in myaddr;
int s;
myaddr.sin_family = AF_INET;
myaddr.sin_port = htons(3490);
// 你可以指定一个 IP address:
inet_pton(AF_INET, "63.161.169.137", &(myaddr.sin_addr));
// 或者你可以让系统自动选一个 IP address:
myaddr.sin_addr.s_addr = INADDR_ANY;
s = socket(PF_INET, SOCK_STREAM, 0);
bind(s, (struct sockaddr*)&myaddr, sizeof myaddr);
参照 getaddrinfo(), socket(), struct sockaddr_in, struct in_addr