release/man2/open.2

   1 .\" This manpage is Copyright (C) 1992 Drew Eckhardt;
   2 .\"             and Copyright (C) 1993 Michael Haardt, Ian Jackson.
   3 .\"             and Copyright (C) 2008 Greg Banks
   4 .\"
   5 .\" %%%LICENSE_START(VERBATIM)
   6 .\" Permission is granted to make and distribute verbatim copies of this
   7 .\" manual provided the copyright notice and this permission notice are
   8 .\" preserved on all copies.
   9 .\"
  10 .\" Permission is granted to copy and distribute modified versions of this
  11 .\" manual under the conditions for verbatim copying, provided that the
  12 .\" entire resulting derived work is distributed under the terms of a
  13 .\" permission notice identical to this one.
  14 .\"
  15 .\" Since the Linux kernel and libraries are constantly changing, this
  16 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  17 .\" responsibility for errors or omissions, or for damages resulting from
  18 .\" the use of the information contained herein.  The author(s) may not
  19 .\" have taken the same level of care in the production of this manual,
  20 .\" which is licensed free of charge, as they might when working
  21 .\" professionally.
  22 .\"
  23 .\" Formatted or processed versions of this manual, if unaccompanied by
  24 .\" the source, must acknowledge the copyright and authors of this work.
  25 .\" %%%LICENSE_END
  26 .\"
  27 .\" Modified 1993-07-21 by Rik Faith <faith@cs.unc.edu>
  28 .\" Modified 1994-08-21 by Michael Haardt
  29 .\" Modified 1996-04-13 by Andries Brouwer <aeb@cwi.nl>
  30 .\" Modified 1996-05-13 by Thomas Koenig
  31 .\" Modified 1996-12-20 by Michael Haardt
  32 .\" Modified 1999-02-19 by Andries Brouwer <aeb@cwi.nl>
  33 .\" Modified 1998-11-28 by Joseph S. Myers <jsm28@hermes.cam.ac.uk>
  34 .\" Modified 1999-06-03 by Michael Haardt
  35 .\" Modified 2002-05-07 by Michael Kerrisk <mtk.manpages@gmail.com>
  36 .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
  37 .\" 2004-12-08, mtk, reordered flags list alphabetically
  38 .\" 2004-12-08, Martin Pool <mbp@sourcefrog.net> (& mtk), added O_NOATIME
  39 .\" 2007-09-18, mtk, Added description of O_CLOEXEC + other minor edits
  40 .\" 2008-01-03, mtk, with input from Trond Myklebust
  41 .\"     <trond.myklebust@fys.uio.no> and Timo Sirainen <tss@iki.fi>
  42 .\"     Rewrite description of O_EXCL.
  43 .\" 2008-01-11, Greg Banks <gnb@melbourne.sgi.com>: add more detail
  44 .\"     on O_DIRECT.
  45 .\" 2008-02-26, Michael Haardt: Reorganized text for O_CREAT and mode
  46 .\"
  47 .\" FIXME . Apr 08: The next POSIX revision has O_EXEC, O_SEARCH, and
  48 .\" O_TTYINIT.  Eventually these may need to be documented.  --mtk
  49 .\" FIXME Linux 2.6.33 has O_DSYNC, and a hidden __O_SYNC.
  50 .\"
  51 .\"*******************************************************************
  52 .\"
  53 .\" This file was generated with po4a. Translate the source file.
  54 .\"
  55 .\"*******************************************************************
  56 .TH OPEN 2 2013\-07\-21 Linux "Linux Programmer's Manual"
  57 .SH 名前
  58 open, creat \- ファイルやデバイスのオープン、作成を行う
  59 .SH 書式
  60 .nf
  61 \fB#include <sys/types.h>\fP
  62 \fB#include <sys/stat.h>\fP
  63 \fB#include <fcntl.h>\fP
  64 .sp
  65 \fBint open(const char *\fP\fIpathname\fP\fB, int \fP\fIflags\fP\fB);\fP
  66 \fBint open(const char *\fP\fIpathname\fP\fB, int \fP\fIflags\fP\fB, mode_t \fP\fImode\fP\fB);\fP
  67
  68 \fBint creat(const char *\fP\fIpathname\fP\fB, mode_t \fP\fImode\fP\fB);\fP
  69 .fi
  70 .SH 説明
  71 ファイルの \fIpathname\fP を与えると、 \fBopen\fP()  はファイルディスクリプタを返す。
  72 ファイルディスクリプタは、この後に続くシステムコール (\fBread\fP(2), \fBwrite\fP(2), \fBlseek\fP(2),
  73 \fBfcntl\fP(2) など)  で使用される小さな非負の整数である。 このシステムコールが成功した場合に返されるファイルディスクリプタは
  74 そのプロセスがその時点でオープンしていないファイルディスクリプタの うち最小の数字のものとなる。
  75 .PP
  76 デフォルトでは、新しいファイルディスクリプタは \fBexecve\fP(2) を実行した後も
  77 オープンされたままとなる (つまり、 \fBfcntl\fP(2) に説明がある \fBFD_CLOEXEC\fP
  78 ファイルディスクリプタフラグは最初は無効である; 後述の \fBO_CLOEXEC\fP フラグ
  79 を使うとこのデフォルトを変更することができる)。 ファイルオフセット
  80 (file offset) はファイルの先頭に設定される (\fBlseek\fP(2) 参照)。
  81 .PP
  82 \fBopen\fP()  を呼び出すと、「オープンファイル記述」 \fI(open file description)\fP
  83 が作成される。ファイル記述とは、システム全体の オープン中のファイルのテーブルのエントリである。 このエントリは、ファイルオフセットとファイル状態フラグ
  84 (\fBfcntl\fP(2)  \fBF_SETFL\fP 操作により変更可能) が保持する。 ファイルディスクリプタはこれらのエントリの一つへの参照である。
  85 この後で \fIpathname\fP が削除されたり、他のファイルを参照するように変更されたりしても、 この参照は影響を受けない。
  86 新しいオープンファイル記述は最初は他のどのプロセスとも 共有されていないが、 \fBfork\fP(2)  で共有が起こる場合がある。
  87 .PP
  88 引き数 \fIflags\fP には、アクセスモード \fBO_RDONLY\fP, \fBO_WRONLY\fP, \fBO_RDWR\fP
  89 のどれかひとつが入っていなければならない。 これらはそれぞれ読み込み専用、書き込み専用、読み書き用に ファイルをオープンすることを要求するものである。
  90
  91 .\" SUSv4 divides the flags into:
  92 .\" * Access mode
  93 .\" * File creation
  94 .\" * File status
  95 .\" * Other (O_CLOEXEC, O_DIRECTORY, O_NOFOLLOW)
  96 .\" though it's not clear what the difference between "other" and
  97 .\" "File creation" flags is.  I raised an Aardvark to see if this
  98 .\" can be clarified in SUSv4; 10 Oct 2008.
  99 .\" http://thread.gmane.org/gmane.comp.standards.posix.austin.general/64/focus=67
 100 .\" TC1 (balloted in 2013), resolved this, so that those three constants
 101 .\" are also categorized" as file status flags.
 102 .\"
 103 さらに、 \fIflags\fP には、ファイル作成フラグ (file creation flag) とファイル状態フラグ (file status
 104 flag) を 0 個以上「ビット単位の OR (bitwise\-or)」で 指定することができる。 \fIファイル作成フラグ\fP は
 105 \fBO_CLOEXEC\fP, \fBO_CREAT\fP, \fBO_DIRECTORY\fP, \fBO_EXCL\fP, \fBO_NOCTTY\fP,
 106 \fBO_NOFOLLOW\fP, \fBO_TRUNC\fP, \fBO_TTY_INIT\fP である。 \fIファイル状態フラグ\fP
 107 は以下のリストのうち上記以外の残りのものである。 二種類のフラグの違いは、ファイル状態フラグの方は \fBfcntl\fP(2)
 108 を使ってその内容を取得したり (場合によっては) 変更したりできる点にある。 ファイル作成フラグとファイル状態フラグの全リストを以下に示す:
 109 .TP
 110 \fBO_APPEND\fP
 111 .\" For more background, see
 112 .\" http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=453946
 113 .\" http://nfs.sourceforge.net/
 114 ファイルを追加 (append) モードでオープンする。 毎回の \fBwrite\fP(2)  の前に \fBlseek\fP(2)
 115 を行ったかのように、ファイルポインタをファイルの最後に移動する。 NFS ファイルシステムで、 \fBO_APPEND\fP
 116 を使用すると、複数のプロセスがひとつのファイルに同時にデータを追加した場合、 ファイルが壊れてしまうことがある。 これは NFS
 117 が追加モードをサポートしていないため、 クライアントのカーネル (kernel) がそれをシミュレートしなければならないのだが、
 118 競合状態を避けることはできないからである。
 119 .TP
 120 \fBO_ASYNC\fP
 121 シグナル駆動 I/O (signal\-driven I/O) を有効にする: このファイルディスクリプタへの
 122 入力または出力が可能になった場合に、シグナルを生成する (デフォルトは \fBSIGIO\fP であるが、 \fBfcntl\fP(2)
 123 によって変更可能である)。 この機能が使用可能なのは端末、疑似端末、ソケットのみであり、 (Linux 2.6 以降では) パイプと FIFO
 124 に対しても使用できる。 さらに詳しい説明は \fBfcntl\fP(2)  を参照すること。
 125 .TP
 126 \fBO_CLOEXEC\fP (Linux 2.6.23 以降)
 127 .\" This flag fixes only one form of the race condition;
 128 .\" The race can also occur with, for example, descriptors
 129 .\" returned by accept(), pipe(), etc.
 130 新しいファイルディスクリプタに対して close\-on\-exec フラグを有効にする。 このフラグを指定することで、プログラムは
 131 \fBFD_CLOEXEC\fP フラグをセットするための \fBfcntl\fP(2)  \fBF_SETFD\fP 操作を別途呼び出す必要がなくなる。
 132 また、ある種のマルチスレッドのプログラムはこのフラグの使用は 不可欠である。なぜなら、個別に \fBFD_CLOEXEC\fP フラグを設定する
 133 \fBfcntl\fP(2)  \fBF_SETFD\fP 操作を呼び出したとしても、あるスレッドがファイルディスクリプタを オープンするのと同時に別のスレッドが
 134 \fBfork\fP(2)  と \fBexecve\fP(2)  を実行するという競合条件を避けるのには十分ではないからである。
 135 .TP
 136 \fBO_CREAT\fP
 137 .\" As at 2.6.25, bsdgroups is supported by ext2, ext3, ext4, and
 138 .\" XFS (since 2.6.14).
 139 ファイルが存在しなかった場合は作成 (create) する。 ファイルの所有者 (ユーザー ID) は、プロセスの実効ユーザー ID に設定される。
 140 グループ所有権 (グループ ID) は、プロセスの実効グループ ID または親ディレクトリのグループ ID に設定される
 141 (これは、ファイルシステムタイプ、マウントオプション、 親ディレクトリのモードに依存する。 \fBmount\fP(8)  で説明されているマウントオプション
 142 \fIbsdgroups\fP と \fIsysvgroups\fP を参照)。
 143 .RS
 144 .PP
 145 \fImode\fP は新しいファイルを作成する場合に使用するアクセス許可 (permission) を指定する。 \fIflags\fP に \fBO_CREAT\fP
 146 が指定されている場合、 \fImode\fP を指定しなければならない。 \fBO_CREAT\fP が指定されていない場合、 \fImode\fP は無視される。
 147 有効なアクセス許可は、普段と同じようにプロセスの \fIumask\fP によって修正され、作成されたファイルの許可は \fI(mode\ &\ ~umask)\fP となる。 このモードは、新しく作成されたファイルに対するそれ以降のアクセス にのみ適用される点に注意すること。
 148 読み取り専用のファイルを作成する \fBopen\fP()  コールであっても、 読み書き可能なファイルディスクリプタを返すことがありうる。
 149 .PP
 150 \fImode\fP のために以下のシンボル定数が提供されている :
 151 .TP  9
 152 \fBS_IRWXU\fP
 153 00700 ユーザー (ファイルの所有者) に読み込み、書き込み、 実行の許可がある。
 154 .TP
 155 \fBS_IRUSR\fP
 156 00400 ユーザーに読み込みの許可がある。
 157 .TP
 158 \fBS_IWUSR\fP
 159 00200 ユーザーに書き込みの許可がある。
 160 .TP
 161 \fBS_IXUSR\fP
 162 00100 ユーザーに実行の許可がある。
 163 .TP
 164 \fBS_IRWXG\fP
 165 00070 グループに読み込み、書き込み、実行の許可がある。
 166 .TP
 167 \fBS_IRGRP\fP
 168 00040 グループに読み込みの許可がある。
 169 .TP
 170 \fBS_IWGRP\fP
 171 00020 グループに書き込みの許可がある。
 172 .TP
 173 \fBS_IXGRP\fP
 174 00010 グループに実行の許可がある。
 175 .TP
 176 \fBS_IRWXO\fP
 177 00007 他人 (others) に読み込み、書き込み、実行の許可がある。
 178 .TP
 179 \fBS_IROTH\fP
 180 00004 他人に読み込みの許可がある。
 181 .TP
 182 \fBS_IWOTH\fP
 183 00002 他人に書き込みの許可がある。
 184 .TP
 185 \fBS_IXOTH\fP
 186 00001 他人に実行の許可がある。
 187 .RE
 188 .TP
 189 \fBO_DIRECT\fP (Linux 2.4.10 以降)
 190 このファイルに対する I/O のキャッシュの効果を最小化しようとする。このフラグを使うと、一般的に性能が低下する。
 191 しかしアプリケーションが独自にキャッシングを行っているような 特別な場合には役に立つ。 ファイルの I/O はユーザー空間バッファに対して直接行われる。
 192 \fBO_DIRECT\fP フラグ自身はデータを同期で転送しようとはするが、 \fBO_SYNC\fP
 193 フラグのようにデータと必要なメタデータの転送が保証されるわけではない。同期 I/O を保証するためには、 \fBO_DIRECT\fP に加えて
 194 \fBO_SYNC\fP を使用しなければならない。下記の「注意」の節の議論も参照。
 195 .sp
 196 ブロックデバイスに対する似通った意味のインターフェースが \fBraw\fP(8)  で説明されている (但し、このインタフェースは非推奨である)。
 197 .TP
 198 \fBO_DIRECTORY\fP
 199 .\" But see the following and its replies:
 200 .\" http://marc.theaimsgroup.com/?t=112748702800001&r=1&w=2
 201 .\" [PATCH] open: O_DIRECTORY and O_CREAT together should fail
 202 .\" O_DIRECTORY | O_CREAT causes O_DIRECTORY to be ignored.
 203 \fIpathname\fP がディレクトリでなければオープンは失敗する。 このフラグは Linux 特有であり、 \fBopendir\fP(3)  が FIFO
 204 やテープデバイスに対してコールされた場合の サービス不能 (denial\-of\-service) 攻撃を避けるために カーネル 2.1.126
 205 で追加された。
 206 .TP
 207 \fBO_EXCL\fP
 208 この呼び出しでファイルが作成されることを保証する。このフラグが \fBO_CREAT\fP と
 209 一緒に指定され、 \fIpathname\fP のファイルが既に存在した場合、 \fBopen\fP() は失敗
 210 する。
 211
 212 .\" POSIX.1-2001 explicitly requires this behavior.
 213 これら二つのフラグが指定された際、シンボリックリンクは辿られない。 \fIpathname\fP がシンボリックリンクの場合、
 214 シンボリックリンクがどこを指しているかに関わらず \fBopen\fP()  は失敗する。
 215
 216 一般的には、 \fBO_CREAT\fP を指定せずに \fBO_EXCL\fP を使用した場合の
 217 \fBO_EXCL\fP の動作は規定されていない。
 218 これには一つ例外があり、Linux 2.6 以降では、
 219 \fIpathname\fP がブロックデバイスを参照している場合、
 220 \fBO_CREAT\fP なしで \fBO_EXCL\fP を使用することができる。
 221 システムがそのブロックデバイスを使用中の場合 (例えば、
 222 マウントされているなど)、 \fBopen\fP() はエラー \fBEBUSY\fP で失敗する。
 223
 224 NFS では、 \fBO_EXCL\fP は、Linux 2.6 以降で NFSv3 以降を使っている場合でのみサポートされる。 \fBO_EXCL\fP
 225 サポートが提供されていない NFS 環境では、このフラグに頼って ロック処理を実行するプログラムは競合状態 (race condition) に出会う
 226 可能性がある。 ロックファイルを使用して不可分 (atomic) なファイルロックを実現し、 NFS が \fBO_EXCL\fP
 227 をサポートしているかに依存しないようにしたい場合、 移植性のある方法は、同じファイルシステム上に他と名前の重ならない ファイル (例えばホスト名と
 228 PID を組み合わせた名前) を作成し、 \fBlink\fP(2)  を使用してそのロックファイルへのリンクを作成することである。 \fBlink\fP(2)
 229 コールの返り値が 0 ならばロックに成功している。 あるいは、そのファイルに \fBstat\fP(2)  を使用してリンク数 (link count) が
 230 2 になっているかをチェックする。 そうなっていれば、同じくロックに成功しているということである。
 231 .TP
 232 \fBO_LARGEFILE\fP
 233 (LFS) \fIoff_t\fP ではサイズを表せない (だだし \fIoff64_t\fP ではサイズを表せる)ファ
 234 イルをオープン可能にする。この定義を有効にするためには、(\fIどの\fPヘッダファイ
 235 ルをインクルードするよりも前に) \fB_LARGEFILE64_SOURCE\fP マクロを定義しなければ
 236 ならない。
 237 32 ビットシステムにおいて大きなファイルにアクセスしたい場合、
 238 (\fBO_LARGEFILE\fP を使うよりも) \fB_FILE_OFFSET_BITS\fP 機能検査マクロを 64 に
 239 セットする方が望ましい方法である (\fBfeature_test_macros\fP(7) を参照)。
 240 .TP
 241 \fBO_NOATIME\fP (Linux 2.6.8 以降)
 242 .\" The O_NOATIME flag also affects the treatment of st_atime
 243 .\" by mmap() and readdir(2), MTK, Dec 04.
 244 ファイルに対して \fBread\fP(2)  が実行されたときに、最終アクセス時刻 (inode の \fIst_atime\fP) を更新しない。
 245 このフラグはインデックス作成やバックアッププログラムで使うことを意図している。 これを使うとディスクに対する操作を大幅に減らすことができる。
 246 このフラグは全てのファイルシステムに対して有効であるわけではない。 その一例が NFS であり、サーバがアクセス時刻を管理している。
 247 .TP
 248 \fBO_NOCTTY\fP
 249 \fIpathname\fP が端末 (terminal) デバイス \(em \fBtty\fP(4) 参照 \(em を指している
 250 場合に、たとえそのプロセスが制御端末を持っていなくても、オープンしたファイル
 251 は制御端末にはならない。
 252 .TP
 253 \fBO_NOFOLLOW\fP
 254 .\" The headers from glibc 2.0.100 and later include a
 255 .\" definition of this flag; \fIkernels before 2.1.126 will ignore it if
 256 .\" used\fP.
 257 \fIpathname\fP がシンボリックリンクだった場合、オープンは失敗する。 これは FreeBSD の拡張で、Linux には バージョン
 258 2.1.126 で追加された。 このフラグが指定された場合でも \fIpathname\fP の前の方の要素 (最後のディレクトリセパレータより前の部分)
 259 にあるシンボリックリンクについてはリンクが辿られる。 下記の \fBO_PATH\fP も参照のこと。
 260 .TP
 261 \fBO_NONBLOCK\fP または \fBO_NDELAY\fP
 262 可能ならば、ファイルは非停止 (nonblocking) モードでオープンされる。
 263 \fBopen\fP() も、返したファイルディスクリプタに対する以後のすべての操作も呼び出
 264 したプロセスを待たせることはない。 FIFO (名前付きパイプ) を扱う場合には
 265 \fBfifo\fP(7) も参照すること。 強制ファイルロック (mandatory file lock) やファイ
 266 ルリース (file lease) と組み合わせた場合の、 \fBO_NONBLOCK\fP の効果についての
 267 議論は、 \fBfcntl\fP(2) を参照すること。
 268 .TP
 269 \fBO_PATH\fP (Linux 2.6.39 以降)
 270 .\" commit 1abf0c718f15a56a0a435588d1b104c7a37dc9bd
 271 .\" commit 326be7b484843988afe57566b627fb7a70beac56
 272 .\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d
 273 .\"
 274 .\" http://thread.gmane.org/gmane.linux.man/2790/focus=3496
 275 .\"     Subject: Re: [PATCH] open(2): document O_PATH
 276 .\"     Newsgroups: gmane.linux.man, gmane.linux.kernel
 277 .\"
 278 Obtain a file descriptor that can be used for two purposes: to indicate a
 279 location in the file\-system tree and to perform operations that act purely
 280 at the file descriptor level.  The file itself is not opened, and other file
 281 operations (e.g., \fBread\fP(2), \fBwrite\fP(2), \fBfchmod\fP(2), \fBfchown\fP(2),
 282 \fBfgetxattr\fP(2))  fail with the error \fBEBADF\fP.
 283
 284 The following operations \fIcan\fP be performed on the resulting file
 285 descriptor:
 286 .RS
 287 .IP * 3
 288 .\" commit 332a2e1244bd08b9e3ecd378028513396a004a24
 289 .\" fstat(): commit 55815f70147dcfa3ead5738fd56d3574e2e3c1c2
 290 \fBclose\fP(2); \fBfchdir\fP(2)  (since Linux 3.5); \fBfstat\fP(2)  (since Linux
 291 3.6).
 292 .IP *
 293 Duplicating the file descriptor (\fBdup\fP(2), \fBfcntl\fP(2)  \fBF_DUPFD\fP, etc.).
 294 .IP *
 295 Getting and setting file descriptor flags (\fBfcntl\fP(2)  \fBF_GETFD\fP and
 296 \fBF_SETFD\fP).
 297 .IP *
 298 Retrieving open file status flags using the \fBfcntl\fP(2)  \fBF_GETFL\fP
 299 operation: the returned flags will include the bit \fBO_PATH\fP.
 300
 301 .IP *
 302 Passing the file descriptor as the \fIdirfd\fP argument of \fBopenat\fP(2)  and
 303 the other "*at()" system calls.
 304 .IP *
 305 Passing the file descriptor to another process via a UNIX domain socket (see
 306 \fBSCM_RIGHTS\fP in \fBunix\fP(7)).
 307 .RE
 308 .IP
 309 When \fBO_PATH\fP is specified in \fIflags\fP, flag bits other than \fBO_DIRECTORY\fP
 310 and \fBO_NOFOLLOW\fP are ignored.
 311
 312 If the \fBO_NOFOLLOW\fP flag is also specified, then the call returns a file
 313 descriptor referring to the symbolic link.  This file descriptor can be used
 314 as the \fIdirfd\fP argument in calls to \fBfchownat\fP(2), \fBfstatat\fP(2),
 315 \fBlinkat\fP(2), and \fBreadlinkat\fP(2)  with an empty pathname to have the calls
 316 operate on the symbolic link.
 317 .TP
 318 \fBO_SYNC\fP
 319 ファイルは同期 (synchronous) I/O モードでオープンされる。 \fBopen\fP()  が返したファイルディスクリプタに対して
 320 \fBwrite\fP(2)  を行うと、必ず呼び出したプロセスをブロックし、 該当ハードウェアに物理的に書き込まれるまで返らない。
 321 \fI以下の「注意」の章も参照。\fP
 322 .TP
 323 \fBO_TRUNC\fP
 324 ファイルが既に存在し、通常ファイルであり、 書き込み可モードでオープンされている (つまり、 \fBO_RDWR\fPまたは\fBO_WRONLY\fP の)
 325 場合、長さ 0 に切り詰め (truncate) られる。 ファイルが FIFO または端末デバイスファイルの場合、 \fBO_TRUNC\fP
 326 フラグは無視される。 それ以外の場合、 \fBO_TRUNC\fP の効果は未定義である。
 327 .PP
 328 これらの選択フラグのいくつかはファイルをオープンした後でも \fBfcntl\fP(2)  を使用して変更することができる。
 329
 330 \fBcreat\fP()  は \fIflags\fP に \fBO_CREAT|O_WRONLY|O_TRUNC\fP を指定して \fBopen\fP()
 331 を行うのと等価である。
 332 .SH 返り値
 333 \fBopen\fP()  と \fBcreat\fP()  は新しいファイルディスクリプタを返す。 エラーが発生した場合は \-1 を返す (その場合は
 334 \fIerrno\fP が適切に設定される)。
 335 .SH エラー
 336 .TP
 337 \fBEACCES\fP
 338 ファイルに対する要求されたアクセスが許されていないか、 \fIpathname\fP のディレクトリ部分の何れかのディレクトリに検索許可がなかった。
 339 またはファイルが存在せず、親ディレクトリへの書き込み許可がなかった。 (\fBpath_resolution\fP(7)  も参照すること。)
 340 .TP
 341 \fBEDQUOT\fP
 342 \fBO_CREAT\fP が指定された場合で、そのファイルが存在せず、ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。
 343 .TP
 344 \fBEEXIST\fP
 345 \fIpathname\fP は既に存在し、 \fBO_CREAT\fP と \fBO_EXCL\fP が使用された。
 346 .TP
 347 \fBEFAULT\fP
 348 \fIpathname\fP がアクセス可能なアドレス空間の外を指している。
 349 .TP
 350 \fBEFBIG\fP
 351 \fBEOVERFLOW\fP 参照。
 352 .TP
 353 \fBEINTR\fP
 354 遅いデバイス (例えば FIFO、 \fBfifo\fP(7)  参照) のオープンが完了するのを待って停止している間に
 355 システムコールがシグナルハンドラにより割り込まれた。 \fBsignal\fP(7)  参照。
 356 .TP
 357 \fBEISDIR\fP
 358 \fIpathname\fP はディレクトリを参照しており、書き込み要求が含まれていた (つまり \fBO_WRONLY\fP または \fBO_RDWR\fP
 359 が設定されている)。
 360 .TP
 361 \fBELOOP\fP
 362 \fIpathname\fP を解決する際に遭遇したシンボリックリンクが多過ぎる。 または \fBO_NOFOLLOW\fP が指定されており、
 363 \fIpathname\fP がシンボリックリンクだった。
 364 .TP
 365 \fBEMFILE\fP
 366 プロセスがオープンしているファイル数がすでに最大数に達している。
 367 .TP
 368 \fBENAMETOOLONG\fP
 369 \fIpathname\fP が長過ぎる。
 370 .TP
 371 \fBENFILE\fP
 372 オープンされているファイルの総数がシステムの制限に達している。
 373 .TP
 374 \fBENODEV\fP
 375 \fIpathname\fP がデバイススペシャルファイルを参照しており、対応するデバイスが存在しない。 (これは Linux
 376 カーネルのバグであり、この場合には \fBENXIO\fP が返されるべきである)
 377 .TP
 378 \fBENOENT\fP
 379 \fBO_CREAT\fP が設定されておらず、かつ指定されたファイルが存在しない。 または、 \fIpathname\fP のディレクトリ部分が存在しないか壊れた
 380 (dangling) シンボリックリンクである。
 381 .TP
 382 \fBENOMEM\fP
 383 十分なカーネルメモリーがない。
 384 .TP
 385 \fBENOSPC\fP
 386 \fIpathname\fP を作成する必要があるが、 \fIpathname\fP を含んでいるデバイスに新しいファイルのための空き容量がない。
 387 .TP
 388 \fBENOTDIR\fP
 389 \fIpathname\fP に含まれるディレクトリ部分のどれかが実際にはディレクトリでない。 または \fBO_DIRECTORY\fP が指定されており、
 390 \fIpathname\fP がディレクトリでない。
 391 .TP
 392 \fBENXIO\fP
 393 \fBO_NONBLOCK\fP | \fBO_WRONLY\fP が設定されており、指定したファイルが FIFO で
 394 そのファイルを読み込みのためにオープンしているプロセスが存在しない。 または、ファイルがデバイススペシャルファイルで 対応するデバイスが存在しない。
 395 .TP
 396 \fBEOVERFLOW\fP
 397 .\" See http://bugzilla.kernel.org/show_bug.cgi?id=7253
 398 .\" "Open of a large file on 32-bit fails with EFBIG, should be EOVERFLOW"
 399 .\" Reported 2006-10-03
 400 \fIpathname\fP が参照しているのが、大き過ぎてオープンできない通常のファイルである。 通常、このエラーが発生するは、32
 401 ビットプラットフォーム上で \fI\-D_FILE_OFFSET_BITS=64\fP を指定せずにコンパイルされたアプリケーションが、ファイルサイズが
 402 \fI(2<31)\-1\fP ビットを超えるファイルを開こうとした場合である。 上記の \fBO_LARGEFILE\fP も参照。 これは
 403 POSIX.1\-2001 で規定されているエラーである。 2.6.24 より前のカーネルでは、Linux はこの場合にエラー \fBEFBIG\fP
 404 を返していた。
 405 .TP
 406 \fBEPERM\fP
 407 .\" Strictly speaking, it's the file system UID... (MTK)
 408 \fBO_NOATIME\fP フラグが指定されたが、呼び出し元の実効ユーザー ID が ファイルの所有者と一致せず、かつ呼び出し元に特権
 409 (\fBCAP_FOWNER\fP)  がない。
 410 .TP
 411 \fBEROFS\fP
 412 \fIpathname\fP が読み込み専用のファイルシステム上のファイルを参照しており、 書き込みアクセスが要求された。
 413 .TP
 414 \fBETXTBSY\fP
 415 \fIpathname\fP が現在実行中の実行イメージを参照しており、書き込みが要求された。
 416 .TP
 417 \fBEWOULDBLOCK\fP
 418 \fBO_NONBLOCK\fP フラグが指定されたが、そのファイルには矛盾するリースが設定されていた (\fBfcntl\fP(2)  参照)。
 419 .SH 準拠
 420 SVr4, 4.3BSD, POSIX.1\-2001.  フラグ \fBO_DIRECTORY\fP, \fBO_NOATIME\fP,
 421 \fBO_NOFOLLOW\fP, \fBO_PATH\fP は Linux 特有のものであり、 これらのフラグの定義を得るためには、
 422 (「どの」ヘッダファイルをインクルードするよりも前に)  \fB_GNU_SOURCE\fP を定義する必要があるかもしれない。
 423
 424 \fBO_CLOEXEC\fP フラグは POSIX.1\-2001 では規定されていないが、 POSIX.1\-2008 で規定されている。
 425
 426 \fBO_DIRECT\fP は POSIX では規定されていない。 \fBO_DIRECT\fP の定義を得るには
 427 (「どの」ヘッダファイルをインクルードするよりも前に)  \fB_GNU_SOURCE\fP を定義しなければならない。
 428 .SH 注意
 429 Linux では、 \fBO_NONBLOCK\fP フラグは、 open を実行したいが read または write を実行する意図は
 430 必ずしもないことを意味する。 これは \fBioctl\fP(2)  のためのファイルディスクリプタを取得するために、
 431 デバイスをオープンするときによく用いられる。
 432
 433 .\" See for example util-linux's disk-utils/setfdprm.c
 434 .\" For some background on access mode 3, see
 435 .\" http://thread.gmane.org/gmane.linux.kernel/653123
 436 .\" "[RFC] correct flags to f_mode conversion in __dentry_open"
 437 .\" LKML, 12 Mar 2008
 438 「アクセスモード」の値 \fBO_RDONLY\fP, \fBO_WRONLY\fP, \fBO_RDWR\fP は、 \fIflags\fP
 439 に指定できる他の値と違い、個々のビットを指定するものではなく、 これらの値は \fIflags\fP の下位 2 ビットを定義する。 \fBO_RDONLY\fP,
 440 \fBO_WRONLY\fP, \fBO_RDWR\fP はそれぞれ 0, 1, 2 に定義されている。 言い換えると、 \fBO_RDONLY |
 441 O_WRONLY\fP の組み合わせは論理的に間違いであり、確かに \fBO_RDWR\fP と同じ意味ではない。 Linux
 442 では、特別な、非標準なアクセスモードとして 3 (バイナリでは 11) が 予約されており \fIflags\fP に指定できる。
 443 このアクセスモードを指定すると、ファイルの読み出し/書き込み許可をチェックし、 読み出しにも書き込みにも使用できないディスクリプタを返す。
 444 この非標準のアクセスモードはいくつかの Linux ドライバで、デバイス固有の \fBioctl\fP(2)
 445 操作にのみ使用されるディスクリプタを返すために使われている。
 446 .LP
 447 .\" Linux 2.0, 2.5: truncate
 448 .\" Solaris 5.7, 5.8: truncate
 449 .\" Irix 6.5: truncate
 450 .\" Tru64 5.1B: truncate
 451 .\" HP-UX 11.22: truncate
 452 .\" FreeBSD 4.7: truncate
 453 \fBO_RDONLY | O_TRUNC\fP の影響は未定義であり、その動作は実装によって異なる。 多くのシステムではファイルは実際に切り詰められる。
 454 .PP
 455 NFS を実現しているプロトコルには多くの不備があり、特に \fBO_SYNC\fP と \fBO_NDELAY\fP に影響する。
 456
 457 POSIX では、3 種類の同期 I/O が提供されており、 \fBO_SYNC\fP, \fBO_DSYNC\fP, \fBO_RSYNC\fP
 458 フラグがこれに対応するものである。 今のところ (カーネル 2.6.31)、 Linux では \fBO_SYNC\fP だけが実装されているが、 glibc
 459 は \fBO_DSYNC\fP と \fBO_RSYNC\fP に \fBO_SYNC\fP と同じ数値を割り当てている。 ほとんどの Linux
 460 のファイルシステムは、実際には POSIX の \fBO_SYNC\fP の動作ではなく \fBO_DSYNC\fP の動作だけを実装している。 POSIX の
 461 \fBO_SYNC\fP では、 \fBopen\fP()  がユーザ空間に返る際に、書き込みに関する全てのメタデータの
 462 更新がディスクに書き込まれている必要がある。 一方、 \fBO_DSYNC\fP では、 \fBopen\fP()
 463 が返るまでに、実際のファイルのデータとそのデータを取得するために 必要なメタデータだけがディスクに書き込まれていればよい。
 464
 465 \fBopen\fP()  はスペシャルファイルをオープンすることができるが、 \fBcreat\fP()  でスペシャルファイルを作成できない点に注意すること。
 466 代わりに \fBmknod\fP(2)  を使用する。
 467 .LP
 468 UID マッピングを使用している NFS ファイルシステムでは、 \fBopen\fP()  がファイルディスクリプタを返した場合でも \fBread\fP(2)
 469 が \fBEACCES\fP で拒否される場合がある。 これはクライアントがアクセス許可のチェックを行って \fBopen\fP()
 470 を実行するが、読み込みや書き込みの際には サーバーで UID マッピングが行われるためである。
 471
 472 ファイルが新しく作成されると、 ファイルの \fIst_atime\fP, \fIst_ctime\fP, \fIst_mtime\fP フィールド
 473 (それぞれ最終アクセス時刻、最終状態変更時刻、最終修正時刻である。 \fBstat\fP(2)  参照) が現在時刻に設定される。 さらに親ディレクトリの
 474 \fIst_ctime\fP と \fIst_mtime\fP も現在時刻に設定される。 それ以外の場合で、O_TRUNC フラグでファイルが修正されたときは、
 475 ファイルの \fIst_ctime\fP と \fIst_mtime\fP フィールドが現在時刻に設定される。
 476 .SS O_DIRECT
 477 .LP
 478 \fBO_DIRECT\fP フラグを使用する場合、ユーザ空間バッファの長さやアドレス、 I/O
 479 のファイルオフセットに関してアラインメントの制限が課されることがある。 Linux では、アラインメントの制限はファイルシステムやカーネルのバージョンに
 480 よって異なり、全く制限が存在しない場合もある。 しかしながら、現在のところ、指定されたファイルやファイルシステムに対して
 481 こうした制限があるかを見つけるための、アプリケーション向けのインタフェースで ファイルシステム非依存のものは存在しない。
 482 いくつかのファイルシステムでは、制限を確認するための独自のインタフェースが 提供されている。例えば、 \fBxfsctl\fP(3)  の
 483 \fBXFS_IOC_DIOINFO\fP 命令である。
 484 .LP
 485 Linux 2.4 では、転送サイズ、 ユーザーバッファのアラインメント、ファイルオフセットは、
 486 ファイルシステムの論理ブロックサイズの倍数でなければならない。 Linux 2.6 では、512 バイトごとの境界に配置されていれば充分である。
 487 .LP
 488 メモリバッファがプライベートマッピング (\fBmmap\fP(2) の \fBMAP_PRIVATE\fP
 489 フラグで作成されたマッピング) の場合には、\fBO_DIRECT\fP I/O は
 490 \fBfork\fP(2) システムコールと同時に決して実行すべきではない
 491 (プライベートマッピングには、ヒープ領域に割り当てられたメモリや静的に
 492 割り当てたバッファも含まれる)。非同期 I/O インターフェース (AIO) 経由
 493 やプロセス内の他のスレッドから発行された、このような I/O は、
 494 \fBfork\fP(2) が呼び出される前に完了されるべきである。
 495 そうしなかった場合、データ破壊や、親プロセスや子プロセスでの予期しない
 496 動作が起こる可能性がある。
 497 \fBO_DIRECT\fP I/O 用のメモリバッファが \fBshmat\fP(2) や\fBMAP_SHARED\fP フラグ
 498 付きの \fBmmap\fP(2) で作成された場合には、この制限はあてはまらない。
 499 \fBmadvise\fP(2) でメモリバッファにアドバイス \fBMADV_DONTFORK\fP が設定され
 500 ている場合にも、この制限はあてはまらない(\fBMADV_DONTFORK\fP はそのメモリ
 501 バッファが \fBfork\fP(2) 後に子プロセスからは利用できないことを保証するも
 502 のである)。
 503 .LP
 504 \fBO_DIRECT\fP フラグは SGI IRIX で導入された。SGI IRIX にも Linux 2.4 と同様の (ユーザーバッファの)
 505 アラインメントの制限がある。 また、IRIX には適切な配置とサイズを取得するための \fBfcntl\fP(2)  コールがある。 FreeBSD 4.x
 506 も同じ名前のフラグを導入したが、アラインメントの制限はない。
 507 .LP
 508 \fBO_DIRECT\fP が Linux でサポートされたのは、カーネルバージョン 2.4.10 である。 古い Linux
 509 カーネルは、このフラグを単に無視する。 \fBO_DIRECT\fP フラグをサポートしていないファイルシステムもあり、その場合は、 \fBO_DIRECT\fP
 510 を使用すると \fBopen\fP()  は \fBEINVAL\fP で失敗する。
 511 .LP
 512 アプリケーションは、同じファイル、 特に同じファイルの重複するバイト領域に対して、 \fBO_DIRECT\fP と通常の I/O
 513 を混ぜて使うのは避けるべきである。 ファイルシステムがこのような状況において一貫性の問題を正しく 扱うことができる場合であっても、全体の I/O
 514 スループットは どちらか一方を使用するときと比べて低速になるであろう。 同様に、アプリケーションは、同じファイルに対して \fBmmap\fP(2)  と直接
 515 I/O (\fBO_DIRECT\fP)  を混ぜて使うのも避けるべきである。
 516 .LP
 517 NFS で \fBO_DIRECT\fP を使った場合の動作はローカルのファイルシステムの場合と違う。
 518 古いカーネルや、ある種の設定でコンパイルされたカーネルは、 \fBO_DIRECT\fP と NFS の組み合わせをサポートしていないかもしれない。 NFS
 519 プロトコル自体はサーバにフラグを渡す機能は持っていないので、 \fBO_DIRECT\fP I/O
 520 はクライアント上のページキャッシュをバイパスするだけになり、 サーバは I/O をキャッシュしているかもしれない。 クライアントは、
 521 \fBO_DIRECT\fP の同期機構を保持するため、サーバに対して I/O を同期して行うように依頼する。 サーバによっては、こうした状況下、特に I/O
 522 サイズが小さい場合に 性能が大きく劣化する。 また、サーバによっては、I/O が安定したストレージにまで行われたと、
 523 クライアントに対して嘘をつくものもある。 これは、サーバの電源故障が起こった際にデータの完全性が保たれない
 524 危険は少しあるが、性能面での不利な条件を回避するために行われている。 Linux の NFS クライアントでは \fBO_DIRECT\fP I/O
 525 でのアラインメントの制限はない。
 526 .PP
 527 まとめると、 \fBO_DIRECT\fP は、注意して使うべきであるが、強力なツールとなる可能性を持っている。 アプリケーションは \fBO_DIRECT\fP
 528 をデフォルトでは無効になっている性能向上のためのオプションと 考えておくのがよいであろう。
 529 .PP
 530 .RS
 531 「O_DIRECT でいつも困るのは、インタフェース全部が本当にお馬鹿な点だ。 たぶん危ないマインドコントロール剤で
 532 頭がおかしくなったサルが設計したんじゃないかな」 \(em Linus
 533 .RE
 534 .SH バグ
 535 .\" FIXME . Check bugzilla report on open(O_ASYNC)
 536 .\" See http://bugzilla.kernel.org/show_bug.cgi?id=5993
 537 現在のところ、 \fBopen\fP()  の呼び出し時に \fBO_ASYNC\fP を指定してシグナル駆動 I/O を有効にすることはできない。
 538 このフラグを有効にするには \fBfcntl\fP(2)  を使用すること。
 539 .SH 関連項目
 540 \fBchmod\fP(2), \fBchown\fP(2), \fBclose\fP(2), \fBdup\fP(2), \fBfcntl\fP(2), \fBlink\fP(2),
 541 \fBlseek\fP(2), \fBmknod\fP(2), \fBmmap\fP(2), \fBmount\fP(2), \fBopenat\fP(2), \fBread\fP(2),
 542 \fBsocket\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBunlink\fP(2), \fBwrite\fP(2),
 543 \fBfopen\fP(3), \fBfifo\fP(7), \fBpath_resolution\fP(7), \fBsymlink\fP(7)
 544 .SH この文書について
 545 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 546 である。プロジェクトの説明とバグ報告に関する情報は
 547 http://www.kernel.org/doc/man\-pages/ に書かれている。