Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
databases(5)		   GNATS configuration files		  databases(5)

NAME
       databases - the known set of GNATS databases

DESCRIPTION
       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/lo-
       cal/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 di-
       rectory,	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-in-
       dex(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 en-
       tire resulting derived work is distributed under	the terms of a permis-
       sion 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=databases&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help