pioneers-meta-server(6) 					   Games Manual 					   pioneers-meta-server(6)

NAME

       pioneers-meta-server - meta game server for Pioneers

SYNOPSIS

       pioneers-meta-server [options]

DESCRIPTION

       Pioneers  is  an  implementation of the popular, award-winning "Settlers of Catan" board game.  It uses a client/server model for networked
       play. This program provides a piece of network infrastructure that helps match pioneers clients to pioneers servers. Casual players of pio-
       neers probably do not need to run this program.

OPTIONS

       -?, --help
	      Print a short help text and exit.

       -d, --daemon
	      Run in daemon mode.

       -P, --pidfile pidfile
	      Write the pid to pidfile (implies -d)

       -r, --redirect location
	      Redirect to another meta-server running at location.

       -s, --servername hostname
	      Use hostname as hostname when creating servers.

       -p, --port-range from-to
	      Use  ports  in  the  range  from-to  (inclusive)	to start servers.  It is advised not to include port 5557 in the range.  (See BUGS
	      below.)  When this range is not specified, the meta-server will not be able to create new games.

       --debug
	      Enable debug messages.

       --syslog-debug
	      Duplicate the messages of the syslog to the console.

       --version
	      Show version information.

ENVIRONMENT

       The default settings of the meta-server can be influenced with the following three environment variables:

       PIONEERS_META_SERVER
	      The hostname the meta-server will use when creating new games. This should be a hostname that can be resolved by	all  clients  that
	      will connect.

       PIONEERS_SERVER_CONSOLE
	      The path to pioneers-server-console.  If it is not set, the default installation path will be used.

       PIONEERS_DIR
	      The path to the game definition files.  If it is not set, the default installation path will be used.

FILES

       /usr/share/games/pioneers/*.game
	      Game definitions

SIGNALS

       USR1
	      Shutdown the meta-server gracefully (can be used to check for memory leaks)

BUGS

       Do not include port 5557 in the --port-range argument because the meta-server uses this port.

AUTHOR

       This  manual  page  was	written  by  Jeff  Breidenbach	<jab@debian.org>, and updated by Roland Clobus <rclobus@rclobus.nl> and Bas Wijnen
       <shevek@fmf.nl>.   Pioneers  was  written  by  Dave  Cole  <dave@dccs.com.au>,  Andy  Heroff  <aheroff@mediaone.net>,   and   Roman   Hodek
       <roman@hodek.net>,  with contributions from many other developers on the Internet; see the AUTHORS file in the pioneers distribution or the
       help->about dialog in one of the graphical programs for a complete list of contributing authors.

SEE ALSO

       pioneers(6), pioneers-server-gtk(6), pioneers-server-console(6)

pioneers							  January 8, 2012					   pioneers-meta-server(6)