NEWSCTL(5)NEWSCTL(5)NAME
newsctl - USENET network news control files
DESCRIPTION
News control files live in /var/lib/news. The major control files are
the sys file (controlling distribution of news, see newssys(5)) and the
active file (controlling local filing, see newsdb(5)). A number of
minor files are also present.
Mailname contains the Internet domain name of this news system. If
your news system doesn't have an Internet domain name (e.g. dept.uni‐
versity.edu or fredshouse.sf.ca.us), you might consider obtaining one.
Failing that, if your news system is registered in the UUCP maps, you
can use name.uucp where name is your system's UUCP name. If your site
is not registered in the UUCP maps but you have UUCP connections to
other sites, please get registered! It is, strictly speaking, not
acceptable to give DUMBHOST.BITNET as a mailname; Bitnet sites should
obtain and use Internet domain names or be hidden behind gateways. As
a kludge to accommodate unregistered sites who are one hop off regis‐
tered ones, mailname's contents may be of the form ``a@b'', indicating
that mail addresses of the form ``user%a@b'' are correct.
Mailpaths describes how to reach the moderators of various hierarchies
of news groups by mail (to submit postings to moderated groups). Each
line consists of two fields: a news group pattern (see newssys(5)) and
mail address, preferably in UUCP bang notation (site1!site2!user) to
avoid ambiguity. The first line whose group pattern matches the news‐
group is used. An entry for `all' near the end is a good idea, to for‐
ward postings for any otherwise-unrecognised groups to some known
`smart host' (be sure to get the smart-host's permission first). If
the user name of the mail address is `%s', as is usual, the %s is
replaced with the name of the moderated group, except that all dots are
replaced with dashes (e.g. posting to comp.compilers with a mailpaths
entry of all smarthost would generate a mail address of smarthost!comp-
compilers). An unrelated feature of mailpaths is that an entry for the
group internet will be used to route mail replies (manual and auto‐
matic) for sites whose mailers cannot deal directly with From:
addresses.
Organization (or organisation) contains the default value for the Orga‐
nization: header for postings originating locally. Only the first line
is significant.
Postdefltdist and postdefltgroup contain the default distribution and
group, respectively, for local postings.
Server contains the hostname (see hostname(1)) of the server in your
cluster (normally, the host that runs relaynews). If such a file
exists, certain aspects of processing will be redirected from clients
to the server using rsh(1).
Whoami contains the name of this news system, for news purposes. This
is the site name used in Path: headers and so must agree with the name
your news neighbours use in their sys files.
EXAMPLES
A mailname.
world.std.com
A mailpaths for a UUNET customer.
all uunet!%s
internet uunet!%s
A whoami.
world
A server.
world
FILES
/var/lib/news/mailname
/var/lib/news/mailpaths
/var/lib/news/organi[sz]ation
/var/lib/news/postdefltdist
/var/lib/news/postdefltgroup
/var/lib/news/server
/var/lib/news/whoami
SEE ALSOinews(1CN), postnews(1CN), newssys(5)HISTORY
Written by Geoff Collyer for the C News project.
15 Sept 1994 NEWSCTL(5)