twistd

TWISTD(1)                                                            TWISTD(1)



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 
              Run the application under the profiler, dumping results  to  the
              specified file.

       --profiler 
              Specify the profiler to use. Defaults to the 'hotshot' profiler.

       --savestats
              Save  the  Stats  object rather than the text output of the pro‐
              filer.

       -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 
              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 
              Log to a specified file, -  for  stdout  (default:  twistd.log).
              The log file will be rotated on SIGUSR1.

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

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

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

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

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

       --umask 
              The (octal) file creation mask to apply. (default: 0077 for dae‐
              mons, no change otherwise).

       -r, --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. Use‐
              ful for debugging freezes or locks in complex code.

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

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

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

       -g, --plugin 
              Read config.tac from a plugin package, as with -y.

       --syslog
              Log to syslog instead of a file.

       -u, --uid 
              The uid to run as.

       -g, --gid 
              The gid to run as.

       --version
              Print version information and exit.

       --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/TwistedDevel‐
       opment#DevelopmentProcess

COPYRIGHT
       Copyright © 2001-2010 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 2003                          TWISTD(1)