Provided by: cnews_cr.g7-40.4_i386 bug
 

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
        inews(1CN), postnews(1CN), newssys(5)
 

HISTORY

        Written by Geoff Collyer for the C News project.
 
                                  15 Sept 1994                     NEWSCTL(5cn)