Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

openat

名前

書式

 #define _ATFILE_SOURCE
 #include <fcntl.h>
 
 int openat(int dirfd, const char *pathname, int flags);
 int openat(int dirfd, const char *pathname, int flags, mode_t mode);
 

説明

pathname で指定されるパス名が相対パスである場合、 ファイルディスクリプタ dirfd で参照されるディレクトリからの相対パス名として解釈される (open(2) では、相対パスは呼び出し元プロセスのカレントワーキングディレクトリからの 相対パスとなる)。

pathname が相対パスであり、かつ dirfd が特別な値 AT_FDCWD である場合、 pathname は (open(2) と同じように) 呼び出し元プロセスの カレントワーキングディレクトリからの相対パス名として解釈される。

pathname が絶対パスである場合、 dirfd は無視される。

返り値

エラー

EBADF

dirfd が有効なファイルディスクリプタでない。

ENOTDIR

pathname が相対パスで、かつ dirfd がディレクトリ以外のファイルを参照するファイルディスクリプタである。

バージョン

準拠

注意

1 つ目の理由は、 カレントワーキングディレクトリ以外のディレクトリにあるファイル群を open(2) でオープンするときに起こる可能性がある競合状態 (race condition) を、 openat() によってアプリケーションが回避できるためである。 これらの競合状態は、 open(2) に指定されたパスのディレクトリ部分の (/ で区切られた) いくつかの構成要素 (をオープンする処理) が、 open(2) を並列に呼び出す処理に変換された場合に起こる。 このような競合は、対象ディレクトリのファイルディスクリプタをオープンし、 そのファイルディスクリプタを openat() の dirfd 引き数に指定することで回避できる。

2 つ目の理由は、 アプリケーションによって管理されるファイルディスクリプタ (群) を使うことで、 openat() がスレッド毎のいわゆる「カレントワーキングディレクトリ」を実装できるためである。 (この機能は /proc/self/fd/dirfd を使った裏技でも実現できるが、あまり効率的ではない)。

関連項目