Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH POP3 8
2 
.SH NAME
3 
pop3, imap4d \- Internet mail servers
4 
.SH SYNOPSIS
5 
.PP
6 
.B upas/pop3
7 
[
8 
.B -d
9 
.I debugfile
10 
][
11 
.B -a
12 
.I mailbox
13 
][
14 
.B -r
15 
.I peeraddr
16 
][
17 
.B -t
18 
.I tlscertfile
19 
][
20 
.B -p
21 
]
22 
.PP
23 
.B ip/imap4d
24 
.RB [ -acpv ]
25 
.RB [ -d
26 
.IR smtpdomain ]
27 
.RB [ -s
28 
.IR servername ]
29 
.SH DESCRIPTION
30 
These programs support remote access to mail across the Internet.
31 
All expect the network connection to be standard input, output, and error.
32 
They are normally started from scripts in
33 
.B /rc/bin/service
34 
(see
35 
.IR listen (8)).
36 
.PP
37 
.I Pop3
38 
provides access to a user's mailboxes via the POP3 protocol.
39 
The options are:
40 
.TP 4
41 
.B -d
42 
create
43 
.I debugfile
44 
and write debugging output to it
45 
.TP
46 
.B -a
47 
causes pop3 to assume that it it already authenticated
48 
and to read
49 
.I mailbox
50 
immediately
51 
.TP
52 
.B -r
53 
causes
54 
.I pop3
55 
to create the file
56 
.B /mail/ratify/trusted/\fIpeeraddr\fP#32
57 
to allow subsequent SMTP sessions from that
58 
address.  See
59 
.IR ratfs (4)
60 
for details.
61 
.TP
62 
.B -t
63 
get the local TLS certificate from the file
64 
.IR tlscertfile .
65 
.TP
66 
.B -p
67 
allow passwords in the clear for authenticating the connection
68 
.PP
69 
.I Imap4d
70 
provides access to a user's mailboxes via the IMAP4rev1 protocol.
71 
Only files rooted in
72 
.BI /mail/box/ username /
73 
are accessible.
74 
The list of subscribed mailboxes is contained in
75 
.BI /mail/box/ username /imap.subscribed ,
76 
and initially contains only
77 
.BR INBOX ,
78 
IMAP's name for the user's mailbox.
79 
A shadow file,
80 
.IB mailbox .imp ,
81 
is created for each mailbox examined.
82 
.PP
83 
.IR Imap4d 's
84 
options are:
85 
.TP 4
86 
.B a
87 
Assume the user is already authenticated.
88 
By default, the user must authenticate using
89 
CRAM-MD5 or
90 
.IR securenet (8)
91 
challenge/response authentication.
92 
.TP
93 
.B c
94 
Allow plan 9 challenge response authentication.
95 
.TP
96 
.B p
97 
Allow login authentication.  This option
98 
should only be enabled for servers using
99 
an encrypted connection, such as SSL,
100 
and when enabled, all non-encrypted connections should be disallowed.
101 
.I Imap4d
102 
does not enforce this policy.
103 
.TP
104 
.B v
105 
Turn on verbose output to the debug file.
106 
.TP
107 
.B s
108 
The server's name.
109 
If none is provided,
110 
.B cs
111 
(see
112 
.IR ndb (8))
113 
is queried or
114 
.B /env/sysname
115 
is used.
116 
.TP
117 
.B d
118 
The local mail domain.
119 
Defaults to the server
120 
.B /env/site
121 
in the mail server's domain.
122 
.PP
123 
For both
124 
.I imap4d
125 
and
126 
.IR pop3 ,
127 
the password used to authenticate the connection is the APOP
128 
secret held by
129 
.IR keyfs (4)
130 
running on the authentication server.
131 
.SH FILES
132 
.TF /mail/box/username/imap.subscrib
133 
.TP
134 
.B /sys/log/imap4d
135 
debugging output
136 
.TP
137 
.BI /mail/box/ username / mailbox
138 
.TP
139 
.BI /mail/box/ username / mailbox .imp
140 
.TP
141 
.BI /mail/box/ username /imap.subscribed
142 
.SH SOURCE
143 
.B /sys/src/cmd/upas/pop3
144 
.br
145 
.B /sys/src/cmd/ip/imap4d
146 
.SH "SEE ALSO"
147 
.IR aliasmail (8),
148 
.IR faces (1),
149 
.IR filter (1),
150 
.IR mail (1),
151 
.IR marshal (1),
152 
.IR mlmgr (1),
153 
.IR nedmail (1),
154 
.IR qer (8),
155 
.IR rewrite (6),
156 
.IR send (8),
157 
.IR upasfs (4)
158 
.SH BUGS
159 
Usually messages flagged for deletion with
160 
.B DELE
161 
are not actually deleted until the client sends a
162 
.B QUIT
163 
command to end the conversation.
164 
.I Pop3
165 
implements a non-standard command
166 
.B SYNC
167 
that deletes messages flagged for deletion
168 
without ending the conversation.