summaryrefslogtreecommitdiff
path: root/doc/rfc/rfc918.txt
blob: dbb6f03d8ff961b028a2ead846fda686bbf34aa5 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
Network Working Group                                     J. K. Reynolds
Request for Comments: 918                                            ISI
                                                            October 1984


                          POST OFFICE PROTOCOL


Status of this Memo

   This RFC suggests a simple method for workstations to dynamically
   access mail from a mailbox server.  This RFC specifies a proposed
   protocol for the ARPA-Internet community, and requests discussion and
   suggestions for improvement.

Introduction

   The intent of the Post Office Protocol (POP) is to allow a user's
   workstation to access mail from a mailbox server.  It is expected
   that mail will be posted from the workstation to the mailbox server
   via the Simple Mail Transfer Protocol (SMTP).  For further
   information see RFC-821 [1] and RFC-822 [2].

   The status of this protocol is experimental, and this protocol is
   dependent upon TCP.

The Protocol

   The protocol is for the server to be listening for a connection.
   When a connection is opened the server sends a greeting message and
   waits for commands.  When commands are received the server acts on
   them and responds with replies.

   The client opens a connection, waits for the greeting, then sends the
   USER and then the PASS commands to establish authorization to access
   mailboxes.  The client begins a mail reading transaction with either
   an RDEL (to read and delete all messages from a mailbox) or a RETR
   (to simply read all messages from a mailbox).  The server opens and
   locks the mailbox, and responds with the number of characters in the
   mailbox.  Then the client asks for the data to be sent by issuing the
   RCEV command.  The server responds by sending the mail data.  When
   all the data has been received the client sends the RCVD command.  If
   the transaction started with the RDEL command the server now deletes
   the mail data from the mailbox. In any case, the server closes and
   unlocks the mailbox.  The client terminates the session with the QUIT
   command.








Reynolds                                                        [Page 1]
^L


Post Office Protocol                                             RFC 918


   The Normal Scenario

           Client                    Server
           ------                    ------
                                Wait for Connection
      Open Connection  -->
                           <--  +OK
                                Wait for Command
      USER Fred        -->
                           <--  +OK
                                Wait for Command
      PASS password    -->
                           <--  +OK
                                Wait for Command
      RDEL mailbox     -->      (open and lock mailbox)
                           <--  #xxx
                                Wait for Command
      RCEV             -->   
                           <--  (send a copy of mail)
                                Wait for Command
      RCVD             -->      (deletes mail from mailbox, unlock
                                and close mailbox)
                           <--  +OK
                                Wait for Command
      QUIT             -->
                           <--  +OK
      Close connection --> <--  Close connection
                                Wait for Connection (go back to start)

Definitions of Commands and Replies

   Summary of Commands and Replies

      Commands                          Replies
      --------                          -------
      USER name                         +OK
      PASS password                     -Error
      RETR mailbox                      #xxx
      RDEL mailbox
      RCEV
      RCVD
      QUIT
      NOOP
      RSET







Reynolds                                                        [Page 2]
^L


Post Office Protocol                                             RFC 918


   Commands

      USER name

         This command identifies the user to the server.  It must be
         followed by the PASS command.

            Possible responses:  "+OK" or "-ERR"

      PASS password

         The PASS command carries the password authenticating this user.
         Together the USER name and PASS password are used by the server
         to control access to the mailboxes.

            Possible responses:  "+OK" or "-ERR"

      RETR mailbox

         This command begins a mail reading transaction.  The RETR
         command is used to read all the messages in a mailbox without
         deleting them.  It must be followed by the RCEV command.

            Possible responses:  "#xxx" or "-ERR"

      RDEL mailbox

         This command begins a mail reading transaction.  The RDEL
         command is used to read all the messages in a mailbox and
         delete them.  It must be followed by the RCEV command.

            Possible responses:  "#xxx" or "-ERR"

      RCEV

         This command confirms that the client is ready to receive the
         mail data.  It must be followed by the RCVD command.

            Possible responses:  "+OK" or (connection aborted)

      RCVD

         This command confirms that the client has received and accepted
         the mail.  The RCVD command ends the mail reading transaction.
         In the case of the RDEL transaction, it is possible that the
         mail is not necessarily deleted.  This is indicated by an error
         reply.

            Possible responses:  "+OK" or "-ERR"


Reynolds                                                        [Page 3]
^L


Post Office Protocol                                             RFC 918


      QUIT

         This command indicates the client is done with the session.
         The server sends an OK response and then closes the connection.

            Possible responses:  "+OK" then Close

      NOOP

         This is the no operation command.  It causes no action on the
         part of the server except an OK response.

            Possible response:  "+OK"

      RSET

         This command causes the server to abort the current transaction
         and return to waiting for a command (one of RDEL, RETR, QUIT,
         NOOP, or RSET).  When aborting a transaction the server must
         take care to properly close and unlock the mailbox.

            Possible response:  "+OK"

Acknowledgment

   I would like to acknowledge the contributions of Jon Postel, Joel
   Goldberger, Dale Chase, and Michael Butler in the development of the
   Post Office Protocol.

References

   [1]  Postel, J., "Simple Mail Transfer Protocol", RFC-821,
   USC/Information Sciences Institute, August 1982.

   [2]  Crocker, D., "Standard for the Format of ARPA-Internet Text
   Messages", RFC-822, University of Delaware, August 1982.















Reynolds                                                        [Page 4]
^L


Post Office Protocol                                             RFC 918


Diagram
         +---+      +---+       +---+       +---+       +---+      
   Open  |   | +OK  |   |       |   | +OK   |   |       |   | +OK  
   ----->| S |--+-->| C |------>| S |------>| C |------>| S |---->+
         |   |  ^   |   | USER  |   |       |   | PASS  |   |     |
         +---+  |   +---+       +---+       +---+       +---+     |
                |                 | -ERR                  | -ERR  |
                |                 V                       V       |
   +<-----------+<----------------+<----------------------+       |
   |                                                              |
   V      +---+       +---+                                       |
   +----->|   | QUIT  |   | +OK                                   |
          | C |------>| S |----->Close                            |
   +----->|   |       |   |                                       |
   ^      +---+       +---+                                       |
   |                                                              V
   +<-------------------------------------------------------------+
   |                                                              ^
   |  +---+     +---+      +---+     +---+     +---+     +---+    |
   |  |   |RETR |   | #xxx |   |RECV |   |DATA |   |RCVD |   |+OK |
   +->| C |---->| S |----->| C |---->| S |---->| C |---->| S |--->+
   |  |   | or  |   |      |   |     |   |     |   |     |   |    ^
   |  +---+ RDEL+---+      +---+     +---+     +---+     +---+    |
   |              | -ERR     |         |         |         | -ERR |
   |              V          |         V         |         |      |
   +<-------------+          |       Abort       |         |      |
   |                         V                   V         V      |
   |        +<---------------+-------------------+         +----->+
   |        V                                                      
   |      +---+       +---+                                        
   |      |   | RSET  |   | +OK                                    
   +----->| C |------>| S |----->+                                 
   |      |   |       |   |      |                                 
   |      +---+       +---+      |                                 
   |                             V                                 
   +<----------------------------+                                 
   |                             ^                                 
   |      +---+       +---+      |                                 
   |      |   | NOOP  |   | +OK  |                                 
   +----->| C |------>| S |----->+                                 
          |   |       |   |                                        
          +---+       +---+                                        









Reynolds                                                        [Page 5]
^L