manual/LDP_man-pages/draft/man3/euidaccess.3

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
   4 .\"
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one.
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\"
  25 .\" Japanese Version Copyright (c) 2007  Akihiro MOTOKI
  26 .\"         all rights reserved.
  27 .\" Translated 2007-06-02, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  28 .\"
  29 .TH EUIDACCESS 3 2007-07-26 "" "Linux Programmer's Manual"
  30 .\"O .SH NAME
  31 .SH Ì¾Á°
  32 .\"O euidaccess, eaccess \- check effective user's permissions for a file
  33 euidaccess, eaccess \- ¥Õ¥¡¥¤¥ë¤Ø¤Î¥¢¥¯¥»¥¹¸¢¤ò¼Â¸ú¥æ¡¼¥¶¤Ç¥Á¥§¥Ã¥¯¤¹¤ë
  34 .\"O .SH SYNOPSIS
  35 .SH ½ñ¼°
  36 .nf
  37 .B #define _GNU_SOURCE
  38 .B #include <unistd.h>
  39 .sp
  40 .BI "int euidaccess(const char *" pathname ", int " mode );
  41 .BI "int eaccess(const char *" pathname ", int " mode );
  42 .fi
  43 .\"O .SH DESCRIPTION
  44 .SH ÀâÌÀ
  45 .\"O Like
  46 .\"O .BR access (2),
  47 .\"O .BR euidaccess ()
  48 .\"O checks permissions and existence of the file identified by its argument
  49 .\"O .IR pathname .
  50 .\"O However, whereas
  51 .\"O .BR access (2),
  52 .\"O performs checks using the real user and group identifiers of the process,
  53 .\"O .BR euidaccess ()
  54 .\"O uses the effective identifiers.
  55 .BR access (2)
  56 ¤ÈÆ±ÍÍ¡¢
  57 .BR euidaccess ()
  58 ¤Ï°ú¤¿ô
  59 .I pathname
  60 ¤Ç»ØÄê¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤Îµö²Ä (permission) ¤ÈÂ¸ºß¤Î¥Á¥§¥Ã¥¯¤ò¹Ô¤¦¡£
  61 .BR access (2)
  62 ¤Ï¥×¥í¥»¥¹¤Î¼Â (real) ¥æ¡¼¥¶ID / ¼Â¥°¥ë¡¼¥×ID ¤òÍÑ¤¤¤Æ¥Á¥§¥Ã¥¯¤ò¹Ô¤¦¤Î¤ËÂÐ¤·¡¢
  63 .BR euidaccess ()
  64 ¤Ï¼Â¸ú (effective) ID ¤òÍÑ¤¤¤ë¡£
  65
  66 .\"O .I mode
  67 .\"O is a mask consisting of one or more of
  68 .\"O .BR R_OK ", " W_OK ", " X_OK " and " F_OK ,
  69 .\"O with the same meanings as for
  70 .\"O .BR access (2).
  71 .I mode
  72 ¤Ï
  73 .BR R_OK ", " W_OK ", " X_OK ", " F_OK
  74 ¤Î°ì¤Ä°Ê¾å¤«¤é¹½À®¤µ¤ì¤ë¥Þ¥¹¥¯¤Ç¤¢¤ë¡£
  75 .BR R_OK ", " W_OK ", " X_OK ", " F_OK
  76 ¤Ï
  77 .BR access (2)
  78 ¤ÈÆ±¤¸°ÕÌ£¤ò»ý¤Ä¡£
  79
  80 .\"O .BR eaccess ()
  81 .\"O is a synonym for
  82 .\"O .BR euidaccess (),
  83 .\"O provided for compatibility with some other systems.
  84 .BR eaccess ()
  85 ¤Ï
  86 .BR euidaccess ()
  87 ¤ÎÆ±µÁ¸ì¤Ç¤¢¤ê¡¢Â¾¤Î¤¤¤¯¤Ä¤«¤Î¥·¥¹¥Æ¥à¤È¤Î¸ß´¹À¤Î¤¿¤á¤ËÄó¶¡¤µ¤ì¤Æ¤¤¤ë¡£
  88 .\"O .SH "RETURN VALUE"
  89 .SH ÊÖ¤êÃÍ
  90 .\"O On success (all requested permissions granted), zero is returned.
  91 .\"O On error (at least one bit in
  92 .\"O .I mode
  93 .\"O asked for a permission that is denied, or some other error occurred),
  94 .\"O \-1 is returned, and
  95 .\"O .I errno
  96 .\"O is set appropriately.
  97 À®¸ù¤·¤¿¾ì¹ç (Í×µá¤·¤¿Á´¤Æ¤Ë¤Ä¤¤¤Æ¤Îµö²Ä¤¬ÆÀ¤é¤ì¤¿¤é)¡¢¥¼¥í¤¬ÊÖ¤µ¤ì¤ë¡£
  98 ¥¨¥é¡¼¤Î¾ì¹ç
  99 .RI ( mode
 100 ¤Î¾¯¤Ê¤¯¤È¤â°ì¤Ä¤Î¥Ó¥Ã¥È¤ÇÍ×µá¤·¤¿µö²Ä¤¬¤Ê¤«¤Ã¤¿¾ì¹ç¤ä¡¢
 101 Â¾¤Î¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç)¡¢\-1 ¤¬ÊÖ¤µ¤ì¡¢
 102 .I errno
 103 ¤¬Å¬ÀÚ¤ËÀßÄê¤µ¤ì¤ë¡£
 104 .\"O .SH ERRORS
 105 .SH ¥¨¥é¡¼
 106 .\"O As for
 107 .\"O .BR access (2).
 108 .BR access (2)
 109 ¤ÈÆ±¤¸¡£
 110 .\"O .SH VERSIONS
 111 .SH ¥Ð¡¼¥¸¥ç¥ó
 112 .\"O The
 113 .\"O .BR eaccess ()
 114 .\"O function was added to glibc in version 2.4.
 115 .BR eaccess ()
 116 ´Ø¿ô¤Ï glibc ¤Î¥Ð¡¼¥¸¥ç¥ó 2.4 ¤ÇÄÉ²Ã¤µ¤ì¤¿¡£
 117 .\"O .SH "CONFORMING TO"
 118 .SH ½àµò
 119 .\"O These functions are nonstandard.
 120 .\"O Some other systems have an
 121 .\"O .\" e.g., FreeBSD 6.1.
 122 .\"O .BR eaccess ()
 123 .\"O function.
 124 ¤³¤ì¤é¤Î´Ø¿ô¤ÏÈóÉ¸½à¤Ç¤¢¤ë¡£
 125 Â¾¤Î¤¤¤¯¤Ä¤«¤Î¥·¥¹¥Æ¥à¤Ë¤Ï
 126 .\" Îã¤¨¤Ð¡¢FreeBSD 6.1.
 127 .BR eaccess ()
 128 ´Ø¿ô¤¬¤¢¤ë¡£
 129 .\"O .SH "SEE ALSO"
 130 .SH ´ØÏ¢¹àÌÜ
 131 .BR access (2),
 132 .BR chmod (2),
 133 .BR chown (2),
 134 .BR faccessat (2),
 135 .BR open (2),
 136 .BR setgid (2),
 137 .BR setuid (2),
 138 .BR stat (2),
 139 .BR credentials (7),
 140 .BR path_resolution (7)