twistd-man.html   [plain text]


<?xml version="1.0"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><title>Twisted Documentation: TWISTD.1</title><link href="../howto/stylesheet.css" type="text/css" rel="stylesheet" /></head><body bgcolor="white"><h1 class="title">TWISTD.1</h1><div class="toc"><ol><li><a href="#auto0">NAME</a></li><li><a href="#auto1">SYNOPSIS</a></li><li><a href="#auto2">DESCRIPTION</a></li><li><a href="#auto3">AUTHOR</a></li><li><a href="#auto4">REPORTING BUGS</a></li><li><a href="#auto5">COPYRIGHT</a></li><li><a href="#auto6">SEE ALSO</a></li></ol></div><div class="content"><span></span><h2>NAME<a name="auto0"></a></h2><p>twistd - run Twisted applications (TACs, TAPs)
</p><h2>SYNOPSIS<a name="auto1"></a></h2><p><strong>twistd</strong> [options]
</p><h2>DESCRIPTION<a name="auto2"></a></h2><p>Read an twisted.application.service.Application out of a file and runs it.
</p><dl><dt><strong>-n</strong>, <strong>--nodaemon</strong></dt><dd>Don't daemonize (stay in foreground)
</dd><dt><strong>-q</strong>, <strong>--quiet</strong></dt><dd>be a little more quiet
</dd><dt><strong>-p</strong>, <strong>--profile</strong></dt><dd>Run profiler
</dd><dt><strong>-b</strong>, <strong>--debug</strong></dt><dd>Run the application in the Python Debugger (implies nodaemon option).
Sending a SIGUSR2 signal to the process will drop it into the debugger.
</dd><dt><strong>-o</strong>, <strong>--no_save</strong></dt><dd>Do not save shutdown state
</dd><dt><strong>--originalname</strong></dt><dd>Behave as though the specified Application has no process name set, and run
with the standard process name (the python binary in most cases).
</dd><dt><strong>-l</strong>, <strong>--logfile</strong><em>&lt;logfile&gt;</em></dt><dd>Log to a specified file, - for stdout (default twistd.log).
The log file will be rotated on SIGUSR1.
</dd><dt><strong>--pidfile</strong><em>&lt;pidfile&gt;</em></dt><dd>Save pid in specified file (default twistd.pid)
</dd><dt><strong>--chroot</strong><em>&lt;directory&gt;</em></dt><dd>Chroot to a supplied directory before running (default -- don't chroot).
Chrooting is done before changing the current directory.
</dd><dt><strong>-d</strong>, <strong>--rundir</strong><em>&lt;directory&gt;</em></dt><dd>Change to a supplied directory before running (default .)
</dd><dt><strong>-r</strong>, <strong>--reactor</strong><em>&lt;reactor&gt;</em></dt><dd>Choose which ReactorCore event loop to use, such as 'poll' or 'gtk'.
</dd><dt><strong>--spew</strong></dt><dd>Write an extremely verbose log of everything that happens.  Useful for
debugging freezes or locks in complex code.
</dd><dt><strong>-f</strong>, <strong>--file</strong><em>&lt;tap file&gt;</em></dt><dd>Read the given .tap file (default twistd.tap)
</dd><dt><strong>-x</strong>, <strong>--xml</strong><em>&lt;tax file&gt;</em></dt><dd>Load an Application from the given .tax (XML) file.
</dd><dt><strong>-s</strong>, <strong>--source</strong><em>&lt;tas file&gt;</em></dt><dd>Load an Application from the given .tas (AOT Python source) file.
</dd><dt><strong>-y</strong>, <strong>--python</strong><em>&lt;python file&gt;</em></dt><dd>Use the variable <q>application</q> from the given Python
file. This setting, if given, overrides <strong>-f</strong>.
</dd><dt><strong>-g</strong>, <strong>--plugin</strong><em>&lt;plugin name&gt;</em></dt><dd>Read config.tac from a plugin package, as with <strong>-y</strong>.
</dd><dt><strong>--syslog</strong></dt><dd>Log to syslog, not to file.
</dd><dt><strong>--prefix</strong><em>&lt;prefix&gt;</em></dt><dd>Use the specified prefix when logging to logfile. Default is <q>twisted</q>.
</dd></dl><p>Note that if <strong>twistd</strong> is run as root, the working directory is <em>not</em>
searched for Python modules.
</p><h2>AUTHOR<a name="auto3"></a></h2><p>Written by Moshe Zadka, based on twistd's help messages
</p><h2>REPORTING BUGS<a name="auto4"></a></h2><p>Report bugs to &lt;twisted-python@twistedmatrix.com&gt;.
</p><h2>COPYRIGHT<a name="auto5"></a></h2><p>Copyright &copy; 2003 Matthew W. Lefkowitz
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
</p><h2>SEE ALSO<a name="auto6"></a></h2><p>mktap(1)
</p></div><p><a href="../howto/index.html">Index</a></p><span class="version">Version: 1.3.0</span></body></html>