100、系统接口函数详解

系统接口函数详解

1. getpeername 函数

1.1 函数概述

getpeername 函数用于获取指定套接字的对端地址。其原型如下：

#include <sys/socket.h>
int getpeername(int socket, struct sockaddr *restrict address,
                socklen_t *restrict address_len);

1.2 功能描述

该函数会检索指定套接字的对端地址，将此地址存储在 address 指针所指向的 sockaddr 结构体中，并将地址长度存储在 address_len 所指向的对象中。 address_len 参数指向的 socklen_t 对象，在输入时指定所提供的 sockaddr 结构体的长度，输出时指定对端地址的长度。若实际地址长度大于所提供的 sockaddr 结构体长度，存储的地址将被截断。若协议允许未绑定客户端进行连接，且对端未绑定，则 address 所指向对象中存储的值未指定。

1.3 返回值

• 成功完成时，返回 0。
• 否则，返回 -1，并设置 errno