Man Linux: Main Page and Category List

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.