summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authorremko <remko@FreeBSD.org>2007-12-08 22:50:35 +0000
committerremko <remko@FreeBSD.org>2007-12-08 22:50:35 +0000
commitf956375817c6c596dcc7b417d254725dcb741698 (patch)
treed2cadaf761cf312cc01d668ee72f66c0980c1496 /lib
parent97bbfe4ca766d24d1d6047a6784486f3b377a294 (diff)
downloadFreeBSD-src-f956375817c6c596dcc7b417d254725dcb741698.zip
FreeBSD-src-f956375817c6c596dcc7b417d254725dcb741698.tar.gz
Make the warning a bit less 'broad' then it used to be. The access
is seems to be a problem for SUID applications, which we like to prevent as much as possible. PR: docs/39530 Submitted by: Soren Spies <sspies at apple dot com> MFC After: 3 days
Diffstat (limited to 'lib')
-rw-r--r--lib/libc/sys/access.211
1 files changed, 10 insertions, 1 deletions
diff --git a/lib/libc/sys/access.2 b/lib/libc/sys/access.2
index e43e271..3879477 100644
--- a/lib/libc/sys/access.2
+++ b/lib/libc/sys/access.2
@@ -28,7 +28,7 @@
.\" @(#)access.2 8.2 (Berkeley) 4/1/94
.\" $FreeBSD$
.\"
-.Dd September 21, 2001
+.Dd December 8, 2007
.Dt ACCESS 2
.Os
.Sh NAME
@@ -140,6 +140,15 @@ The
.Fn eaccess
system call
likewise may be subject to races if used inappropriately.
+.Pp
+.Fn access
+remains useful for providing clues to users as to whether operations
+make sense for particular filesystem objects (e.g. 'delete' menu
+item only highlighted in a writable folder ... avoiding interpretation
+of the st_mode bits that the application might not understand --
+e.g. in the case of AFS). It also allows a cheaper file existance
+test than
+.Ns Xr stat 2 .
.Sh SEE ALSO
.Xr chmod 2 ,
.Xr intro 2 ,
OpenPOWER on IntegriCloud