135 lines
4.5 KiB
Groff
135 lines
4.5 KiB
Groff
.\" 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$
|
||
.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
|
||
¤Ï¡¢¥×¥í¥»¥¹¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿¥¢¥É¥ì¥¹¶õ´Ö¤ÎÈϰϳ°¤ò»Ø¤·¤Æ¤¤¤Þ¤¹¡£
|
||
.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
|
||
¤ÇÅо줷¤Þ¤·¤¿¡£
|