From ccf0efbb21f6bbf6efd5f8cb560fed11079ce1a2 Mon Sep 17 00:00:00 2001 From: Victor Stinner Date: Wed, 5 Jun 2019 12:24:52 +0200 Subject: [PATCH] bpo-26836: Document os.memfd_create() name parameter (GH-13838) https://bugs.python.org/issue26836 --- Doc/library/os.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Doc/library/os.rst b/Doc/library/os.rst index 107764ba4d..f0df35e9dd 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 `. + 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 -- 2.40.0