Changes to gnats/doc/gnats.texi

[Milan Zamazal]

Index: gnats/doc/gnats.texi
diff -c gnats/doc/gnats.texi:1.25 gnats/doc/gnats.texi:1.26
*** gnats/doc/gnats.texi:1.25   Mon May 20 08:23:54 2002
--- gnats/doc/gnats.texi        Sun Jul 14 13:27:47 2002
***************
*** 519,525 ****
  related to this specific database, including the @file{categories},
  @file{submitters}, @file{responsible}, @file{states}, @file{classes},
  @file{dbconfig}, @file{addresses}, @file{states} and
! @file{gnatsd.access}, as well as two
  files generated and maintained by @sc{gnats}, @file{index} and
  @file{current}.
  
--- 519,525 ----
  related to this specific database, including the @file{categories},
  @file{submitters}, @file{responsible}, @file{states}, @file{classes},
  @file{dbconfig}, @file{addresses}, @file{states} and
! @file{gnatsd.user_access}, as well as two
  files generated and maintained by @sc{gnats}, @file{index} and
  @file{current}.
  
***************
*** 627,637 ****
  all databases on the server.  @xref{gnatsd.host_access,,The
  @file{gnatsd.host_access} file}.
  
! @item gnatsd.access
  The access-level settings for the users that will be accessing
  the databases on your server.  The settings in this file apply across
! all databases on the server.  @xref{gnatsd.access,,The
! @file{gnatsd.access} file}.
  @end table
  
  @item @var{prefix}/share/emacs/site-lisp
--- 627,637 ----
  all databases on the server.  @xref{gnatsd.host_access,,The
  @file{gnatsd.host_access} file}.
  
! @item gnatsd.user_access
  The access-level settings for the users that will be accessing
  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}.
  @end table
  
  @item @var{prefix}/share/emacs/site-lisp
***************
*** 688,694 ****
  
  @item states
  
! @item gnatsd.access
  
  @item index
  (@emph{This file is created by @sc{gnats}.})
--- 688,694 ----
  
  @item states
  
! @item gnatsd.user_access
  
  @item index
  (@emph{This file is created by @sc{gnats}.})
***************
*** 1558,1564 ****
  * Overview::
  * Overall gnatsd access level::
  * gnatsd.host_access::           Per-host access settings
! * gnatsd.access::                Access levels per user
  * Privileged gnatsd commands::
  @end menu
  
--- 1558,1564 ----
  * Overview::
  * Overall gnatsd access level::
  * gnatsd.host_access::           Per-host access settings
! * gnatsd.user_access::           Access levels per user
  * Privileged gnatsd commands::
  @end menu
  
***************
*** 1660,1676 ****
  than is set for their host.  The gnatsd @code{USER} command takes two
  arguments: @code{USER <userid> <passwd>}.
  
! @node gnatsd.access
  @section Access levels per user
! @cindex @file{gnatsd.access}
  
  Access levels per user can be set both across all databases on the
! server or on a per-database basis.  The @file{gnatsd.access} file in a
  database's @file{gnats-adm} directory specifies the user access rules
  for that database.  If it doesn't exist, or doesn't contain the user
  name given to @code{gnatsd}, then the file
! @address@hidden@var{SYSCONFDIR}/gnats/gnatsd.access}}, usually
! @address@hidden/etc/gnats/gnatsd.access}}, specifying the per-user
  access levels across all the databases on the server is checked.
  
  The user access files can only @emph{increase} the access level
--- 1660,1676 ----
  than is set for their host.  The gnatsd @code{USER} command takes two
  arguments: @code{USER <userid> <passwd>}.
  
! @node gnatsd.user_access
  @section Access levels per user
! @cindex @file{gnatsd.user_access}
  
  Access levels per user can be set both across all databases on the
! server or on a per-database basis.  The @file{gnatsd.user_access} file in a
  database's @file{gnats-adm} directory specifies the user access rules
  for that database.  If it doesn't exist, or doesn't contain the user
  name given to @code{gnatsd}, then the file
! @address@hidden@var{SYSCONFDIR}/gnats/gnatsd.user_access}}, usually
! @address@hidden/etc/gnats/gnatsd.user_access}}, specifying the per-user
  access levels across all the databases on the server is checked.
  
  The user access files can only @emph{increase} the access level
***************
*** 1680,1686 ****
  If the access level is @code{none} after processing the userid and
  password, the connection is closed.
  
! The @file{gnatsd.access} files can contain plain text passwords, in
  such a case they should be owned by the @sc{gnats} user with file
  permission 600.
  
--- 1680,1686 ----
  If the access level is @code{none} after processing the userid and
  password, the connection is closed.
  
! The @file{gnatsd.user_access} files can contain plain text passwords, in
  such a case they should be owned by the @sc{gnats} user with file
  permission 600.
  
***************
*** 1688,1694 ****
  plain text passwords.  A null string or @samp{*} matches anything;
  @samp{?} matches any one character.
  
! Entries in the database-specific @file{gnatsd.access} user access file
  in the @file{gnats-adm} directory of the database have the following
  general format:
  
--- 1688,1694 ----
  plain text passwords.  A null string or @samp{*} matches anything;
  @samp{?} matches any one character.
  
! Entries in the database-specific @file{gnatsd.user_access} user access file
  in the @file{gnats-adm} directory of the database have the following
  general format:
  
***************
*** 1706,1712 ****
  string @samp{$1$}.  Passwords encrypted by @code{crypt()} should have no
  prefix.
  
! A @code{gnats-passwd} tool to manage @file{gnatsd.access} files is
  planned.  In the meantime, @code{crypt()} passwords can be generated by
  using standard UNIX passwords tools, while MD5 passwords can be
  generated with the following little Perl snippet:
--- 1706,1712 ----
  string @samp{$1$}.  Passwords encrypted by @code{crypt()} should have no
  prefix.
  
! A @code{gnats-passwd} tool to manage @file{gnatsd.user_access} files is
  planned.  In the meantime, @code{crypt()} passwords can be generated by
  using standard UNIX passwords tools, while MD5 passwords can be
  generated with the following little Perl snippet:
***************
*** 1724,1730 ****
  perl -MCPAN -e 'install Crypt::PasswdMD5'
  @end example
  
! A tool for conversion of pre-version 4 @file{gnatsd.access} files is
  distributed with @sc{gnats} 4.  @xref{gnats-pwconv,,Converting old
  password files}.
  
--- 1724,1730 ----
  perl -MCPAN -e 'install Crypt::PasswdMD5'
  @end example
  
! A tool for conversion of pre-version 4 @file{gnatsd.user_access} files is
  distributed with @sc{gnats} 4.  @xref{gnats-pwconv,,Converting old
  password files}.
  
***************
*** 1733,1739 ****
  lowers) the access level given as the default for the user's host in the
  global gnatsd.host_access file.
  
! The following shows an example gnatsd.access file with plain text passwords:
  
  @example
  rickm:$0$ruckm:edit
--- 1733,1740 ----
  lowers) the access level given as the default for the user's host in the
  global gnatsd.host_access file.
  
! The following shows an example @file{gnatsd.user_access} file with
! plain text passwords:
  
  @example
  rickm:$0$ruckm:edit
***************
*** 1754,1761 ****
  to anyone.
  
  The overall user access file
! @address@hidden@var{SYSCONFDIR}/gnats/gnatsd.access}}, usually
! @address@hidden/etc/gnats/gnatsd.access}}, adds a fourth
  @var{database} field.  This file contains a comma-separated list of
  database names, as defined in the @file{databases} file
  (@pxref{databases file,,The @code{databases} file}.  Wildcard characters
--- 1755,1762 ----
  to anyone.
  
  The overall user access file
! @address@hidden@var{SYSCONFDIR}/gnats/gnatsd.user_access}}, usually
! @address@hidden/etc/gnats/gnatsd.user_access}}, adds a fourth
  @var{database} field.  This file contains a comma-separated list of
  database names, as defined in the @file{databases} file
  (@pxref{databases file,,The @code{databases} file}.  Wildcard characters