NAME
inn.conf - configuration data for InterNetNews programs
DESCRIPTION
The file /usr/local/news/etc/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 environ-
ment 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.
Three parameters are used only by nnrpd when accepting post-
ings 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 ver-
sion, and should normally be ``1.0''.
mime-contenttype
If MIME headers are being added, this parameter speci-
fies 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 speci-
fies 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).
Man(1) output converted with
man2html