Scroll to navigation

READV(2) 리눅스 프로그래머 매뉴얼 READV(2)

이름

readv, writev - 벡터를 읽거나 쓴다.

사용법

#include <sys/uio.h>

int readv(int fd, const struct iovec * vector, int count);

int writev(int fd, const struct iovec * vector, int count);

struct iovec {
__ptr_t iov_base; /* 시작 주소 */
size_t iov_len; /* 바이트수 길이 */
};

설명

readv 는 파일 기술자 fd 에서 데이터를 읽고, 그리고 결과를 vector 가 가리키고 있는 버퍼에 넣는다. 버퍼의 숫자는 count 에 의해 지정된다. 버퍼는 지정된 순서로 채워진다. 데이터가 연속적인 버퍼 대신에 vector 에 넣어지는것을 제외하고 read 처럼 작동한다.

writevvector 가 가리키고 있는 버퍼에서 파일 기술자 fd 에 데이터를 쓴다. 버퍼의 숫자는 count 에 의해 지정된다. 버퍼는 지정된 순서로 사용된다. 데이터를 연속적인 버퍼 대신에 vector 에서 가져오는것을 제외하고 write 처럼 작동한다.

반환값

성공시, readv 는 읽은 바이트수를 반환한다. 성공시, writev 는 쓰여진 바이트의 수를 반환한다. 에러시, -1이 리턴되고 errno 는 적당한 값으로 설정된다.

에러

유효하지 않은 인자가 주어졌다. 예를 들어 countMAX_IOVEC, 또는 0보다 크다. fd 가 읽거나(readv) 쓰기(writev) 에 알맞지 않은 객체와 연결되어 있다.
"Segmentation fault." 대체로 vectoriov_base 의 몇몇 포인터들이 올바르게 할당되지 않은 메모리를 가리키고 있다.
파일 기술자 fd 가 유효하지 않다.
함수가 어떤 데이터를 읽고 쓰기 전에 신호에 의해 인터럽트되었다.
Non-blocking I/O 가 O_NONBLOCK 를 사용하여 선택되어 졌고 읽기 위해 즉시 이용할수 있는 데이터가 없다. (또는 파일 기술자 fd가 잠겨져 있는 객체를 위한 것이다.)
fd 가 디렉토리를 가리킨다.
fd 가 읽기/쓰기가 지원되지 않는 소켓이나 장치를 가리킨다.
이용할수 있는 커널 메모리가 충분하지 않다.

fd 와 연결된 객체에 의존하여 다른 에러들이 발생할수 있다.

호환

4.4BSD ( readv 그리고 writev 함수는 BSD 4.2에서 처음 나타났다), Unix98. Linux libc5 는 count 인자의 타입으로써 size_t 를 사용하였다. 이것은 타당하지만 표준은 아니다.

관련 항목

read(2), write(2), fprintf(3), fscanf(3)

역자

정강훈 <skyeyes@soback.kornet.net>, 2000년 8월 7일

1999년 1월 20일 Linux 2.2.0-pre8