readv
接口名称
readv(int fd, const struct iovec *iov, int iovcnt)
接口描述
从文件描述符读取数据到缓冲区。
参数说明
| 参数 | 说明 | 备注 |
|---|---|---|
| fd | 文件描述符 | 传入socket描述符。 |
| *iov | iov指针 | 调用者保证长度的有效性，待接收数据总长度范围为(0, SSIZE_MAX]。 |
| iovcnt | iov个数 | 范围[0, 1024]。 |
返回值
类型：ssize_t
正数：实际读取的数据长度，表示成功
-1：表示失败，并设置errno以指示错误类型
0：表示链路已中断
错误码
| 错误码 | 描述 |
|---|---|
| EAGAIN | EWOULDBLOCK |
| ECONNRESET | 连接被对端终止。 |
| EINVAL | 入参iov结构体中的iov_len值之和大于SSIZE_MAX，或者入参iovcnt小于0或大于1024。 |
| ENOTCONN | 套接字未连接。 |
| EINTR | 被信号中断。 |
| EFAULT | 入参iov为空指针。 |
| ELIBBAD | 系统符号加载失败。 |
| EINVAL | 套接字存在，但是套接字对应的数据结构存在异常。 |
| EINVAL | 共线程部署模式时，sockfd的worker id和当前线程的worker id不一致，即socket跨worker线程调用。 |