| 1 |
.\" Copyright, the authors of the Linux man-pages project |
| 2 |
.\" |
| 3 |
.\" SPDX-License-Identifier: Linux-man-pages-copyleft |
| 4 |
.\" |
| 5 |
.TH iovec 3type 2026-01-09 "Linux man-pages 6.18" |
| 6 |
.SH NAME |
| 7 |
iovec \- Vector I/O data structure |
| 8 |
.SH LIBRARY |
| 9 |
Standard C library |
| 10 |
.RI ( libc ) |
| 11 |
.SH SYNOPSIS |
| 12 |
.EX |
| 13 |
.B #include <sys/uio.h> |
| 14 |
.P |
| 15 |
.B struct iovec { |
| 16 |
.BR " void *iov_base;" " /* Starting address */" |
| 17 |
.BR " size_t iov_len;" " /* Size of the memory pointed to by "\c |
| 18 |
.IR iov_base ". */" |
| 19 |
.B }; |
| 20 |
.EE |
| 21 |
.SH DESCRIPTION |
| 22 |
Describes a region of memory, beginning at |
| 23 |
.I iov_base |
| 24 |
address and with the size of |
| 25 |
.I iov_len |
| 26 |
bytes. |
| 27 |
System calls use arrays of this structure, |
| 28 |
where each element of the array represents a memory region, |
| 29 |
and the whole array represents a vector of memory regions. |
| 30 |
The maximum number of |
| 31 |
.I iovec |
| 32 |
structures in that array |
| 33 |
is limited by |
| 34 |
.B IOV_MAX |
| 35 |
(defined in |
| 36 |
.IR <limits.h> , |
| 37 |
or accessible via the call |
| 38 |
.IR sysconf(_SC_IOV_MAX) ). |
| 39 |
.SH STANDARDS |
| 40 |
POSIX.1-2024. |
| 41 |
.SH HISTORY |
| 42 |
SUSv1, |
| 43 |
POSIX.1-2001 XSI. |
| 44 |
.SH NOTES |
| 45 |
The following header also provides this type: |
| 46 |
.IR <sys/socket.h> . |
| 47 |
.SH SEE ALSO |
| 48 |
.BR process_madvise (2), |
| 49 |
.BR readv (2) |