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

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@bigfoot.com> 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.