/[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.37 by yngves, Thu Oct 24 12:39:52 2002 UTC revision 1.38 by yngves, Sun Oct 27 12:43:36 2002 UTC
# Line 269  backing up the database, and distributin Line 269  backing up the database, and distributin
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
# Line 398  We use a few conventions when referring Line 399  We use a few conventions when referring
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
# Line 611  The @sc{gnu} @code{libiberty} library. Line 612  The @sc{gnu} @code{libiberty} library.
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
# Line 697  particular database.  The files Line 687  particular database.  The files
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    
# Line 1535  The normal response; the supplied text i Line 1526  The normal response; the supplied text i
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
# Line 1627  were given, substitute as appropriate be Line 1618  were given, substitute as appropriate 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    
# Line 1661  arguments: @code{USER <userid> <passwd>} Line 1652  arguments: @code{USER <userid> <passwd>}
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
# Line 1690  general format: Line 1681  general format:
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
# Line 1760  they would be denied access entirely.  T Line 1756  they would be denied access entirely.  T
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

Legend:
Removed from v.1.37  
changed lines
  Added in v.1.38

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