home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / how_to.zip / NEWS.HOW < prev    next >
Text File  |  1994-04-29  |  34KB  |  849 lines
  1. Archive-name: linux/howto/news
  2. Last-modified: 19 Apr 94
  3.  
  4.   The Linux News HOWTO
  5.   Vince Skahan, <vince@victrola.wa.com>
  6.   v1.7, Last modified 26 March 1994
  7.  
  8.   This  document  describes  the  setup  and care+feeding of USENET News
  9.   under Linux.  You need to read this if you plan to post or read USENET
  10.   news either locally on your site or between your site and other sites.
  11.   You probably do *not* need to read this document if don't plan to pro-
  12.   vide USENET news as a feature of your system.
  13.  
  14.   1.  Introduction
  15.  
  16.   The  intent  of  this  document is to answer some of the questions and
  17.   comments that appear to  meet  the  definition  of  "frequently  asked
  18.   questions"  about USENET News software under Linux in general, and the
  19.   version in the Linux SLS distribution in particular.
  20.  
  21.   This document and the corresponding Mail and  UUCP  "HOWTO"  documents
  22.   collectively supersede the UUCP-NEWS-MAIL-FAQ that has previously been
  23.   posted to comp.os.linux.announce.
  24.  
  25.  
  26.   1.1.  New versions of this document
  27.  
  28.   New  versions  of  this  document  will  be  periodically  posted   to
  29.   comp.os.linux.announce,  comp.answers,  and  news.answers.   They will
  30.   also be added to the various anonymous  ftp  sites  who  archive  such
  31.   information including sunsite.unc.edu:/pub/Linux/docs/HOWTO.
  32.  
  33.  
  34.   1.2.  Feedback
  35.  
  36.   I  am  interested in any feedback, positive or negative, regarding the
  37.   content of this document via e-mail.  Definitely  contact  me  if  you
  38.   find errors or obvious omissions.
  39.  
  40.   I  read,  but  do  not  necessarily  respond to, all e-mail I receive.
  41.   Requests for enhancements will be considered and acted upon  based  on
  42.   that  day's  combination  of available time, merit of the request, and
  43.   daily blood pressure :-)
  44.  
  45.   Flames will quietly go to /dev/null so don't bother.
  46.  
  47.   Feedback concerning the actual format of the document should go to the
  48.   HOWTO coordinator - Matt Welsh (mdw@sunsite.unc.edu).
  49.  
  50.  
  51.   1.3.  Copyright Information
  52.  
  53.   The News-HOWTO is copyrighted (c)1994 Vince Skahan.
  54.  
  55.   A  verbatim  copy  may  be  reproduced  or  distributed  in any medium
  56.   physical or electronic without permission of the author.  Translations
  57.   are  similarly  permitted  without express permission if it includes a
  58.   notice on who translated it.
  59.  
  60.   Short quotes  may  be  used  without  prior  consent  by  the  author.
  61.   Derivative  work  and  partial distributions of the News-HOWTO must be
  62.   accompanied with either a verbatim copy of this file or a  pointer  to
  63.   the verbatim copy.
  64.  
  65.   Commercial  redistribution  is  allowed  and  encouraged; however, the
  66.   author would like to be notified of any such distributions.
  67.  
  68.   In short, we wish to promote dissemination of this information through
  69.   as  many channels as possible. However, we do wish to retain copyright
  70.   on the HOWTO documents, and would like to be notified of any plans  to
  71.   redistribute the HOWTOs.
  72.  
  73.   We  further  want  that  ALL  information  provided  in  the HOWTOS is
  74.   disseminated.  If you have questions, please contact Matt  Welsh,  the
  75.   Linux HOWTO coordinator, at mdw@sunsite.unc.edu, or +1 607 256 7372.
  76.  
  77.  
  78.   1.4.  Standard Disclaimer
  79.  
  80.   Of  course, I disavow any potential liability for the contents of this
  81.   document.  Use of the concepts, examples, and/or other content of this
  82.   document is entirely at your own risk.
  83.  
  84.  
  85.   1.5.  Other sources of information
  86.  
  87.  
  88.  
  89.   1.5.1.  USENET
  90.  
  91.  
  92.      news.admin.misc         General topics of network news administration.
  93.      news.admin.policy       Policy issues of USENET.
  94.      news.admin.technical    Maintaining network news. (Moderated)
  95.      news.software.b         Discussion about B-news-compatible software.
  96.      news.software.nn        Discussion about the "nn" news reader package.
  97.      news.software.nntp      The Network News Transfer Protocol.
  98.      news.software.readers   Software used to read network news.
  99.      news.sysadmin           Comments directed to system administrators.
  100.      news.announce.newusers  Explanatory postings for new users. (Moderated)
  101.      news.newusers.questions Q & A for users new to the Usenet.
  102.  
  103.  
  104.  
  105.  
  106.   1.5.2.  Books
  107.  
  108.   The following is a non-inclusive set of books that will help
  109.  
  110.  
  111.   o  "Managing  UUCP  and USENET" published by O'Reilly+Associates is in
  112.      my opinion the best book out there for figuring  out  the  programs
  113.      and protocols involved in being a USENET site.
  114.  
  115.   o  "Unix  Communications" published by The Waite Group contains a nice
  116.      description of all the pieces (and more) and how they fit together.
  117.  
  118.   o  "Practical  Unix  Security"  published by O'Reilly+Associates has a
  119.      nice discussion of how to secure UUCP in general.
  120.  
  121.   o  "The Internet Complete Reference" from Osborne is a fine  reference
  122.      book  that  explains the various services available on Internet and
  123.      is a great "one-stop-shopping"  source  for  information  on  news,
  124.      mail, and various other Internet resources.
  125.  
  126.  
  127.   1.6.  Where NOT to look for help
  128.  
  129.   There  is  nothing "special" about configuring and running USENET news
  130.   under Linux (any more).  Accordingly, you almost  certainly  do  *NOT*
  131.   want   to   be   posting   generic   news-related   questions  to  the
  132.   comp.os.linux.* newsgroups.
  133.  
  134.   Unless your posting is truly Linux-specific (ie, "please tell me  what
  135.   patches  are  needed  to  run INN with the bash1.12 in SLS v1.03") you
  136.   should be asking your questions in the newsgroups mentioned above.
  137.  
  138.   Let me repeat that.
  139.  
  140.   There is virtually no reason to  post  anything  news-related  in  the
  141.   comp.os.linux  hierarchy  any  more.  There are existing newsgroups in
  142.   the news.*  hierarchy to handle *ALL* your questions.
  143.  
  144.   IF YOU POST TO COMP.OS.LINUX.* FOR NON-LINUX-SPECIFIC  QUESTIONS,  YOU
  145.   ARE LOOKING IN THE WRONG PLACE FOR HELP.  THE USENET NEWS EXPERTS HANG
  146.   OUT IN THE PLACES INDICATED ABOVE AND GENERALLY DO NOT RUN LINUX.
  147.  
  148.   POSTING TO THE LINUX HIERARCHY FOR NON-LINUX-SPECIFIC QUESTIONS WASTES
  149.   YOUR  TIME  AND  EVERYONE  ELSE'S  AND  IT  FREQUENTLY DELAYS YOU FROM
  150.   GETTING THE ANSWER TO YOUR QUESTION.
  151.  
  152.  
  153.   2.  Hardware Requirements
  154.  
  155.   There are no specific hardware  requirements  for  USENET  News  under
  156.   Linux.   The  only requirement of any type is sufficient disk space to
  157.   hold the software itself, the threads database(s), and the  amount  of
  158.   news  you wish to keep on the system.  Figure on a minimum of 10 MB of
  159.   disk space for starters.
  160.  
  161.  
  162.   3.  Getting USENET News software
  163.  
  164.   All the software referenced in this "HOWTO" is available on the  usual
  165.   Internet anonymous ftp sites.
  166.  
  167.   Looking in /news on ftp.uu.net is usually a good way to start.
  168.  
  169.   The  newspak-2.1.tar.z  distribution  contains config files and readme
  170.   files related to building uucp, news, and mail  software  under  Linux
  171.   from the various freely-available sources.  It can usually be found on
  172.   sunsite.unc.edu in the directory /pub/Linux/system/Mail.
  173.  
  174.  
  175.   4.  News Transport Software
  176.  
  177.   There are two main sets of news "transport" software  for  *nix  these
  178.   days,  Cnews  and  INN.   The old "Bnews" has been declared officially
  179.   dead and unsupported by its authors.
  180.  
  181.   News "transport" is defined here to be the software that works  behind
  182.   the  scenes  to post and propagate the news articles as well as making
  183.   the articles available for the newsreaders to access.
  184.  
  185.   You can set your paths to anything you like, as long as UUCP  has  the
  186.   absolute path to rnews in the Permissions file and as long as you have
  187.   your newsreaders configured so that they can find "inews" and  "mail".
  188.  
  189.   Important - you're asking for trouble if you try to intermix Cnews and
  190.   INN.  Pick one or the other.  It's  ok  to  add  the  NNTP  "Reference
  191.   Release" into Cnews since they're intended to play well together.
  192.  
  193.  
  194.   4.1.  Cnews Performance Release
  195.  
  196.   The  current  de-facto  standard  news software is Cnews.  It has been
  197.   around for a number of years, I first saw it sometime around 1988.
  198.  
  199.   Cnews's main benefit is its maturity.  It runs on about every *nix you
  200.   can  find  and  there  are  literally  thousands of systems running it
  201.   worldwide.
  202.   Its main disadvantage is that it seems to have been intended for uucp-
  203.   over-modem connections between sites and as such requires the addition
  204.   of NNTP software to handle realtime Internet feeds and reading.
  205.  
  206.   In addition, it requires external threading packages for  the  various
  207.   newsreaders,  although  the  NOV  package can now be hooked in to help
  208.   somewhat and it's rumored to have native NOV support in  the  upcoming
  209.   "cleanup" release.
  210.  
  211.   Regardless, the beginning USENET admin should probably run Cnews first
  212.   since it's so stable, well  documented,  and  has  many  thousands  of
  213.   experienced administrators who can answer questions.
  214.  
  215.   The  newspak-2.1.tar.z distribution on sunsite contains working config
  216.   files for Cnews under Linux as well as a couple line patch you'll need
  217.   to  make  to  "doexplode"  to  get around some problems with bash1.12.
  218.   bash1.13 is now available on the  various  Linux  archive  sites  that
  219.   should help.
  220.  
  221.  
  222.   4.1.1.  Installing Cnews
  223.  
  224.   Installing  the  Performance  Release  of Cnews is absolutely a "rtfm"
  225.   project.   Just  grab  the  sources,  extract  them,  and  follow  the
  226.   instructions.
  227.  
  228.   The  build.def  in  newspak was generated by running "build" the first
  229.   time  and  simply  looking  up  the  answers  by  checking   out   the
  230.   /usr/include files to get the right answers.
  231.  
  232.   When  you  start  the  actual  compilation,  it'll blow up a couple of
  233.   times.  In all cases, you'll need to simply comment out  a  couple  of
  234.   atoi()  and  atol()  macros  that  gcc doesn't like when your doit.bin
  235.   compilation blows up.
  236.  
  237.   Also, you need the following tiny change to doexplode  to  get  around
  238.   some bash1.12 bugs or else you won't feed anything downstream
  239.  
  240.  
  241.           (from Steve Robbins -  steve@nyongwa.cam.org )
  242.  
  243.           if [ ! -f $f ] ; then continue; fi              # add this line
  244.           #       case "$f" in                            # comment me out
  245.           #       "out.master/[0-9]*")    break ;;        # comment me out
  246.           #       esac                                    # comment me out
  247.  
  248.  
  249.   Henry  Spencer  of  Cnews fame says that the code in doexplode that is
  250.   currently causing problems with bash is on the list to be revised in a
  251.   future release.
  252.  
  253.   It  is  uncertain at this time if the need for this patch goes away if
  254.   you switch to the bash1.13 now available for Linux.  I switched to the
  255.   new  bash  and libs and left the patch in place and nothing broke (for
  256.   what that's worth :-)
  257.  
  258.  
  259.   4.1.2.  Configuring Cnews
  260.  
  261.   At the very least, you need to  edit  the  following  files  that  all
  262.   should be in /usr/local/lib/news:
  263.  
  264.  
  265.  
  266.  
  267.  
  268.   active             - the active file
  269.   batchparms         - batch parameters
  270.   explist            - article expiration setup
  271.   mailname           - name in headers for mailed replies
  272.   mailpaths          - path to mail moderated postings to
  273.   organization       - your "org"
  274.   sys                - control what you take and feed
  275.   whoami             - your hostname for the Path: line
  276.  
  277.  
  278.  
  279.  
  280.   4.1.3.  Maintaining a Cnews Site
  281.  
  282.   First,  a  significant rule of thumb is to not mess with files by hand
  283.   that have utilities that configure them. In particular  don't  set  up
  284.   newsfeeds (run "addfeed" instead) and don't mess with your active file
  285.   (run "addgroup").  When in doubt, read and re-read  the  docs  in  the
  286.   source distribution.
  287.  
  288.   Everything  else  can  be  done via cron.  My crontab for "news" looks
  289.   like the following:
  290.  
  291.  
  292.           # take the compressed batches that came in from other systems
  293.           20 *       * * * /usenet/sw/news/bin/input/newsrun
  294.  
  295.           # batch 'em up to go out
  296.           0 *        * * * /usenet/sw/news/bin/batch/sendbatches myfeedsite
  297.  
  298.           # expire C-news
  299.           59 0       * * * /usenet/sw/news/bin/expire/doexpire
  300.  
  301.           # monitor stuff and report if needed
  302.           10 5       * * * /usenet/sw/news/bin/newsdaily
  303.           00 5       * * * /usenet/sw/new/bin/newswatch
  304.  
  305.           # turn processing of incoming news batches off 6:30AM - 4:00 PM
  306.           30 6       * * * /usenet/sw/news/bin/input/newsrunning off
  307.           00 16      * * * /usenet/sw/news/bin/input/newsrunning on
  308.  
  309.  
  310.  
  311.  
  312.   4.2.  InterNetNews (INN)
  313.  
  314.   INN is the newcomer on the scene, but it's gaining  popularity  as  it
  315.   matures.   Its  main benefit is speed and the fact that it contains an
  316.   integrated nntp package.  Its main drawback is that it's new and  that
  317.   it  doesn't  necessarily  install  and  run  flawlessly  on  the  many
  318.   "standard *nixes" yet.  In addition, it operates by  having  a  daemon
  319.   (the  innd)  always  running  plus potentially a overchan daemon to do
  320.   threading.  The tradeoff seems to be memory vs. speed.
  321.  
  322.   New USENET  admins  should  probably  not  try  INN  until  they  have
  323.   experience  with either B-news or Cnews.  While it's fast and reliable
  324.   under Linux,  it's  virtually  undocumented  for  the  beginning  news
  325.   administrator  (though  in practice it's rather simple to run once you
  326.   figure it out).
  327.  
  328.   INN is very particular about its permissions.  Don't mess with them.
  329.  
  330.   INN is also very particular about having a "quality"  TCP/IP  to  work
  331.   with.   Linux is not necessarily all the way there at this time, so it
  332.   is recommended that you grab a Linux-specific  INN  distribution  from
  333.   one of the usual Linux archive sites.
  334.   4.2.1.  Installing INN
  335.  
  336.   ( from Arjan de Vet - devet@info.win.tue.nl )
  337.  
  338.   I've  made a patch + config kit for INN 1.4 to get it to run on Linux.
  339.   It can be found at:
  340.  
  341.   ftp.win.tue.nl:/pub/linux/ports/inn-1.4-linux.tar.gz
  342.  
  343.   INN depends heavily on a good /bin/sh substitute. I use a beta version
  344.   of  bash  1.13  that  is now available for Linux on the normal archive
  345.   sites.  bash 1.12 gives some small problems with newgroups  not  being
  346.   handled correctly (maybe some other problems too, I don't remember).
  347.  
  348.  
  349.   4.2.2.  Configuring INN
  350.  
  351.   Basically  follow  Arjan's instructions and you'll be all set.  Here's
  352.   the summary of what to do:
  353.  
  354.  
  355.   o  In config.data, make sure you have "HAVE_UNIX_DOMAIN DONT"
  356.  
  357.   o  Add the hostname of the system running innd  to  hosts.nntp  For  a
  358.      uucp-only site, that's your sitename.
  359.  
  360.   o  Make sure you do not have a line for nntp in /etc/inetd.conf
  361.  
  362.   o  Make  sure  that  you have innshellvars say "HAVE_UUSTAT DO" rather
  363.      than the "DONT" in his example config.data if you have uustat  from
  364.      the Taylor UUCP package installed.  If you have this defined wrong,
  365.      it'll result in no outgoing news getting batched.
  366.  
  367.   o  If you run INN, definitely define  the  recommended  syslogd  stuff
  368.      because it is very, very helpful.
  369.  
  370.      There  is  a spectacular (!!!!) FAQ for INN that comes out monthly.
  371.      Look on rtfm.mit.edu for it.  You'll be glad you did.
  372.  
  373.  
  374.   4.2.3.  Maintaining a INN Site
  375.  
  376.   I've found that there's essentially zero care-and-feeding of  a  Linux
  377.   INN  site  other  than  having a working "cron".  Basically you want a
  378.   crontab that looks something like the following:
  379.  
  380.  
  381.           # daily maint, also expire the .overview database and articles
  382.           1 0 * * * /usenet/sw/inn/bin/news.daily expireover delayrm <
  383. /dev/null
  384.  
  385.           # send 'em out
  386.           5 * * * * /usenet/sw/inn/lib/send-uucp
  387.  
  388.  
  389.  
  390.   ( if you switch to bash1.13, the "< /dev/null" above is not needed )
  391.  
  392.  
  393.   4.3.  Other News Transport Agents
  394.  
  395.   The following is a non-inclusive list of other news transport software
  396.   known to work under Linux:
  397.  
  398.   dynafeed, nntp1.5.11, slurp1.05
  399.  
  400.  
  401.   5.  News Readers
  402.  
  403.   There  is no "one true newsreader".  As a result, there are many well-
  404.   known newsreaders that port easily to Linux in  particular.   At  this
  405.   writing,  "tin", "trn", and "nn" are in most of the commonly available
  406.   distributions of Linux and in.
  407.  
  408.   When picking a newsreader, you basically want to find  something  that
  409.   is easy to use, very configurable by the user, with threading and kill
  410.   files (to select interesting articles or make the non-interesting ones
  411.   not appear at all).
  412.  
  413.   You  can  set  your  paths  to  anything  you  like as long as all the
  414.   newsreaders can find "inews" from your Cnews or INN installation and a
  415.   "mail" program to send mail replies to posts.
  416.  
  417.   This section will talk briefly about several of the most popular ones.
  418.   Before you ask, I use "nn" for lots of reasons :-)
  419.  
  420.  
  421.   5.1.  Tin
  422.  
  423.   Tin is a threaded newsreader generally intended to  be  easy  for  new
  424.   users.   It  supports kill files and NOV threading.  If you're running
  425.   INN, it will read NOV .overview files by default and not  write  index
  426.   files.
  427.  
  428.   To  compile  Tin  under linux, basically just edit the makefile to set
  429.   the locations of the software (especially the location of  inews)  and
  430.   type "make linux".  There are no patches required for tin under Linux.
  431.  
  432.   For threading, you can basically just say "tin -u" to update the index
  433.   files.
  434.  
  435.   To  enable  the  ability  to  read  via NNTP, compile with "NNTP_ABLE"
  436.   defined.  This will result in a file called "tin" for  local  and  one
  437.   called  "rtin"  for  NNTP  reading.   "tin  -r" will also get the same
  438.   behavior as "rtin".
  439.  
  440.   Iain Lea recommends the following crontab entry and says that you need
  441.   to do a "make daemon" to make tind.
  442.  
  443.  
  444.           # thread the database
  445.           35 * * * * /usenet/bin/tind -u
  446.  
  447.  
  448.  
  449.  
  450.   5.2.  Trn/Mthreads
  451.  
  452.   trn  is  a threaded derivative of the "rn" newsreader.  trn3.3 has the
  453.   nice ability to select either the "mthreads" (trn's threading package)
  454.   or NOV (threader from INN) threading.
  455.  
  456.   To  compile  it,  just run Configure and take the calculated defaults.
  457.   You might need to have lib4.4.1 and bash-1.13 (there  is  a  beta  now
  458.   available  on  the  various  Linux  archive sites) to successfully run
  459.   Configure.  You'll probably need both bash1.13 and  libs4.4.1  to  get
  460.   the new Configure to run properly.
  461.  
  462.   The  newspak-2.1.tar.z distribution on sunsite contains working config
  463.   files for trn under Linux.
  464.  
  465.   It's probably unwise to try to edit a trn  config.sh  by  hand  unless
  466.   you're  doing  something  *VERY* simple like changing the paths to fit
  467.   your tastes.  If you do so, you'll need to run "Configure  -S"  before
  468.   you "make depend", "make", and "make install".
  469.  
  470.   Although  "Configure"  fails  generally  under  Linux  with  bash1.12,
  471.   "Configure -S" work fine so if you take the  newspak  config.sh  as  a
  472.   starting point, you'll be very close.
  473.  
  474.   Compiling  for  NNTP  reading  is  as  simple  as answering "yes" when
  475.   Configure asks you if you want to do so (assuming Configure runs ok on
  476.   your  system).   A  future release of newspak will include a config.sh
  477.   for NNTP reading as well as the existing one  for  local  reading  for
  478.   those of us who are still "bash-impaired" :-)
  479.  
  480.   There  are dozens of command line switches for trn to get all kinds of
  481.   behavior.  Read the "trn" man page for details.  I use a nice  feature
  482.   to set all the switches easily:
  483.  
  484.  
  485.   o  add all the settings in a file called  /.trnrc
  486.  
  487.   o  export TRNINIT=" /.trnrc"
  488.  
  489.   A future newspak will have my .trnrc file as an example.
  490.  
  491.   trn3.2  and  above  has  support  for NOV or mthreads threading that's
  492.   user-selectable.  Accordingly, I recommend building  the  software  to
  493.   allow  both  threading  mechanisms (it's a question in Configure).  To
  494.   pick one at runtime, try "trn -Zo" for NOV and "trn -Zt" for mthreads.
  495.  
  496.   To build the mthreads database, do something like the following in the
  497.   "news" crontab:
  498.  
  499.  
  500.           # thread the trn database
  501.           35 * * * * /usenet/bin/mthreads all
  502.  
  503.  
  504.  
  505.   5.3.  NN
  506.  
  507.   The newspak-2.1.tar.z distribution on sunsite contains working  config
  508.   files  for nn6.4.18 that you can drop into place and type "make" under
  509.   Linux. They also work with the 6.5b2 beta of the coming nn6.5  update.
  510.  
  511.   When you're done compiling, you need to do the following:
  512.  
  513.   o  - run the "inst" program to install things.  (install everything)
  514.  
  515.   o  - initialize the database
  516.  
  517.   o  - fire up nnmaster
  518.  
  519.   See  the  nn docs for details.  Compiling, configuring, and running nn
  520.   under Linux is no different than running nn on any other *nix with the
  521.   exception  that  you  probably  want  to  run nnmaster as a cron entry
  522.   rather than as a daemon.  If you run it as a daemon  under  linux,  it
  523.   doesn't  tend  to  wake up properly (the net effect of running it from
  524.   cron is the same anyway).
  525.  
  526.   Support of "nn" is as simple as the following crontab entries:
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.           # run nnmaster to collect "nn" stuff
  534.           25 * * * * /usenet/sw/nn/lib/nnmaster
  535.  
  536.           # expire the nn database
  537.           0  4       * * * /usenet/sw/nn/bin/nnadmin =EYW
  538.  
  539.           # stash a copy of the active file for "nngoback" and keep last 7
  540.           0 3 * * * /usenet/sw/nn/lib/back_act 7
  541.  
  542.  
  543.  
  544.  
  545.   5.4.  Other newsreaders
  546.  
  547.   The following is a non-inclusive list of newsreaders said  to  install
  548.   and run under Linux:
  549.  
  550.   tass, xrn, gnus
  551.  
  552.   6.  Acknowledgements
  553.  
  554.  
  555.   The  following  people  have helped in the assembly of the information
  556.   (and experience) that helped make this document possible:
  557.  
  558.   Ed Carp, Steve Robbins, Ian Taylor, Greg Naber, Matt Welsh, Iain  Lea,
  559.   Arjan de Vet
  560.  
  561.   If I forgot anybody, my apologies
  562.  
  563.  
  564.   7.  Frequently Asked Questions about USENET (in c.o.l.* anyway)
  565.  
  566.  
  567.  
  568.   7.1.  Why can't I post to moderated groups ?
  569.  
  570.   Probably because the newsreader is trying to call  /bin/mail  to  send
  571.   the  mail  and  it doesn't like it.  Replace the /bin/mail in SLS with
  572.   the port of mailx-5.3b.tar.z from  the  pub/Linux/system/Mail  dir  on
  573.   sunsite.unc.edu  and make it mode 2755 and group mail (like "elm") and
  574.   you'll be all set.
  575.  
  576.   Another possibility is that you have a moderated newsgroup set  up  on
  577.   your  local  system  as not-moderated and somebody upstream is quietly
  578.   deleting the article (some system's software,  not  a  person).   Make
  579.   sure  you  run a "checkgroups" every now and then when the checkgroups
  580.   article rolls by in news.admin every few weeks.
  581.  
  582.  
  583.   7.2.  Why do I have problems that appear to be permission-related ?
  584.  
  585.   Check  to  see  that  your  permissions  are right and that you have a
  586.   "news" username and group in /etc/passwd and /etc/group  that  matches
  587.   the binary distribution you grabbed.  It seems that there is not yet a
  588.   Linux-standard for commonly available accounts.
  589.  
  590.   All the  stuff  in  /usr/local/lib/news  should  be  news.news  except
  591.   /usr/local/lib/news/setnewsids which should be setuid root.
  592.  
  593.   You can use whatever UID and GID you want for "news".
  594.  
  595.  
  596.  
  597.  
  598.  
  599.   7.3.   Why  can  I post articles locally, but they don't get fed down-
  600.   stream ?
  601.  
  602.   Probably because you didn't call newsrun from cron.  Maybe because you
  603.   edited your sys file and messed it up.  Maybe because you don't have a
  604.   /usr/spool/news/out.going tree or something.
  605.  
  606.   Do  not create newsgroups or feeds by editing the active or sys files.
  607.   Use the utilities in /usr/local/lib/news/bin/maint to do it.
  608.  
  609.  
  610.   7.4.   Why  doesn't  my  binary  distribution  have  the  "Performance
  611.   Release" of C-news?
  612.  
  613.   Because it's optional.  Because it has problems under  Linux  in  some
  614.   places.   Because the Pre-Performance Release Cnews is more stable and
  615.   plenty fast enough on any type of reasonable  system  (IMHO).  If  you
  616.   need  any  more  convincing,  here's  a  few  excerpts from the C-news
  617.   README.new file:
  618.  
  619.   "This is the 20 Feb 1993 Performance Release of C News, a minor update
  620.   to  the 2 May 1992 P.R. that just fixes some installation problems and
  621.   a couple of annoying bugs"
  622.  
  623.   "This release is more or less  a  halfway  step  to  what  we've  been
  624.   calling the "cleanup release""
  625.  
  626.   "People who are happy with the older C News might want to wait for the
  627.   cleanup release, which is still coming although behind schedule"
  628.  
  629.   Mainly because at the time SLS1.01 came out, the  compilers  and  libs
  630.   didn't  like the Performance Release too much.  Things are better now.
  631.  
  632.  
  633.   7.5.  Why doesn't my binary distribution have nntp ?
  634.  
  635.   Because it's supposed to be plug-n-play  under  Linux  and  because  I
  636.   didn't  want to make SLS's news stuff doubly big by having to maintain
  637.   both nntp and non-nntp versions of the newsreaders and news  transport
  638.   programs.   Also  because it compiles in localized information that is
  639.   not overridable at runtime via a config file.
  640.  
  641.  
  642.   7.6.  Why does doexpire (or relaynews or) say "severe space  shortage"
  643.   when there's lots of room ?
  644.  
  645.   Because it can't read /etc/mtab.  Make it mode 644.  This happens when
  646.   you  unmount  a  mounted  filesystem by root with a umask that doesn't
  647.   permit world-read of files owned by root.
  648.  
  649.  
  650.   7.7.  Why does everything look normal, but posting doesn't happen ?
  651.  
  652.   Older  versions  of  Linux had a "broken" sed that C-news was prone to
  653.   blow up.  In particular, if you've installed over an old SLS, be  sure
  654.   to check /bin and /usr/bin to be certain you have only one copy of sed
  655.   and that it's a modern one.
  656.  
  657.  
  658.   7.8.  the various independent thread databases ?  Can I hook  the  new
  659.   news overview (NOV) stuff into trn/tin/nn to replace
  660.  
  661.   Yes.  trn3.3 supports it now.  The next version of tin will.
  662.  
  663.   You can hook it into the Performance  Release  of  Cnews  and  various
  664.   other readers as well
  665.   The  beta  copy of nn6.5 I have here has NOV support and it works just
  666.   dandy under Linux.  I run it here and have nn running  without  having
  667.   to run nnmaster (!).  Look on uniwa.uwa.edu for a copy of it.
  668.  
  669.  
  670.   7.9.  Why can't we have a binary distribution of NNTP ?
  671.  
  672.   Because  significant  local-only information is compiled-in and cannot
  673.   be determined auto-magically at runtime.
  674.  
  675.  
  676.   7.10.  storing any news articles or databases locally.  How do  I  set
  677.   up NNTP to allow read/post across the network while *not*
  678.  
  679.   ( mdw@sunsite.unc.edu (Matt Welsh) )
  680.  
  681.   o  1) Grab the "reference implementation" of nntp and  a  copy  or  rn
  682.      from  your  local archive site.  If you connect to ftp.uu.net you'd
  683.      grab:
  684.  
  685.      nntp.1.5.11.tar.Z from ftp.uu.net:/news/nntp rn-4.4.pl3.tar.Z  from
  686.      ftp.uu.net:/news/rn
  687.  
  688.   o  2) compile nntp as follows:
  689.  
  690.      copy  common/conf.h.dist  to  common/conf.h.  Edit common/conf.h to
  691.      set certain options: The only ones I set were:
  692.  
  693.      DOMAIN: undefine it  (i.e.  change  the  line  to  #undef  DOMAIN).
  694.      REALDOMAIN:   Define  this.  It  looks  up  the  domain  using  the
  695.      libraries.
  696.  
  697.      SERVER_FILE: Set this to the name of the file  which  will  contain
  698.      the  hostname  of the news server (i.e. the machine you'll read and
  699.      post news through). I use "/usr/local/lib/news/server".
  700.  
  701.      PASSFILE: If your news server requires  authorization  (i.e.   some
  702.      kind  of  username/password)  to  post, set this to the name of the
  703.      file which contains the username and password (described below).  I
  704.      use "/usr/local/lib/news/nntppass".
  705.  
  706.      I   decided   to   keep   all   of   the   other   news   stuff  in
  707.      /usr/local/lib/news.  So I set all of the rest of the pathnames  in
  708.      the   file   (i.e.   ACTIVE_FILE,  NEWSGROUPS_FILE,  etc.)  to  use
  709.      /usr/local/lib/news.  Many of these files are only used by the NNTP
  710.      server,  not the client, but to be safe I changed them all to point
  711.      to  the  right  directory.  You  can  of  course  use  the  default
  712.      pathnames; just make sure you create the directory accordingly.
  713.  
  714.      3)  Create  the  user  "usenet"  if  you haven't already. The inews
  715.      program runs as this user. All you need is a userid; you don't need
  716.      a  home  directory or shell or anything for the user. Just plop the
  717.      following line into your /etc/passwd:
  718.  
  719.      usenet:*:13:1::/:
  720.  
  721.      Make sure you set the userid ("13", above) to something unique. The
  722.      group can be anything; I use "daemon" (gid 1).
  723.  
  724.   o  4)  Create  the  SERVER_FILE, above. For example, my news server is
  725.      "wonton.tc.cornell.edu",     so     I     created     the      file
  726.      /usr/local/lib/news/server     which     contained     one    line:
  727.      wonton.tc.cornell.edu
  728.  
  729.   o  5) Create the PASSFILE. This file contains lines of the form
  730.  
  731.                      <server name> <username> <password>
  732.  
  733.  
  734.   Let's say that your news server (the one  in  SERVER_FILE,  above)  is
  735.   "shoop.vpizza.com",  and to post on that machine you need to be autho-
  736.   rized as the user "news" with a password  of  "floof".  Thus,  in  the
  737.   PASSFILE  (I  use  /usr/local/lib/news/nntppass),  you  need  the line
  738.   shoop.vpizza.com news floof
  739.  
  740.   o  6) Make this file secure!  The  inews  program  runs  as  the  user
  741.      "usenet",  so  make  this news directory owned by that user and the
  742.      nntppass file as well.
  743.  
  744.              chown usenet /usr/local/lib/news
  745.              chmod 755 /usr/local/lib/news
  746.              chown usenet /usr/local/lib/news/nntppass
  747.              chmod 600 /usr/local/lib/news/nntppass
  748.  
  749.  
  750.   So nobody else can read this file. No, the passwords  in  it  are  not
  751.   encrypted.
  752.  
  753.   o  7)  Go  back  to  the  nntp.1.5.11  source  directory;  issue "make
  754.      client".  At this point you'll build the  NNTP  version  of  inews,
  755.      which is the only software used by the NNTP client.
  756.  
  757.      When I built inews, there was a bug in the library which caused the
  758.      function uname() in uname.c to call itself eternally.  This  should
  759.      be gone now; however, if inews seems to hang and your system starts
  760.      slowing down *a lot* you should rename the  function  "uname()"  in
  761.      uname.c  to something like "my_uname()", and change the calls to it
  762.      (in inews.c) to call my_uname() instead. Mail me if  you  run  into
  763.      this problem.  (VDS note - this means mail to Matt-not me :-) )
  764.  
  765.   o  8)  Issue "make install_client". This will install the inews stuff.
  766.      Also link /usr/local/lib/news/inews to /usr/local/bin/inews
  767.  
  768.      Now you should be able to happily post  (by  hand).  Try  something
  769.      like the following:
  770.  
  771.                      $ inews -h << EOF
  772.                      Newsgroups: misc.test
  773.                      From: me@foo.bar.com
  774.                      Subject: Testing
  775.                      Reply-To: my-real-address@wherever.edu
  776.  
  777.                      This is a test.
  778.                      EOF
  779.  
  780.  
  781.   If  this  works,  inews  should  post the article. You'll know because
  782.   test-responders on misc.test will reply to the address on the Reply-To
  783.   line, above. Please don't do test postings on real groups, like c.o.l.
  784.   :)
  785.  
  786.   7.11.  How do I build "rrn" as a nntp-based newsreader/poster ?
  787.  
  788.   ( mdw@sunsite.unc.edu (Matt Welsh) )
  789.  
  790.   o  1.  cd  to the rn source directory and do "./Configure". For almost
  791.      all the questions, take the defaults (it's very smart).  Make  sure
  792.      you    have   a   link   to   "cpp"   (usually   in   /usr/lib/gcc-
  793.      lib/i386-linux/2.3.3) in /lib, so rn can find it.
  794.  
  795.      - Don't panic if it says you're on a NeXT or a USG system. Just  go
  796.      with the flow
  797.      - Answer "y" to "Do you expect to run these scripts and binaries on
  798.      multiple machines?"
  799.  
  800.      - For your domain name: if  your  system  is,  say,  "foo.bar.com",
  801.      answer with just "bar.com" (the domain, not the entire hostname).
  802.  
  803.      - Answer "usenet" for the name of the user which is the news admin.
  804.  
  805.      - For "Where is your news library?" use  the  directory  where  the
  806.      above NNTP files are kept: I use /usr/local/lib/news.
  807.  
  808.      - Man page source is in /usr/man/man1.
  809.  
  810.      -  Answer  "y"  to  "Does  your /etc/passwd file keep full names in
  811.      Berkeley/V7 format?"
  812.  
  813.      - Answer "gcc" to the name of the compiler which forces resolution.
  814.  
  815.      -  Answer  "y"  to  "Do  you  want  to build the NNTP version of rn
  816.      (rrn)?"
  817.  
  818.      - For the name of the news server file: use the same name you  used
  819.      when building inews, above (for me, /usr/local/lib/news/server).
  820.  
  821.      Don't run makedepend yet! Go to the next step:
  822.  
  823.   o  2)  Edit  config.h.  Change  the  "#define ROOTID " line to #define
  824.      ROOTID 0 if it isn't already.
  825.  
  826.   o  3) In rrn-4.4.pl3, there is a small bug  with  SIGEMT:  it  doesn't
  827.      exist  on  Linux.  rn  used  SIGEMT  to check if a process is still
  828.      running; however, under  POSIX.1  we  can  instead  just  send  the
  829.      process a signal 0.
  830.  
  831.      Edit  init.c. On line 243, note the following: if (kill(processnum,
  832.      SIGEMT)) { Change this to if (kill(processnum, 0)) {
  833.  
  834.      You may wish to #ifdef it out instead; it's up to you.  Don't  just
  835.      define  SIGEMT  to be zero; this will break the sigignore() call in
  836.      final.c.
  837.  
  838.   o  4) Issue "makedepend > makedepend.out".
  839.  
  840.   o  5) Issue "make". Rn should compile happily.
  841.  
  842.   o  6) Issue "make install".
  843.  
  844.      You're all set. Keep in mind that rn does in  fact  eat  a  lot  of
  845.      memory  (as  does any newsreader), handling the newsgroups file. So
  846.      when you first run rn, it might be  a  little  slow  building  your
  847.      .newsrc  and  checking  for new groups. If you're impatient, copy a
  848.      .newsrc from somewhere else and use that.
  849.