annotate debian/README.Debian @ 301:3b5b7f3fd71f noffle

[svn] initial debian/ upload
author godisch
date Fri, 14 Feb 2003 13:54:32 +0000
parents
children 75e489e4c2e4
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
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
9 manpage for noffle.conf(5) for more info.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
10
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
11 IMPORTANT: Once it's been configured, you need to run the following steps
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
12 before it will work properly:
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
13
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
14 noffle --query groups
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
15 noffle --query desc (see note)
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
16 noffle --fetch
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
17
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
18 The first fetches the list of available newsgroups from the server. The
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
19 second fetches the descriptions of the newsgroups. This isn't required,
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
20 but sometimes it can be useful to have those descriptions. The third
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
21 actually fetches the articles the first time. After the first time, how
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
22 articles can be fetched is decided by the "mode" (see next paragraph).
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
23
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
24 Noffle on Debian can run in basically two "modes": via PPP and via cron.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
25 The difference is that in PPP mode, it goes online and fetches any
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
26 requested articles when the PPP connection is made, whereas in cron mode
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
27 it is always online and fetches articles every 30 minutes (edit
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
28 /etc/cron.d/noffle to adjust). The mode is configured via
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
29 /etc/default/noffle. Of course, the PPP mode can be misused to control
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
30 the fetching by hand (i.e. by running "noffle --fetch").
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
31
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
32 Every day (via cron.daily) an expire is done.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
33
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
34 -- Paul Slootman <paul@debian.org>, Mon, 24 Sep 2001 19:55:36 +0200
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
35 -- Martin A. Godisch <godisch@tcs.inf.tu-dresden.de> Sat, 04 Jan 2003 09:30:20 +0100
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
36
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
37
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
38 Regarding security when authenticating to your NNTP server please keep
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
39 two aspects in mind:
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
40
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
41 1. Your username and password will be stored in plaintext two times on your
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
42 harddisk, readable by everyone at least in the group 'news'.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
43 2. Your username and password will be transmitted in plaintext over the wire.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
44
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
45 If you have an SSH account on a host which is authenticated to your NNTP
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
46 server by itself, you may consider to open an SSH tunnel to that host and
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
47 to use localhost as NNTP proxy for noffle. This tunnel can be created using
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
48 some kind of
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
49
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
50 ssh -fNL 10119:remote.news.server:119 mylogin@remote.ssh.server
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
51
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
52 in combination with SSH public key authentication, which yields
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
53
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
54 localhost:10119
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
55
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
56 as "remote" NNTP server for noffle. Have a look at the SSH manuals for
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
57 further information.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
58
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
59 -- Martin A. Godisch <godisch@tcs.inf.tu-dresden.de> Sat, 04 Jan 2003 09:30:20 +0100
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
60
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
61
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
62 There are three low-traffic mailing lists concerning noffle, visit
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
63
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
64 http://lists.sourceforge.net/lists/listinfo/noffle-announce
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
65 http://lists.sourceforge.net/lists/listinfo/noffle-devel
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
66 http://lists.sourceforge.net/lists/listinfo/noffle-users
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
67
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
68 if you are interested.
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
69
3b5b7f3fd71f [svn] initial debian/ upload
godisch
parents:
diff changeset
70 -- Martin A. Godisch <godisch@tcs.inf.tu-dresden.de> Mon, 20 Jan 2003 16:20:58 +0100