diff options
author | Antoine Pitrou <solipsis@pitrou.net> | 2012-01-24 08:05:18 (GMT) |
---|---|---|
committer | Antoine Pitrou <solipsis@pitrou.net> | 2012-01-24 08:05:18 (GMT) |
commit | 91ecea24f53b99aa190f6b17c2b51d95cb09d233 (patch) | |
tree | 223a4b5fa95e535f8fa16560cea1eaa748e8ef7d /Doc/library/os.rst | |
parent | 09406023a8c19febb3358008ddeabe4450c21b79 (diff) | |
parent | 5311c1d7ab24f862b9b0bb272a9aee9c4f4ac023 (diff) | |
download | cpython-91ecea24f53b99aa190f6b17c2b51d95cb09d233.zip cpython-91ecea24f53b99aa190f6b17c2b51d95cb09d233.tar.gz cpython-91ecea24f53b99aa190f6b17c2b51d95cb09d233.tar.bz2 |
Issue #13772: In os.symlink() under Windows, do not try to guess the link
target's type (file or directory). The detection was buggy and made the
call non-atomic (therefore prone to race conditions).
Diffstat (limited to 'Doc/library/os.rst')
-rw-r--r-- | Doc/library/os.rst | 9 |
1 files changed, 3 insertions, 6 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 0c0d681..3c302a4 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -2085,11 +2085,9 @@ Files and Directories *target_is_directory*, which defaults to ``False``. On Windows, a symlink represents a file or a directory, and does not morph to - the target dynamically. For this reason, when creating a symlink on Windows, - if the target is not already present, the symlink will default to being a - file symlink. If *target_is_directory* is set to ``True``, the symlink will - be created as a directory symlink. This parameter is ignored if the target - exists (and the symlink is created with the same type as the target). + the target dynamically. If *target_is_directory* is set to ``True``, the + symlink will be created as a directory symlink, otherwise as a file symlink + (the default). Symbolic link support was introduced in Windows 6.0 (Vista). :func:`symlink` will raise a :exc:`NotImplementedError` on Windows versions earlier than 6.0. @@ -2102,7 +2100,6 @@ Files and Directories administrator level. Either obtaining the privilege or running your application as an administrator are ways to successfully create symlinks. - :exc:`OSError` is raised when the function is called by an unprivileged user. |