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