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

SIGNALS¶

USR1

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)