annotate debian/README.Debian @ 464:d9035d08fe51 noffle

[svn] * src/fetch.c: Log failed posting that we can't mail back to the sender or where sending fails to <Noffle spool>/failed.posting.
author bears
date Wed, 23 Jul 2003 10:32:25 +0100
parents d052294eb30f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
301
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
1 NOFFLE for Debian
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
2 -----------------
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
3
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
4 This is the first debian package of noffle, so be prepared for some rough
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
5 edges. By all means, _please_ report any bugs you find! (and do so through
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
6 the debian bug tracking system, http://bugs.debian.org/)
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
7
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
8 The standard configuration is stored in /etc/news/noffle.conf, see the
440
d052294eb30f [svn] update
godisch
parents: 353
diff changeset
9 manpage for noffle.conf(5) for more info. noffle is started from inetd,
d052294eb30f [svn] update
godisch
parents: 353
diff changeset
10 please check your /etc/inetd.conf and adjust it if necessary.
301
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
11
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
12 IMPORTANT: Once it's been configured, you need to run the following steps
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
13 before it will work properly:
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
14
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
15 noffle --query groups
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
16 noffle --query desc (see note)
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
17 noffle --fetch
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
18
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
19 The first fetches the list of available newsgroups from the server. The
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
20 second fetches the descriptions of the newsgroups. This isn't required,
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
21 but sometimes it can be useful to have those descriptions. The third
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
22 actually fetches the articles the first time. After the first time, how
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
23 articles can be fetched is decided by the "mode" (see next paragraph).
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
24
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
25 Noffle on Debian can run in basically two "modes": via PPP and via cron.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
26 The difference is that in PPP mode, it goes online and fetches any
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
27 requested articles when the PPP connection is made, whereas in cron mode
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
28 it is always online and fetches articles every 30 minutes (edit
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
29 /etc/cron.d/noffle to adjust). The mode is configured via
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
30 /etc/default/noffle. Of course, the PPP mode can be misused to control
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
31 the fetching by hand (i.e. by running "noffle --fetch").
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
32
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
33 Every day (via cron.daily) an expire is done.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
34
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
35 -- Paul Slootman <paul@debian.org>, Mon, 24 Sep 2001 19:55:36 +0200
352
75e489e4c2e4 [svn] updated email address
godisch
parents: 301
diff changeset
36 -- Martin A. Godisch <godisch@debian.org> Sat, 04 Jan 2003 09:30:20 +0100
301
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
37
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
38
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
39 Regarding security when authenticating to your NNTP server please keep
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
40 two aspects in mind:
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
41
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
42 1. Your username and password will be stored in plaintext two times on your
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
43 harddisk, readable by everyone at least in the group 'news'.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
44 2. Your username and password will be transmitted in plaintext over the wire.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
45
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
46 If you have an SSH account on a host which is authenticated to your NNTP
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
47 server by itself, you may consider to open an SSH tunnel to that host and
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
48 to use localhost as NNTP proxy for noffle. This tunnel can be created using
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
49 some kind of
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
50
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
51 ssh -fNL 10119:remote.news.server:119 mylogin@remote.ssh.server
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
52
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
53 in combination with SSH public key authentication, which yields
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
54
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
55 localhost:10119
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
56
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
57 as "remote" NNTP server for noffle. Have a look at the SSH manuals for
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
58 further information.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
59
353
14839d84d375 [svn] updated email address
godisch
parents: 352
diff changeset
60 -- Martin A. Godisch <godisch@debian.org> Sat, 04 Jan 2003 09:30:20 +0100
301
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
61
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
62
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
63 There are three low-traffic mailing lists concerning noffle, visit
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
64
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
65 http://lists.sourceforge.net/lists/listinfo/noffle-announce
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
66 http://lists.sourceforge.net/lists/listinfo/noffle-devel
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
67 http://lists.sourceforge.net/lists/listinfo/noffle-users
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
68
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
69 if you are interested.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
70
352
75e489e4c2e4 [svn] updated email address
godisch
parents: 301
diff changeset
71 -- Martin A. Godisch <godisch@debian.org> Mon, 20 Jan 2003 16:20:58 +0100