SubprocessFlags

Added in version 2.40.

class SubprocessFlags

Flags to define the behaviour of a Subprocess.

Note that the default for stdin is to redirect from /dev/null. For stdout and stderr the default are for them to inherit the corresponding descriptor from the calling process.

Note that it is a programmer error to mix ‘incompatible’ flags. For example, you may not request both STDOUT_PIPE and STDOUT_SILENCE.

Fields

class SubprocessFlags

INHERIT_FDS

Spawned processes will inherit the file descriptors of their parent, unless those descriptors have been explicitly marked as close-on-exec. This flag has no effect over the “standard” file descriptors (stdin, stdout, stderr).

NONE

No flags.

SEARCH_PATH_FROM_ENVP

If path searching is needed when spawning the subprocess, use the PATH in the launcher environment. (Since: 2.72)

STDERR_MERGE

Merge the stderr of the spawned process with whatever the stdout happens to be. This is a good way of directing both streams to a common log file, for example.

STDERR_PIPE

Create a pipe for the stderr of the spawned process that can be accessed with get_stderr_pipe().

STDERR_SILENCE

Silence the stderr of the spawned process (ie: redirect to /dev/null).

STDIN_INHERIT

Stdin is inherited from the calling process.

STDIN_PIPE

Create a pipe for the stdin of the spawned process that can be accessed with get_stdin_pipe().

STDOUT_PIPE

Create a pipe for the stdout of the spawned process that can be accessed with get_stdout_pipe().

STDOUT_SILENCE

Silence the stdout of the spawned process (ie: redirect to /dev/null).