[Python-checkins] bpo-26836: Document os.memfd_create() name parameter (GH-13838) (GH-13839)

[Victor Stinner]

https://github.com/python/cpython/commit/b496c2672131ea51a55b5a414aeda271562f18d3
commit: b496c2672131ea51a55b5a414aeda271562f18d3
branch: 3.8
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Victor Stinner <vstinner at redhat.com>
date: 2019-06-05T13:16:00+02:00
summary:

bpo-26836: Document os.memfd_create() name parameter (GH-13838) (GH-13839)

https://bugs.python.org/issue26836
(cherry picked from commit ccf0efbb21f6bbf6efd5f8cb560fed11079ce1a2)

Co-authored-by: Victor Stinner <vstinner at redhat.com>

files:
M Doc/library/os.rst

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 107764ba4d53..f0df35e9ddd5 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -3011,6 +3011,13 @@ features:
    (or a bitwise ORed combination of them).  By default, the new file
    descriptor is :ref:`non-inheritable <fd_inheritance>`.
 
+   The name supplied in *name* is used as a filename and will be displayed as
+   the target of the corresponding symbolic link in the directory
+   ``/proc/self/fd/``. The displayed name is always prefixed with ``memfd:``
+   and serves only for debugging purposes. Names do not affect the behavior of
+   the file descriptor, and as such multiple files can have the same name
+   without any side effects.
+
    .. availability:: Linux 3.17 or newer with glibc 2.27 or newer.
 
    .. versionadded:: 3.8