[Python-checkins] cpython (merge 3.2 -> default): Issue #10433: merge
ned.deily
python-checkins at python.org
Mon Apr 30 20:16:23 CEST 2012
http://hg.python.org/cpython/rev/e7d545a5f6bc
changeset: 76674:e7d545a5f6bc
parent: 76671:6e541ed4e987
parent: 76673:5c801899cd6d
user: Ned Deily <nad at acm.org>
date: Mon Apr 30 11:15:38 2012 -0700
summary:
Issue #10433: merge
files:
Doc/library/os.rst | 18 ++++++++++++++++++
1 files changed, 18 insertions(+), 0 deletions(-)
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -238,6 +238,20 @@
Availability: Unix.
+ .. note:: On Mac OS X, :func:`getgroups` behavior differs somewhat from
+ other Unix platforms. If the Python interpreter was built with a
+ deployment target of :const:`10.5` or earlier, :func:`getgroups` returns
+ the list of effective group ids associated with the current user process;
+ this list is limited to a system-defined number of entries, typically 16,
+ and may be modified by calls to :func:`setgroups` if suitably privileged.
+ If built with a deployment target greater than :const:`10.5`,
+ :func:`getgroups` returns the current group access list for the user
+ associated with the effective user id of the process; the group access
+ list may change over the lifetime of the process, it is not affected by
+ calls to :func:`setgroups`, and its length is not limited to 16. The
+ deployment target value, :const:`MACOSX_DEPLOYMENT_TARGET`, can be
+ obtained with :func:`sysconfig.get_config_var`.
+
.. function:: initgroups(username, gid)
@@ -425,6 +439,10 @@
Availability: Unix.
+ .. note:: On Mac OS X, the length of *groups* may not exceed the
+ system-defined maximum number of effective group ids, typically 16.
+ See the documentation for :func:`getgroups` for cases where it may not
+ return the same group list set by calling setgroups().
.. function:: setpgrp()
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list