Lines Matching +full:qemu +full:- +full:consistency
1 :mod:`subprocess` --- Subprocess management
12 --------------
26 :pep:`324` -- PEP proposing the subprocess module
28 .. include:: ../includes/wasm-notavail.rst
31 ----------------------------------
47 in :ref:`frequently-used-arguments` (hence the use of keyword-only notation
49 same as that of the :class:`Popen` constructor - most of the arguments to
62 :exc:`TimeoutExpired` exception will be re-raised after the child process
71 If *check* is true, and the process exits with a non-zero exit code, a
91 >>> subprocess.run(["ls", "-l"]) # doesn't capture output
92 CompletedProcess(args=['ls', '-l'], returncode=0)
97 subprocess.CalledProcessError: Command 'exit 1' returned non-zero exit status 1
99 >>> subprocess.run(["ls", "-l", "/dev/null"], capture_output=True)
100 CompletedProcess(args=['ls', '-l', '/dev/null'], returncode=0,
101 stdout=b'crw-rw-rw- 1 root root 1, 3 Jan 23 16:23 /dev/null\n', stderr=b'')
135 A negative value ``-N`` indicates that the child was terminated by signal
156 If :attr:`returncode` is non-zero, raise a :exc:`CalledProcessError`.
231 returns a non-zero exit status.
261 .. _frequently-used-arguments:
327 implementations of many shell-like features (in particular, :mod:`glob`,
354 .. class:: Popen(args, bufsize=-1, executable=None, stdin=None, stdout=None, \
359 extra_groups=None, user=None, umask=-1, \
360 encoding=None, errors=None, text=None, pipesize=-1, \
364 :meth:`os.execvpe`-like behavior to execute the child program. On Windows,
369 or :term:`path-like object`.
372 platform-dependent and described below. See the *shell* and *executable*
382 and use the ``-m`` command-line format to launch an installed module.
398 Popen(["/usr/bin/git", "commit", "-m", "Fixes a bug."])
412 /bin/vikings -input eggs.txt -output "spam spam.txt" -cmd "echo '$MONEY'"
415 ['/bin/vikings', '-input', 'eggs.txt', '-output', 'spam spam.txt', '-cmd', "echo '$MONEY'"]
418 Note in particular that options (such as *-input*) and arguments (such
425 manner described in :ref:`converting-argument-sequence`. This is because
429 *args* parameter accepts a :term:`path-like object` if *shell* is
430 ``False`` and a sequence containing path-like objects on POSIX.
433 *args* parameter accepts a :term:`path-like object` if *shell* is
434 ``False`` and a sequence containing bytes and path-like objects
450 Popen(['/bin/sh', '-c', args[0], args[1], ...])
456 ``shell=True`` to run a batch file or console-based executable.
466 - :const:`0` means unbuffered (read and write are one
468 - :const:`1` means line buffered
470 - any other positive value means use a buffer of approximately that
472 - negative bufsize (the default) means the system default of
476 *bufsize* now defaults to -1 to enable buffering by default to match the
493 *executable* parameter accepts a :term:`path-like object` on POSIX.
496 *executable* parameter accepts a bytes and :term:`path-like object`
570 :term:`path-like <path-like object>` object. On POSIX, the function
575 *cwd* parameter accepts a :term:`path-like object` on POSIX.
578 *cwd* parameter accepts a :term:`path-like object` on Windows.
598 If *process_group* is a non-negative integer, the ``setpgid(0, value)`` system call will
647 execute. On Windows, in order to run a `side-by-side assembly`_ the
650 .. _side-by-side assembly: https://en.wikipedia.org/wiki/Side-by-Side_Assembly
654 *encoding* and *errors*, as described above in :ref:`frequently-used-arguments`.
696 .. audit-event:: subprocess.Popen executable,args,cwd,env subprocess.Popen
712 performance. On Windows Subsystem for Linux and QEMU User Emulation,
715 with a non-zero :attr:`~Popen.returncode`.
722 execute, will be re-raised in the parent.
725 when trying to execute a non-existent file. Applications should prepare for
735 :exc:`CalledProcessError` if the called process returns a non-zero return
747 .. _subprocess-security:
750 -----------------------
759 vulnerabilities. On :ref:`some platforms <shlex-quote-warning>`, it is possible
764 -------------
793 The function is implemented using a busy loop (non-blocking call and
803 until end-of-file is reached. Wait for process to terminate and set the
823 cleanup properly a well-behaved application should kill the child process and
873 The *args* argument as it was passed to :class:`Popen` -- a
931 A negative value ``-N`` indicates that the child was terminated by signal
936 ---------------------
945 `STARTUPINFO <https://msdn.microsoft.com/en-us/library/ms686331(v=vs.85).aspx>`__
947 be set by passing them as keyword-only arguments.
950 Keyword-only argument support was added.
985 `ShowWindow <https://msdn.microsoft.com/en-us/library/ms633548(v=vs.85).aspx>`__
996 …`UpdateProcThreadAttribute <https://msdn.microsoft.com/en-us/library/windows/desktop/ms686880(v=vs…
1002 non-empty.
1146 .. _call-function-trio:
1148 Older high-level API
1149 --------------------
1169 same as that of the :class:`Popen` constructor - this function passes all
1209 same as that of the :class:`Popen` constructor - this function passes all
1238 If the return code was non-zero it raises a :exc:`CalledProcessError`. The
1248 The full function signature is largely the same as that of :func:`run` -
1260 :ref:`frequently-used-arguments` and :func:`run`.
1294 .. _subprocess-replacements:
1297 -----------------------------------------------------------
1308 :exc:`CalledProcessError` if the requested operation produces a non-zero
1319 .. code-block:: bash
1330 .. code-block:: bash
1347 .. code-block:: bash
1380 print("Child was terminated by signal", -retcode, file=sys.stderr)
1501 ---------------------------------
1506 handling consistency are valid for these functions.
1513 return a 2-tuple ``(exitcode, output)``.
1515 see the notes on :ref:`frequently-used-arguments` for more details.
1528 (-15, '')
1562 -----
1564 .. _converting-argument-sequence:
1616 subprocess._USE_VFORK = False # See CPython issue gh-NNNNNN.
1625 subprocess._USE_POSIX_SPAWN = False # See CPython issue gh-NNNNNN.