From 6ce8cde26d5744e0fec0cf96859912e3796d6453 Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Sun, 6 May 2007 08:32:47 +0000
Subject: [PATCH] Documentation of euidaccess() and eaccess().

---
 man3/eaccess.3    |  1 +
 man3/euidaccess.3 | 89 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 90 insertions(+)
 create mode 100644 man3/eaccess.3
 create mode 100644 man3/euidaccess.3

diff --git a/man3/eaccess.3 b/man3/eaccess.3
new file mode 100644
index 000000000..9e5035180
--- /dev/null
+++ b/man3/eaccess.3
@@ -0,0 +1 @@
+.so man3/euidaccess.3
diff --git a/man3/euidaccess.3 b/man3/euidaccess.3
new file mode 100644
index 000000000..1a68a0c87
--- /dev/null
+++ b/man3/euidaccess.3
@@ -0,0 +1,89 @@
+.\" Hey Emacs! This file is -*- nroff -*- source.
+.\"
+.\"
+.\" 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.
+.\"
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\"
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date.  The author(s) assume no
+.\" responsibility for errors or omissions, or for damages resulting from
+.\" the use of the information contained herein.  The author(s) may not
+.\" have taken the same level of care in the production of this manual,
+.\" which is licensed free of charge, as they might when working
+.\" professionally.
+.\"
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.\"
+.\"
+.TH EUIDACCESS 3 2007-05-18 "" "Linux Programmer's Manual"
+.SH NAME
+euidaccess, eaccess \- check effective user's permissions for a file
+.SH SYNOPSIS
+.nf
+.B #include <unistd.h>
+.sp
+.BI "int euidaccess(const char *" pathname ", int " mode );
+.BI "int eaccess(const char *" pathname ", int " mode );
+.fi
+.SH DESCRIPTION
+Like
+.BR access (),
+.BR euidaccess ()
+checks permissions and existence of the file identified by its argument
+.IR pathname .
+However, whereas 
+.BR access (),
+performs checks using the real user and group identifiers of the process,
+.BR euidaccess ()
+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 ,
+with the same meanings as for 
+.BR access ().
+
+.BR eaccess ()
+is a synonym for
+.BR euidaccess (),
+provided for compatibility with some other systems.
+.SH "RETURN VALUE"
+On success (all requested permissions granted), zero is returned.
+On error (at least one bit in
+.I mode
+asked for a permission that is denied, or some other error occurred),
+\-1 is returned, and
+.I errno
+is set appropriately.
+.SH ERRORS
+As for
+.BR access ().
+.SH "CONFORMING TO"
+These functions are non-standard.
+Some other systems have an
+.\" e.g., FreeBSD 6.1.
+.BR eaccess ()
+function.
+.SH "GLIBC NOTES"
+The 
+.BR eaccess ()
+function was added to glibc in version 2.4.
+.SH "SEE ALSO"
+.BR access (2),
+.\" FIXME add SEE ALSO in access.2 referring to this page
+.BR chmod (2),
+.BR chown (2),
+.\" FIXME add SEE ALSO in faccessat.2 referring to this page
+.BR faccessat (2),
+.BR open (2),
+.BR path_resolution (2),
+.BR setgid (2),
+.BR setuid (2),
+.BR stat (2)