twisted.internet.interfaces.IReactorProcess(Interface)
interface documentationtwisted.internet.interfaces
View Source
(View In Hierarchy)
Known implementations: twisted.internet.iocpreactor.reactor.IOCPReactor, twisted.internet.posixbase.PosixReactorBase
Method | spawnProcess | Spawn a process, with a process protocol. |
Spawn a process, with a process protocol.
Arguments given to this function that are listed as bytes
or unicode
may be encoded or decoded depending on the platform and the argument type
given. On UNIX systems (Linux, FreeBSD, macOS) and Python 2 on Windows, unicode
arguments will be encoded down to bytes
using the encoding given by os.getfilesystemencoding
,
to be used with the "narrow" OS APIs. On Python 3 on Windows, bytes
arguments will be decoded up to unicode
using the encoding given by os.getfilesystemencoding
(mbcs
before Python 3.6, utf8
thereafter) and
given to Windows's native "wide" APIs.
Parameters | processProtocol | An object which will be notified of all events related to the created
process. (type: IProcessProtocol
provider) |
executable | the file name to spawn - the full path should be used. (type: bytes
or unicode ) | |
args | the command line arguments to pass to the process; a sequence of strings.
The first string should be the executable's name. (type: list
with bytes
or unicode
items.) | |
env | the environment variables to pass to the child process. The resulting
behavior varies between platforms. If:
dict
mapping bytes /unicode
keys to bytes /unicode
items, or None .) | |
path | the path to run the subprocess in - defaults to the current directory. (type: bytes
or unicode
or None ) | |
uid | user ID to run the subprocess as. (Only available on POSIX systems.) | |
gid | group ID to run the subprocess as. (Only available on POSIX systems.) | |
usePTY | if true, run this process in a pseudo-terminal. optionally a tuple of
(masterfd, slavefd, ttyname) , in which case use those file
descriptors. (Not available on all systems.) | |
childFDs | A dictionary mapping file descriptors in the new child process to an
integer or to the string 'r' or 'w'.
If the value is an integer, it specifies a file descriptor in the parent process which will be mapped to a file descriptor (specified by the key) in the child process. This is useful for things like inetd and shell-like file redirection. If it is the string 'r', a pipe will be created and attached to the
child at that file descriptor: the child will be able to write to that file
descriptor and the parent will receive read notification via the If it is the string 'w', similar setup to the previous case will occur,
with the pipe being readable by the child instead of writeable. The parent
process can write to that file descriptor using If childFDs is not passed, the default behaviour is to use a mapping that opens the usual stdin/stdout/stderr pipes. (type:dict
of int
to int
or str ) | |
Returns | An object which provides IProcessTransport . | |
Raises | OSError | Raised with errno EAGAIN or ENOMEM if there are
insufficient system resources to create a new process. |
See Also | twisted.internet.protocol.ProcessProtocol |