summaryrefslogtreecommitdiffstats
path: root/Doc/library/os.rst
diff options
context:
space:
mode:
authorVidar Tonaas Fauske <vidartf@gmail.com>2019-04-09 18:19:46 (GMT)
committerSteve Dower <steve.dower@microsoft.com>2019-04-09 18:19:46 (GMT)
commit0e10766574f4e287cd6b5e5860a1ca75488f4119 (patch)
tree6f501fe8daeaa226bf61905cbeebfd8dfad4f149 /Doc/library/os.rst
parent8709490f48fc27b3dd1a16acb33bea2299c6a575 (diff)
downloadcpython-0e10766574f4e287cd6b5e5860a1ca75488f4119.zip
cpython-0e10766574f4e287cd6b5e5860a1ca75488f4119.tar.gz
cpython-0e10766574f4e287cd6b5e5860a1ca75488f4119.tar.bz2
bpo-31512: Add non-elevated symlink support for Windows (GH-3652)
Diffstat (limited to 'Doc/library/os.rst')
-rw-r--r--Doc/library/os.rst15
1 files changed, 7 insertions, 8 deletions
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 85e240a..f3b5d96 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2699,19 +2699,15 @@ features:
as a directory if *target_is_directory* is ``True`` or a file symlink (the
default) otherwise. On non-Windows platforms, *target_is_directory* is ignored.
- Symbolic link support was introduced in Windows 6.0 (Vista). :func:`symlink`
- will raise a :exc:`NotImplementedError` on Windows versions earlier than 6.0.
-
This function can support :ref:`paths relative to directory descriptors
<dir_fd>`.
.. note::
- On Windows, the *SeCreateSymbolicLinkPrivilege* is required in order to
- successfully create symlinks. This privilege is not typically granted to
- regular users but is available to accounts which can escalate privileges
- to the administrator level. Either obtaining the privilege or running your
- application as an administrator are ways to successfully create symlinks.
+ On newer versions of Windows 10, unprivileged accounts can create symlinks
+ if Developer Mode is enabled. When Developer Mode is not available/enabled,
+ the *SeCreateSymbolicLinkPrivilege* privilege is required, or the process
+ must be run as an administrator.
:exc:`OSError` is raised when the function is called by an unprivileged
@@ -2729,6 +2725,9 @@ features:
.. versionchanged:: 3.6
Accepts a :term:`path-like object` for *src* and *dst*.
+ .. versionchanged:: 3.8
+ Added support for unelevated symlinks on Windows with Developer Mode.
+
.. function:: sync()