---
title: readv
description: "**readv(int fd, const struct iovec *iov, int iovcnt)**"
url: https://www.hikunpeng.com/document/detail/zh/knet/api/docs/zh/api/posix_apis/readv.md
sourcePath: /source/zh/knet/api/docs/zh/api/posix_apis/readv.md
indexId: 57be624bb44098d4a439dc57548d88500ae28bb2bdcdd4bea55469ca8c6fab3351
---
# 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|当文件描述符设置O_NONBLOCK标志时，非阻塞读取操作无法立即完成。|
|ECONNRESET|连接被对端终止。|
|EINVAL|入参iov结构体中的iov_len值之和大于SSIZE_MAX，或者入参iovcnt小于0或大于1024。|
|ENOTCONN|套接字未连接。|
|EINTR|被信号中断。|
|EFAULT|入参iov为空指针。|
|ELIBBAD|系统符号加载失败。|
|EINVAL|套接字存在，但是套接字对应的数据结构存在异常。|
|EINVAL|共线程部署模式时，sockfd的worker id和当前线程的worker id不一致，即socket跨worker线程调用。|