home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / news / cnews.tar / readnews / README.aus < prev    next >
Text File  |  1989-09-15  |  5KB  |  132 lines
  1. The files in this distribution are:
  2.  
  3.     Makefile
  4.     README
  5.     active.c
  6.     at.h
  7.     defs.h
  8.     expire.c
  9.     funcs.c
  10.     header.c
  11.     history.c
  12.     lib
  13.     lib/bsearch.c
  14.     lib/memset.c
  15.     lib/strpbrk.c
  16.     lib/tmpfile.c
  17.     lib/tmpnam.c
  18.     maketime.c
  19.     man
  20.     man/postnews.1
  21.     man/readnews.1
  22.     man/uurec.8
  23.     man/uusend.8
  24.     mtempnam.c
  25.     news.help
  26.     newsrc.c
  27.     postnews.c
  28.     readnews.c
  29.     sample.sys
  30.     uurec.c
  31.     uusend.c
  32.  
  33. This news system is modelled on the USENET news system
  34. by Mark Horton (and others).
  35.  
  36. Apart from some minor programs the system has been completely re-written.
  37. The aim of re-writing was to produce a system that was:
  38.     1. smaller
  39.     2. cleaner
  40.     3. faster
  41.     4. was compatible at the site <--> site level with USENET
  42.     5. had a better user interface ("readnews" and "postnews")
  43.  
  44. These goals have been met.
  45. The programs "readnews" and "postnews" are 1/3 the previous size, and
  46. does not require separate I/D space to run on pdp11/70's.
  47. Also far fewer processes are needed to use "postnews".
  48.  
  49. This system is compatible with USENET at the site <--> site level, provided
  50. communication is done with Version B format messages (the current 'standard').
  51. The messages meet the Standard for the format of ARPA Internet Text messages
  52. (RFC 822).
  53.  
  54. "postnews" methods of editing messages is compatible with our local "mail"
  55. program (also re-written locally).
  56.  
  57. To aid someone familiar with USENET to find his/her way around the source:
  58.     Program changes:
  59.     "checknews" has become a function of "readnews" (readnews -cC)
  60.     "postnews" and "inews" are combined into "postnews"
  61.     "readnews" has the same function (simplified user interface)
  62.     "expire" has the same function (simplified arguments)
  63.     "recnews" is not needed
  64.     "sendnews" has been renamed "uusend" (and simplified)
  65.     "uurec" has the same function
  66.     Files:
  67.     The layout of the news database is the same, except that articles
  68.     are named #<number> rather than <number>, so that numbers can
  69.     be a valid newsgroup (like class.6.621).
  70.  
  71.     "/usr/lib/news/active" has an extra field - the lowest numbered article
  72.     present in a newsgroup.
  73.     "/usr/lib/news/history" has a sightly different format.
  74.     "/usr/lib/news/sys" is compatible, except that the third field
  75.     is ignored (always expects format B site); colons are allowed in
  76.     the last field.
  77.  
  78. To setup the news system:
  79.     1. edit the "defs.h" file and make any changes necessary
  80.        in particular: MYDOMAIN, MYORG and the paths of SEQ, SYS etc.
  81.        MANGRPS should not be defined without making suitable
  82.        modifications to getmangrps() in readnews.c
  83.        UNSWMAIL is set if you have the version of mail from UNSW,
  84.        in particular it allows arguments "-s subject -i include_file"
  85.        to specify the subject, and make include_file available to
  86.        a ".i" command (like postnews).
  87.        AUSAM should not be set unless you have the hashed passwd file,
  88.        and locked file facilities of AUSAM.
  89.     1a. edit "Makefile" for the pathnames of LIBDIR, BINDIR and NETDIR.
  90.     2. create the account NEWSROOT (defined in defs.h) (this is where
  91.        the messages are kept).
  92.     3. Run the makefile. If you don't have the routines found in
  93.        lib/* (bsearch, memset etc.) these can be compiled and
  94.        linked in as required.
  95.     4. Create any groups (using "postnews -c 'newgroup <name>'"),
  96.        that require immediate local posting, otherwise groups will
  97.        be created automatically when news is received from other sites.
  98.        Root and NEWSROOT can also mail to non-existent groups, and
  99.        will be asked whether or not to create the new group.
  100.     5. Set up a pseudo user "rnews" to direct received news into
  101.        "postnews -p" (with uid set to NEWSROOT).
  102.        How this is done will depend on your network implementation.
  103.        It may require a deamon emptying a mail box regularly
  104.        (see rnews.sh in this case).
  105.        If a mail interface is required, series of messages can be
  106.        piped into /usr/lib/news/uurec instead.
  107.     6. Set up "/usr/lib/news/sys". See sample.sys for an example.
  108.        Each line in the "sys" file specifies:
  109.         host name
  110.         distribution newsgroups
  111.         (empty field (system assumes type B interchange))
  112.         the command needed to send the item to the host.
  113.        Note the current host must have the first two fields also.
  114.        News transmission can be via "mail" or directly as a
  115.        network file transfer.
  116.     7. Test the system by posting to "to.mysite".
  117.     8. Arrange for "expire" to be run periodically (via "cron" or "at").
  118.  
  119. If you had an existing (old) news system, and wish to transfer the
  120. articles. The best way to do it is run the command:
  121.  
  122.     find oldnewsdir -type f -a -print ^
  123.     while read F
  124.     do
  125.         postnews -p < $F
  126.     done
  127.  
  128. Michael Rourke
  129. University of New South Wales, Australia    13 June 1984
  130. (decvax!mulga!michaelr:elecvax)
  131. (vax135!mulga!michaelr:elecvax)
  132.