The config file

Much of the behavior GNATS exhibits depends on the values of fields in the file `GNATS_ROOT/gnats-adm/config'. The `config' file contains a list of varibles (using Bourne-shell syntax) which control the following behavior. These values can be changed at any time; the new values take effect for all subsequent iterations of the tools.

GNATS_ADDR="address"

The address where your site receives Problem Reports. This address is aliased in the file `/etc/aliases' so that it directs incoming mail into queue-pr (see section Installing the utilities). The default is `bugs' (a local address).

GNATS_ADMIN="address"

The address of the GNATS administrator. Normally this is set to `gnats-admin', which is an alias in `/etc/aliases' that points toward the person responsible for administrating GNATS. See section Installing the utilities. The default is `gnats-admin' (a local address).

GNATS_SITE="site"

The nametag for your Support Site (your organization, company, group, etc.). This nametag should also appear in the `submitters' file, so that users at your site can submit Problem Reports locally. site is also used as the name of the file containing a valid category list for your site. This file is installed locally as `prefix/lib/gnats/site'. Warning: if you change this variable after GNATS is installed, you must also change the name of this file, as well as the name of the alias for your local submitters (see section Setting up mail aliases). The default is the second-to-last field in your domain name. For example, if your domain name is `unleaded.truckstop.org', your default site is `truckstop'.

SUBMITTER="submitter-id"

The nametag for your local Submitter Site (this value appears as the default value for `>Submitter-Id' when you run send-pr). Even though you are a Support Site, if you submit Problem Reports to your own organization you become a Submitter Site. The value submitter-id is the default value for the `>Submitter-Id:' field that your maintainers see when they submit Problem Reports locally. The default is the value of `GNATS_SITE'.

DEFAULT_RELEASE="release"

The default release for your site (this value appears as the default value for `>Release:' when you run send-pr). The default is `unknown-1.0'.

DEFAULT_ORGANIZATION="text"

The default value for the `>Organization:' field (this value appears as the default when you run send-pr). The default is the value of `GNATS_SITE'.

NOTIFY=boolean

Determines whether or not to remind maintainers if a requisite time period has passed before they change the state of a Problem Report to `analyzed'. This feature uses the program at-pr; see section Timely reminders. This requisite time is determined for each submitter individually; see section The submitters file. The time is measured in business hours, which by default are 8:00am to 5:00pm, Monday through Friday. Business hours can be redefined by changing the variables BDAY_START, BDAY_END, BWEEK_START, and BWEEK_END in the `config' file (see below). If boolean is `1', this feature is active. If boolean is `0', the feature is turned off. The default value for `NOTIFY' is `1'.

ACKNOWLEDGE=boolean

Determines whether or not to send an automatic acknowledgement to the originator of a problem report when the GNATS first receives the PR. If boolean is `1', this feature is active. If boolean is `0', the feature is turned off. The default for `ACKNOWLEDGE' is `1'. The acknowledgment is of the form:

To: your-address
From: gnats
Subject: Re: category/gnats-id:Synopsis
In-Reply-To: Your message of date

Thank you very much for your problem report.
It has the internal identification: category/gnats-id
The individual assigned to look at your bug is:
     responsible

Category:     category of the PR
Responsible:  responsible
Synopsis:     Synopsis from submitted PR
Arrival-Date: arrival date

DEFAULT_SUBMITTER="submitter-id"

The value GNATS assigns to PRs which come in with missing or unknown values for the `>Submitter-Id:' field. This value must also appear in the `submitters' file; see section The submitters file. To disable the feature of GNATS which tracks the `>Submitter-Id:', simply alter the `submitters' file to only contain the submitter-id value which appears in DEFAULT_SUBMITTER, and and instruct your submitters to ignore the field. The default value for `DEFAULT_SUBMITTER' is `unknown'.

KEEP_RECEIVED_HEADERS=boolean

Determines whether or not GNATS should retain the `Received-By:' mail headers from incoming mail. These headers often take up a lot of space, and they are seldom used. If boolean is `1', this feature is active. If boolean is `0', the feature is turned off. The default value for `KEEP_RECEIVED_HEADERS' is `1'.

DEBUG=boolean

Determines whether or not GNATS is operating in a mode for debugging. When boolean is `1', GNATS fowards all mail to the GNATS administrator, gnats-admin.

BDAY_START=integer

BDAY_END=integer

BWEEK_START=integer

BWEEK_END=integer

The definition of business hours. These values are only used if NOTIFY is set to `1' in the `config' file (see above). By default, business hours are 8:00am to 5:00pm Monday through Friday, local time.

BDAY_START=integer

Defines the hour of the day when business hours begin. integer values must fall between `0' (midnight) and `23' (11:00pm). The default is `8' (8:00am).

BDAY_END=integer

Defines the hour of the day when business hours end. integer values must fall between `0' (midnight) and `23' (11:00pm). The default is `17' (5:00pm).

BWEEK_START=integer

Defines the beginning day of the business week. integer values must fall between `0' (Sunday) and `6' (Saturday). The default is `1' (Monday).

BWEEK_END=integer

Defines the ending day of the business week. integer values must fall between `0' (Sunday) and `6' (Saturday). The default is `5' (Friday).

Go to the first, previous, next, last section, table of contents.