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