aboutsummaryrefslogtreecommitdiff
path: root/documentation/manual-pages/ja/man2/access.2
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/manual-pages/ja/man2/access.2')
-rw-r--r--documentation/manual-pages/ja/man2/access.2148
1 files changed, 148 insertions, 0 deletions
diff --git a/documentation/manual-pages/ja/man2/access.2 b/documentation/manual-pages/ja/man2/access.2
new file mode 100644
index 0000000000..ae65abcc9f
--- /dev/null
+++ b/documentation/manual-pages/ja/man2/access.2
@@ -0,0 +1,148 @@
+.\" 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
+で登場しました。