twisted.internet.process.PTYProcess : API documentation

Method	__init__	Spawn an operating-system process.
Method	closeStdin	Close stdin after all data has been written out.
Method	closeStdout	Close stdout.
Method	closeStderr	Close stderr.
Method	doRead	Called when my standard output stream is ready for reading.
Method	fileno	This returns the file number of standard output on this process.
Method	maybeCallProcessEnded	Call processEnded on protocol after final cleanup.
Method	connectionLost	I call this to clean up when one or all of my connections has died.
Method	writeSomeData	Write some data to the open process.
Method	_setupChild	Set up child process after `fork()` but before `exec()`.

Inherited from BaseProcess (via _BaseProcess):

Method	processEnded	This is called when the child terminates.
Method	_callProcessExited	Undocumented

Inherited from BaseProcess (via _BaseProcess):

Method	processEnded	This is called when the child terminates.
Method	_callProcessExited	Undocumented

Inherited from BaseProcess (via _BaseProcess):

Method	processEnded	This is called when the child terminates.
Method	_callProcessExited	Undocumented

Inherited from BaseProcess (via _BaseProcess):

Method	processEnded	This is called when the child terminates.
Method	_callProcessExited	Undocumented

Inherited from BaseProcess (via _BaseProcess):

Method	processEnded	This is called when the child terminates.
Method	_callProcessExited	Undocumented

def __init__(self, reactor, executable, args, environment, path, proto, uid=None, gid=None, usePTY=None): (source)

overrides twisted.internet.abstract.FileDescriptor.__init__

Spawn an operating-system process.

This is where the hard work of disconnecting all currently open files / forking / executing the new process happens. (This is executed automatically when a Process is instantiated.)

This will also run the subprocess as a given user ID and group ID, if specified. (Implementation Note: this doesn't support all the arcane nuances of setXXuid on UNIX: it will assume that either your effective or real UID is 0.)

def _setupChild(self, masterfd, slavefd): (source)

overrides twisted.internet.process._BaseProcess._setupChild

Set up child process after fork() but before exec().

This involves:

closing masterfd, since it is not used in the subprocess
creating a new session with os.setsid
changing the controlling terminal of the process (and the new session) to point at slavefd
duplicating slavefd to standard input, output, and error
closing all other open file descriptors (according to _listOpenFDs)
re-setting all signal handlers to SIG_DFL

Parameters	masterfd	The master end of a PTY file descriptors opened with `openpty`. (type: `int`)
	slavefd	The slave end of a PTY opened with `openpty`. (type: `int`)