.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
-.\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
-.\" all rights reserved.
-.\" Translated Fri Jun 25 23:32:20 JST 1999
-.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
+.\"*******************************************************************
.\"
-.\"WORD: descriptor ディスクリプタ
-.\"WORD: offset オフセット
-.\"WORD: seek シーク
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH PREAD 2 2010-09-26 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH PREAD 2 2010\-11\-21 Linux "Linux Programmer's Manual"
.SH 名前
pread, pwrite \- 指定したオフセットでファイルディスクリプタを読み書きする
.SH 書式
-.B #include <unistd.h>
+\fB#include <unistd.h>\fP
.sp
-.BI "ssize_t pread(int " fd ", void *" buf ", size_t " count \
-", off_t " offset );
+\fBssize_t pread(int \fP\fIfd\fP\fB, void *\fP\fIbuf\fP\fB, size_t \fP\fIcount\fP\fB, off_t
+\fP\fIoffset\fP\fB);\fP
.sp
-.BI "ssize_t pwrite(int " fd ", const void *" buf ", size_t " count \
-", off_t " offset );
+\fBssize_t pwrite(int \fP\fIfd\fP\fB, const void *\fP\fIbuf\fP\fB, size_t \fP\fIcount\fP\fB,
+off_t \fP\fIoffset\fP\fB);\fP
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.PD 0
.ad l
.sp
-.BR pread (),
-.BR pwrite ():
+\fBpread\fP(), \fBpwrite\fP():
.RS 4
_XOPEN_SOURCE\ >=\ 500
.br
.ad
.PD
.SH 説明
-.BR pread ()
-は、ファイルディスクリプタ
-.I fd
-の (ファイルの先頭からの) オフセット
-.I offset
-から最大
-.I count
-バイトをバッファ
-.I buf
-へ読み込む。ファイル・オフセットは変化しない。
+\fBpread\fP() は、ファイルディスクリプタ \fIfd\fP の (ファイルの先頭からの) オフセット \fIoffset\fP から最大 \fIcount\fP
+バイトをバッファ \fIbuf\fP へ読み込む。ファイル・オフセットは変化しない。
.PP
-.BR pwrite ()
-は、バッファ
-.I buf
-から最大
-.I count
-バイトをファイルディスクリプタ
-.I fd
-のオフセット
-.I offset
-に書き込む。ファイル・オフセットは変化しない。
+\fBpwrite\fP() は、バッファ \fIbuf\fP から最大 \fIcount\fP バイトをファイルディスクリプタ \fIfd\fP のオフセット
+\fIoffset\fP に書き込む。ファイル・オフセットは変化しない。
.PP
-.I fd
-で参照されるファイルはシーク (seek) 可能でなければならない。
+\fIfd\fP で参照されるファイルはシーク (seek) 可能でなければならない。
.SH 返り値
-成功した場合、読み書きを行ったバイト数が返される (ゼロは、
-.BR pwrite ()
-の場合には何も書かれなかったことを意味し、
-.BR pread ()
-の場合にはファイル
-の末尾に達したことを意味する)。
-エラーの場合は \-1 が返され、
-.I errno
-がそのエラーを示すように設定される。
+成功した場合、読み書きを行ったバイト数が返される (ゼロは、 \fBpwrite\fP() の場合には何も書かれなかったことを意味し、 \fBpread\fP()
+の場合にはファイル の末尾に達したことを意味する)。 エラーの場合は \-1 が返され、 \fIerrno\fP がそのエラーを示すように設定される。
.SH エラー
-.BR pread ()
-では、
-.BR read (2)
-および
-.BR lseek (2)
-で規定された全てのエラーが発生する可能性があり、
-.I error
-にはエラーを示す値が設定される。
-.BR pwrite ()
-では、
-.BR write (2)
-および
-.BR lseek (2)
-で規定された全てのエラーが発生する可能性があり、
-.I error
-にはエラーを示す値が設定される。
+\fBpread\fP() では、 \fBread\fP(2) および \fBlseek\fP(2) で規定された全てのエラーが発生する可能性があり、
+\fIerror\fP にはエラーを示す値が設定される。 \fBpwrite\fP() では、 \fBwrite\fP(2) および \fBlseek\fP(2)
+で規定された全てのエラーが発生する可能性があり、 \fIerror\fP にはエラーを示す値が設定される。
.SH バージョン
-システムコール
-.BR pread ()
-と
-.BR pwrite ()
-は Linux にバージョン 2.1.60 で追加された。
-i386 のシステムコールのエントリは 2.1.69 で追加された。
-(システムコールを持たない古いカーネルでの
-.BR lseek (2)
-を使ったエミュレーションを含めると)
-C ライブラリにおけるサポートは glibc 2.1 で追加された。
+システムコール \fBpread\fP() と \fBpwrite\fP() は Linux にバージョン 2.1.60 で追加された。 i386
+のシステムコールのエントリは 2.1.69 で追加された。 (システムコールを持たない古いカーネルでの \fBlseek\fP(2)
+を使ったエミュレーションを含めると) C ライブラリにおけるサポートは glibc 2.1 で追加された。
.SH 準拠
-POSIX.1-2001.
+POSIX.1\-2001.
+.SH 注意
+Linux では、裏で呼び出されるシステムコールの名前がカーネル 2.6 で変更された。
+\fBpread\fP() は \fBpread64\fP() になり、 \fBpwrite\fP() は \fBpwrite64\fP() になった。
+システムコールの番号は変更されていない。
+glibc の \fBpread\fP() と \fBpwrite\fP() のラッパー関数はこれらの変更を吸収している。
.SH 関連項目
-.BR lseek (2),
-.BR read (2),
-.BR write (2)
+\fBlseek\fP(2), \fBread\fP(2), \fBreadv\fP(2), \fBwrite\fP(2)
OSDN Git Service
