bpo-29707: Document that os.path.ismount() is not able to reliable detect bind mounts. (GH-11238)

This commit is contained in:
Serhiy Storchaka 2019-01-15 10:55:40 +02:00 committed by GitHub
parent efcf82f945
commit 32ebd8508d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 3 deletions

View File

@ -283,10 +283,11 @@ the :mod:`glob` module.)
Return ``True`` if pathname *path* is a :dfn:`mount point`: a point in a 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 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 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 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 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 always mount points, and for any other path ``GetVolumePathName`` is called
to see if it is different from the input path. to see if it is different from the input path.