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/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)

NAME | DESCRIPTION | SEE ALSO | COPYING

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

home | help