twisted.scripts._twistd_unix.UnixApplicationRunner

Known subclasses: twisted.test.test_twistd.CrippledApplicationRunner, twisted.test.test_twistd.StubApplicationRunnerWithSignal

An ApplicationRunner which does Unix-specific things, like fork, shed privileges, and maintain a PID file.

Method	preApplication	Do pre-application-creation setup.
Method	postApplication	To be called after the application is created: start the application and run the reactor. After the reactor stops, clean up PID files and such.
Method	removePID	Remove the specified PID file, if possible. Errors are logged, not raised.
Method	setupEnvironment	Set the filesystem root, the working directory, and daemonize.
Method	daemonize	Daemonizes the application on Unix. This is done by the usual double forking approach.
Method	shedPrivileges	Change the UID and GID or the EUID and EGID of this process.
Method	startApplication	Configure global process state based on the given application and run the application.
Method	_formatChildException	No summary
Method	_waitForStart	Wait for the daemonization success.

Inherited from ApplicationRunner:

Instance Variable	config	The config object, which provides a dict-like interface.
Instance Variable	application	Available in postApplication, but not preApplication. This is the application object.
Instance Variable	profilerFactory	Factory for creating a profiler object, able to profile the application if options are set accordingly.
Instance Variable	profiler	Instance provided by `profilerFactory`.
Instance Variable	loggerFactory	Factory for creating object responsible for logging.
Instance Variable	logger	Instance provided by `loggerFactory`.
Method	__init__	Undocumented
Method	run	Run the application.
Method	startReactor	Run the reactor with the given configuration. Subclasses should probably call this from `postApplication`.
Method	createOrGetApplication	Create or load an Application based on the parameters found in the given `ServerOptions` instance.

def preApplication(self):

overrides twisted.application.app.ApplicationRunner.preApplication

overridden in twisted.test.test_twistd.CrippledApplicationRunner, twisted.test.test_twistd.StubApplicationRunnerWithSignal

Do pre-application-creation setup.

def _formatChildException(self, exception):

Format the exception in preparation for writing to the status pipe. This does the right thing on Python 2 if the exception's message is Unicode, and in all cases limits the length of the message afte* encoding to 100 bytes.

This means the returned message may be truncated in the middle of a unicode escape.

Parameters	exception	The exception to format. (type: `Exception`)
Returns	The formatted message, suitable for writing to the status pipe. (type: `bytes`)

def postApplication(self):

overrides twisted.application.app.ApplicationRunner.postApplication

overridden in twisted.test.test_twistd.CrippledApplicationRunner, twisted.test.test_twistd.StubApplicationRunnerWithSignal

To be called after the application is created: start the application and run the reactor. After the reactor stops, clean up PID files and such.

def removePID(self, pidfile):

Remove the specified PID file, if possible. Errors are logged, not raised.

Parameters pidfile The path to the PID tracking file. (type: str)

def setupEnvironment(self, chroot, rundir, nodaemon, umask, pidfile):

Set the filesystem root, the working directory, and daemonize.

Parameters	chroot	If not None, a path to use as the filesystem root (using `os.chroot`). (type: `str` or `None`)
	rundir	The path to set as the working directory. (type: `str`)
	nodaemon	A flag which, if set, indicates that daemonization should not be done. (type: `bool`)
	umask	The value to which to change the process umask. (type: `int` or `None`)
	pidfile	If not `None`, the path to a file into which to put the PID of this process. (type: `str` or `None`)

def daemonize(self, reactor):

Daemonizes the application on Unix. This is done by the usual double forking approach.

Parameters	reactor	The reactor in use. If it provides `IReactorDaemonize`, its daemonization-related callbacks will be invoked.
Returns	A writable pipe to be used to report errors. (type: `int`)
See Also	http://code.activestate.com/recipes/278731/
	W. Richard Stevens, "Advanced Programming in the Unix Environment", 1992, Addison-Wesley, ISBN 0-201-56317-7

def _waitForStart(self, readPipe):

Wait for the daemonization success.

Parameters	readPipe	file descriptor to read start information from. (type: `int`)
Returns	code to be passed to `os._exit`: 0 for success, 1 for error. (type: `int`)

def shedPrivileges(self, euid, uid, gid):

Change the UID and GID or the EUID and EGID of this process.

Parameters	euid	A flag which, if set, indicates that only the effective UID and GID should be set. (type: `bool`)
	uid	If not `None`, the UID to which to switch. (type: `int` or `None`)
	gid	If not `None`, the GID to which to switch. (type: `int` or `None`)

def startApplication(self, application):

Configure global process state based on the given application and run the application.

Parameters application An object which can be adapted to service.IProcess and service.IService.

API Documentation for twisted, generated by pydoctor at 2020-03-25 17:34:30.

twisted.scripts._twistd_unix.UnixApplicationRunner(app.ApplicationRunner) class documentation

`twisted.scripts._twistd_unix.UnixApplicationRunner(app.ApplicationRunner)` class documentation