summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSerhiy Storchaka <storchaka@gmail.com>2019-01-15 08:55:40 (GMT)
committerGitHub <noreply@github.com>2019-01-15 08:55:40 (GMT)
commit32ebd8508d4807a7c85d2ed8e9c3b44ecd6de591 (patch)
treeba2acc5352da36d4ba3b99e5c0a5a397eeff1cc3
parentefcf82f94572abcdbd70336e0b2c3d0f4df280bc (diff)
downloadcpython-32ebd8508d4807a7c85d2ed8e9c3b44ecd6de591.zip
cpython-32ebd8508d4807a7c85d2ed8e9c3b44ecd6de591.tar.gz
cpython-32ebd8508d4807a7c85d2ed8e9c3b44ecd6de591.tar.bz2
bpo-29707: Document that os.path.ismount() is not able to reliable detect bind mounts. (GH-11238)
-rw-r--r--Doc/library/os.path.rst7
1 files changed, 4 insertions, 3 deletions
diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index 23194ae..ebbf63c 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -283,10 +283,11 @@ the :mod:`glob` module.)
Return ``True`` if pathname *path* is a :dfn:`mount point`: a point in a
file system where a different file system has been mounted. On POSIX, the
- function checks whether *path*'s parent, :file:`path/..`, is on a different
- device than *path*, or whether :file:`path/..` and *path* point to the same
+ function checks whether *path*'s parent, :file:`{path}/..`, is on a different
+ device than *path*, or whether :file:`{path}/..` and *path* point to the same
i-node on the same device --- this should detect mount points for all Unix
- and POSIX variants. On Windows, a drive letter root and a share UNC are
+ and POSIX variants. It is not able to reliably detect bind mounts on the
+ same filesystem. On Windows, a drive letter root and a share UNC are
always mount points, and for any other path ``GetVolumePathName`` is called
to see if it is different from the input path.