1TWISTD(1) TWISTD(1)
2
6 twistd - run Twisted applications (TACs, TAPs)
7
9 twistd [options]
10
12 Read an twisted.application.service.Application out of a file and runs
13 it.
14 -n, --nodaemon
16 Don't daemonize (stay in foreground)
17 -q, --quiet
19 No-op for backwards compatibility.
20 -p, --profile <profile output>
22 Run the application under the profiler, dumping results to the
23 specified file.
24 --profiler <profiler name>
26 Specify the profiler to use, default to the 'hotshot' profiler.
27 --savestats
29 Save the Stats object rather than the text output of the pro‐
30 filer.
31 -b, --debug
33 Run the application in the Python Debugger (implies nodaemon
34 option). Sending a SIGUSR2 signal to the process will drop it
35 into the debugger.
36 -e, --encrypted <file>
38 The specified tap/aos/xml file is encrypted.
39 --euid Set only effective user-id rather than real user-id. This option
41 has no effect unless the server is running as root, in which
42 case it means not to shed all privileges after binding ports,
43 retaining the option to regain privileges in cases such as
44 spawning processes. Use with caution.
45 -o, --no_save
47 Do not save shutdown state
48 --originalname
50 Behave as though the specified Application has no process name
51 set, and run with the standard process name (the python binary
52 in most cases).
53 -l, --logfile <logfile>
55 Log to a specified file, - for stdout (default: twistd.log).
56 The log file will be rotated on SIGUSR1.
57 --pidfile <pidfile>
59 Save pid in specified file (default: twistd.pid)
60 --chroot <directory>
62 Chroot to a supplied directory before running (default: don't
63 chroot). Chrooting is done before changing the current direc‐
64 tory.
65 -d, --rundir <directory>
67 Change to a supplied directory before running (default: .)
68 -u, --uid <uid>
70 The uid to run as. (default: don't change)
71 -g, --gid <gid>
73 The gid to run as. (default: don't change)
74 --umask <mask>
76 The (octal) file creation mask to apply. (default: 0077 for dae‐
77 mons, no change otherwise).
78 -r, --reactor <reactor>
80 Choose which reactor to use. See --help-reactors for a list of
81 possibilties.
82 --help-reactors
84 List the names of possibly available reactors.
85 --spew Write an extremely verbose log of everything that happens. Use‐
87 ful for debugging freezes or locks in complex code.
88 -f, --file <tap file>
90 Read the given .tap file (default: twistd.tap)
91 -x, --xml <tax file>
93 Load an Application from the given .tax (XML) file.
94 -s, --source <tas file>
96 Load an Application from the given .tas (AOT Python source)
97 file.
98 -y, --python <python file>
100 Use the variable "application" from the given Python file. This
101 setting, if given, overrides -f. This option implies --no_save.
102 -g, --plugin <plugin name>
104 Read config.tac from a plugin package, as with -y.
105 --syslog
107 Log to syslog, not to file.
108 -u, --uid <uid>
110 The uid to run as.
111 -g, --gid <gid>
113 The gid to run as.
114 --version
116 Print version information and exit.
117 --prefix <prefix>
119 Use the specified prefix when logging to logfile. Default is
120 "twisted".
121 Note that if twistd is run as root, the working directory is not
123 searched for Python modules.
124
126 Written by Moshe Zadka, based on twistd's help messages
127
129 To report a bug, visit http://twistedmatrix.com/bugs/
130
132 Copyright © 2001-2008 Twisted Matrix Laboratories.
133 This is free software; see the source for copying conditions. There is
134 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
135 PURPOSE.
136 Dec 2003 TWISTD(1)