databases(5) GNATS configuration files databases(5)NAMEdatabases - the known set of GNATS databasesDESCRIPTION
The databases configuration file is a site-wide configuration file con‐
taining 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/local/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:
database name:short description:/path/to/database
The first field is the database name. This is the name used to iden‐
tify the database when invoking programs such as query-pr or send-pr,
either by using the --database option of the program or by setting the
GNATSDB 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 database::hostname:port
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 tool.
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 GNATSDB envi‐
ronment variable.
SEE ALSO
Keeping Track: Managing Messages With GNATS (also installed as the GNU
Info file gnats.info)
databases(5), dbconfig(5), delete-pr(8), edit-pr(1)file-pr(8), gen-
index(8), gnats(7), gnatsd(8), mkcat(8), mkdb(8), pr-edit(8), query-
pr(1), queue-pr(8), send-pr(1).
COPYING
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 copies.
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 per‐
mission notice identical to this one.
Permission is granted to copy and distribute translations of this man‐
ual into another language, under the above conditions for modified ver‐
sions, except that this permission notice may be included in transla‐
tions approved by the Free Software Foundation instead of in the origi‐
nal English.
GNATS August 2003 databases(5)
