NAME
ggzmetaserv - The GGZ Gaming Zone Metaserver
SYNOPSIS
ggzmetaserv [OPTIONS...]
DESCRIPTION
The metaserver ggzmetaserv registers GGZ servers, available game rooms
on them and running games of any type (even non-GGZ games) and makes
this information available to interested clients or to aggregation
services such as Metacle. It has been designed to be as flexible as
possible, and allows to give arbitrary options to all entries.
The server listens to connections on port 15689, and responds to XML or
URI queries with a list of servers of the requested type. It should be
run by server administrators, for example by inetd or xinetd, or as a
stand-alone daemon to allow updates to the internal database.
Features include authentication for parts of the internal directory
structure, caching of the current contents for later use, and
incremental updates.
For more information, especially on the protocol format, please have a
look at http://www.ggzgamingzone.org/backend/metaserver/.
OPTIONS
-c, --configuration=FILE
Use FILE as the configuration file instead of the default,
metaservconf.xml.
-C, --cache=FILE
After each update to the internal data, save all the data to
this file. When the server restarts, this file is read in
automatically and thus contains more recent data than the
original configuration file.
-d, --daemon
Runs in daemon mode. This is what is wanted in most cases, since
without this option, only queries on the command line will be
responded to. Also, updates to the data are only possible in
daemon mode.
-D, --debug
Output information about the connections, queries, results and
disconnections.
-h, --help
Shows a help screen with a command summary.
-p, --port=PORT
Instead of the default port (15689), use PORT to accept
connections. This option only makes sense in combination with
--daemon.
-v, --version
Displays the version number of ggzmetaserv.
-V, --verbose
Similar to --debug, however only some information is written
out, not all the transmission content.
-l, --logfile=FILE
Log messages into FILE instead of to the command line. Special
values for FILE are ’stdout’ and ’stderr’. This option only
makes sense in combination with --debug or --verbose.
FILES
/usr/share/ggzmetaserv/metaservconf.xml
SEE ALSO
ggzd(6)
AUTHORS
The GGZ Development Team <ggz-dev@mail.ggzgamingzone.org>