[go: up one dir, main page]

File: README

package info (click to toggle)
suck 3.10.1-3
  • links: PTS
  • area: main
  • in suites: slink
  • size: 728 kB
  • ctags: 727
  • sloc: ansic: 8,357; sh: 585; makefile: 212; java: 144; perl: 24
file content (154 lines) | stat: -rw-r--r-- 6,025 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
PREFACE
=======
Original Author - Tim Smith (address unknown)
Maintainers - 
March 1995 - Sven Goldt (address unknown)
July 1995  - Robert A. Yetman (bobyetman@worldnet.att.net)

Current Maintainer - bobyetman@worldnet.att.net

LOCATION
========
visit http://home.att.net/~bobyetman/index.html
to download the latest version or view the README file.

FTP Sites:
Site1	     = sunsite.unc.edu
Path1        = /pub/Linux/system/news/transport
File1        = suck-3.10.1.tar.gz

INTRODUCTION
============
The primary use for suck is to feed a local NNTP server, without the
remote NNTP feeding you articles.  It is designed for a small, partial
news feed.  It is NOT designed to feed 10,000 groups and 3 Gigs of articles
a day.

This package contains software for copying news from an NNTP server to your
local machine, and copying replies back up to an NNTP server.  It works
with most standard NNTP servers, including INN, CNEWS, DNEWS, and typhoon.

The suck/rpost combination allows you to run your own  site, controlling
where you get your news, and where you post outgoing articles.  Suck/rpost
use only standard NNTP commands that are used by your favorite news reader
(tin, xvnews, strn) such as POST and ARTICLE.  If you can use tin or xvnews
against a NNTP site, than you can use Suck/Rpost.  

suck			Pull a small newsfeed from an NNTP server

lpost			Gives one article fetched by suck to the local server.

rpost			Posts article(s) to a remote NNTP server

testhost        	Check to see what commands your host recognizes or
			get the active or new list.

lmove 			put articles in news/group/number format.

MAJOR CHANGES FROM 3.10.-> 3.10.1

* suck - bug fixes in the GDBM code, the XOVER code, and the embedded
	Perl code if using perl 5.004 or older.

* rpost - added embedded perl filter capability.

MAJOR CHANGES FROM 3.9.4 -> 3.10.0

* suck - suck has a new form of killfiles, based on the XOVER command.
	The key difference with these killfiles is that they are 
	processed before downloading the articles.  They use the same
        syntax as the old killfiles.  See README.Xover for more details.

* suck - added code to allow you to define your own perl function
	for killing messages, similar to the kill program routines.
	If you're using an external filter, you'll want to consider
	using this instead, as it's much faster.
	See suck's man page for details.

* suck - added compile time option for use of GDBM for the chkhistory
	routines.

* suck - added -G option.  This changes the format of the BPS and count
	output, to enable an external program, such as a GUI to parse.
	See README.Gui for more details.

* suck - added -f option.  This option forces a reconnect after deduping
	of messages, and before downloading the messages.  This is in
	case deduping takes some time, and the remote end times out.

* suck - added code to cause error messages to go to debug.suck, if -D 
	selected.

* suck - added code to handle INN history lines beginning with [.

* suck - various fixes so code compiles on BEos and SunOS.

* suck - added some tests so that if killfiles evaluate to empty,
	we throw them out.

* testhost - added -o option to run "list overview.fmt", to see
	what XOVER command returns, and the -M option, in case
	you need to run "mode reader" prior to the -o option.

MAILING LIST!
=============
Thanks to Motoharu Kubo (mkubo@3ware.co.jp), there is a mailing list for
suck.  It is intended as a place to discuss problems, etc, plans, and
other issues related to suck.  Its address is "suck-ml@3ware.co.jp".

To subscribe to the mailing list, send a mail message to majordomo@3ware.co.jp
with the message text reading "subscribe suck-ml"

NOTES:
======
Suck will not work with obsolete NNTP servers that can't handle the xhdr
command.

This code assumes an ANSI-compliant compiler, it will NOT work with old
compilers (Such as Sun's) which don't accept function prototypes.  You could
try using the unprotoize program included in gcc, but then if you are going
to get that, why not just build gcc? :)

The Makefile assumes you are using GNU make, other makes may or may not work.

If your remote INN server slows drastically after 100 messages are downloaded,
and they are using INN 1.5.1 or newer, chances are they compiled INN with 
"LIKE_PULLERS" set to DONT, which causes INN to put a small sleep before each message.  
Talk to the SA for the system and see if they'll compile with "DO".  Chances
are they didn't even know this option existed.

If you don't feel like going to the trouble of running INND/CNEWS/DNEWS/Typhoon, and
you don't need a full blown NNTP daemon running, then suck, along with tin
and a few batch files, can be used to read articles.  The scripts should be
available from http://poboxes.com/rdebath.  I don't use these, but supposedly
they do work.

Is suck Y2K compliant?  As far as I can make it yes.   The only program that uses
dates is testhost, and the date is sent to the remote NNTP host for the NEWGRP
command.  I don't do any date calculations.   Once servers take an 8 digit 
date (right now its YYMMDD), I'll update testhost.

HOW-TO-USE
==========
1.  run ./configure
2.  If your history file is not a flat file, or if its not at 
    /usr/lib/news/history, edit the top of the Makefile.
3.  Edit suck_config.h - lots of configurable stuff here
4.  Make it.  (make , make install)
5.  READ THE MAN PAGES.
6.  Create a sucknewsrc - which groups to download (see suck man pg).
	If you have INND/CNEWS/DNEWS/PNEWS already running, then
	just use 'suck remotehost -A -hl localhost', and the sucknewsrc
	will be built for you.  However, you might want to read the
	man page, and create a suck.ignore file first.
7.  Take a look at sample/get.news(.innxmit or .rnews)
	These scripts show the whole scheme, from sucking news to
	posting replies to your remote host.  Use .innxmit if you
	are using INND, or .rnews if you are using CNEWS.

PLANS FOR NEXT VERSION.
=======================

FUTURE PLANS.
========================
I'm open to suggestions.