1 .\" This manpage is Copyright (C) 1992 Drew Eckhardt;
2 .\" and Copyright (C) 1993 Michael Haardt, Ian Jackson.
4 .\" %%%LICENSE_START(VERBATIM)
5 .\" Permission is granted to make and distribute verbatim copies of this
6 .\" manual provided the copyright notice and this permission notice are
7 .\" preserved on all copies.
9 .\" Permission is granted to copy and distribute modified versions of this
10 .\" manual under the conditions for verbatim copying, provided that the
11 .\" entire resulting derived work is distributed under the terms of a
12 .\" permission notice identical to this one.
14 .\" Since the Linux kernel and libraries are constantly changing, this
15 .\" manual page may be incorrect or out-of-date. The author(s) assume no
16 .\" responsibility for errors or omissions, or for damages resulting from
17 .\" the use of the information contained herein. The author(s) may not
18 .\" have taken the same level of care in the production of this manual,
19 .\" which is licensed free of charge, as they might when working
22 .\" Formatted or processed versions of this manual, if unaccompanied by
23 .\" the source, must acknowledge the copyright and authors of this work.
26 .\" Modified Sat Jul 24 00:06:00 1993 by Rik Faith <faith@cs.unc.edu>
27 .\" Modified Wed Jan 17 16:02:32 1996 by Michael Haardt
28 .\" <michael@cantor.informatik.rwth-aachen.de>
29 .\" Modified Thu Apr 11 19:26:35 1996 by Andries Brouwer <aeb@cwi.nl>
30 .\" Modified Sun Jul 21 18:59:33 1996 by Andries Brouwer <aeb@cwi.nl>
31 .\" Modified Fri Jan 31 16:47:33 1997 by Eric S. Raymond <esr@thyrsus.com>
32 .\" Modified Sat Jul 12 20:45:39 1997 by Michael Haardt
33 .\" <michael@cantor.informatik.rwth-aachen.de>
35 .\"*******************************************************************
37 .\" This file was generated with po4a. Translate the source file.
39 .\"*******************************************************************
41 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
42 .\" all rights reserved.
43 .\" Translated 1997-02-23, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
44 .\" Modified 1997-09-28, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
45 .\" Updated & Modified 2005-02-24, Yuichi SATO <ysato444@yahoo.co.jp>
46 .\" Updated 2005-09-06, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
47 .\" Updated 2005-10-14, Akihiro MOTOKI
48 .\" Updated 2008-02-10, Akihiro MOTOKI, LDP v2.77
49 .\" Updated 2009-04-13, Akihiro MOTOKI, LDP v3.20
50 .\" Updated 2012-04-30, Akihiro MOTOKI <amotoki@gmail.com>
51 .\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
53 .TH READ 2 2014\-05\-04 Linux "Linux Programmer's Manual"
55 read \- ファイルディスクリプタから読み込む
58 \fB#include <unistd.h>\fP
60 \fBssize_t read(int \fP\fIfd\fP\fB, void *\fP\fIbuf\fP\fB, size_t \fP\fIcount\fP\fB);\fP
63 \fBread\fP() はファイルディスクリプタ (file descriptor) \fIfd\fP から最大 \fIcount\fP バイトを \fIbuf\fP
66 seek に対応しているファイルでは、read
67 は現在のファイルオフセットから行われ、ファイルオフセットは読み込んだバイト数分だけ進められる。現在のファイルオフセットがファイル末尾かそれより先の場合は、読み出しは行われず、
70 \fIcount\fP が 0 の場合、 \fBread\fP() は以下で説明するエラーを検出する\fI場合がある\fP。 どのエラーもなかった場合、もしくは
71 \fBread\fP() がエラーのチェックを行わない場合、 \fIcount\fP が 0 で呼び出された \fBread\fP() は 0 を返し、何も行わない。
73 \fIcount\fP が \fBSSIZE_MAX\fP より大きければ、結果は規定できない。
75 成功した場合、読み込んだバイト数を返す (0 はファイルの終りを意味する)。 ファイル位置はこの数だけ進められる。
76 この数が要求した数より小さかったとしてもエラーではない; 例えば今すぐには実際にそれだけの数しかない場合 (ファイルの最後に近いのかも
77 しれないし、パイプ (pipe) や端末 (terminal) から読み込んでいるかもしれない) や \fBread\fP() がシグナル (signal)
78 によって割り込まれた場合にこれは起こりえる。 エラーの場合は、\-1 が返され、 \fIerrno\fP
79 が適切に設定される。この場合はファイル位置が変更されるかどうかは 不定である。
83 ファイルディスクリプタ \fIfd\fP がソケット以外のファイルを参照していて、 非停止 (nonblocking) モード (\fBO_NONBLOCK\fP)
84 に設定されており、読み込みを行うと停止する状況にある。
86 \fBEAGAIN\fP または \fBEWOULDBLOCK\fP
87 .\" Actually EAGAIN on Linux
88 ファイルディスクリプタ \fIfd\fP がソケットを参照していて、非停止 (nonblocking) モード (\fBO_NONBLOCK\fP)
89 に設定されており、読み込みを行うと停止する状況にある。 POSIX.1\-2001 は、この場合にどちらのエラーを返すことも認めており、 これら 2
90 つの定数が同じ値を持つことも求めていない。 したがって、移植性が必要なアプリケーションでは、両方の可能性を 確認すべきである。
93 \fIfd\fP が有効なファイルディスクリプタでないか、読み込みのために オープン (open) されていない。
96 \fIbuf\fP がアクセス可能なアドレス空間の外にある。
99 何のデータも読み込まないうちにシグナルに割り込まれた。 \fBsignal\fP(7) 参照。
102 \fIfd\fP は読み込みに適していないオブジェクトを参照している。 もしくは、ファイルが \fBO_DIRECT\fP フラグを指定してオープンされているが、
103 \fIbuf\fP に指定されたアドレス、 \fIcount\fP に指定された値、 現在のファイルオフセットのいずれかの アラインメントが不適切である。
106 \fIfd\fP が \fBtimerfd_create\fP(2) の呼び出しで作成されたが、 \fBread\fP() に間違ったサイズのバッファが渡された。
107 さらなる情報は \fBtimerfd_create\fP(2) を参照のこと。
110 I/O エラー。これは例えばプロセスがバックグランド・プロセスグループで、それを制御している端末から読み込もうとし、 \fBSIGTTIN\fP が無視
111 (ignore) または禁止 (blocking) されている場合や、 そのプロセスグループが孤立 (orphan) している場合に起こる。
112 またディスクやテープを読んでいる時に低レベル I/O エラー が発生した場合にも起こる。
115 \fIfd\fP がディレクトリを参照している。
117 \fIfd\fP が接続しているオブジェクトによっては他のエラーも起こりえる。 POSIX では、 いくらかのデータを読んだ後に割り込みが起こった場合、
118 \fBread\fP() は (\fIerrno\fP に \fBEINTR\fP を設定して) \-1 を返してもよいし、 既に読み込んだバイト数を返してもよい。
120 SVr4, 4.3BSD, POSIX.1\-2001.
122 NFS において。少量のデータを読み込む場合、最初の時のみにタイム スタンプが更新され、続くコールでは更新されないだろう。
123 これはクライアント側で属性のキャッシングを行なうためである。 なぜならば、もし全ての NFS クライアントが st_atime
124 (最終ファイルアクセス時刻) の更新をサーバーに送らず、クライアント側でキャッシュを読むことに満足して いれば、サーバー側での read
125 は発生しないので st_atime の更新は行なわれからだ。 UNIX の方式では、クライアント側の属性のキャッシングを無効にすることで、
126 これを得ることができる。しかしほとんどの状況ではこれは続くサーバーの 負荷を増加させ、パフォーマンスの低下をもたらす。
128 According to POSIX.1\-2008/SUSv4 Section XSI 2.9.7 ("Thread Interactions with
129 Regular File Operations"):
132 All of the following functions shall be atomic with respect to each other in
133 the effects specified in POSIX.1\-2008 when they operate on regular files or
137 .\" http://thread.gmane.org/gmane.linux.kernel/1649458
138 .\" From: Michael Kerrisk (man-pages <mtk.manpages <at> gmail.com>
139 .\" Subject: Update of file offset on write() etc. is non-atomic with I/O
140 .\" Date: 2014-02-17 15:41:37 GMT
141 .\" Newsgroups: gmane.linux.kernel, gmane.linux.file-systems
142 .\" commit 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
143 .\" Author: Linus Torvalds <torvalds@linux-foundation.org>
144 .\" Date: Mon Mar 3 09:36:58 2014 -0800
146 .\" vfs: atomic f_pos accesses as per POSIX
147 Among the APIs subsequently listed are \fBread\fP() and \fBreadv\fP(2). And
148 among the effects that should be atomic across threads (and processes) are
149 updates of the file offset. However, on Linux before version 3.14, this was
150 not the case: if two processes that share an open file description (see
151 \fBopen\fP(2)) perform a \fBread\fP() (or \fBreadv\fP(2)) at the same time, then
152 the I/O operations were not atomic with respect updating the file offset,
153 with the result that the reads in the two processes might (incorrectly)
154 overlap in the blocks of data that they obtained. This problem was fixed in
157 \fBclose\fP(2), \fBfcntl\fP(2), \fBioctl\fP(2), \fBlseek\fP(2), \fBopen\fP(2), \fBpread\fP(2),
158 \fBreaddir\fP(2), \fBreadlink\fP(2), \fBreadv\fP(2), \fBselect\fP(2), \fBwrite\fP(2),
161 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.75 の一部
162 である。プロジェクトの説明とバグ報告に関する情報は
163 http://www.kernel.org/doc/man\-pages/ に書かれている。