269 |
may submit Problem Reports. |
may submit Problem Reports. |
270 |
|
|
271 |
Responsibility for a given Problem Report initially depends on the |
Responsibility for a given Problem Report initially depends on the |
272 |
category of the problem. Optionally, an automated reminder can be sent |
category of the problem. Optionally, an automated reminder can be |
273 |
to the responsible person if a problem report is neglected for a |
sent to the responsible person if a problem report is neglected for a |
274 |
requisite time period. @xref{GNATS configuration,,GNATS configuration}. |
requisite time period. @xref{GNATS configuration,,Overview of |
275 |
|
@sc{gnats} configuration}. |
276 |
|
|
277 |
@cindex @code{pending} directory |
@cindex @code{pending} directory |
278 |
@cindex unparseable incoming PRs |
@cindex unparseable incoming PRs |
399 |
|
|
400 |
@c FIXME - check these |
@c FIXME - check these |
401 |
@table @asis |
@table @asis |
402 |
@item database-specific configuration and database contents |
@item the directory path of the default database |
403 |
@file{@var{prefix}/com}@* |
@file{@var{prefix}/com}@* |
404 |
|
|
405 |
@item site-wide configuration files |
@item site-wide configuration files |
612 |
|
|
613 |
@table @file |
@table @file |
614 |
@item databases |
@item databases |
615 |
The list of valid databases. For local databases it contains the |
@xref{databases file,,The @file{databases} file}. |
|
pathname of the database directory, and for remote databases it has the |
|
|
hostname and port of the gnatsd server to connect to. |
|
|
(@pxref{databases file,,The @code{databases} file}). |
|
616 |
|
|
617 |
@item defaults |
@item defaults |
618 |
A directory containing the set of default files used when a new database |
@xref{GNATS configuration,,Overview of @sc{gnats} configuration}. |
|
is created with @code{mkdb}. |
|
|
(@pxref{dbconfig file,,The @code{dbconfig} file}). |
|
619 |
|
|
620 |
@item gnatsd.host_access |
@item gnatsd.host_access |
621 |
The access-level settings for the different hosts that will be accessing |
@xref{gnatsd.host_access,,The @file{gnatsd.host_access} file}. |
|
the databases on your server. The settings in this file apply across |
|
|
all databases on the server. @xref{gnatsd.host_access,,The |
|
|
@file{gnatsd.host_access} file}. |
|
622 |
|
|
623 |
@item gnatsd.user_access |
@item gnatsd.user_access |
624 |
The access-level settings for the users that will be accessing |
@xref{gnatsd.user_access,,The @file{gnatsd.user_access} file}. |
|
the databases on your server. The settings in this file apply across |
|
|
all databases on the server. @xref{gnatsd.user_access,,The |
|
|
@file{gnatsd.user_access} file}. |
|
625 |
@end table |
@end table |
626 |
|
|
627 |
@item @var{prefix}/share/emacs/site-lisp |
@item @var{prefix}/share/emacs/site-lisp |
687 |
(@emph{This file is created by @sc{gnats}.}) |
(@emph{This file is created by @sc{gnats}.}) |
688 |
@end table |
@end table |
689 |
|
|
690 |
@noindent exist here. @xref{GNATS configuration,,GNATS configuration}, |
@noindent exist here. |
691 |
|
@xref{Other config files,,Other database-specific config files}, |
692 |
@ref{Admin files,,Administrative data files} and @ref{Access |
@ref{Admin files,,Administrative data files} and @ref{Access |
693 |
Control,,Controlling access to databases}. |
Control,,Controlling access to databases}. |
694 |
|
|
1526 |
@cindex @code{GNATSDB} |
@cindex @code{GNATSDB} |
1527 |
|
|
1528 |
@code{gnatsd} supports the @code{GNATSDB} environment varable, |
@code{gnatsd} supports the @code{GNATSDB} environment varable, |
1529 |
@xref{Environment}, in almost the same way as the GNATS tools do. This |
@xref{Environment}, in almost the same way as the @sc{gnats} tools do. |
1530 |
variable is used to determine which database to use. For a local |
This variable is used to determine which database to use. For a local |
1531 |
database, it contains the name of the database to |
database, it contains the name of the database to |
1532 |
access. @code{gnatsd} cannot service remote databases (though it might |
access. @code{gnatsd} cannot service remote databases (though it might |
1533 |
be interesting if it could) so the database is always assumed to be |
be interesting if it could) so the database is always assumed to be |
1618 |
@section Overall access levels per host |
@section Overall access levels per host |
1619 |
@cindex @file{gnatsd.host_access} |
@cindex @file{gnatsd.host_access} |
1620 |
|
|
1621 |
The file @file{@var{SYSCONFDIR}/gnats/gnatsd.host_access} (usually |
The host access file (by default |
1622 |
@file{/etc/gnats/gnatsd.host_access}) controls overall access levels |
@file{/usr/local/etc/gnats/gnatsd.host_access}) controls overall |
1623 |
on a per-host basis, meaning that settings in this file apply across |
access levels on a per-host basis, meaning that settings in this file |
1624 |
all databases on the server. Entries in this file are on the |
apply across all databases on the server. Entries in this file are in |
1625 |
following format: |
the following format: |
1626 |
|
|
1627 |
@var{host:access-level:whatever} |
@var{host:access-level:whatever} |
1628 |
|
|
1652 |
@cindex @file{gnatsd.user_access} |
@cindex @file{gnatsd.user_access} |
1653 |
|
|
1654 |
Access levels per user can be set both across all databases on the |
Access levels per user can be set both across all databases on the |
1655 |
server or on a per-database basis. The @file{gnatsd.user_access} file in a |
server or on a per-database basis. The @file{gnatsd.user_access} file |
1656 |
database's @file{gnats-adm} directory specifies the user access rules |
in a database's @file{gnats-adm} directory specifies the user access |
1657 |
for that database. If it doesn't exist, or doesn't contain the user |
rules for that database. If it doesn't exist, or doesn't contain the |
1658 |
name given to @code{gnatsd}, then the file |
user name given to @code{gnatsd}, then the overall user access file |
1659 |
@w{@file{@var{SYSCONFDIR}/gnats/gnatsd.user_access}}, usually |
(by default @w{@file{/usr/local/etc/gnats/gnatsd.user_access}}) |
1660 |
@w{@file{/etc/gnats/gnatsd.user_access}}, specifying the per-user |
specifying the per-user access levels across all the databases on the |
1661 |
access levels across all the databases on the server is checked. |
server is checked. |
1662 |
|
|
1663 |
The user access files can only @emph{increase} the access level |
The user access files can only @emph{increase} the access level |
1664 |
defined in the host access files for the given host, they can never |
defined in the host access files for the given host, they can never |
1681 |
|
|
1682 |
@var{userid:password:access-level} |
@var{userid:password:access-level} |
1683 |
|
|
1684 |
|
The overall @file{gnatsd.user_access} user access file adds a fourth |
1685 |
|
@var{databases} field: |
1686 |
|
|
1687 |
|
@var{userid:password:access-level:databases} |
1688 |
|
|
1689 |
@noindent @var{password} should either be in plain text, DES |
@noindent @var{password} should either be in plain text, DES |
1690 |
@code{crypt()}@footnote{DES crypt is the standard password encryption |
@code{crypt()}@footnote{DES crypt is the standard password encryption |
1691 |
format used by most UNIX systems} or MD5 hash format@footnote{MD5 is |
format used by most UNIX systems} or MD5 hash format@footnote{MD5 is |
1756 |
might be surprised if they suddenly found themselves logged in, but with |
might be surprised if they suddenly found themselves logged in, but with |
1757 |
a lower access level than they usually have. |
a lower access level than they usually have. |
1758 |
|
|
1759 |
The overall user access file |
The @var{databases} field contains a comma-separated list of database |
1760 |
@w{@file{@var{SYSCONFDIR}/gnats/gnatsd.user_access}}, usually |
names, as defined in the @file{databases} file (@pxref{databases |
1761 |
@w{@file{/etc/gnats/gnatsd.user_access}}, adds a fourth |
file,,The @code{databases} file}. Wildcard characters are |
1762 |
@var{database} field. This file contains a comma-separated list of |
supported. The databases listed in this field are the ones to which |
|
database names, as defined in the @file{databases} file |
|
|
(@pxref{databases file,,The @code{databases} file}. Wildcard characters |
|
|
are supported. The databases listed in this field are the ones to which |
|
1763 |
the other settings on the same line will be applied. |
the other settings on the same line will be applied. |
1764 |
|
|
1765 |
@node Privileged gnatsd commands |
@node Privileged gnatsd commands |