Issue #23836: Document functions releasing the GIL in fileutils.c

This commit is contained in:
Victor Stinner 2015-04-01 18:34:32 +02:00
parent 82c3e4599d
commit 6f4fae8a95

View File

@ -667,7 +667,8 @@ _Py_fstat_noraise(int fd, struct _Py_stat_struct *status)
error on error. On POSIX, set errno on error. Fill status and return 0 on error on error. On POSIX, set errno on error. Fill status and return 0 on
success. success.
The GIL must be held. */ Release the GIL to call GetFileType() and GetFileInformationByHandle(), or
to call fstat(). The caller must hold the GIL. */
int int
_Py_fstat(int fd, struct _Py_stat_struct *status) _Py_fstat(int fd, struct _Py_stat_struct *status)
{ {
@ -968,7 +969,7 @@ _Py_open_impl(const char *pathname, int flags, int gil_held)
When interrupted by a signal (open() fails with EINTR), retry the syscall, When interrupted by a signal (open() fails with EINTR), retry the syscall,
except if the Python signal handler raises an exception. except if the Python signal handler raises an exception.
The GIL must be held. */ Release the GIL to call open(). The caller must hold the GIL. */
int int
_Py_open(const char *pathname, int flags) _Py_open(const char *pathname, int flags)
{ {
@ -1054,7 +1055,8 @@ _Py_fopen(const char *pathname, const char *mode)
When interrupted by a signal (open() fails with EINTR), retry the syscall, When interrupted by a signal (open() fails with EINTR), retry the syscall,
except if the Python signal handler raises an exception. except if the Python signal handler raises an exception.
The GIL must be held. */ Release the GIL to call _wfopen() or fopen(). The caller must hold
the GIL. */
FILE* FILE*
_Py_fopen_obj(PyObject *path, const char *mode) _Py_fopen_obj(PyObject *path, const char *mode)
{ {