diff options
| author | Antoine Pitrou <solipsis@pitrou.net> | 2012-01-24 07:59:28 (GMT) |
|---|---|---|
| committer | Antoine Pitrou <solipsis@pitrou.net> | 2012-01-24 07:59:28 (GMT) |
| commit | 5311c1d7ab24f862b9b0bb272a9aee9c4f4ac023 (patch) | |
| tree | aef57f35c7e9b616acf4597f63a8165e0d55491f /Doc/library/os.rst | |
| parent | 3b65fd7e9784967567e66bd67e9205cbb0d53d3a (diff) | |
| download | cpython-5311c1d7ab24f862b9b0bb272a9aee9c4f4ac023.zip cpython-5311c1d7ab24f862b9b0bb272a9aee9c4f4ac023.tar.gz cpython-5311c1d7ab24f862b9b0bb272a9aee9c4f4ac023.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 df9a6b6..be322a0 100644 --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -1429,11 +1429,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. @@ -1446,7 +1444,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. |