annotate conf/doc/pop5.rf @ 0:bce86c4163a3

Initial revision
author kono
date Mon, 18 Apr 2005 23:46:02 +0900
parents
children 441a2190cfae
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1 .\" @(MHWARNING)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
2 .\" @(#)$Id$
bce86c4163a3 Initial revision
kono
parents:
diff changeset
3 .SC POP 5
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 POP \- POP database of subscribers
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 /usr/spool/pop/POP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 .DE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9 The POP database has exactly the same format as the \fIBBoards\fR\0(5)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 database,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 although many fields are unused.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 Currently,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13 only four fields are examined:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15 .nf
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 .ta \w'encrypted password 'u
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 \fIfield\fR \fIvalue\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 name the POP subscriber
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 primary file the maildrop for the POP subscriber
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20 (relative to the POP directory)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 encrypted password the POP subscriber's password
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 network address the remote user allowed to RPOP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 .re
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 .fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 This is an ASCII file. Each field within each POP subscriber's entry
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 is separated from the next by a colon.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 Each POP subscriber is separated from the next by a new-line.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 If the password field is null, then no password is valid.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31 To add a new POP subscriber,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 edit the file adding a line such as
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 mrose::mrose:::::::0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 Then, use \fIpopwrd\fR to set the password for the POP subscriber.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38 If you wish to allow POP subscribers to access their maildrops without
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 supplying a password (by using privileged ports),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40 fill\-in the network address field, as in:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43 mrose::mrose:::mrose@nrtc-isc::::0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45 which permits \*(lqmrose@nrtc\-isc\*(rq to access the maildrop for the POP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 subscriber \*(lqmrose\*(rq.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47 Multiple network addresses may be specified by separating them with commas,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 as in:
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51 dave::dave:9X5/m4yWHvhCc::dave@romano.wisc.edu,dave@rsch.wisc.edu::::
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 To disable a POP subscriber from \fIreceiving\fR mail,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 set the primary file name to the empty string.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55 To prevent a POP subscriber from \fIpicking\-up\fR mail,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 set the encrypted password to \*(lq*\*(rq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 and set the network address to the empty string.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 This file resides in home directory of the login \*(lqpop\*(rq.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 Because of the encrypted passwords,
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 it can and does have general read permission.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63 ^/usr/spool/pop/POP~^POP database
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
65 bboards(5), pop(8), popaka(8), popd(8), popwrd(8)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
66 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
67 A binary indexed file format should be available for fast access.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
68
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69 Appropriate precautions must be taken to lock the file against changes
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70 if it is to be edited with a text editor.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71 A \fIvipop\fR program is needed.
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72 .En