.\" 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.7. 2.4 2001/12/14 18:34:00 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/access. 2, v 1.6 2001/12/23 00:03:41 horikawa Exp $ .Dd April 1, 1994 .Dt ACCESS 2 .Os .Sh 명칭 .Nm access .Nd 파일 또는 패스명의 액세스 허가를 체크한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In unistd.h .Ft int .Fn access "const char *path" "int mode" .Sh 해설 .Fn access 함수는, .Fa mode 에 의해 나타난 액세스 허가에 대해 .Fa path 그리고 지정되는 파일의 액세스 가능성을 체크합니다. .Fa mode 의 값은, 체크되는 액세스 허가 (읽기 허가에 대해서는 .Dv R_OK , 기록 허가에 대해서는 .Dv W_OK , 실행 / 검색 허가에 대해서는 .Dv X_OK ) 의 비트 단위의 OR, 또는 존재 시험 .Dv F_OK 입니다. 패스명 .Fa path 의 모든 원가요소가 액세스 허가에 대해 체크됩니다 .Pf ( Dv F_OK 도 포함됩니다). .Pp 열매 유저 ID 는 실효 유저 ID 대신에 사용되어 열매 그룹 액세스 리스트 (열매 그룹 ID 를 포함한다) 하지만 퍼미션을 검증하기 위해서 실효 ID 대신에 사용됩니다. .Pp 프로세스에 적절한 특권이 있어, .Dv X_OK 에 붙어 성공을 나타내고 있어도, 실제로는 파일의 실행 허가 비트가 설정되어 있지 않은 것이 있습니다. 같은 것이, .Dv R_OK 및 .Dv W_OK 에도 해당합니다. .Sh 반환값 .Fa path 하지만 발견되지 않는 경우, 또는 희망의 액세스 모드가 인정받지 않는 경우, 값 -1 이 돌려주어집니다. 그렇지 않은 경우는, 값 0 이 돌려주어집니다. .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 파일 모드의 허가 비트가 요구된 액세스를 허용 하지 않는지, 또는 패스의 원가요소에 대해 검색 허가가 거절되고 있습니다. 파일의 소유자는 ``소유자 (owner)''의 읽기, 기록, 및 실행의 모드 비트에 따라 체크된 허가를 가집니다. 소유자 이외의 파일의 그룹의 멤버는 ``그룹 (group)''모드 비트에 따라서 체크된 허가를 가져, 다른 모든 것은 ``그 외 (other)''모드 비트에 따라서 체크된 허가를 가집니다. .It Bq Er EFAULT .Fa path (은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다. .It Bq Er EIO 파일 시스템에 읽고 쓰기하고 있는 동안에 입출력 에러가 발생했습니다. .El .Sh 관련 항목 .Xr chmod 2 , .Xr stat 2 .Sh 표준 .Fn access 함수는 .St -p1003.1-90 에 준거하고 있습니다. .Sh 경고 .Fn access (은)는, 보안 홀이 될 가능성이 있어, 결코 사용하지 않게 해 주세요. .Sh 역사 .Fn access 함수는 .At v7 그리고 등장했습니다.