网络

基本概念

网络模块实现了TCP/IP协议栈基本功能，提供标准的POSIX socket接口。

网络 - 图1 说明： 当前系统使用lwIP提供网络能力。

使用场景

针对用户态开发，OpenHarmony内核提供了一套网络功能系统调用接口，支持socket的创建关闭、数据收发、网络属性的设置等，通过C库提供标准的POSIX socket函数供开发者使用。

功能

表 1 标准C库相关接口

头文件 接口 功能
sys/socket.h int accept(int socket, struct sockaddr address, socklen_t address_len) 接受连接。
sys/socket.h int bind(int s, const struct sockaddr name, socklen_t namelen) socket与IP地址绑定。
sys/socket.h int shutdown(int socket, int how) 关闭连接。
sys/socket.h int getpeername(int s, struct sockaddr name, socklen_t namelen) 获取对端地址。
sys/socket.h int getsockname(int s, struct sockaddr name, socklen_t namelen) 获取本地地址。
sys/socket.h int getsockopt(int s, struct sockaddr name, socklen_t namelen) 获取socket属性信息。
sys/socket.h int setsockopt(int sockfd, int level, int optname, void optval, socklen_t optlen) 配置socket属性。
unistd.h int close(int s) 关闭socket。
sys/socket.h int connect(int s, const struct sockaddr name, socklen_t namelen) 连接到指定的目的IP。
sys/socket.h int listen(int sockfd, int backlog) listen连接本socket的请求。
sys/socket.h ssize_t recv(int socket, void buffer, size_t length, int flags) 接收socket上收到的数据。
sys/socket.h ssize_t recvmsg(int s, struct msghdr message, int flags) 接收socket上收到的数据，可使用更丰富的参数。
sys/socket.h ssize_t recvfrom(int socket, void buffer, size_t length, int flags, struct sockaddr address, socklen_t address_len) 接收socket上收到的数据，可同时获得数据来源IP地址。
sys/socket.h ssize_t send(int s, const void dataptr, size_t size, int flags) 通过socket发送数据。
sys/socket.h ssize_t sendmsg(int s, const struct msghdr message, int flags) 通过socket发送数据，可使用更丰富的参数。
sys/socket.h ssize_t sendto(int s, const void dataptr, size_t size, int flags, const struct sockaddr to, socklen_t tolen) 通过socket发送数据，可指定发送的目的IP地址。
sys/socket.h int socket(int domain, int type, int protocol) 创建socket。
sys/select.h int select(int nfds, fd_set readfds, fd_set writefds, fd_set exceptfds, struct timeval timeout) 多路复用。
sys/ioctl.h int ioctl(int s, int request, …) socket属性获取、设置。
arpa/inet.h const char inet_ntop(int af, const void src, char dst, socklen_t size) 网络地址格式转换：将二进制格式IP地址转换为字符串格式。
arpa/inet.h int inet_pton(int af, const char src, void dst) 网络地址格式转换：将字符串格式IP地址转换为二进制格式。

与标准接口差异详细说明：

  • sendmsg

函数原型：

ssize_t sendmsg(int s, const struct msghdr *message, int flags)

函数功能：发送消息。

参数说明：

参数 描述
s 套接字。
message 待发送的消息，不支持发送ancillary消息。
flags 用于指定发送消息时行为特性，有如下行为特性： - MSG_MORE：允许将多次发送的消息进行拼包发送。 - MSG_DONTWAIT：非阻塞操作。

返回值：

  • 成功返回：已发送的消息长度（字节数）。

  • 失败返回：-1，并设置errno。

  • recvmsg

函数原型：

ssize_t recvmsg(int s, struct msghdr *message, int flags)

函数功能：接收消息。

参数说明：

参数 描述
s 套接字。
message 存放接收的消息，不支持接收ancillary消息。
flags 用于指定接收消息时行为特性，有如下行为特性： - MSG_PEEK：允许预读消息而不取走。 - MSG_DONTWAIT：非阻塞操作。

返回值：

  • 成功返回：已接收的消息长度（字节数）。

  • 失败返回：-1，并设置errno。

  • ioctl

函数原型：

int ioctl(int s, int request, …)

函数功能：获取或设置socket属性。

参数说明：

参数 描述
s 套接字
request 对socket属性要进行的操作，当前支持如下操作： - FIONREAD：获取socket当前可读取的数据大小（字节数）。 - FIONBIO：设置socket是否非阻塞。

返回值：

  • 成功返回：0。
  • 失败返回：-1，并设置errno。