home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / suck-422.zip / README < prev    next >
Text File  |  1999-12-27  |  6KB  |  138 lines
  1. PREFACE
  2. =======
  3. Original Author - Tim Smith (address unknown)
  4. Maintainers - 
  5. March 1995 - Sven Goldt (address unknown)
  6. July 1995  - Robert A. Yetman (bobyetman@worldnet.att.net)
  7.  
  8. Current Maintainer - bobyetman@worldnet.att.net
  9.  
  10. LOCATION
  11. ========
  12. visit http://home.att.net/~bobyetman/index.html
  13. to download the latest version or view the README file.
  14.  
  15. FTP Sites:
  16. Site1         = sunsite.unc.edu
  17. Path1        = /pub/Linux/system/news/transport
  18. File1        = suck-4.2.2.tar.gz
  19.  
  20. INTRODUCTION
  21. ============
  22. The primary use for suck is to feed a local NNTP server, without the
  23. remote NNTP feeding you articles.  It is designed for a small, partial
  24. news feed.  It is NOT designed to feed 10,000 groups and 3 Gigs of articles
  25. a day.
  26.  
  27. This package contains software for copying news from an NNTP server to your
  28. local machine, and copying replies back up to an NNTP server.  It works
  29. with most standard NNTP servers, including INN, CNEWS, DNEWS, and typhoon.
  30.  
  31. The suck/rpost combination allows you to run your own  site, controlling
  32. where you get your news, and where you post outgoing articles.  Suck/rpost
  33. use only standard NNTP commands that are used by your favorite news reader
  34. (tin, xvnews, strn) such as POST and ARTICLE.  If you can use tin or xvnews
  35. against a NNTP site, than you can use Suck/Rpost.  
  36.  
  37. suck            Pull a small newsfeed from an NNTP server
  38.  
  39. lpost            Gives one article fetched by suck to the local server.
  40.  
  41. rpost            Posts article(s) to a remote NNTP server
  42.  
  43. testhost            Check to see what commands your host recognizes or
  44.             get the active or new list.
  45.  
  46. lmove             put articles in news/group/number format.
  47.  
  48. MAJOR CHANGES FROM 4.2.1 -> 4.2.2
  49.  
  50. * suck - changed format of xover and xhdr commands from xhr 111- to
  51.     xhdr 111-222 for brain-dead servers that can't handle the 
  52.     correct format.
  53.  
  54. * lmove - Added two new options, -h and -s, to create hard and
  55.     symbolic links respectively, for files that are cross
  56.     posted to multiple groups in the active file.  See man
  57.     page for more details.
  58.  
  59.  
  60. MAILING LIST!
  61. =============
  62. Thanks to Motoharu Kubo (mkubo@3ware.co.jp), there is a mailing list for
  63. suck.  It is intended as a place to discuss problems, etc, plans, and
  64. other issues related to suck.  Its address is "suck-ml@3ware.co.jp".
  65.  
  66. To subscribe to the mailing list, send a mail message to majordomo@3ware.co.jp
  67. with the message text reading "subscribe suck-ml"
  68.  
  69. NOTES:
  70. ======
  71. Suck will not work with obsolete NNTP servers that can't handle the xhdr
  72. command.
  73.  
  74. This code assumes an ANSI-compliant compiler, it will NOT work with old
  75. compilers (Such as Sun's) which don't accept function prototypes.  You could
  76. try using the unprotoize program included in gcc, but then if you are going
  77. to get that, why not just build gcc? :)
  78.  
  79. The Makefile assumes you are using GNU make, other makes may or may not work.
  80.  
  81. If your remote INN server slows drastically after 100 messages are downloaded,
  82. and they are using INN 1.5.1 or newer, chances are they compiled INN with 
  83. "LIKE_PULLERS" set to DONT, which causes INN to put a small sleep before each message.  
  84. Talk to the SA for the system and see if they'll compile with "DO".  Chances
  85. are they didn't even know this option existed.
  86.  
  87. If you don't feel like going to the trouble of running INND/CNEWS/DNEWS/Typhoon, and
  88. you don't need a full blown NNTP daemon running, then suck, along with tin
  89. and a few batch files, can be used to read articles.  The scripts should be
  90. available from http://www.cix.co.uk/~mayday.  I don't use these, but supposedly
  91. they do work.
  92.  
  93. Is suck Y2K compliant?  As far as I can make it yes.   The only program that uses
  94. dates is testhost, and the date is sent to the remote NNTP host for the NEWGRP
  95. command.  I don't do any date calculations.   Once servers take an 8 digit 
  96. date (right now its YYMMDD), I'll update testhost.
  97.  
  98. HOW-TO-USE
  99. ==========
  100. 1.  run ./configure
  101. 2.  If your history file is not a flat file, edit the top of the Makefile.
  102.     If your flatfile history file is not at /usr/news/db/history, 
  103.     you'll need to use the -HF option, to tell suck where it is.
  104. 3.  Make it.  (make , make install)
  105.     If you are having problems compiling suck, look at the Makefile,
  106.     there are comments in there for the various common problems
  107.     I see.   
  108. 4.  READ THE MAN PAGES.
  109. 5.  Create a sucknewsrc - which groups to download (see suck man pg).
  110.     If you have INND/CNEWS/DNEWS/PNEWS already running, then
  111.     just use 'suck remotehost -A -hl localhost', and the sucknewsrc
  112.     will be built for you.  BUT, before you do this, create a active.ignore
  113.     file, listing all the groups on the local host that you don't want
  114.     downloaded from the remote host (see man page for sample).
  115. 6.  Take a look at the sample directory.  There are two shell scripts
  116.      in there that show the whole scheme from how to download news
  117.     (with suck), and how to upload news (with rpost).  Use get.news.inn
  118.     if you have INN running, as it knows how to gracefully get the
  119.     outgoing article listing.  get.news.generic is for everyone else.
  120.     WARNING: These scripts need editing before you can use them.  You
  121.     must change the various variables at the top of the scripts to
  122.     ensure they point to the right files/directories.
  123.  
  124.  
  125. WHERE TO GET STUFF
  126. ==================
  127. inn: anonymous ftp from ftp.isc.org /isc/inn
  128. perl: http://www.perl.com/CPAN/src/latest.tar.gz 
  129.       anonymous ftp from prep.ai.mit.edu /gnu
  130. Perl/Tk: http://www.perl.com/CPAN/modules/by-module/Tk/Tk8XX.XXX.tar.gz
  131.  
  132. FUTURE PLANS.
  133. ========================
  134. I'm in the planning stages of a major rewrite to the internals of suck.  This
  135. rewrite will hopefully address the long-standing complaint that killfiles
  136. greatly slow things down.
  137.  
  138.