NAME

       databases - the known set of GNATS databases

DESCRIPTION

       The 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:

              database name:short description:/path/to/database

       The  first  field  is  the  database  name.  This is the name used to identify 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 environment 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
       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.

GNATS                                              August 2003                                      databases(5)