.\" Copyright (c) 1980, 1991, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)access.2	8.2 (Berkeley) 4/1/94
.\" %FreeBSD: src/lib/libc/sys/access.2,v 1.18 2002/12/19 09:40:24 ru Exp %
.\"
.\" $FreeBSD$
.Dd September 21, 2001
.Dt ACCESS 2
.Os
.Sh 名称
.Nm access , eaccess
.Nd ファイルのアクセス可能性をチェックする
.Sh ライブラリ
.Lb libc
.Sh 書式
.In unistd.h
.Ft int
.Fn access "const char *path" "int mode"
.Ft int
.Fn eaccess "const char *path" "int mode"
.Sh 解説
.Fn access
システムコールと
.Fn eaccess
システムコールは、
.Fa mode
引数によって示されたアクセス許可について
.Fa path
引数で指定されるファイルのアクセス可能性をチェックします。
.Fa mode
の値は、チェックされるアクセス許可 (読取り許可については
.Dv R_OK
、書込み許可については
.Dv W_OK
、実行 / 検索許可については
.Dv X_OK )
のビット単位の OR、または存在試験 (
.Dv F_OK
) のどちらかです。
.Pp
さらなる情報は、
.Xr intro 2
の
.Sx ファイルアクセスパーミッション
セクションを参照してください。
.Pp
.Fn eaccess
システムコールは、実効ユーザ ID とグループアクセスリストを用いて
要求を許可します。
一方
.Fn access
システムコールは、実効ユーザ ID の代わりに実ユーザ ID を、
実効グループ ID の代わりに実グループと残りのグループアクセスリストを
用います。
.Pp
プロセスの実ユーザもしくは実効ユーザに適切な特権があり、
.Dv X_OK
について成功を示していても、実際にはファイルの実行許可ビットが
設定されていないことがあります。
同じことが、
.Dv R_OK
および
.Dv W_OK
にも該当します。
.Sh 戻り値
.Rv -std
.Sh エラー
ファイルへのアクセスは次の場合に拒絶されます:
.Bl -tag -width Er
.It Bq Er ENOTDIR
パスの構成要素中にディレクトリ以外のものが含まれています。
.It Bq Er ENAMETOOLONG
パス名の構成要素が 255 文字を越えているか、
またはパス名全体が 1023 文字を越えています。
.It Bq Er ENOENT
指定されたファイルが存在しません。
.It Bq Er ELOOP
パス名を変換するときに検出されたシンボリックリンクが多すぎます。
.It Bq Er EROFS
読取り専用ファイルシステム上のファイルについて書込みアクセスが
要求されました。
.It Bq Er ETXTBSY
現時点で実行中の純粋な手続き (共有テキスト)
ファイルについて書込みアクセスが要求されています。
.It Bq Er EACCES
ファイルモードの許可ビットが要求されたアクセスを許容しないか、
またはパスの構成要素について検索許可が拒絶されています。
.It Bq Er EFAULT
.Fa path
引数が、プロセスに割り当てられたアドレス空間の範囲外を指しています。
.It Bq Er EIO
ファイルシステムに読み書きしている間に入出力エラーが発生しました。
.El
.Sh セキュリティに関する考察
.Fn access
システムコールは、競合状態によって潜在的なセキュリティホールとなるので、
使うべきではありません。
ユーザ ID 設定とグループ ID 設定されたアプリケーションは、
実効ユーザ ID もしくは実効グループ ID を復元するようにしてください。
そして実ユーザ ID もしくは実グループ ID でのアクセスを、
.Fn access
を使用して模擬的にチェックするのではなく、直接実行するべきです。
不適切に使用された場合、
.Fn eaccess
呼び出しも同様にして競合の対象となることがあります。
.Sh 関連項目
.Xr chmod 2 ,
.Xr intro 2 ,
.Xr stat 2
.Sh 規格
.Fn access
システムコールは
.St -p1003.1-90
に適合しています。
.Sh 歴史
.Fn access
関数は
.At v7
で登場しました。