read(2) - Japanese

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

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

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

EAGAIN	ファイルディスクリプター fd がソケット以外のファイルを参照していて、 非停止 (nonblocking) モード (O_NONBLOCK) に設定されており、読み込みを行うと停止する状況にある。
EAGAIN または EWOULDBLOCK
	ファイルディスクリプター fd がソケットを参照していて、非停止 (nonblocking) モード (O_NONBLOCK) に設定されており、読み込みを行うと停止する状況にある。 POSIX.1-2001 は、この場合にどちらのエラーを返すことも認めており、 これら 2 つの定数が同じ値を持つことも求めていない。 したがって、移植性が必要なアプリケーションでは、両方の可能性を 確認すべきである。
EBADF	fd が有効なファイルディスクリプターでないか、読み込みのために オープン (open) されていない。
EFAULT	buf がアクセス可能なアドレス空間の外にある。
EINTR	何のデータも読み込まないうちにシグナルに割り込まれた。 signal(7) 参照。
EINVAL	fd は読み込みに適していないオブジェクトを参照している。 もしくは、ファイルが O_DIRECT フラグを指定してオープンされているが、 buf に指定されたアドレス、 count に指定された値、 現在のファイルオフセットのいずれかの アラインメントが不適切である。
EINVAL	fd が timerfd_create(2) の呼び出しで作成されたが、 read() に間違ったサイズのバッファーが渡された。 さらなる情報は timerfd_create(2) を参照のこと。
EIO	I/O エラー。これは例えばプロセスがバックグランドプロセスグループで、それを制御している端末から読み込もうとし、 SIGTTIN が無視 (ignore) または禁止 (blocking) されている場合や、 そのプロセスグループが孤立 (orphan) している場合に起こる。 またディスクやテープを読んでいる時に低レベル I/O エラー が発生した場合にも起こる。
EISDIR	fd がディレクトリを参照している。

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

SVr4, 4.3BSD, POSIX.1-2001.

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

POSIX.1-2008/SUSv4 セクション XSI 2.9.7 ("Thread Interactions with Regular File Operations") によると、

close(2), fcntl(2), ioctl(2), lseek(2), open(2), pread(2), readdir(2), readlink(2), readv(2), select(2), write(2), fread(3)

この man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。

epoll_ctl(2), eventfd(2), fanotify_init(2), fcntl(2), getrandom(2), inotify_add_watch(2), ioctl_tty(2), open(2), perf_event_open(2), perfmonctl(2), pipe(2), prctl(2), pread(2), ptrace(2), readahead(2), readv(2), recv(2), seccomp(2), select(2), select_tut(2), sendfile(2), setpgid(2), signalfd(2), socket(2), socketpair(2), timerfd_create(2), userfaultfd(2), write(2), aio_error(3), aio_read(3), aio_return(3), dbopen(3), fgetc(3), fread(3), getline(3), gets(3), mkfifo(3), mpool(3), readdir(3), rtime(3), stdin(3), stdio(3), termios(3), xdr(3), dsp56k(4), fuse(4), lirc(4), null(4), random(4), rtc(4), st(4), tty_ioctl(4), proc(5), aio(7), cpuset(7), epoll(7), fanotify(7), inotify(7), pipe(7), signal(7), socket(7), spufs(7), x25(7), inode(7), strace(1), xfs_io(8), xfsctl(3), atread(3), rmt-dump(8), hylafax-log(5), cpuset(4), firestring_estr_read(3), iv_fd_pump(3), libssh2_sftp_read(3), tar_append_file(3), tar_block_read(3), mknod(2), stat(2), grep(1), readv(3p), nfslogsum(8), telnet-probe(1), pv(1), since(1), tthsum(1), msocket(2viewos), pthread_cancel(3), rmt(1), hylafax-log(5f), rscsi(1), anysurrect-plugins(3), vsock(7), netsniff-ng(8), ermt(1), ast(3ast), libkeccak_generalised_sum_fd(3), libkeccak_keccaksum_fd(3), libkeccak_rawshakesum_fd(3), libkeccak_sha3sum_fd(3), libkeccak_shakesum_fd(3), fzopen(3), srmt(1), io_uring_enter(2), rmtclose(3), rmtioctl(3), rmtopen(3), rmtread(3), rmtseek(3), rmtwrite(3)