chiark / gitweb /
wip filepoll poll interval variable
[innduct.git] / doc / pod / passwd.nntp.pod
1 =head1 NAME
2
3 passwd.nntp - passwords for connecting to remote NNTP servers
4
5 =head1 DESCRIPTION
6
7 The file F<passwd.nntp> in I<pathetc> contains host / name / password
8 triplets for use when authenticating client programs to NNTP servers.
9 This file is normally interpreted by NNTPsendpassword() in libinn(3).
10 Blank lines and lines beginning with a number sign (C<#>) are ignored.
11 All other lines should consist of three or four fields separated by
12 colons:
13
14     host:name:password
15     host:name:password:style
16
17 The first field is the name of a host, and is matched in a
18 case-insensitive manner.  (No detailed matching, such as comparing IP
19 addresses, is done.)
20
21 The second field is a user name, and the third is a password.  If either
22 the username or password is empty, then that portion of the
23 authentication will not occur.  (For example, when connecting to a
24 remote INN for peering, only the password is needed.)
25
26 The optional fourth field specifies the type of authentication to use.
27 At present, the only recognized "authentication style" is C<authinfo>;
28 this is also the default.  It means that NNTP "authinfo" commands are
29 used to authenticate to the remote host.  (The C<authinfo> command is a
30 common extension to RFC 977.)
31
32 For example:
33
34     ##  UUNET needs a password, MIT doesn't.
35     mit.edu:bbn::authinfo
36     uunet.uu.net:bbn:yoyoma:authinfo
37
38 This file should not be world-readable.
39
40 =head1 HISTORY
41
42 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  This is
43 revision $Revision: 5089 $, dated $Date: 2002-02-03 11:03:41 -0800 (Sun, 03 Feb 2002) $.
44
45 $Id: passwd.nntp.pod 5089 2002-02-03 19:03:41Z vinocur $
46
47 =head1 SEE ALSO
48
49 inn.conf(5), innd(8), libinn(3).
50
51 =cut