home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / docs / slack-docs / inn / FILES.descript < prev    next >
Encoding:
Text File  |  1996-05-08  |  5.6 KB  |  158 lines
  1. 06/05/96 v0.62          Description of INN files (FILES.descript)
  2.  
  3. Configuration of Linux Slackware INN_PKG for use with DEMON INTERNET SERVICES
  4.  
  5.    Copyright (C) 1995,1996 Ivan A. Beveridge.       ivan@dreamtim.demon.co.uk
  6.  
  7.    This package is freely distributable.
  8.  
  9. -----------------------------------------------------------------------------
  10. The following is a description of what the INN configuration files mean (for
  11. more information read the relevant man pages):
  12.  
  13. active
  14. ------
  15. This tells INN which newsgroups are on your computer (ie which ones you can
  16. subscribe to from your news reader. This is *not necessarily* the same as
  17. the ones that you are going to download (these are named in slurp.sys).
  18. *Important* - do create/have the groups "control" and "junk". Control is
  19. for the passing of news control messages, and junk is for the articles that
  20. have no home to go to (eg. you have put a group in slurp.sys that you have
  21. not put in active - the downloaded news will go to junk).
  22.  
  23.  
  24. expire.ctl
  25. ----------
  26. This tells INN how long you want news articles to remain on your system.
  27. /remember/:14        means keep the header info for 14 days, to ensure that
  28.             you do not receive the same article more than once.
  29.  
  30. *:A:1:10:21        means for all named groups, moderated and unmoderated,
  31.             keep the article for a minimum of 1 day, a default of
  32.             10 days, and a maximum of 21 days.
  33.  
  34. news.announce.newusers:A:never:never:never    means keep all articles in the
  35.                     news.announce.newusers group for ever.
  36.  
  37. hosts.nntp
  38. ----------
  39. This tells INN which computers feed news. There are only two entries in this.
  40. "pubnews.demon.co.uk" could be added but bear in mind that this is *not* a 
  41. guaranteed news server.
  42.  
  43. news.demon.co.uk:
  44. YOURHOST.demon.co.uk:        This means that you are able to "feed" news
  45.                 to your site (from your news reader).
  46.  
  47.  
  48. inn.conf
  49. --------
  50. This tells INN domain and other details about your News. This assumes that
  51. you have an address in the form HOST.demon.co.uk (if not, change domain name),
  52. and you are reading news off-line.
  53.  
  54. domain:         demon.co.uk    means that news articles posted from you will
  55.                 be in domain demon.co.uk
  56.  
  57. #organisation:  Home        means that your organisation is called    "Home"
  58.                 (This is named in the article header info, but
  59.                 is commented out here).
  60.  
  61. server:      YOURHOST.demon.co.uk    This sets the default NNTP server that you will
  62.                 use to *read* news. This is for when you dis-
  63.                 connect from Demon, and want to read news
  64.                 locally.
  65.  
  66. moderators
  67. ----------
  68. This is only included as a reminder. I have included the line for
  69. comp.os.linux.announce. If you do not setup the moderators file properly, you
  70. any articles you send to moderated groups will be silently deleted by some
  71. other computer once you have sent the message to Demon. Either look at the
  72. "moderators" file, or look at the man pages (man moderators) to find out how
  73. to set this up. It is not vital, hence no more discussion.
  74.  
  75.  
  76. newsfeeds
  77. ---------
  78. This tells INN where to send articles that you post:
  79.  
  80. ME:*::            This means send all articles to your own computer.
  81.  
  82. OVERVIEW!:*:Tc,WO:/usr/lib/news/bin/overchan
  83.             This is needed for the NOV threading to work. It
  84.             saves article header details.
  85.  
  86. demon/news.demon.co.uk\
  87.         :*,!control,!junk\
  88.         :Tf,Wnm:
  89.             This tells INN to send articles that have not been sent
  90.             through news.demon.co.uk to the site with the "demon"
  91.             entry in the nntpsend.ctl file. It states which groups
  92.             to send - in this case everything except for those in
  93.             the control and junk newsgroups - notice the "!" which
  94.             means "not").
  95.             "demon" is an alias for the news.demon.co.uk site.
  96.             The "\" at the end of the lines mean "think of this as
  97.             a continuation line".
  98.  
  99.  
  100. nnrp.access
  101. -----------
  102. This tells INN which computers are allowed to read and post articles (*not*
  103. those which are newsfeeds):
  104.  
  105. *:: -no- : -no- :!*        means, by default, no-one is allowed to read
  106.                 or post articles to your machine (not even
  107.                 your own machine!).
  108.  
  109. YOURHOST.demon.co.uk:Read Post:::*
  110.                                 means that you machine can read and post
  111.                                 articles to all newsgroups. Ensure that you
  112.                                 put you host name in place of YOURHOST.
  113.                                 (Note, if you have a domain name like
  114.                                 HOST.YOURCO.co.uk, change the name to this.
  115.  
  116. nntpsend.ctl
  117. ------------
  118. This tells INN where to send the news articles you have posted:
  119.  
  120. demon:news.demon.co.uk::    "demon" is the alias mentioned in the newsfeeds
  121.                 file, and "news.demon.co.uk" is the full name
  122.                 of the news host to post news to.
  123.  
  124.  
  125. overview.fmt
  126. ------------
  127. This explains the format of threading for NOV. The only think I have changed
  128. is uncommenting the Xref: line, as recommended by the INN FAQ.
  129.  
  130. Xref:full
  131.  
  132.  
  133. slurp.sys
  134. ---------
  135. This is a configuration file for use with "slurp", which is included with
  136. the slack2.1.help.tar.gz package, and names the news server to connect to
  137. for downloading news articles, and which newsgroups to download:
  138.  
  139. news.demon.co.uk:\
  140. comp.os.linux,\
  141. comp.os.linux.announce
  142.                 The news site is named before the colon, and
  143.                 the newsgroups after, each group being
  144.                 separated by a comma (the "\" is there to make
  145.                 the file easy to read).
  146.  
  147.  
  148. slurp.news.demon.co.uk
  149. ----------------------
  150. This file contains a timestamp. This is the last time you downloaded news.
  151. Set this to something reasonable - say yesterday. The format for the time is:
  152.         YYMMDD HHMMSS
  153. If the file is not there, it apparently defaults to 1st January 1986! You
  154. have been warned!
  155.  
  156. In Slurp v1.10, this also may include news headers of articles that have not
  157. yet been downloaded (but will be on the next attempt).
  158.