open、openat、openx、openxat、 open64、 open64at、 open64x、 open64xat、creat、または creat64 サブルーチン

目的

読み取りまたは書き込みのためにファイルをオープンします。

構文

#include <fcntl.h>

int creat (Path, Mode)
const char *Path;
mode_t Mode;

int open64 (Path, OFlag [, Mode])
const char *Path;
int OFlag;
mode_t Mode;

int open64at (DirFileDescriptor, Path, 
OFlag [, Mode])
int DirFileDescriptor;
const char * Path;
int OFlag;
mode_t Mode;

int creat64 (Path, Mode)
const char *Path;
mode_t Mode;

int open64x (Path, OFlag, Mode, Extension)
char *Path;
int64_t OFlag;
mode_t Mode;
ext_t Extension;

int open64xat (DirFileDescriptor, Path, OFlag, Mode, Extension)
int DirFileDescriptor;
char *Path;
int64_t OFlag;
mode_t Mode;
ext_t Extension;

説明

DirFileDescriptorパラメータがAT_FDCWDであるか、Pathパラメータが絶対パス名である場合、openatサブルーチンはopenサブルーチンと等価である。 DirFileDescriptorているディレクトリの有効なファイル記述子であり、Pathが相対パス名である場合、Pathは、現在の作業ディレクトリではなく、DirFileDescriptorパラメータに関連付けられたディレクトリからの相対パスであるとみなされる。 同様に、openxat、open64at、open64xatサブルーチンは、openatや openと同様に、それぞれopenx、open64、open64xサブルーチンと等価である。

open、openx、creatサブルーチンは、 Pathパラメータで指定されたファイルとファイル記述子との接続を確立する。 オープンされたファイルディスクリプタは、 readや writeなどの後続のI/Oサブルーチンによって、そのファイルにアクセスするために使用される。

openxサブルーチンは openサブルーチンと同じであるが、デバイス・ドライバ用に Extensionパラメータが追加されている。 creatサブルーチンは、O_WRONLY、 O_CREAT、O_TRUNCフラグが設定されたopenサブルーチンと等価である。

戻されるファイル記述子は、そのプロセス用に以前にオープンされていない最下位のファイル記述子です。 プロセスは、 最大オープン数 個を超えるファイル記述子を同時にオープンすることはできません。

ファイル内の現在位置にマークを付けるファイル・オフセットは、ファイルの先頭に設定されます。 新しいファイル記述子は、EXEC サブルーチン間でオープンしたままになるように設定されます。

open64サブルーチンとcreat64サブルーチンは、返されるファイル記述子に関連付けられたオープン・ファイル記述子にO_LARGEFILEフラグが設定される点を除いて、openサブルーチンとcreatサブルーチンと同等である。 このフラグにより、OFF_MAXより大きなファイルにアクセスできる。 呼び出し元がOFF_MAXより大きなファイルを開こうとし、O_LARGEFILEが設定されていない場合、オープンは失敗し、errnoは EOVERFLOWに設定される。

大容量ファイル対応プログラミング環境では、openは open64と再定義され、creatは creat64と再定義される。

open64xサブルーチンは、暗号化ファイル・システムEFS）内の暗号化ファイルを作成し、アクセスする。 open64xサブルーチンはopenxサブルーチンに似ているが、OFlagパラメータが64ビットに更新される点が異なる。

openat、openxat、open64at、またはopen64xatサブルーチンのDirFileDescriptorパラメータがO_SEARCHopen フラグなしでオープンされた場合、サブルーチンは、ディレクトリの現在のパーミッションを使用して、そのディレクトリでディレクトリ検索が許可されているかどうかを確認する。 ディレクトリがO_SEARCHオープン・フラグでオープンされた場合、サブルーチンはそのディレクトリのチェックを行わない。

パラメーター

アクセスタイプを指定するフラグ

以下の オフラッグ パラメーター・フラグ値は、アクセスのタイプを指定します。

特別なオープン処理を指定するフラグ

以下の オフラッグ パラメーター・フラグ値は、特殊なオープン処理を指定します。

オープン・サブルーチンは、以下の条件のいずれかが真であれば失敗となる：

• ファイルは強制レコード・ロックをサポートしており、別のプロセスがファイルの一部をロックしています。
• ファイルは物理ファイルシステム上にあり、 O_RSHARE (_R) フラグまたは NSHARE (_N) フラグを指定して既にオープンしています。
• ファイルは書き込みアクセスを許可しません。
• ファイルは既に据え置き更新用にオープンされています。

更新のタイプを指定するフラグ

プログラムは、書き込みアクセス用にオープンされた通常のファイルの更新をいつ永続的にするかについて、ある種の制御を要求することができます。 以下の オフラッグ パラメーター値は、実行される更新のタイプを指定します。

オープンファイルの初期状態を定義するフラグ

以下の オフラッグ パラメーター・フラグ値は、オープン・ファイルの初期状態を定義します。

O_NDELAYフラグとO_NONBLOCKフラグは、リードと ライトのサブルーチンが返す値以外は同じである。 これらのフラグは、プロセスがオブジェクトの状態でブロックするのではなく、通常のファイルまたはブロック・デバイスへの入力または出力でブロックすることを意味します。

O_DELAY (Y) フラグは、 NSHARE (_N) フラグまたは O_RSHARE (_R) フラグと一緒に使用された場合にのみ関係します。 これは、 O_NDELAY (Y) フラグおよび O_ 非ブロック フラグとは関係ありません。

OFlag パラメータ・フラグに関する一般的な注意事項

ファイルが O_DEFER (定義者) フラグを指定してオープンされている場合でも、 O_CREAT (作成) フラグの効果は即時に現れます。

NSHARE (_N) フラグまたは O_RSHARE (_R) フラグを使用して物理ファイル・システム上のファイルを開くときに、ファイルが競合するアクセスで既にオープンされている場合は、以下のことが発生する可能性があります。

• O_DELAYフラグがクリア（デフォルト）の場合、オープン・サブルーチンは失敗する。
• O_DELAYフラグがセットされている場合、オープン・サブルーチンは競合するオープンがなくなるまでブロックする。 O_DELAY (Y) フラグを使用するプロセスのデッドロック検出はありません。

NSHARE (_N) フラグを使用して既にオープンされている物理ファイル・システム上のファイルをオープンすると、以下のことが起こる可能性があります。

• O_DELAY (Y) フラグがクリア (デフォルト) の場合、オープンは即時に失敗します。
• O_DELAY (Y) フラグが設定されている場合、オープンは、競合するオープンがなくなるまでブロックします。

O_RDWR (R)、 O_ 手首のみ、または O_TRUNC (単位) フラグを指定してファイルを開いたときに、そのファイルが既に O_RSHARE (_R) フラグを指定して開かれている場合は、以下のようになります。

• O_DELAY (Y) フラグがクリア (デフォルト) の場合、オープンは即時に失敗します。
• O_DELAY (Y) フラグが設定されている場合、オープンは、競合するオープンがなくなるまでブロックします。

O_RDONLY (オドONLY) フラグを使用して先入れ先出し法 (FIFO) をオープンすると、次のようになります。

• O_NDELAYフラグと O_NONBLOCKフラグがクリアされている場合、プロセスは書き込みのためにファイルをオープンするまで、オープンはブロックされる。 ファイルが（呼び出しプロセスによってであっても）すでに書き込みのためにオープンされている場合、openサブルーチンは遅滞なくリターンする。
• O_NDELAY (Y) フラグまたは O_ 非ブロック フラグが設定されている場合、書き込み用に FIFO をオープンしているプロセスがない場合でも、オープンは即時に成功します。

O_ 手首のみ フラグを指定して FIFO をオープンすると、以下のことが起こる可能性があります。

• O_NDELAY (Y) フラグと O_ 非ブロック フラグがクリアされている場合 (デフォルト)、プロセスが読み取りのためにファイルを開くまで、オープンはブロックされます。 ファイルが（呼び出しプロセスによってであっても）すでに書き込みのためにオープンされている場合、openサブルーチンは遅滞なくリターンする。
• O_NDELAYフラグまたはO_NONBLOCKフラグがセットされている場合、openサブルーチンは、現在そのファイルを読み込みのためにオープンしているプロセスがなければエラーを返す。

非ブロッキング・オープンをサポートするブロック・スペシャル・ファイルまたはキャラクター・スペシャル・ファイル (端末装置など) をオープンすると、次のようになります。

• O_NDELAY (Y) フラグと O_ 非ブロック フラグがクリアされている場合 (デフォルト)、装置が作動可能になるか使用可能になるまで、オープンはブロックされます。
• O_NDELAYフラグまたはO_NONBLOCKフラグがセットされている場合、オープン・サブルーチンは、デバイスが準備完了または使用可能になるのを待たずにリターンする。 それ以降のデバイスの動作は、デバイス固有のものになります。

O_NDELAY、O_RSHARE、 O_NSHARE、O_DELAYフラグが特定のデバイスに及ぼす影響に関する追加情報は、そのデバイス・タイプに関連する特殊ファイルの記述に記載されています。

パスがSTREAMSファイルを参照する場合、oflagは O_NONBLOCKORO_RDONLY、O_WRONLY、 O_RDWRのいずれかから構成される。 他のフラグ値は STREAMS 装置 には適用されず、装置への影響はありません。 値 O_NONBLOCK は、 STREAMS ファイルと関連付けられたファイル記述子に 適用される特定の関数および STREAMS ドライバーに影響します。 STREAMS ドライバーの場合、 O_ 非ブロック の実装はデバイス固有のものです。

pathが擬似端子デバイスのコントローラ側を指定する場合、openがワーカー側をロックし、オープンできないようにするかどうかは不定である。 ポータブルアプリケーションは、ワーカー側を開く前にunlockptを呼び出さなければならない。

O_Search フラグの値は、 O_EXEC (_EXEC) フラグの値と同じです。 AIX® 7.1以降、 O_EXEC フラグをディレクトリー・オープンに渡したプログラムは失敗する可能性があります。これは、オープン・コードがディレクトリーの検索許可も検査するためです。

off_t型のオブジェクトで正しく表現できる最大の値が、オープン・ファイル記述におけるオフセットの最大値として設定される。

戻り値

正常終了すると、ファイル記述子 (負でない整数) が戻されます。 そうでない場合は-1が返され、ファイルは作成も変更もされず、エラーを示すerrnoグローバル変数が設定される。

エラー・コード

open、openat openx、openxat、open64、open64at、open64x、open64xat、 creatサブルーチンは、以下の1つ以上が真である場合、失敗し、指定されたファイルはオープンされない：

open、 openx、open64x、 creatサブルーチンは、以下のいずれかが真であれば失敗する：

openat、openxat、open64at、open64xatサブルーチンは、以下の1つ以上が真である場合、失敗し、指定されたファイルはオープンされない：