home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / network / news / nntp.1.5.11.README < prev    next >
Encoding:
Text File  |  1995-11-23  |  4.7 KB  |  136 lines
  1. NNTP README        July 4, 1990  (NNTP 1.5.10)
  2.  
  3. [See the file CHANGES to see differences between this version and
  4. older versions.]
  5.  
  6. INTRODUCTION
  7.  
  8.      This package contains everything (well, most of it, I hope) that
  9. you'll need to implement a remote news server running the NNTP protocol.
  10.  
  11.      A brief tour of the directories and their programs:
  12.  
  13.     server        Source for the NNTP news server daemon.
  14.  
  15.     inews        A "mini-inews" written by Steven Grady
  16.             <grady@postgres.berkeley.edu> which allows
  17.              remote posting without changing much else.
  18.  
  19.     xmit        An active transmission client for transferring
  20.             news, written by Erik Fair; see note below.
  21.  
  22.     common        Common stuff (response codes, configuration info,
  23.             and some client library routines) for the
  24.             the news server and the clients.  The "conf.h"
  25.             file here needs to be edited to reflect
  26.             the peculiarities of your system.
  27.  
  28.     support        Some support files and scripts.
  29.  
  30.     doc        Documentation on the server, including manual
  31.             pages.
  32.  
  33.     xfer        A passive reception client which uses the
  34.             NEWNEWS command to retrieve news from a remote
  35.             server.  Written by Brian Kantor, this software
  36.             works more or less. Bug reports are welcome.
  37.  
  38.      Each directory has associated with it a README file.
  39. This file will try to give enough information for you to get things
  40. running and installed, but the README in each directory has more
  41. details for each subset of the NNTP package.  You may also want to print
  42. a copy of doc/rfc977, which describes the NNTP protocol.
  43.  
  44. INTRODUCTION TO NNTP INSTALLATION
  45.  
  46.      First, figure out what you are trying to do (this is good
  47. advice under most circumstances, and it is especially apropos here).
  48. NNTP can be used for two things:  (1) Remote news reading, where news
  49. is stored on one machine and read from remote machines across a
  50. high-speed local area network such as Ethernet, and (2) News transfer,
  51. where news is transmitted to NNTP servers on remote machines over
  52. either local or long-haul networks.
  53.  
  54.      NNTP "server" machines are machines that have a full installation
  55. of USENET news on them.  An NNTP process, the "server", allows remote
  56. sites to connect to the server machine and read or transfer news.
  57. The server machine DOES NOT NEED "reader client" software such as
  58. "rrn".  It MAY NEED "transmission client" software such as "nntpxmit"
  59. if you want to use NNTP to transfer news.
  60.  
  61.      NNTP "client" machines do not have a full installation of USENET
  62. news on them.  They get their news from an NNTP server machine across
  63. the network.  They DO have NNTP "reader clients" such as "rrn" installed
  64. on them.
  65.  
  66.      In summary,
  67.  
  68.     >>> A full client installation of NNTP may require the following
  69.         files (suitable for rdist, assuming standard directories):
  70.  
  71. NEWS = ( /usr/local/bin/{Pnews,Rnmail,inews,rn,rrn,newsetup,newsgroups}
  72.     /usr/local/lib/rn 
  73.     /usr/man/catl/{Pnews,Rnmail,rn,newsetup,newsgroups}.1 )
  74.  
  75.         You DO NOT need any of the normal news junk (e.g.,
  76.         /usr/lib/news, /usr/spool/news, /usr/spool/batch) on CLIENT
  77.         systems.
  78.  
  79.         You DO need these on SERVER systems.
  80.  
  81.      An important note:
  82.  
  83.     The NNTP server assumes that the history file format
  84.     is 2.11.19 BNEWS or CNEWS; therefore you need 2.11.19 BNEWS or CNEWS
  85.     on your    server machine.
  86.  
  87.     >>>>> Get 2.11.19 BNEWS or CNEWS if you don't have it.
  88.  
  89. GENERAL INSTALLATION
  90.  
  91.      Time for a general and cohesive Plan:
  92.  
  93.      Regardless of whether you are making a server or a client NNTP
  94. setup, you will have to edit common/conf.h to reflect your system's
  95. setup.  So,
  96.  
  97.      1. Look at common/README.  This will explain the stuff
  98.     needs to be tailored for your system in common/conf.h.
  99.     Make the necessary changes to reflect your system.
  100.  
  101.     There are special READMEs for certain types of systems.
  102.     Look them over and see if they apply to you.
  103.  
  104.      Now, at this point, what you do depends on whether you are
  105. installing a server system or a client system.
  106.  
  107. SERVER INSTALLATION
  108.  
  109.      2. Type "make server" in this directory.
  110.  
  111.      3. Type "make install_server" in this directory.
  112.  
  113. CLIENT INSTALLATION
  114.  
  115.      2. Type "make client" in this directory.
  116.  
  117.      3. Type "make install_client" in this directory.
  118.  
  119.      4. Get some client newsreaders (like rrn or the NNTP version of vnews)
  120.         and install them on your client systems.
  121.  
  122. IF YOU HAVE PROBLEMS
  123.  
  124.      You can get to me via electronic mail at the following addresses:
  125.  
  126.     Internet:        nntp@tmc.edu
  127.     UUCP:            ...!bcm!nntp
  128.     Telephone (work):    (713) 798-6042
  129.  
  130.      I'm very interested in learning what hacks need to be made to
  131. nntpd to get it to work on various systems, and certainly, if there are
  132. outright bugs, please let me know.  Bug reports and fixes for nntp are
  133. posted to the newsgroup "news.software.nntp".  Announcements of new
  134. versions of nntp software are posted there, too.
  135.  
  136.