access.2: Mention that lstat(2) should be used for symbolic links

access(), eaccess() and faccessat() will always dereference
symbolic links.

So add a note in the manual page, that lstat(2) should be
used in the case of symbolic links.

PR:	262895
Reviewed by:	gbe, pauamma_gundo.com
MFC after:	1 week
Differential Revision:	https://reviews.freebsd.org/D44890
This commit is contained in:
Gordon Bergling 2024-05-13 10:40:12 +02:00
parent 9bfd3b4076
commit 421025a274

View File

@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd March 30, 2021
.Dd May 13, 2024
.Dt ACCESS 2
.Os
.Sh NAME
@ -147,6 +147,15 @@ Likewise for
.Dv R_OK
and
.Dv W_OK .
.Pp
.Fn access ,
.Fn eaccess
and
.Fn faccessat
will always dereference symbolic links.
If the symbolic link itself needs to be referenced,
.Xr lstat 2
should be used instead.
.Sh RETURN VALUES
.Rv -std
.Sh ERRORS