ggz-config(6)							  GGZ Gaming Zone						     ggz-config(6)

NAME

       ggz-config - GGZ Gaming Zone configuration manager

SYNOPSIS

       Query Mode:
       ggz-config [--configdir] [--gamedir] [--datadir] [--protocol] [--version]

       Install Mode:
       ggz-config --install --modfile=FILENAME [--destdir] [--force]

       Uninstall Mode:
       ggz-config --remove --modfile=FILENAME

       Repair Mode:
       ggz-config --check

DESCRIPTION

       The  program ggz-config is a central tool and part of the client libraries package of the GGZ Gaming Zone.  It can be used for several pur-
       poses.  Primarily it is used to maintain the ggz.modules configuration file by installing and removing game module  information.   This	is
       done with the --install and --remove modes of operation.

       Additionally,  the  program can query the installation settings of the GGZ client libraries to assist in configuring the build process of a
       client or game module.

OPTIONS

       Query Mode Options

       -c, --configdir
	      Output location of the GGZ client libraries configuration directory and exit. This value will usually be @ggzconfdir@ and  is  where
	      the file ggz.modules is located.

       -g, --gamedir
	      Output  location	of  the  executable  game  modules  and  exit.	 Game modules in this directory are all game clients which are not
	      installed into a standard PATH directory, mostly because they only run when invoked by a GGZ core client. As a special  module,  the
	      game client wrapper ggzwrap is installed into this place.  The gamedir is usually @ggzexecmoddir@.

       -d, --datadir
	      Output  location	of  game  module  data directory and exit.  This is where games look for their graphics and level data.  This will
	      likely resolve to @ggzdatadir@.

       -p, --protocol
	      Query GGZ_CS_PROTO_VERSION - version of core protocol between the GGZ server and any GGZ core clients.

       -h, --help
	      Output help information and exit.

       -u, --usage
	      Print some ggz-config usage scenarios for quick reference.

       -v, --version
	      Output version information and exit.

       Install Mode Options

       --install
	      Specifies that we are installing a game module description.

       --modfile=FILENAME
	      Specifies the source module description file.  FILENAME will often be named module.dsc, but this is merely a convention.

       --force
	      Overwrite an existing module entry of the same name, author and version rather than returning an error.

       -D, --destdir
	      Specifies that the $DESTDIR environment variable contains a directory to prepend to the path for the GGZ module  configuration  file
	      (ggz.modules).  The only known purpose for this is for creating binary packages of GGZ games.

       Uninstall Mode Options

       --remove
	      Specifies that we are removing a game module description.

       --modfile=FILENAME
	      Specifies the source module description file.

FILES

       @ggzconfdir@/ggz.modules
	      Game module registry for all GGZ Gaming Zone core clients.

ENVIRONMENT VARIABLES

       DESTDIR
	      Used during install process, most commonly by the build sequence of binary packages such as rpm or dpkg.

BUGS

       The program is currently unable to detect many problems that could arise with an invalid ggz.modules file.

       Probably others, too numerous to mention.

SEE ALSO

       ggz_h(3),  ggzcore_h(3),  ggzmod_h(3),  libggz(3), libggzcore(3), libggzmod(3), attributes(5), ggz.modules(5), gnome-interfaces(5), ggz(6),
       ggz-config(6), ggz(7)

       GGZ Gaming Zone:
	  http://www.ggzgamingzone.org/

AUTHORS

	  The GGZ Development Team <ggz-dev@mail.ggzgamingzone.org>
	  Last edited by Michal Pryc, Sun Microsystems Inc., 2008.

The GGZ Development Team					      0.0.14							     ggz-config(6)