databases(5)        GNATS configuration files        databases(5)



NAME
       databases - the known set of GNATS databases

DESCRIPTION
       The databases configuration file is a site-wide configura-
       tion 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/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 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 environ-
       ment 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::host-
              name:port

       The first two fields are the same as for local  databases,
       the third field is empty (notice the two adjacent `:' sym-
       bols, 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 ver-
       sions 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 con-
       ditions 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)