git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/conf/doc/RCS/pop5.rf,v

   1 head     1.5;
   2 branch   ;
   3 access   ;
   4 symbols  ;
   5 locks    ; strict;
   6 comment  @@;
   7
   8
   9 1.5
  10 date     90.04.05.15.14.09;  author sources;  state Exp;
  11 branches ;
  12 next     1.4;
  13
  14 1.4
  15 date     90.03.22.11.31.34;  author sources;  state Exp;
  16 branches ;
  17 next     1.3;
  18
  19 1.3
  20 date     90.03.20.19.42.16;  author sources;  state Exp;
  21 branches ;
  22 next     1.2;
  23
  24 1.2
  25 date     90.03.20.17.36.31;  author sources;  state Exp;
  26 branches ;
  27 next     1.1;
  28
  29 1.1
  30 date     90.03.20.17.21.15;  author sources;  state Exp;
  31 branches ;
  32 next     ;
  33
  34
  35 desc
  36 @@
  37
  38
  39 1.5
  40 log
  41 @add ID
  42 @
  43 text
  44 @.\"    @@(MHWARNING)
  45 .\" @@(#)$Id:$
  46 .SC POP 5
  47 .NA
  48 POP \- POP database of subscribers
  49 .SY
  50 /usr/spool/pop/POP
  51 .DE
  52 The POP database has exactly the same format as the \fIBBoards\fR\0(5)
  53 database,
  54 although many fields are unused.
  55 Currently,
  56 only four fields are examined:
  57
  58 .nf
  59 .ta \w'encrypted password  'u
  60 \fIfield\fR     \fIvalue\fR
  61 name    the POP subscriber
  62 primary file    the maildrop for the POP subscriber
  63         (relative to the POP directory)
  64 encrypted password      the POP subscriber's password
  65 network address the remote user allowed to RPOP
  66 .re
  67 .fi
  68
  69 This is an ASCII file.  Each field within each POP subscriber's entry
  70 is separated from the next by a colon.
  71 Each POP subscriber is separated from the next by a new-line.
  72 If the password field is null, then no password is valid.
  73
  74 To add a new POP subscriber,
  75 edit the file adding a line such as
  76
  77 .ti +.5i
  78 mrose::mrose:::::::0
  79
  80 Then, use \fIpopwrd\fR to set the password for the POP subscriber.
  81 If you wish to allow POP subscribers to access their maildrops without
  82 supplying a password (by using privileged ports),
  83 fill\-in the network address field, as in:
  84
  85 .ti +.5i
  86 mrose::mrose:::mrose@@nrtc-isc::::0
  87
  88 which permits \*(lqmrose@@nrtc\-isc\*(rq to access the maildrop for the POP
  89 subscriber \*(lqmrose\*(rq.
  90 Multiple network addresses may be specified by separating them with commas,
  91 as in:
  92
  93 .ti +.5i
  94 dave::dave:9X5/m4yWHvhCc::dave@@romano.wisc.edu,dave@@rsch.wisc.edu::::
  95
  96 To disable a POP subscriber from \fIreceiving\fR mail,
  97 set the primary file name to the empty string.
  98 To prevent a POP subscriber from \fIpicking\-up\fR mail,
  99 set the encrypted password to \*(lq*\*(rq
 100 and set the network address to the empty string.
 101
 102 This file resides in home directory of the login \*(lqpop\*(rq.
 103 Because of the encrypted passwords,
 104 it can and does have general read permission.
 105 .Fi
 106 ^/usr/spool/pop/POP~^POP database
 107 .Sa
 108 bboards(5), pop(8), popaka(8), popd(8), popwrd(8)
 109 .Bu
 110 A binary indexed file format should be available for fast access.
 111
 112 Appropriate precautions must be taken to lock the file against changes
 113 if it is to be edited with a text editor.
 114 A \fIvipop\fR program is needed.
 115 .En
 116 @
 117
 118
 119 1.4
 120 log
 121 @put things back, do .NA stuff another way
 122 @
 123 text
 124 @d2 1
 125 @
 126
 127
 128 1.3
 129 log
 130 @typo
 131 @
 132 text
 133 @d2 2
 134 a3 2
 135 .TH POP 5 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
 136 .SH .NA
 137 d5 1
 138 a5 1
 139 .SH .SY
 140 @
 141
 142
 143 1.2
 144 log
 145 @fixup for makewhatis
 146 @
 147 text
 148 @d2 1
 149 a2 1
 150 .TH POP 5 [mh.6] MH
 151 @
 152
 153
 154 1.1
 155 log
 156 @Initial revision
 157 @
 158 text
 159 @d2 2
 160 a3 2
 161 .SC POP 5
 162 .NA
 163 d5 1
 164 a5 1
 165 .SY
 166 @