preadのヘルプ・マニュアル
日本語 英語
pread --help
man pread
PREAD(2) Linux Programmer’s Manual PREAD(2)
名前
pread, pwrite - 指定したオフセットでファイルディスクリプタを読み書きす
る
書式
#define _XOPEN_SOURCE 500
#include
ssize_t pread(int fd, void *buf, size_t count, off_t offset);
ssize_t pwrite(int fd, const void *buf, size_t count, off_t offset);
説明
pread() は、ファイルディスクリプタ fd の (ファイルの先頭からの) オフ セ
ッ ト offset から最大 count バイトをバッファ buf へ読み込む。ファイル・
オフセットは変化しない。
pwrite() は、バッファ buf から最大 count バイトをファイルディスクリプタ
fd のオフセット offset に書き込む。ファイル・オフセットは変化しない。
fd で参照されるファイルはシーク (seek) 可能でなければならない。
返り値
成 功した場合、読み書きを行ったバイト数が返される (ゼロは、 pwrite() の
場合には何も書かれなかったことを意味し、 pread() の場合にはファイルの末
尾 に達したことを意味する)。エラーの場合は -1 が返され、 errno がそのエ
ラーを示すように設定される。
エラー
pread() では、 read(2) および lseek(2) で規定された全てのエラーが発生す
る可能性があり、 error にはエラーを示す値が設定される。 pwrite() では、
write(2) および lseek(2) で規定された全てのエラーが発生する可能性があり
、 error にはエラーを示す値が設定される。
バージョン
シ ステムコール pread() と pwrite() は Linux にバージョン 2.1.60 で追加
された。 i386 のシステムコールのエントリは 2.1.69 で追加された。 (シ ス
テ ムコールを持たない古いカーネルでの lseek(2) を使ったエミュレーション
を含めると) C ライブラリにおけるサポートは glibc 2.1 で追加された。
準拠
POSIX.1-2001.
関連項目
lseek(2), read(2), write(2), feature_test_macros(7)
Linux 2008-12-03 PREAD(2)
PREAD(2) Linux Programmer’s Manual PREAD(2)
NAME
pread, pwrite - read from or write to a file descriptor at a given off-
set
SYNOPSIS
#define _XOPEN_SOURCE 500
#include
ssize_t pread(int fd, void *buf, size_t count, off_t offset);
ssize_t pwrite(int fd, const void *buf, size_t count, off_t offset);
DESCRIPTION
pread() reads up to count bytes from file descriptor fd at offset off-
set (from the start of the file) into the buffer starting at buf. The
file offset is not changed.
pwrite() writes up to count bytes from the buffer starting at buf to
the file descriptor fd at offset offset. The file offset is not
changed.
The file referenced by fd must be capable of seeking.
RETURN VALUE
On success, the number of bytes read or written is returned (zero indi-
cates that nothing was written, in the case of pwrite(), or end of
file, in the case of pread(), or -1 on error, in which case errno is
set to indicate the error.
ERRORS
pread() can fail and set errno to any error specified for read(2) or
lseek(2). pwrite() can fail and set errno to any error specified for
write(2) or lseek(2).
VERSIONS
The pread() and pwrite() system calls were added to Linux in version
2.1.60; the entries in the i386 system call table were added in 2.1.69.
C library support (including emulation using lseek(2) on older kernels
without the system calls) was added in glibc 2.1.
CONFORMING TO
POSIX.1-2001.
SEE ALSO
lseek(2), read(2), write(2), feature_test_macros(7)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
Linux 2008-12-03 PREAD(2)