NAME

       twistd - run Twisted applications (TACs, TAPs)

SYNOPSIS

       twistd [options]

DESCRIPTION

       Read a twisted.application.service.Application out of a file and run it.

OPTIONS

       -n, --nodaemon Don't daemonize (stay in foreground).

       -q, --quiet
              No-op for backwards compatibility.

       -p, --profile <profile output>
              Run the application under the profiler, dumping results to the specified file.

       --profiler <profiler name>
              Specify the profiler to use. Defaults to the 'hotshot' profiler.

       --savestats
              Save the Stats object rather than the text output of the profiler.

       -b, --debug
              Run  the application in the Python Debugger (implies --nodaemon option).  Sending a
              SIGINT or SIGUSR2 signal to the process will drop it into the debugger.

       -e, --encrypted <file>
              The specified tap/aos file is encrypted.

       --euid Set only effective user-id rather than real user-id.  This  option  has  no  effect
              unless  the  server  is  running  as  root,  in which case it means not to shed all
              privileges after binding ports, retaining the option to regain privileges in  cases
              such as spawning processes. Use with caution.

       -o, --no_save
              Do not save shutdown state.

       --originalname
              Behave  as  though  the specified Application has no process name set, and run with
              the standard process name (the Python binary in most cases).

       -l, --logfile <logfile>
              Log to a specified file, - for stdout (default: twistd.log).  The log file will  be
              rotated on SIGUSR1.

       -l, --logger <fully qualified python name>
              A  fully-qualified  name  to  a  log  observer  factory  to use for the initial log
              observer. Takes precedence over --logfile and --syslog.

       --pidfile <pidfile>
              Save pid in specified file (default: twistd.pid).

       --chroot <directory>
              Chroot to a supplied directory before running (default: don't  chroot).   Chrooting
              is done before changing the current directory.

       -d, --rundir <directory>
              Change to a supplied directory before running (default: .).

       -u, --uid <uid>
              The uid to run as (default: don't change).

       -g, --gid <gid>
              The gid to run as (default: don't change).

       --umask <mask>
              The  (octal)  file  creation  mask  to apply. (default: 0077 for daemons, no change
              otherwise).

       -r, --reactor <reactor>
              Choose which reactor to use. See --help-reactors for a list of possibilities.

       --help-reactors
              List the names of possibly available reactors.

       --spew Write an extremely verbose log of everything that  happens.  Useful  for  debugging
              freezes or locks in complex code.

       -f, --file <tap file>
              Read the given .tap file (default: twistd.tap).

       -s, --source <tas file>
              Load an Application from the given .tas (AOT Python source) file.

       -y, --python <python file>
              Use  the  variable  "application" from the given Python file. This option overrides
              -f. This option implies --no_save.

       --syslog
              Log to syslog instead of a file.

       --version
              Print version information and exit.

       --prefix <prefix>
              Use the specified prefix when logging to logfile. Default is "twisted".

       Note that if twistd is run as root, the working  directory  is  not  searched  for  Python
       modules.

SIGNALS

       A running twistd accepts SIGINT for a clean shutdown and SIGUSR1 to rotate log files.

AUTHOR

       Written by Moshe Zadka, based on twistd's help messages.

REPORTING BUGS

       To                  report                  a                  bug,                  visit
       http://twistedmatrix.com/trac/wiki/TwistedDevelopment#DevelopmentProcess

COPYRIGHT

       Copyright © 2001-2011 Twisted Matrix Laboratories.
       This is free software; see the source for copying conditions. There is  NO  warranty;  not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

                                             Dec 2011                                   TWISTD(1)