:right-sidebar: True

SubprocessFlags
===================================================================

.. currentmodule:: gi.repository.Gio


.. versionadded:: 2.40




.. class:: SubprocessFlags
   :no-contents-entry:






Flags to define the behaviour of a :obj:`~gi.repository.Gio.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 :const:`~gi.repository.Gio.SubprocessFlags.STDOUT_PIPE` and
:const:`~gi.repository.Gio.SubprocessFlags.STDOUT_SILENCE`.













Fields
------

.. rst-class:: interim-class

.. class:: SubprocessFlags
   :no-index:
   

   .. attribute:: 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).







   .. attribute:: NONE

      No flags.







   .. attribute:: SEARCH_PATH_FROM_ENVP

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







   .. attribute:: 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.







   .. attribute:: STDERR_PIPE

      Create a pipe for the stderr of the
      spawned process that can be accessed with
      :func:`~gi.repository.Gio.Subprocess.get_stderr_pipe`.







   .. attribute:: STDERR_SILENCE

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







   .. attribute:: STDIN_INHERIT

      Stdin is inherited from the
      calling process.







   .. attribute:: STDIN_PIPE

      Create a pipe for the stdin of the
      spawned process that can be accessed with
      :func:`~gi.repository.Gio.Subprocess.get_stdin_pipe`.







   .. attribute:: STDOUT_PIPE

      Create a pipe for the stdout of the
      spawned process that can be accessed with
      :func:`~gi.repository.Gio.Subprocess.get_stdout_pipe`.







   .. attribute:: STDOUT_SILENCE

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