databases - the known set of GNATS databases
configuration file is a site-wide configuration file
containing the list of GNATS databases that are available either on the host
itself or remotely over the network, together with some parameters associated
with each database. It is located in the directory /usr/share/gnats.
The file contains one line for each database. For databases located on the host
itself, each line consists of three fields separated by colons:
The first field is the database name. This is the name used to identify the
database when invoking programs such as query-pr
either by using the --database
option of the program or by setting the
environment variable to the name of the database. The second
field is a short human-readable description of the database contents, and the
final field is the directory where the database contents are kept.
For a database that is located across a network, but which should be accessible
from this host, the entry for the database should look like this:
database name:short description of
The first two fields are the same as for local databases, the third field is
empty (notice the two adjacent `:' symbols, indicating an empty field), the
fourth field is the hostname of the remote GNATS server, and the fifth field
is the port number that the remote GNATS server is running on.
Note that if you add a new local database, you must create its data directory,
including appropriate subdirectories and administrative files after adding an
entry to databases
. This is best done using the mkdb
Lines beginning with a # are ignored.
The database name default
is special; this is the entry used if no
database name is specified via a --database
option or the
Keeping Track: Managing Messages With GNATS
(also installed as the GNU
Info file gnats.info
Copyright (c) 1993, 2000, 2003, Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this manual
provided the copyright notice and this permission notice are preserved on all
Permission is granted to copy and distribute modified versions of this manual
under the conditions for verbatim copying, provided that the entire resulting
derived work is distributed under the terms of a permission notice identical
to this one.
Permission is granted to copy and distribute translations of this manual into
another language, under the above conditions for modified versions, except
that this permission notice may be included in translations approved by the
Free Software Foundation instead of in the original English.