read

READ(2)                           System calls                           READ(2)



名前
       read - ファイル・ディスクリプターから読み込む

書式
       #include <unistd.h>

       ssize_t read(int fd, void *buf, size_t count);

説明
       read() はファイル・ディスクリプター(file descriptor) fd から最大 count バイトを buf
       で始まるバッファーへ読み込もうとする。

       count がゼロならば、read() はゼロを返し他に何も起きない。 count が SSIZE_MAX より大きければ、結果は特定できない。

返り値
       成功した場合、読み込んだバイト数を返す(ゼロはファイルの終りを意味する)、 ファイル位置はこの数だけ進められる。
       この数が要求した数より小さかったとしてもエラーではない; 例えば今すぐには実際にそれだけの数しかない場合(ファイルの最後に近いのかも
       しれないし、パイプ(pipe)や端末(terminal)から読み込んでいるかもしれない)や read()
       がシグナル(signal)によって割り込まれた場合にこれは起こり える。 エラーの場合は、-1 が返され、 errno
       が適切に設定される。この場合はファイル位置が変更されるかどうかは 不定である。

エラー
       EINTR   何のデータも読み込まないうちにシグナルに割り込まれた。

       EAGAIN  O_NONBLOCK を使用して非停止(Non-blocking) I/O が選択されており、
               すぐにデータが読み込み可能でなかった。

       EIO     I/O エラー。これは例えばプロセスがバックグランド・プロセス・グループで、 それを制御している tty
               から読みこもうとし、SIGTTIN が無視(ignore)または
               禁止(blocking)されている場合や、そのプロセス・グループが孤立(orphan)して
               いる場合に起こる。またディスクやテープを読んでいる時に低レベル I/O エラー が発生した場合にも起こる。

       EISDIR  fd がディレクトリを参照している。

       EBADF   fd が有効なファイル・ディスクリプターでないか、読み込みのために オープン(open)されていない。

       EINVAL  fd は読み込みに適していないオブジェクトを参照している。

       EFAULT  buf がアクセス可能なアドレス空間の外にある。

       fd が接続しているオブジェクトによっては他のエラーも起こりえる。 POSIX では、 いくらかのデータを読んだ後に割り込みが起こった場合、
       read は( errno に EINTR を設定して) -1 を返してもよいし、 既に読み込んだバイト数を返してもよい。


準拠
       SVr4, SVID, AT&T, POSIX, X/OPEN, BSD 4.3

制限
       NFS において。少量のデータを読み込む場合、最初の時のみにタイム・ スタンプが更新され、続くコールでは更新されないだろう。
       これはクライアント側で属性のキャッシングを行なうためである。 なぜならば、もし全ての NFS クライアントが atime(アクセス時間)の更新を
       サーバーに送らず、クライアント側でキャッシュを読むことに満足していれば、 サーバー側での read は発生しないので atime
       の更新は行なわれないだろう。 UNIX の方式では、クライアント側の属性のキャッシングを無効にすることで、
       これを得ることができる。しかしほとんどの状況ではこれは続くサーバーの 負荷を増加させ、パフォーマンスの低下をもたらす。

関連項目
       readdir(2), write(2), write(2), fcntl(2), close(2), lseek(2), select(2),
       readlink(2), ioctl(2), fread(3).



Linux                             July 12, 1997                          READ(2)