1 /* pop.c: client routines for talking to a POP3-protocol post-office server
2 Copyright (c) 1991, 1993, 1996, 1997 Free Software Foundation, Inc.
3 Written by Jonathan Kamens, jik@security.ov.com.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #define NO_SHORTNAMES /* Tell config not to load remap.h */
24 #include <../src/config.h>
32 /* Cancel these substitutions made in config.h */
39 #include <sys/types.h>
44 #define RECV(s,buf,len,flags) recv(s,buf,len,flags)
45 #define SEND(s,buf,len,flags) send(s,buf,len,flags)
46 #define CLOSESOCKET(s) closesocket(s)
48 #include <netinet/in.h>
49 #include <sys/socket.h>
50 #define RECV(s,buf,len,flags) read(s,buf,len)
51 #define SEND(s,buf,len,flags) write(s,buf,len)
52 #define CLOSESOCKET(s) close(s)
63 * It really shouldn't be necessary to put this declaration here, but
64 * the version of hesiod.h that Athena has installed in release 7.2
65 * doesn't declare this function; I don't know if the 7.3 version of
68 extern struct servent
*hes_getservbyname (/* char *, char * */);
86 # ifdef HAVE_KERBEROSIV_DES_H
87 # include <kerberosIV/des.h>
89 # ifdef HAVE_KERBEROS_DES_H
90 # include <kerberos/des.h>
97 # ifdef HAVE_KERBEROSIV_KRB_H
98 # include <kerberosIV/krb.h>
100 # ifdef HAVE_KERBEROS_KRB_H
101 # include <kerberos/krb.h>
105 # ifdef HAVE_COM_ERR_H
106 # include <com_err.h>
108 #endif /* KERBEROS */
111 extern char *getenv (/* char * */);
112 extern char *getlogin (/* void */);
113 extern char *getpass (/* char * */);
114 extern char *strerror (/* int */);
115 extern char *index ();
119 extern int krb_sendauth (/* long, int, KTEXT, char *, char *, char *,
120 u_long, MSG_DAT *, CREDENTIALS *, Key_schedule,
121 struct sockaddr_in *, struct sockaddr_in *,
123 extern char *krb_realmofhost (/* char * */);
124 #endif /* ! KERBEROS5 */
125 #endif /* KERBEROS */
128 #if !defined(HAVE_H_ERRNO) || !defined(HAVE_CONFIG_H)
133 static int socket_connection (/* char *, int */);
134 static char *getline (/* popserver */);
135 static int sendline (/* popserver, char * */);
136 static int fullwrite (/* int, char *, int */);
137 static int getok (/* popserver */);
139 static int gettermination (/* popserver */);
141 static void pop_trash (/* popserver */);
142 static char *find_crlf (/* char * */);
144 #define ERROR_MAX 80 /* a pretty arbitrary size */
146 #define KPOP_PORT 1109
148 #define POP_SERVICE "pop3" /* we don't want the POP2 port! */
150 #define POP_SERVICE "pop"
153 #define KPOP_SERVICE "kpop"
156 char pop_error
[ERROR_MAX
];
160 #define min(a,b) (((a) < (b)) ? (a) : (b))
164 * Function: pop_open (char *host, char *username, char *password,
167 * Purpose: Establishes a connection with a post-office server, and
168 * completes the authorization portion of the session.
171 * host The server host with which the connection should be
172 * established. Optional. If omitted, internal
173 * heuristics will be used to determine the server host,
176 * The username of the mail-drop to access. Optional.
177 * If omitted, internal heuristics will be used to
178 * determine the username, if possible.
180 * The password to use for authorization. If omitted,
181 * internal heuristics will be used to determine the
182 * password, if possible.
183 * flags A bit mask containing flags controlling certain
184 * functions of the routine. Valid flags are defined in
187 * Return value: Upon successful establishment of a connection, a
188 * non-null popserver will be returned. Otherwise, null will be
189 * returned, and the string variable pop_error will contain an
190 * explanation of the error.
193 pop_open (host
, username
, password
, flags
)
202 /* Determine the user name */
205 username
= getenv ("USER");
206 if (! (username
&& *username
))
208 username
= getlogin ();
209 if (! (username
&& *username
))
211 struct passwd
*passwd
;
212 passwd
= getpwuid (getuid ());
213 if (passwd
&& passwd
->pw_name
&& *passwd
->pw_name
)
215 username
= passwd
->pw_name
;
219 strcpy (pop_error
, "Could not determine username");
227 * Determine the mail host.
232 host
= getenv ("MAILHOST");
236 if ((! host
) && (! (flags
& POP_NO_HESIOD
)))
238 struct hes_postoffice
*office
;
239 office
= hes_getmailhost (username
);
240 if (office
&& office
->po_type
&& (! strcmp (office
->po_type
, "POP"))
241 && office
->po_name
&& *office
->po_name
&& office
->po_host
244 host
= office
->po_host
;
245 username
= office
->po_name
;
259 strcpy (pop_error
, "Could not determine POP server");
263 /* Determine the password */
265 #define DONT_NEED_PASSWORD (! (flags & POP_NO_KERBEROS))
267 #define DONT_NEED_PASSWORD 0
270 if ((! password
) && (! DONT_NEED_PASSWORD
))
272 if (! (flags
& POP_NO_GETPASS
))
274 password
= getpass ("Enter POP password:");
278 strcpy (pop_error
, "Could not determine POP password");
283 flags
|= POP_NO_KERBEROS
;
287 sock
= socket_connection (host
, flags
);
291 server
= (popserver
) malloc (sizeof (struct _popserver
));
294 strcpy (pop_error
, "Out of memory in pop_open");
297 server
->buffer
= (char *) malloc (GETLINE_MIN
);
298 if (! server
->buffer
)
300 strcpy (pop_error
, "Out of memory in pop_open");
301 free ((char *) server
);
307 server
->buffer_index
= 0;
308 server
->buffer_size
= GETLINE_MIN
;
309 server
->in_multi
= 0;
310 server
->trash_started
= 0;
316 * I really shouldn't use the pop_error variable like this, but....
318 if (strlen (username
) > ERROR_MAX
- 6)
322 "Username too long; recompile pop.c with larger ERROR_MAX");
325 sprintf (pop_error
, "USER %s", username
);
327 if (sendline (server
, pop_error
) || getok (server
))
332 if (strlen (password
) > ERROR_MAX
- 6)
336 "Password too long; recompile pop.c with larger ERROR_MAX");
339 sprintf (pop_error
, "PASS %s", password
);
341 if (sendline (server
, pop_error
) || getok (server
))
352 * Purpose: Issue the STAT command to the server and return (in the
353 * value parameters) the number of messages in the maildrop and
354 * the total size of the maildrop.
356 * Return value: 0 on success, or non-zero with an error in pop_error
359 * Side effects: On failure, may make further operations on the
360 * connection impossible.
363 pop_stat (server
, count
, size
)
370 if (server
->in_multi
)
372 strcpy (pop_error
, "In multi-line query in pop_stat");
376 if (sendline (server
, "STAT") || (! (fromserver
= getline (server
))))
379 if (strncmp (fromserver
, "+OK ", 4))
381 if (0 == strncmp (fromserver
, "-ERR", 4))
383 strncpy (pop_error
, fromserver
, ERROR_MAX
);
388 "Unexpected response from POP server in pop_stat");
394 *count
= atoi (&fromserver
[4]);
396 fromserver
= index (&fromserver
[4], ' ');
400 "Badly formatted response from server in pop_stat");
405 *size
= atoi (fromserver
+ 1);
413 * Purpose: Performs the POP "list" command and returns (in value
414 * parameters) two malloc'd zero-terminated arrays -- one of
415 * message IDs, and a parallel one of sizes.
418 * server The pop connection to talk to.
419 * message The number of the one message about which to get
420 * information, or 0 to get information about all
423 * Return value: 0 on success, non-zero with error in pop_error on
426 * Side effects: On failure, may make further operations on the
427 * connection impossible.
430 pop_list (server
, message
, IDs
, sizes
)
439 if (server
->in_multi
)
441 strcpy (pop_error
, "In multi-line query in pop_list");
450 if (pop_stat (server
, &count
, &size
))
455 *IDs
= (int *) malloc ((how_many
+ 1) * sizeof (int));
456 *sizes
= (int *) malloc ((how_many
+ 1) * sizeof (int));
457 if (! (*IDs
&& *sizes
))
459 strcpy (pop_error
, "Out of memory in pop_list");
465 sprintf (pop_error
, "LIST %d", message
);
466 if (sendline (server
, pop_error
))
468 free ((char *) *IDs
);
469 free ((char *) *sizes
);
472 if (! (fromserver
= getline (server
)))
474 free ((char *) *IDs
);
475 free ((char *) *sizes
);
478 if (strncmp (fromserver
, "+OK ", 4))
480 if (! strncmp (fromserver
, "-ERR", 4))
481 strncpy (pop_error
, fromserver
, ERROR_MAX
);
485 "Unexpected response from server in pop_list");
488 free ((char *) *IDs
);
489 free ((char *) *sizes
);
492 (*IDs
)[0] = atoi (&fromserver
[4]);
493 fromserver
= index (&fromserver
[4], ' ');
497 "Badly formatted response from server in pop_list");
499 free ((char *) *IDs
);
500 free ((char *) *sizes
);
503 (*sizes
)[0] = atoi (fromserver
);
504 (*IDs
)[1] = (*sizes
)[1] = 0;
509 if (pop_multi_first (server
, "LIST", &fromserver
))
511 free ((char *) *IDs
);
512 free ((char *) *sizes
);
515 for (i
= 0; i
< how_many
; i
++)
517 if (pop_multi_next (server
, &fromserver
))
519 free ((char *) *IDs
);
520 free ((char *) *sizes
);
523 (*IDs
)[i
] = atoi (fromserver
);
524 fromserver
= index (fromserver
, ' ');
528 "Badly formatted response from server in pop_list");
529 free ((char *) *IDs
);
530 free ((char *) *sizes
);
534 (*sizes
)[i
] = atoi (fromserver
);
536 if (pop_multi_next (server
, &fromserver
))
538 free ((char *) *IDs
);
539 free ((char *) *sizes
);
545 "Too many response lines from server in pop_list");
546 free ((char *) *IDs
);
547 free ((char *) *sizes
);
550 (*IDs
)[i
] = (*sizes
)[i
] = 0;
556 * Function: pop_retrieve
558 * Purpose: Retrieve a specified message from the maildrop.
561 * server The server to retrieve from.
562 * message The message number to retrieve.
564 * If true, then mark the string "From " at the beginning
567 * Return value: A string pointing to the message, if successful, or
568 * null with pop_error set if not.
570 * Side effects: May kill connection on error.
573 pop_retrieve (server
, message
, markfrom
)
578 int *IDs
, *sizes
, bufsize
, fromcount
= 0, cp
= 0;
579 char *ptr
, *fromserver
;
582 if (server
->in_multi
)
584 strcpy (pop_error
, "In multi-line query in pop_retrieve");
588 if (pop_list (server
, message
, &IDs
, &sizes
))
591 if (pop_retrieve_first (server
, message
, &fromserver
))
597 * The "5" below is an arbitrary constant -- I assume that if
598 * there are "From" lines in the text to be marked, there
599 * probably won't be more than 5 of them. If there are, I
600 * allocate more space for them below.
602 bufsize
= sizes
[0] + (markfrom
? 5 : 0);
603 ptr
= (char *)malloc (bufsize
);
605 free ((char *) sizes
);
609 strcpy (pop_error
, "Out of memory in pop_retrieve");
610 pop_retrieve_flush (server
);
614 while (! (ret
= pop_retrieve_next (server
, &fromserver
)))
623 if (markfrom
&& fromserver
[0] == 'F' && fromserver
[1] == 'r' &&
624 fromserver
[2] == 'o' && fromserver
[3] == 'm' &&
625 fromserver
[4] == ' ')
627 if (++fromcount
== 5)
630 ptr
= (char *)realloc (ptr
, bufsize
);
633 strcpy (pop_error
, "Out of memory in pop_retrieve");
634 pop_retrieve_flush (server
);
641 linesize
= strlen (fromserver
);
642 bcopy (fromserver
, &ptr
[cp
], linesize
);
655 pop_retrieve_first (server
, message
, response
)
660 sprintf (pop_error
, "RETR %d", message
);
661 return (pop_multi_first (server
, pop_error
, response
));
665 pop_retrieve_next (server
, line
)
669 return (pop_multi_next (server
, line
));
673 pop_retrieve_flush (server
)
676 return (pop_multi_flush (server
));
680 pop_top_first (server
, message
, lines
, response
)
685 sprintf (pop_error
, "TOP %d %d", message
, lines
);
686 return (pop_multi_first (server
, pop_error
, response
));
690 pop_top_next (server
, line
)
694 return (pop_multi_next (server
, line
));
698 pop_top_flush (server
)
701 return (pop_multi_flush (server
));
705 pop_multi_first (server
, command
, response
)
710 if (server
->in_multi
)
713 "Already in multi-line query in pop_multi_first");
717 if (sendline (server
, command
) || (! (*response
= getline (server
))))
722 if (0 == strncmp (*response
, "-ERR", 4))
724 strncpy (pop_error
, *response
, ERROR_MAX
);
727 else if (0 == strncmp (*response
, "+OK", 3))
729 for (*response
+= 3; **response
== ' '; (*response
)++) /* empty */;
730 server
->in_multi
= 1;
736 "Unexpected response from server in pop_multi_first");
742 pop_multi_next (server
, line
)
748 if (! server
->in_multi
)
750 strcpy (pop_error
, "Not in multi-line query in pop_multi_next");
754 fromserver
= getline (server
);
760 if (fromserver
[0] == '.')
765 server
->in_multi
= 0;
770 *line
= fromserver
+ 1;
782 pop_multi_flush (server
)
787 if (! server
->in_multi
)
792 while (! pop_multi_next (server
, &line
))
803 /* Function: pop_delete
805 * Purpose: Delete a specified message.
808 * server Server from which to delete the message.
809 * message Message to delete.
811 * Return value: 0 on success, non-zero with error in pop_error
815 pop_delete (server
, message
)
819 if (server
->in_multi
)
821 strcpy (pop_error
, "In multi-line query in pop_delete");
825 sprintf (pop_error
, "DELE %d", message
);
827 if (sendline (server
, pop_error
) || getok (server
))
836 * Purpose: Send a noop command to the server.
839 * server The server to send to.
841 * Return value: 0 on success, non-zero with error in pop_error
844 * Side effects: Closes connection on error.
850 if (server
->in_multi
)
852 strcpy (pop_error
, "In multi-line query in pop_noop");
856 if (sendline (server
, "NOOP") || getok (server
))
865 * Purpose: Find out the highest seen message from the server.
870 * Return value: If successful, the highest seen message, which is
871 * greater than or equal to 0. Otherwise, a negative number with
872 * the error explained in pop_error.
874 * Side effects: Closes the connection on error.
882 if (server
->in_multi
)
884 strcpy (pop_error
, "In multi-line query in pop_last");
888 if (sendline (server
, "LAST"))
891 if (! (fromserver
= getline (server
)))
894 if (! strncmp (fromserver
, "-ERR", 4))
896 strncpy (pop_error
, fromserver
, ERROR_MAX
);
899 else if (strncmp (fromserver
, "+OK ", 4))
901 strcpy (pop_error
, "Unexpected response from server in pop_last");
907 return (atoi (&fromserver
[4]));
912 * Function: pop_reset
914 * Purpose: Reset the server to its initial connect state
919 * Return value: 0 for success, non-0 with error in pop_error
922 * Side effects: Closes the connection on error.
928 if (pop_retrieve_flush (server
))
933 if (sendline (server
, "RSET") || getok (server
))
942 * Purpose: Quit the connection to the server,
945 * server The server to quit.
947 * Return value: 0 for success, non-zero otherwise with error in
950 * Side Effects: The popserver passed in is unusable after this
951 * function is called, even if an error occurs.
959 if (server
->file
>= 0)
961 if (pop_retrieve_flush (server
))
966 if (sendline (server
, "QUIT") || getok (server
))
971 close (server
->file
);
975 free (server
->buffer
);
976 free ((char *) server
);
982 static int have_winsock
= 0;
986 * Function: socket_connection
988 * Purpose: Opens the network connection with the mail host, without
989 * doing any sort of I/O with it or anything.
992 * host The host to which to connect.
993 * flags Option flags.
995 * Return value: A file descriptor indicating the connection, or -1
996 * indicating failure, in which case an error has been copied
1000 socket_connection (host
, flags
)
1004 struct hostent
*hostent
;
1005 struct servent
*servent
;
1006 struct sockaddr_in addr
;
1007 char found_port
= 0;
1012 krb5_error_code rem
;
1013 krb5_context kcontext
= 0;
1014 krb5_auth_context auth_context
= 0;
1016 krb5_principal client
, server
;
1017 krb5_error
*err_ret
;
1023 Key_schedule schedule
;
1026 #endif /* KERBEROS5 */
1027 #endif /* KERBEROS */
1033 WSADATA winsockData
;
1034 if (WSAStartup (0x101, &winsockData
) == 0)
1041 hostent
= gethostbyname (host
);
1043 if ((! hostent
) && ((h_errno
!= TRY_AGAIN
) || (try_count
== 5)))
1045 strcpy (pop_error
, "Could not determine POP server's address");
1048 } while (! hostent
);
1050 bzero ((char *) &addr
, sizeof (addr
));
1051 addr
.sin_family
= AF_INET
;
1054 service
= (flags
& POP_NO_KERBEROS
) ? POP_SERVICE
: KPOP_SERVICE
;
1056 service
= POP_SERVICE
;
1060 if (! (flags
& POP_NO_HESIOD
))
1062 servent
= hes_getservbyname (service
, "tcp");
1065 addr
.sin_port
= servent
->s_port
;
1072 servent
= getservbyname (service
, "tcp");
1075 addr
.sin_port
= servent
->s_port
;
1080 addr
.sin_port
= htons ((flags
& POP_NO_KERBEROS
) ?
1081 POP_PORT
: KPOP_PORT
);
1083 addr
.sin_port
= htons (POP_PORT
);
1088 #define POP_SOCKET_ERROR "Could not create socket for POP connection: "
1090 sock
= socket (PF_INET
, SOCK_STREAM
, 0);
1093 strcpy (pop_error
, POP_SOCKET_ERROR
);
1094 strncat (pop_error
, strerror (errno
),
1095 ERROR_MAX
- sizeof (POP_SOCKET_ERROR
));
1100 while (*hostent
->h_addr_list
)
1102 bcopy (*hostent
->h_addr_list
, (char *) &addr
.sin_addr
,
1104 if (! connect (sock
, (struct sockaddr
*) &addr
, sizeof (addr
)))
1106 hostent
->h_addr_list
++;
1109 #define CONNECT_ERROR "Could not connect to POP server: "
1111 if (! *hostent
->h_addr_list
)
1114 strcpy (pop_error
, CONNECT_ERROR
);
1115 strncat (pop_error
, strerror (errno
),
1116 ERROR_MAX
- sizeof (CONNECT_ERROR
));
1122 #define KRB_ERROR "Kerberos error connecting to POP server: "
1123 if (! (flags
& POP_NO_KERBEROS
))
1126 if ((rem
= krb5_init_context (&kcontext
)))
1130 krb5_auth_con_free (kcontext
, auth_context
);
1132 krb5_free_context (kcontext
);
1133 strcpy (pop_error
, KRB_ERROR
);
1134 strncat (pop_error
, error_message (rem
),
1135 ERROR_MAX
- sizeof(KRB_ERROR
));
1140 if ((rem
= krb5_auth_con_init (kcontext
, &auth_context
)))
1143 if (rem
= krb5_cc_default (kcontext
, &ccdef
))
1146 if (rem
= krb5_cc_get_principal (kcontext
, ccdef
, &client
))
1149 for (cp
= hostent
->h_name
; *cp
; cp
++)
1153 *cp
= tolower (*cp
);
1157 if (rem
= krb5_sname_to_principal (kcontext
, hostent
->h_name
,
1158 POP_SERVICE
, FALSE
, &server
))
1161 rem
= krb5_sendauth (kcontext
, &auth_context
,
1162 (krb5_pointer
) &sock
, "KPOPV1.0", client
, server
,
1163 AP_OPTS_MUTUAL_REQUIRED
,
1164 0, /* no checksum */
1165 0, /* no creds, use ccache instead */
1168 0, /* don't need subsession key */
1169 0); /* don't need reply */
1170 krb5_free_principal (kcontext
, server
);
1173 if (err_ret
&& err_ret
->text
.length
)
1175 strcpy (pop_error
, KRB_ERROR
);
1176 strncat (pop_error
, error_message (rem
),
1177 ERROR_MAX
- sizeof (KRB_ERROR
));
1178 strncat (pop_error
, " [server says '",
1179 ERROR_MAX
- strlen (pop_error
) - 1);
1180 strncat (pop_error
, err_ret
->text
.data
,
1181 min (ERROR_MAX
- strlen (pop_error
) - 1,
1182 err_ret
->text
.length
));
1183 strncat (pop_error
, "']",
1184 ERROR_MAX
- strlen (pop_error
) - 1);
1188 strcpy (pop_error
, KRB_ERROR
);
1189 strncat (pop_error
, error_message (rem
),
1190 ERROR_MAX
- sizeof (KRB_ERROR
));
1193 krb5_free_error (kcontext
, err_ret
);
1194 krb5_auth_con_free (kcontext
, auth_context
);
1195 krb5_free_context (kcontext
);
1200 #else /* ! KERBEROS5 */
1201 ticket
= (KTEXT
) malloc (sizeof (KTEXT_ST
));
1202 realhost
= strdup (hostent
->h_name
);
1203 rem
= krb_sendauth (0L, sock
, ticket
, "pop", realhost
,
1204 (char *) krb_realmofhost (realhost
),
1205 (unsigned long) 0, &msg_data
, &cred
, schedule
,
1206 (struct sockaddr_in
*) 0,
1207 (struct sockaddr_in
*) 0,
1209 free ((char *) ticket
);
1211 if (rem
!= KSUCCESS
)
1213 strcpy (pop_error
, KRB_ERROR
);
1214 strncat (pop_error
, krb_err_txt
[rem
],
1215 ERROR_MAX
- sizeof (KRB_ERROR
));
1219 #endif /* KERBEROS5 */
1221 #endif /* KERBEROS */
1224 } /* socket_connection */
1229 * Purpose: Get a line of text from the connection and return a
1230 * pointer to it. The carriage return and linefeed at the end of
1231 * the line are stripped, but periods at the beginnings of lines
1232 * are NOT dealt with in any special way.
1235 * server The server from which to get the line of text.
1237 * Returns: A non-null pointer if successful, or a null pointer on any
1238 * error, with an error message copied into pop_error.
1240 * Notes: The line returned is overwritten with each call to getline.
1242 * Side effects: Closes the connection on error.
1248 #define GETLINE_ERROR "Error reading from server: "
1251 int search_offset
= 0;
1255 char *cp
= find_crlf (server
->buffer
+ server
->buffer_index
);
1261 found
= server
->buffer_index
;
1262 data_used
= (cp
+ 2) - server
->buffer
- found
;
1264 *cp
= '\0'; /* terminate the string to be returned */
1265 server
->data
-= data_used
;
1266 server
->buffer_index
+= data_used
;
1269 fprintf (stderr
, "<<< %s\n", server
->buffer
+ found
);
1270 return (server
->buffer
+ found
);
1274 bcopy (server
->buffer
+ server
->buffer_index
,
1275 server
->buffer
, server
->data
);
1276 /* Record the fact that we've searched the data already in
1277 the buffer for a CRLF, so that when we search below, we
1278 don't have to search the same data twice. There's a "-
1279 1" here to account for the fact that the last character
1280 of the data we have may be the CR of a CRLF pair, of
1281 which we haven't read the second half yet, so we may have
1282 to search it again when we read more data. */
1283 search_offset
= server
->data
- 1;
1284 server
->buffer_index
= 0;
1289 server
->buffer_index
= 0;
1294 /* There's a "- 1" here to leave room for the null that we put
1295 at the end of the read data below. We put the null there so
1296 that find_crlf knows where to stop when we call it. */
1297 if (server
->data
== server
->buffer_size
- 1)
1299 server
->buffer_size
+= GETLINE_INCR
;
1300 server
->buffer
= (char *)realloc (server
->buffer
, server
->buffer_size
);
1301 if (! server
->buffer
)
1303 strcpy (pop_error
, "Out of memory in getline");
1308 ret
= RECV (server
->file
, server
->buffer
+ server
->data
,
1309 server
->buffer_size
- server
->data
- 1, 0);
1312 strcpy (pop_error
, GETLINE_ERROR
);
1313 strncat (pop_error
, strerror (errno
),
1314 ERROR_MAX
- sizeof (GETLINE_ERROR
));
1320 strcpy (pop_error
, "Unexpected EOF from server in getline");
1327 server
->data
+= ret
;
1328 server
->buffer
[server
->data
] = '\0';
1330 cp
= find_crlf (server
->buffer
+ search_offset
);
1333 int data_used
= (cp
+ 2) - server
->buffer
;
1335 server
->data
-= data_used
;
1336 server
->buffer_index
= data_used
;
1339 fprintf (stderr
, "<<< %s\n", server
->buffer
);
1340 return (server
->buffer
);
1342 /* As above, the "- 1" here is to account for the fact that
1343 we may have read a CR without its accompanying LF. */
1344 search_offset
+= ret
- 1;
1352 * Function: sendline
1354 * Purpose: Sends a line of text to the POP server. The line of text
1355 * passed into this function should NOT have the carriage return
1356 * and linefeed on the end of it. Periods at beginnings of lines
1357 * will NOT be treated specially by this function.
1360 * server The server to which to send the text.
1361 * line The line of text to send.
1363 * Return value: Upon successful completion, a value of 0 will be
1364 * returned. Otherwise, a non-zero value will be returned, and
1365 * an error will be copied into pop_error.
1367 * Side effects: Closes the connection on error.
1370 sendline (server
, line
)
1374 #define SENDLINE_ERROR "Error writing to POP server: "
1377 ret
= fullwrite (server
->file
, line
, strlen (line
));
1379 { /* 0 indicates that a blank line was written */
1380 ret
= fullwrite (server
->file
, "\r\n", 2);
1386 strcpy (pop_error
, SENDLINE_ERROR
);
1387 strncat (pop_error
, strerror (errno
),
1388 ERROR_MAX
- sizeof (SENDLINE_ERROR
));
1393 fprintf (stderr
, ">>> %s\n", line
);
1399 * Procedure: fullwrite
1401 * Purpose: Just like write, but keeps trying until the entire string
1404 * Return value: Same as write. Pop_error is not set.
1407 fullwrite (fd
, buf
, nbytes
)
1416 while ((ret
= SEND (fd
, cp
, nbytes
, 0)) > 0)
1428 * Purpose: Reads a line from the server. If the return indicator is
1429 * positive, return with a zero exit status. If not, return with
1430 * a negative exit status.
1433 * server The server to read from.
1435 * Returns: 0 for success, else for failure and puts error in pop_error.
1437 * Side effects: On failure, may make the connection unusable.
1445 if (! (fromline
= getline (server
)))
1450 if (! strncmp (fromline
, "+OK", 3))
1452 else if (! strncmp (fromline
, "-ERR", 4))
1454 strncpy (pop_error
, fromline
, ERROR_MAX
);
1455 pop_error
[ERROR_MAX
-1] = '\0';
1461 "Unexpected response from server; expecting +OK or -ERR");
1469 * Function: gettermination
1471 * Purpose: Gets the next line and verifies that it is a termination
1472 * line (nothing but a dot).
1474 * Return value: 0 on success, non-zero with pop_error set on error.
1476 * Side effects: Closes the connection on error.
1479 gettermination (server
)
1484 fromserver
= getline (server
);
1488 if (strcmp (fromserver
, "."))
1491 "Unexpected response from server in gettermination");
1501 * Function pop_close
1503 * Purpose: Close a pop connection, sending a "RSET" command to try to
1504 * preserve any changes that were made and a "QUIT" command to
1505 * try to get the server to quit, but ignoring any responses that
1508 * Side effects: The server is unusable after this function returns.
1509 * Changes made to the maildrop since the session was started (or
1510 * since the last pop_reset) may be lost.
1517 free ((char *) server
);
1523 * Function: pop_trash
1525 * Purpose: Like pop_close or pop_quit, but doesn't deallocate the
1526 * memory associated with the server. It is legal to call
1527 * pop_close or pop_quit after this function has been called.
1533 if (server
->file
>= 0)
1535 /* avoid recursion; sendline can call pop_trash */
1536 if (server
->trash_started
)
1538 server
->trash_started
= 1;
1540 sendline (server
, "RSET");
1541 sendline (server
, "QUIT");
1543 CLOSESOCKET (server
->file
);
1547 free (server
->buffer
);
1558 /* Return a pointer to the first CRLF in IN_STRING,
1559 or 0 if it does not contain one. */
1562 find_crlf (in_string
)
1569 else if (*in_string
== '\r')
1571 if (*++in_string
== '\n')
1572 return (in_string
- 1);
1580 #endif /* MAIL_USE_POP */