NAME

       start_server - a superdaemon for hot-deploying server programs

SYNOPSIS

         start_server [options] -- server-prog server-arg1 server-arg2 ...

         # start Plack using Starlet listening at TCP port 8000
         start_server --port=8000 -- plackup -s Starlet --max-workers=100 index.psgi

DESCRIPTION

       This script is a frontend of Server::Starter.  For more information please refer to the documentation of
       the module.

OPTIONS

   --port=(port|host:port)
       TCP port to listen to (if omitted, will not bind to any ports)

   --path=path
       path at where to listen using unix socket (optional)

   --dir=path
       working directory, start_server do chdir to before exec (optional)

   --interval=seconds
       minimum interval to respawn the server program (default: 1)

   --signal-on-hup=SIGNAL
       name of the signal to be sent to the server process when start_server receives a SIGHUP (default:
       SIGTERM). If you use this option, be sure to also use "--signal-on-term" below.

   --signal-on-term=SIGNAL
       name of the signal to be sent to the server process when start_server receives a SIGTERM (default:
       SIGTERM)

   --pid-file=filename
       if set, writes the process id of the start_server process to the file

   --status-file=filename
       if set, writes the status of the server process(es) to the file

   --envdir=ENVDIR
       directory that contains environment variables to the server processes.  It is intended for use with
       "envdir" in "daemontools".  This can be overwritten by environment variable "ENVDIR".

   --enable-auto-restart
       enables automatic restart by time.  This can be overwritten by environment variable
       "ENABLE_AUTO_RESTART".

   --auto-restart-interval=seconds
       automatic restart interval (default 360). It is used with "--enable-auto-restart" option.  This can be
       overwritten by environment variable "AUTO_RESTART_INTERVAL".

   --kill-old-delay=seconds
       time to suspend to send a signal to the old worker. The default value is 5 when "--enable-auto-restart"
       is set, 0 otherwise.  This can be overwritten by environment variable "KILL_OLD_DELAY".

   --restart
       this is a wrapper command that reads the pid of the start_server process from --pid-file, sends SIGHUP to
       the process and waits until the server(s) of the older generation(s) die by monitoring the contents of
       the --status-file

   --help
       prints this help

   --version
       prints the version number

AUTHOR

       Kazuho Oku

SEE ALSO

       Server::Starter

LICENSE

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself.

perl v5.18.1                                       2013-07-18                                   START_SERVER(1p)