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 documenation 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)

--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)

--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

--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.