summaryrefslogtreecommitdiffstats
path: root/Doc/library/os.rst
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2012-06-24 10:38:14 (GMT)
committerGeorg Brandl <georg@python.org>2012-06-24 10:38:14 (GMT)
commitb9df00cc009e6593ac7914af2755b835f98934ea (patch)
tree40f6243c7cd89e1ec73a93666fcec2a3b3248b88 /Doc/library/os.rst
parentdd7987382d538ef7d9e90dacaee422f1a414060e (diff)
downloadcpython-b9df00cc009e6593ac7914af2755b835f98934ea.zip
cpython-b9df00cc009e6593ac7914af2755b835f98934ea.tar.gz
cpython-b9df00cc009e6593ac7914af2755b835f98934ea.tar.bz2
Note that equivalents are valid for 3.3+ only.
Diffstat (limited to 'Doc/library/os.rst')
-rw-r--r--Doc/library/os.rst36
1 files changed, 20 insertions, 16 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index e185e47..6a5d54c 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -678,9 +678,9 @@ as internal buffering of data.
.. function:: fchmod(fd, mode)
- Change the mode of the file given by *fd* to the numeric *mode*. See the docs
- for :func:`chmod` for possible values of *mode*.
- Equivalent to ``os.chmod(fd, mode)``.
+ Change the mode of the file given by *fd* to the numeric *mode*. See the
+ docs for :func:`chmod` for possible values of *mode*. From Python 3.3, this
+ is equivalent to ``os.chmod(fd, mode)``.
Availability: Unix.
@@ -688,8 +688,9 @@ as internal buffering of data.
.. function:: fchown(fd, uid, gid)
Change the owner and group id of the file given by *fd* to the numeric *uid*
- and *gid*. To leave one of the ids unchanged, set it to -1. Equivalent
- to ``os.chown(fd, uid, gid)``.
+ and *gid*. To leave one of the ids unchanged, set it to -1. See
+ :func:`chown`. From Python 3.3, this is equivalent to ``os.chown(fd, uid,
+ gid)``.
Availability: Unix.
@@ -725,15 +726,17 @@ as internal buffering of data.
.. function:: fstat(fd)
- Return status for file descriptor *fd*, like :func:`~os.stat`.
+ Return status for file descriptor *fd*, like :func:`~os.stat`. From Python
+ 3.3, this is equivalent to ``os.stat(fd)``.
Availability: Unix, Windows.
.. function:: fstatvfs(fd)
- Return information about the filesystem containing the file associated with file
- descriptor *fd*, like :func:`statvfs`.
+ Return information about the filesystem containing the file associated with
+ file descriptor *fd*, like :func:`statvfs`. From Python 3.3, this is
+ equivalent to ``os.statvfs(fd)``.
Availability: Unix.
@@ -1309,7 +1312,7 @@ features:
Change the current working directory to the directory represented by the file
descriptor *fd*. The descriptor must refer to an opened directory, not an
- open file. Equivalent to ``os.chdir(fd)``.
+ open file. From Python 3.3, this is equivalent to ``os.chdir(fd)``.
Availability: Unix.
@@ -1425,8 +1428,8 @@ features:
.. function:: lchflags(path, flags)
Set the flags of *path* to the numeric *flags*, like :func:`chflags`, but do
- not follow symbolic links. Equivalent to ``os.chflags(path, flags,
- follow_symlinks=False)``.
+ not follow symbolic links. From Python 3.3, this is equivalent to
+ ``os.chflags(path, flags, follow_symlinks=False)``.
Availability: Unix.
@@ -1435,8 +1438,8 @@ features:
Change the mode of *path* to the numeric *mode*. If path is a symlink, this
affects the symlink rather than the target. See the docs for :func:`chmod`
- for possible values of *mode*. Equivalent to ``os.chmod(path, mode,
- follow_symlinks=False)``.
+ for possible values of *mode*. From Python 3.3, this is equivalent to
+ ``os.chmod(path, mode, follow_symlinks=False)``.
Availability: Unix.
@@ -1444,8 +1447,8 @@ features:
.. function:: lchown(path, uid, gid)
Change the owner and group id of *path* to the numeric *uid* and *gid*. This
- function will not follow symbolic links. Equivalent to ``os.chown(path, uid,
- gid, follow_symlinks=False)``.
+ function will not follow symbolic links. From Python 3.3, this is equivalent
+ to ``os.chown(path, uid, gid, follow_symlinks=False)``.
Availability: Unix.
@@ -1502,7 +1505,8 @@ features:
Perform the equivalent of an :c:func:`lstat` system call on the given path.
Similar to :func:`~os.stat`, but does not follow symbolic links. On
platforms that do not support symbolic links, this is an alias for
- :func:`~os.stat`. (Equivalent to ``os.stat(path, follow_symlinks=False)``.)
+ :func:`~os.stat`. From Python 3.3, this is equivalent to ``os.stat(path,
+ dir_fd=dir_fd, follow_symlinks=False)``.
This function can also support :ref:`paths relative to directory descriptors
<dir_fd>`.