euidaccess(3) ファイルへのアクセス権を実効ユーザでチェックする

Other Alias

eaccess

書式

#define _GNU_SOURCE /* feature_test_macros(7) 参照 */
#include <unistd.h>


int euidaccess(const char *pathname, int mode);
int eaccess(const char *pathname, int mode);

説明

access(2) と同様、 euidaccess() は引き数 pathname で指定されたファイルの許可 (permission) と存在のチェックを行う。 access(2) はプロセスの実 (real) ユーザID / 実グループID を用いてチェックを行うのに対し、 euidaccess() は実効 (effective) ID を用いる。

modeR_OK, W_OK, X_OK, F_OK の一つ以上から構成されるマスクである。 R_OK, W_OK, X_OK, F_OKaccess(2) と同じ意味を持つ。

eaccess() は euidaccess() の同義語であり、他のいくつかのシステムとの互換性のために提供されている。

返り値

成功した場合 (要求した全てについて許可が得られたら)、ゼロが返される。 エラーの場合 (mode の少なくとも一つのビットで要求した許可がなかった場合や、 他のエラーが起こった場合)、-1 が返され、 errno が適切に設定される。

エラー

access(2) と同じ。

バージョン

eaccess() 関数は glibc のバージョン 2.4 で追加された。

属性

マルチスレッディング (pthreads(7) 参照)

関数 euidaccess() と eaccess() はスレッドセーフである。

準拠

これらの関数は非標準である。 他のいくつかのシステムには eaccess() 関数がある。

注意

警告: ある操作を実行する前にこの関数を使ってファイルに対するプロセスのアクセス許可を 確認してから、その情報に基づいて操作を行うと、競合条件が発生する可能性がある。 これは二つの操作の間でファイルのアクセス許可が変化する場合があるからである。 一般的には、必要な操作のみを行い、その際に発生したアクセス許可に関するエラーを 処理する方が安全である。

この関数は常にシンボリックリンクの展開を行う。 シンボリックリンクのアクセス許可を確認する必要がある場合は、 フラグ AT_EACCESSAT_SYMLINK_NOFOLLOW を付けて faccessat(2) を使うこと。

この文書について

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