Man Linux: Main Page and Category List

NAME

       ggzd - GGZ Gaming Zone Main Server

SYNOPSIS

       ggzd [OPTIONS...]

DESCRIPTION

       The  main GGZ Gaming Zone server ggzd implements a centralized facility
       for multiplayer gaming.  It is a  multi-threaded  multi-process  daemon
       which  handles  rooms, games, players and tables, and is connected to a
       database to handle player permissions and game statistics.  The  server
       forks  a  child server for every launched game. It listens on port 5688
       by default for incoming connections from GGZ  core  clients  (or  other
       clients like the chatbot grubby).

       Most  of its options are configured in ggzd.conf, although some command
       line options are available as well. Configuration details are  outlined
       below.   It  is  recommended  that the GGZ Server Hosting Guide be read
       before running the  server,  especially  for  production  systems.   An
       overview  on  the  server  is  given  in GGZ Server Architecture.  Both
       documents are available in the ggz-docs package.

OPTIONS

       -F, --foreground
              Stay in the foreground instead  of  daemonizing  away  from  the
              terminal

       -f, --file=FILE
              Use the specified configuration file instead of the default one,
              which is ggzd.conf.

       -l, --log=LEVEL
              Start with the given log levels for  messages  to  the  console.
              Levels  are  described  in ggzd.conf. A value of all will output
              all log messages.

       -p, --port=PORT
              Use this port number to listen for  incoming  connections.   The
              default PORT is 5688.

       -s, --specs
              Display the compile-time configuration of ggzd. For some values,
              the activation  depends  on  configuration  settings,  so  their
              values are shown in brackets for each of those values.

       -v, --version
              Display ggzd version information.

       -h, --help
              Display the command line options overview.

CONFIGURATION

       The  file  ggzd.conf  contains  several  sections  for  general  server
       configuration, database connectivity, security,  logging,  broadcasting
       of events and more.

       In   case   reconfiguration   support   has   been   compiled   in  and
       ReconfigureRooms is enabled, room  files  added  to  and  removed  from
       /etc/ggzd/rooms/ will automatically be read in by ggzd.

       The server might contact a zeroconf daemon, a metaserver and a database
       server depending on the configuration. Therefore, its first run  should
       be  performed with the -F option, so that errors can be caught.  All of
       the daemons mentioned above must be running before  ggzd  is  launched,
       even  though  intermediate downtimes of the database server are handled
       by some of the backends in ggzd.

FILES

       /etc/ggzd/ggzd.conf - main server configuration

       /etc/ggzd/ggzd.motd - message of the day

       /etc/ggzd/games/* - description files for the game servers

       /etc/ggzd/rooms/* - room description files

       /var/lib/ggzd/* - dynamic game data files and savegames (if any)

AUTHORS

       The GGZ Development Team <ggz-dev@mail.ggzgamingzone.org>

SEE ALSO

       ggzduedit(1), ggz(7)