4.5 The send-pr.conf file

This file contains some default values that need to be known in order for send-pr to work properly. This file needs to be copied to all hosts where send-pr will be used.

If gnats was built with default options, the send-pr.conf file should be placed in the /usr/local/etc/gnats directory. However, if the option --sysconfdir was used during building of gnats, the send-pr.conf file resides at the location given to this option.

Entries in this file are on the format

     variable=value

The valid variables are:

SUBMITTER

The default value to be used for the Submitter-Id field when send-pr is invoked.

DEFAULT_RELEASE

The default value to be used for the Release field (only applicable if the Release field is defined in the dbconfig file.

DEFAULT_ORGANIZATION

The default value to be used for the Organization field. (only applicable if the Organization field is defined in the dbconfig file.

MAILPROG

If the gnats server can't be reached directly over the network, i.e. it is behind a firewall or suchlike, send-pr can be set up to submit Problem Reports by e-mail. This is done by setting the MAILPROG variable to point to a mailer such as Sendmail. If MAILPROG needs to have the address that the mail is being sent to specified on the command line, it should be specified here as well (for example, MAILPROG=''mail bugs@foo.bar.com'' should work). If Sendmail is used, use MAILPROG=''/usr/lib/sendmail -oi -t''. See also MAILADDR and TEMPLATE below.

MAILADDR

If using e-mail to submit PRs, this is the address that PRs should be sent to.

TEMPLATE

When invoked, send-pr communicates directly over the network with the gnats server to determine what fields to include in a correctly formatted Problem Report so that it can present the user with a template. If the gnats server can't be reached directly over the network, a template must be provided. Set the TEMPLATE variable to point to a template file created on the gnats server by using the command send-pr -p. See Installing the user tools.