Provided by: inn_1.7.2q-40build2_amd64 bug

NAME

       inn.conf - configuration data for InterNetNews programs

DESCRIPTION

       The  file  /etc/news/inn.conf  is  used  to determine various parameters.  Blank lines and
       lines starting with a number sign (``#'') are ignored.  All other lines specify parameters
       that may be read, and should be of the following form:
              name : [optional whitespace] value
       Everything  after  the  whitespace  and  up  to the end of the line is taken as the value;
       multi-word values should not be put in quotes.  The case of names is significant —  server
       is not the same as Server or SERVER.

       Some parameters specified in the file may be overridden by environment variables, and some
       file parameters may be used to mask real data, such as when  hiding  a  cluster  of  hosts
       behind a single electronic mail hostname.  The current set of parameters is as follows:

       fromhost
              This  is  the  name  of  the  host  to use when building the From header line.  The
              default is the fully-qualified domain name of the local host.   The  value  of  the
              FROMHOST environment variable, if it exists, overrides this.

       moderatormailer
              This  names  the default machine that contains forwarding aliases for all moderated
              groups.  It is only used if the moderators(5) file doesn't exist, or if  the  group
              is  not  matched  by  that  file.  The value is interpreted as a pattern match; see
              moderators(5).

       organization
              This specifies what to put in the Organization header if it is blank.  The value of
              the ORGANIZATION environment variable, if it exists, overrides this.

       pathhost
              This  specifies how to name the local site when building the Path header line.  The
              default is the fully-qualified domain name of the local host.

       server This specifies the name of the NNTP server to which an article  should  be  posted.
              The value of the NNTPSERVER environment variable, if it exists, overrides this.

       domain This  should  be  the  domain name of the local host.  It should not have a leading
              period, and it should not be a full host address.  It is used only if  the  GetFQDN
              routine in libinn(3) cannot get the fully-qualified domain name by using either the
              gethostname(2) or gethostbyname(3) calls.  The check  is  very  simple;  if  either
              routine  returns  a  name  with a period in it, then it is assumed to have the full
              domain name.

       nntpport
              This is the TCP port INN is accepting connections on.  This  can  be  changed,  for
              example  if  you want to run in.nnrpd from inetd on port 119.  The default value is
              ``119.''

       useactived
              When this parameter is enabled (``yes''), nnrpd will try using the actived program.
              The default value is ``no''.

       The inewsport parameter is only used by inews when posting an article.

       Three parameters are used only by nnrpd when accepting postings from clients:

       mime-version
              If  this parameter is present, then nnrpd will add the necessary MIME (Multipurpose
              Internet Mail Extensions) headers to all any articles that  do  not  have  a  Mime-
              Version  header.  This parameter specifies the MIME version, and should normally be
              ``1.0''.

       mime-contenttype
              If MIME headers are being added, this parameter specifies the value of the Content-
              Type header.  The default value is ``text/plain; charset=US-ASCII.''

       mime-encoding
              If MIME headers are being added, this parameter specifies the value of the Content-
              Transfer-Encoding header.  The default value is ``7bit.''

       Note that this file can be identical on all machines in an organization.

EXAMPLE

              fromhost:           foo.com
              moderatormailer:    %s@uunet.uu.net
              organization:       Foo, Incorporated
              #pathhost -- use FQDN.
              server:             news.foo.com
              domain: foo.com

       This file is intended to be fairly static; any  changes  made  to  it  are  typically  not
       reflected until a program restarts.

HISTORY

       Written  by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  This is revision 1.16, dated
       1996/09/06.

SEE ALSO

       libinn(3), moderators(5).

                                                                                      INN.CONF(5)