/[gnats]/gnats/doc/gnats.texi
ViewVC logotype

Diff of /gnats/doc/gnats.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.21 by pdm, Sat Dec 15 15:21:54 2001 UTC revision 1.22 by pdm, Sun Dec 23 20:20:43 2001 UTC
# Line 1330  was successful, or one or more error cod Line 1330  was successful, or one or more error cod
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
# Line 1615  were given, substitute as appropriate be Line 1628  were given, substitute as appropriate be
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    
# Line 1653  database's @file{gnats-adm} directory sp Line 1667  database's @file{gnats-adm} directory sp
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
# Line 1671  general format: Line 1691  general format:
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.
# Line 1710  the beginning of this appendix.  This ov Line 1730  the beginning of this appendix.  This ov
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
# Line 1732  to anyone. Line 1752  to anyone.
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

Legend:
Removed from v.1.21  
changed lines
  Added in v.1.22

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26