summaryrefslogtreecommitdiffstats
path: root/Modules/posixmodule.c
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2002-06-18 16:15:51 (GMT)
committerFred Drake <fdrake@acm.org>2002-06-18 16:15:51 (GMT)
commit7f591246936a5a2b763851e3cb866be44a321d50 (patch)
treee59b0311f4628ac2fdaa8401c310c0b392f9744c /Modules/posixmodule.c
parentae39ddd628ace75e48d90e33b8aa5fd351dad24e (diff)
downloadcpython-7f591246936a5a2b763851e3cb866be44a321d50.zip
cpython-7f591246936a5a2b763851e3cb866be44a321d50.tar.gz
cpython-7f591246936a5a2b763851e3cb866be44a321d50.tar.bz2
Clarified documentation for os.access().
Patch contributed by Sean Reifschneider. Closes SF patch #570618.
Diffstat (limited to 'Modules/posixmodule.c')
-rw-r--r--Modules/posixmodule.c6
1 files changed, 5 insertions, 1 deletions
diff --git a/Modules/posixmodule.c b/Modules/posixmodule.c
index f3d951a..838e2d7 100644
--- a/Modules/posixmodule.c
+++ b/Modules/posixmodule.c
@@ -736,7 +736,11 @@ posix_do_stat(PyObject *self, PyObject *args, char *format,
PyDoc_STRVAR(posix_access__doc__,
"access(path, mode) -> 1 if granted, 0 otherwise\n\
-Test for access to a file.");
+Use the real uid/gid to test for access to a path. Note that most
+operations will use the effective uid/gid, therefore this routine can
+be used in a suid/sgid environment to test if the invoking user has the
+specified access to the path. The mode argument can be F_OK to test
+existance, or the inclusive-OR of R_OK, W_OK, and X_OK.");
static PyObject *
posix_access(PyObject *self, PyObject *args)