这两个函数或者返回与某个套接字关联的本地协议地址(getsocketname),或者返回与某个套接字关联的外地协议地址(getpeername)。
#include <sys/socket.h>
int getsockname(int sockfd, struct sockaddr *localaddr, socklen_t *addrlen);
int getpeername(int sockfd, struct sockaddr *peeraddr, socklen_t *addrlen);
均返回:若成功则为0,若出错则为-1
注意,这两个函数的最后一个参数都是值-结果参数。这就是说,这两个函数都得装填由localaddr或peeraddr指针所指的套接字地址结构。
需要这两个函数的理由如下所述。
- 在一个没有调用bind的TCP客户上,connect成功返回后,getsockname用于返回由内核赋予该连接的本地IP地址和本地端口号。
- 在以端口号0调用bind(告知内核去选择本地端口号后),getsockname用于返回由内核赋予的本地端口号。
- getsockname可用于获取某个套接字的地址族。
- 在一个以通配IP地址调用bind的TCP服务器上,与某个客户的连接一旦建立(accept成功返回),getsockname就可以用于返回由内核赋予该连接的本地IP地址。在这样的调用中,套接字描述符参数必须是已连接套接字的描述符,而不是监听套接字的描述符。
- 当一个服务器是由调用accept的某个进程通过调用exec执行程序时,它能够获取客户身份的唯一途径便是调用getpeername。
举个使用的例子:
struct sockaddr_storage ss;
socklen_t len;
len = sizeof(ss);
getsockname(sockfd, (struct sockaddr *)&ss, &len);