LDP: Update original to LDP v3.68

[linuxjm/LDP_man-pages.git] / original / man3 / euidaccess.3

diff --git a/original/man3/euidaccess.3 b/original/man3/euidaccess.3
index b4dfb88..72b5784 100644 (file)
--- a/original/man3/euidaccess.3
+++ b/original/man3/euidaccess.3
@@ -1,7 +1,6 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -21,14 +20,14 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.\"
-.TH EUIDACCESS 3 2007-07-26 "" "Linux Programmer's Manual"
+.TH EUIDACCESS 3 2013-09-25 "" "Linux Programmer's Manual"
 .SH NAME
 euidaccess, eaccess \- check effective user's permissions for a file
 .SH SYNOPSIS
 .nf
-.B #define _GNU_SOURCE
+.BR "#define _GNU_SOURCE" "             /* See feature_test_macros(7) */"
 .B #include <unistd.h>
 .sp
 .BI "int euidaccess(const char *" pathname ", int " mode );
@@ -48,7 +47,7 @@ uses the effective identifiers.
 
 .I mode
 is a mask consisting of one or more of
-.BR R_OK ", " W_OK ", " X_OK " and " F_OK ,
+.BR R_OK ", " W_OK ", " X_OK ", and " F_OK ,
 with the same meanings as for
 .BR access (2).
 
@@ -56,7 +55,7 @@ with the same meanings as for
 is a synonym for
 .BR euidaccess (),
 provided for compatibility with some other systems.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 On success (all requested permissions granted), zero is returned.
 On error (at least one bit in
 .I mode
@@ -71,13 +70,35 @@ As for
 The
 .BR eaccess ()
 function was added to glibc in version 2.4.
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+.SS Multithreading (see pthreads(7))
+The
+.BR euidaccess ()
+and
+.BR eaccess ()
+functions are thread-safe.
+.SH CONFORMING TO
 These functions are nonstandard.
 Some other systems have an
 .\" e.g., FreeBSD 6.1.
 .BR eaccess ()
 function.
-.SH "SEE ALSO"
+.SH NOTES
+.IR Warning :
+Using this function to check a process's permissions on a file before
+performing some operation based on that information leads to race conditions:
+the file permissions may change between the two steps.
+Generally, it is safer just to attempt the desired operation and handle
+any permission error that occurs.
+
+This function always dereferences symbolic links.
+If you need to check the permissions on a symbolic link, use
+.BR faccessat (2)
+with the flags
+.BR AT_EACCESS
+and
+.BR AT_SYMLINK_NOFOLLOW .
+.SH SEE ALSO
 .BR access (2),
 .BR chmod (2),
 .BR chown (2),
@@ -88,3 +109,12 @@ function.
 .BR stat (2),
 .BR credentials (7),
 .BR path_resolution (7)
+.SH COLOPHON
+This page is part of release 3.68 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.