]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
gh-107959: clarify Unix-availability of `os.lchmod()` (GH-107960)
authorChristoph Anton Mitterer <mail@christoph.anton.mitterer.name>
Wed, 13 Dec 2023 19:55:31 +0000 (20:55 +0100)
committerGitHub <noreply@github.com>
Wed, 13 Dec 2023 19:55:31 +0000 (21:55 +0200)
commitf14e3d59c955fb3cf89e5241727ec566164dcf42
treec2966ead389d634e28a21f265464d8b815574687
parent85923cb377c4a13720c135da9ae3ed93465a81e7
gh-107959: clarify Unix-availability of `os.lchmod()` (GH-107960)

POSIX specifies that implementations are not required to support changing the
file mode of symbolic links, but may do so.
Consequently, `lchmod()` is not part of POSIX (but mentioned for implementations
which do support the above).

The current wording of the availability of `os.lchmod()` is rather vague and
improved to clearly tell which POSIX/Unix/BSD-like support the function in
general (those that support changing the file mode of symbolic links).
Further, some examples of major implementations are added.

Data for the BSDs taken from their online manpages.

Signed-off-by: Christoph Anton Mitterer <mail@christoph.anton.mitterer.name>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Doc/library/os.rst