gspawn: document FD_CLOEXEC behaviour

G_SPAWN_LEAVE_DESCRIPTORS_OPEN must be set to enable the optimized
posix_spawn codepath, so this flag is likely to see more usage now.

Document that FD_CLOEXEC can be used to cause file descriptors to be
automatically closed while this flag is used.
This commit is contained in:
Daniel Drake
2018-06-13 13:41:53 -06:00
parent 156d009696
commit 86e2b8d427

View File

@@ -638,10 +638,11 @@ g_spawn_sync (const gchar *working_directory,
* is equivalent to calling CloseHandle() on the process handle returned * is equivalent to calling CloseHandle() on the process handle returned
* in @child_pid). See g_child_watch_add(). * in @child_pid). See g_child_watch_add().
* *
* %G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that the parent's open file * Open UNIX file descriptors marked as `FD_CLOEXEC` will be automatically
* descriptors will be inherited by the child; otherwise all descriptors * closed in the child process. %G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that
* except stdin/stdout/stderr will be closed before calling exec() in * other open file descriptors will be inherited by the child; otherwise all
* the child. %G_SPAWN_SEARCH_PATH means that @argv[0] need not be an * descriptors except stdin/stdout/stderr will be closed before calling exec()
* in the child. %G_SPAWN_SEARCH_PATH means that @argv[0] need not be an
* absolute path, it will be looked for in the `PATH` environment * absolute path, it will be looked for in the `PATH` environment
* variable. %G_SPAWN_SEARCH_PATH_FROM_ENVP means need not be an * variable. %G_SPAWN_SEARCH_PATH_FROM_ENVP means need not be an
* absolute path, it will be looked for in the `PATH` variable from * absolute path, it will be looked for in the `PATH` variable from