1330 |
the replacement PR text or errors encountered while updating the PR file |
the replacement PR text or errors encountered while updating the PR file |
1331 |
or index. |
or index. |
1332 |
|
|
1333 |
|
@item EDITADDR @var{address} |
1334 |
|
Sets the e-mail address of the person communicating with |
1335 |
|
@code{gnatsd}. The command requires at least the @code{edit} access |
1336 |
|
level. |
1337 |
|
|
1338 |
|
The possible responses are: |
1339 |
|
|
1340 |
|
@code{200 (CODE_OK)} |
1341 |
|
@*The address was successfully set. |
1342 |
|
|
1343 |
|
@code{440 (CODE_CMD_ERROR)} |
1344 |
|
@*Invalid number of arguments were supplied. |
1345 |
|
|
1346 |
@item APPN @var{PR} @var{field} |
@item APPN @var{PR} @var{field} |
1347 |
@itemx REPL @var{PR} @var{field} |
@itemx REPL @var{PR} @var{field} |
1348 |
Appends to or replaces the contents of @var{field} in @var{PR} with the |
Appends to or replaces the contents of @var{field} in @var{PR} with the |
1628 |
@section Overall access levels per host |
@section Overall access levels per host |
1629 |
@cindex @file{gnatsd.host_access} |
@cindex @file{gnatsd.host_access} |
1630 |
|
|
1631 |
The file @file{/usr/local/etc/gnats/gnatsd.host_access} controls |
The file @file{@var{SYSCONFDIR}/gnats/gnatsd.host_access} (usually |
1632 |
overall access levels on a per-host basis, meaning that settings in this |
@file{/etc/gnats/gnatsd.host_access}) controls overall access levels |
1633 |
file apply across all databases on the server. Entries in this file are |
on a per-host basis, meaning that settings in this file apply across |
1634 |
on the following format: |
all databases on the server. Entries in this file are on the |
1635 |
|
following format: |
1636 |
|
|
1637 |
@var{host:access-level:whatever} |
@var{host:access-level:whatever} |
1638 |
|
|
1667 |
for that database. If it doesn't exist, or doesn't contain the user |
for that database. If it doesn't exist, or doesn't contain the user |
1668 |
name given to @code{gnatsd}, then the file |
name given to @code{gnatsd}, then the file |
1669 |
@w{@file{@var{SYSCONFDIR}/gnats/gnatsd.access}}, usually |
@w{@file{@var{SYSCONFDIR}/gnats/gnatsd.access}}, usually |
1670 |
@w{@file{/usr/local/etc/gnats/gnatsd.access}}, specifying the per-user |
@w{@file{/etc/gnats/gnatsd.access}}, specifying the per-user |
1671 |
access levels across all the databases on the server is checked. |
access levels across all the databases on the server is checked. |
1672 |
|
|
1673 |
|
The user access files can only @emph{increase} the access level |
1674 |
|
defined in the host access files for the given host, they can never |
1675 |
|
lower it. |
1676 |
|
|
1677 |
If the access level is @code{none} after processing the userid and |
If the access level is @code{none} after processing the userid and |
1678 |
password, the connection is closed. |
password, the connection is closed. |
1679 |
|
|
1680 |
The @file{gnatsd.access} files are clear text, but should be owned by |
The @file{gnatsd.access} files can contain plain text passwords, in |
1681 |
the @sc{gnats} user with file permission 600. |
such a case they should be owned by the @sc{gnats} user with file |
1682 |
|
permission 600. |
1683 |
Wildcard characters are supported for the userid and password. A null |
|
1684 |
string or @samp{*} matches anything; @samp{?} matches any one character. |
Wildcard characters are supported for the userid and password with |
1685 |
|
plain text passwords. A null string or @samp{*} matches anything; |
1686 |
|
@samp{?} matches any one character. |
1687 |
|
|
1688 |
Entries in the database-specific @file{gnatsd.access} user access file |
Entries in the database-specific @file{gnatsd.access} user access file |
1689 |
in the @file{gnats-adm} directory of the database have the following |
in the @file{gnats-adm} directory of the database have the following |
1691 |
|
|
1692 |
@var{userid:password:access-level} |
@var{userid:password:access-level} |
1693 |
|
|
1694 |
@noindent @var{password} should either be in plaintext, DES |
@noindent @var{password} should either be in plain text, DES |
1695 |
@code{crypt()}@footnote{DES crypt is the standard password encryption |
@code{crypt()}@footnote{DES crypt is the standard password encryption |
1696 |
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 |
1697 |
only supported on platforms that have a @code{crypt()} function that |
only supported on platforms that have a @code{crypt()} function that |
1698 |
supports MD5. Among others, this currently includes @sc{gnu} Linux and |
supports MD5. Among others, this currently includes @sc{gnu} Linux and |
1699 |
OpenBSD.}. |
OpenBSD.}. |
1700 |
|
|
1701 |
If the password is in plaintext format, it must be prefixed by |
If the password is in plain text format, it must be prefixed by |
1702 |
@samp{$0$} and if it is in MD5 format, it needs to be prefixed by the |
@samp{$0$} and if it is in MD5 format, it needs to be prefixed by the |
1703 |
string @samp{$1$}. Passwords encrypted by @code{crypt()} should have no |
string @samp{$1$}. Passwords encrypted by @code{crypt()} should have no |
1704 |
prefix. |
prefix. |
1730 |
lowers) the access level given as the default for the user's host in the |
lowers) the access level given as the default for the user's host in the |
1731 |
global gnatsd.host_access file. |
global gnatsd.host_access file. |
1732 |
|
|
1733 |
The following shows an example gnatsd.access file with plaintext passwords: |
The following shows an example gnatsd.access file with plain text passwords: |
1734 |
|
|
1735 |
@example |
@example |
1736 |
rickm:$0$ruckm:edit |
rickm:$0$ruckm:edit |
1752 |
|
|
1753 |
The overall user access file |
The overall user access file |
1754 |
@w{@file{@var{SYSCONFDIR}/gnats/gnatsd.access}}, usually |
@w{@file{@var{SYSCONFDIR}/gnats/gnatsd.access}}, usually |
1755 |
@w{@file{/usr/local/etc/gnats/gnatsd.access}}, adds a fourth |
@w{@file{/etc/gnats/gnatsd.access}}, adds a fourth |
1756 |
@var{database} field. This file contains a comma-separated list of |
@var{database} field. This file contains a comma-separated list of |
1757 |
database names, as defined in the @file{databases} file |
database names, as defined in the @file{databases} file |
1758 |
(@pxref{databases file,,The @code{databases} file}. Wildcard characters |
(@pxref{databases file,,The @code{databases} file}. Wildcard characters |