pop.c 38 KB
Newer Older
Richard M. Stallman's avatar
Richard M. Stallman committed
1
/* pop.c: client routines for talking to a POP3-protocol post-office server
2
   Copyright (C) 1991, 1993, 1996, 1997, 1999, 2001, 2002, 2003, 2004,
Glenn Morris's avatar
Glenn Morris committed
3
                 2005, 2006, 2007, 2008, 2009, 2010  Free Software Foundation, Inc.
4 5

Author: Jonathan Kamens <jik@security.ov.com>
Richard M. Stallman's avatar
Richard M. Stallman committed
6 7 8

This file is part of GNU Emacs.

9
GNU Emacs is free software: you can redistribute it and/or modify
Richard M. Stallman's avatar
Richard M. Stallman committed
10
it under the terms of the GNU General Public License as published by
11 12
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Richard M. Stallman's avatar
Richard M. Stallman committed
13 14 15 16 17 18 19

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
20 21
along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */

Richard M. Stallman's avatar
Richard M. Stallman committed
22

23
#ifdef HAVE_CONFIG_H
Pavel Janík's avatar
Pavel Janík committed
24
#include <config.h>
25 26 27
#else
#define MAIL_USE_POP
#endif
Richard M. Stallman's avatar
Richard M. Stallman committed
28

29 30
#ifdef MAIL_USE_POP

Richard M. Stallman's avatar
Richard M. Stallman committed
31
#include <sys/types.h>
32 33 34 35
#ifdef WINDOWSNT
#include "ntlib.h"
#include <winsock.h>
#undef SOCKET_ERROR
36 37 38
#define RECV(s,buf,len,flags) recv(s,buf,len,flags)
#define SEND(s,buf,len,flags) send(s,buf,len,flags)
#define CLOSESOCKET(s) closesocket(s)
39
#else
Richard M. Stallman's avatar
Richard M. Stallman committed
40 41
#include <netinet/in.h>
#include <sys/socket.h>
42 43 44
#define RECV(s,buf,len,flags) read(s,buf,len)
#define SEND(s,buf,len,flags) write(s,buf,len)
#define CLOSESOCKET(s) close(s)
45
#endif
Richard M. Stallman's avatar
Richard M. Stallman committed
46
#include <pop.h>
47

Richard M. Stallman's avatar
Richard M. Stallman committed
48 49
#ifdef sun
#include <malloc.h>
50
#endif /* sun */
51

Richard M. Stallman's avatar
Richard M. Stallman committed
52 53 54 55 56 57 58 59 60 61
#ifdef HESIOD
#include <hesiod.h>
/*
 * It really shouldn't be necessary to put this declaration here, but
 * the version of hesiod.h that Athena has installed in release 7.2
 * doesn't declare this function; I don't know if the 7.3 version of
 * hesiod.h does.
 */
extern struct servent *hes_getservbyname (/* char *, char * */);
#endif
62

Richard M. Stallman's avatar
Richard M. Stallman committed
63 64 65 66
#include <pwd.h>
#include <netdb.h>
#include <errno.h>
#include <stdio.h>
67 68
#ifdef STDC_HEADERS
#include <string.h>
69 70 71 72
#define index strchr
#endif
#ifdef HAVE_UNISTD_H
#include <unistd.h>
73
#endif
74

Richard M. Stallman's avatar
Richard M. Stallman committed
75
#ifdef KERBEROS
76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92
# ifdef HAVE_KRB5_H
#  include <krb5.h>
# endif
# ifdef HAVE_KRB_H
#  include <krb.h>
# else
#  ifdef HAVE_KERBEROSIV_KRB_H
#   include <kerberosIV/krb.h>
#  else
#   ifdef HAVE_KERBEROS_KRB_H
#    include <kerberos/krb.h>
#   endif
#  endif
# endif
# ifdef HAVE_COM_ERR_H
#  include <com_err.h>
# endif
93
#endif /* KERBEROS */
Richard M. Stallman's avatar
Richard M. Stallman committed
94

95
#ifdef KERBEROS
96
#ifndef KERBEROS5
Richard M. Stallman's avatar
Richard M. Stallman committed
97
extern int krb_sendauth (/* long, int, KTEXT, char *, char *, char *,
98 99 100
			    u_long, MSG_DAT *, CREDENTIALS *, Key_schedule,
			    struct sockaddr_in *, struct sockaddr_in *,
			    char * */);
Richard M. Stallman's avatar
Richard M. Stallman committed
101
extern char *krb_realmofhost (/* char * */);
102
#endif /* ! KERBEROS5 */
103
#endif /* KERBEROS */
Richard M. Stallman's avatar
Richard M. Stallman committed
104

105
#ifndef WINDOWSNT
106
#if !defined(HAVE_H_ERRNO) || !defined(HAVE_CONFIG_H)
Richard M. Stallman's avatar
Richard M. Stallman committed
107 108
extern int h_errno;
#endif
109
#endif
Richard M. Stallman's avatar
Richard M. Stallman committed
110

111 112 113 114 115
static int socket_connection (char *, int);
static int pop_getline (popserver, char **);
static int sendline (popserver, char *);
static int fullwrite (int, char *, int);
static int getok (popserver);
Richard M. Stallman's avatar
Richard M. Stallman committed
116
#if 0
117
static int gettermination (popserver);
Richard M. Stallman's avatar
Richard M. Stallman committed
118
#endif
119 120
static void pop_trash (popserver);
static char *find_crlf (char *, int);
121

Dave Love's avatar
Dave Love committed
122
#define ERROR_MAX 160		/* a pretty arbitrary size, but needs
Dave Love's avatar
comment  
Dave Love committed
123 124
				   to be bigger than the original
				   value of 80 */
Richard M. Stallman's avatar
Richard M. Stallman committed
125 126
#define POP_PORT 110
#define KPOP_PORT 1109
127
#define POP_SERVICE "pop3"	/* we don't want the POP2 port! */
Richard M. Stallman's avatar
Richard M. Stallman committed
128
#ifdef KERBEROS
129
#define KPOP_SERVICE "kpop"	/* never used: look for 20060515 to see why */
Richard M. Stallman's avatar
Richard M. Stallman committed
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
#endif

char pop_error[ERROR_MAX];
int pop_debug = 0;

#ifndef min
#define min(a,b) (((a) < (b)) ? (a) : (b))
#endif

/*
 * Function: pop_open (char *host, char *username, char *password,
 * 		       int flags)
 *
 * Purpose: Establishes a connection with a post-office server, and
 * 	completes the authorization portion of the session.
 *
 * Arguments:
 * 	host	The server host with which the connection should be
 * 		established.  Optional.  If omitted, internal
 * 		heuristics will be used to determine the server host,
 * 		if possible.
 * 	username
 * 		The username of the mail-drop to access.  Optional.
 * 		If omitted, internal heuristics will be used to
 * 		determine the username, if possible.
 * 	password
 * 		The password to use for authorization.  If omitted,
 * 		internal heuristics will be used to determine the
 * 		password, if possible.
 * 	flags	A bit mask containing flags controlling certain
 * 		functions of the routine.  Valid flags are defined in
 * 		the file pop.h
 *
 * Return value: Upon successful establishment of a connection, a
 * 	non-null popserver will be returned.  Otherwise, null will be
 * 	returned, and the string variable pop_error will contain an
 * 	explanation of the error.
 */
popserver
169
pop_open (char *host, char *username, char *password, int flags)
Richard M. Stallman's avatar
Richard M. Stallman committed
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
{
  int sock;
  popserver server;

  /* Determine the user name */
  if (! username)
    {
      username = getenv ("USER");
      if (! (username && *username))
	{
	  username = getlogin ();
	  if (! (username && *username))
	    {
	      struct passwd *passwd;
	      passwd = getpwuid (getuid ());
	      if (passwd && passwd->pw_name && *passwd->pw_name)
		{
		  username = passwd->pw_name;
		}
	      else
		{
		  strcpy (pop_error, "Could not determine username");
		  return (0);
		}
	    }
	}
    }

  /*
   *  Determine the mail host.
   */

  if (! host)
    {
      host = getenv ("MAILHOST");
    }

#ifdef HESIOD
  if ((! host) && (! (flags & POP_NO_HESIOD)))
    {
      struct hes_postoffice *office;
      office = hes_getmailhost (username);
      if (office && office->po_type && (! strcmp (office->po_type, "POP"))
	  && office->po_name && *office->po_name && office->po_host
	  && *office->po_host)
	{
	  host = office->po_host;
	  username = office->po_name;
	}
    }
#endif

#ifdef MAILHOST
  if (! host)
    {
      host = MAILHOST;
    }
#endif

  if (! host)
    {
      strcpy (pop_error, "Could not determine POP server");
      return (0);
    }

  /* Determine the password */
Richard M. Stallman's avatar
Richard M. Stallman committed
236 237
#ifdef KERBEROS
#define DONT_NEED_PASSWORD (! (flags & POP_NO_KERBEROS))
Richard M. Stallman's avatar
Richard M. Stallman committed
238
#else
Richard M. Stallman's avatar
Richard M. Stallman committed
239
#define DONT_NEED_PASSWORD 0
Richard M. Stallman's avatar
Richard M. Stallman committed
240
#endif
241

Richard M. Stallman's avatar
Richard M. Stallman committed
242 243 244 245 246 247 248 249 250 251 252 253
  if ((! password) && (! DONT_NEED_PASSWORD))
    {
      if (! (flags & POP_NO_GETPASS))
	{
	  password = getpass ("Enter POP password:");
	}
      if (! password)
	{
	  strcpy (pop_error, "Could not determine POP password");
	  return (0);
	}
    }
254
  if (password)			/* always true, detected 20060515 */
Richard M. Stallman's avatar
Richard M. Stallman committed
255
    flags |= POP_NO_KERBEROS;
Richard M. Stallman's avatar
Richard M. Stallman committed
256
  else
257 258
    password = username;	/* dead code, detected 20060515 */
  /** "kpop" service is  never used: look for 20060515 to see why **/
Richard M. Stallman's avatar
Richard M. Stallman committed
259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276

  sock = socket_connection (host, flags);
  if (sock == -1)
    return (0);

  server = (popserver) malloc (sizeof (struct _popserver));
  if (! server)
    {
      strcpy (pop_error, "Out of memory in pop_open");
      return (0);
    }
  server->buffer = (char *) malloc (GETLINE_MIN);
  if (! server->buffer)
    {
      strcpy (pop_error, "Out of memory in pop_open");
      free ((char *) server);
      return (0);
    }
Pavel Janík's avatar
Pavel Janík committed
277

Richard M. Stallman's avatar
Richard M. Stallman committed
278 279 280 281 282
  server->file = sock;
  server->data = 0;
  server->buffer_index = 0;
  server->buffer_size = GETLINE_MIN;
  server->in_multi = 0;
283
  server->trash_started = 0;
Richard M. Stallman's avatar
Richard M. Stallman committed
284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335

  if (getok (server))
    return (0);

  /*
   * I really shouldn't use the pop_error variable like this, but....
   */
  if (strlen (username) > ERROR_MAX - 6)
    {
      pop_close (server);
      strcpy (pop_error,
	      "Username too long; recompile pop.c with larger ERROR_MAX");
      return (0);
    }
  sprintf (pop_error, "USER %s", username);

  if (sendline (server, pop_error) || getok (server))
    {
      return (0);
    }

  if (strlen (password) > ERROR_MAX - 6)
    {
      pop_close (server);
      strcpy (pop_error,
	      "Password too long; recompile pop.c with larger ERROR_MAX");
      return (0);
    }
  sprintf (pop_error, "PASS %s", password);

  if (sendline (server, pop_error) || getok (server))
    {
      return (0);
    }

  return (server);
}

/*
 * Function: pop_stat
 *
 * Purpose: Issue the STAT command to the server and return (in the
 * 	value parameters) the number of messages in the maildrop and
 * 	the total size of the maildrop.
 *
 * Return value: 0 on success, or non-zero with an error in pop_error
 * 	in failure.
 *
 * Side effects: On failure, may make further operations on the
 * 	connection impossible.
 */
int
336
pop_stat (popserver server, int *count, int *size)
Richard M. Stallman's avatar
Richard M. Stallman committed
337 338
{
  char *fromserver;
339
  char *end_ptr;
Richard M. Stallman's avatar
Richard M. Stallman committed
340 341 342 343 344 345

  if (server->in_multi)
    {
      strcpy (pop_error, "In multi-line query in pop_stat");
      return (-1);
    }
Pavel Janík's avatar
Pavel Janík committed
346

347
  if (sendline (server, "STAT") || (pop_getline (server, &fromserver) < 0))
Richard M. Stallman's avatar
Richard M. Stallman committed
348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364
    return (-1);

  if (strncmp (fromserver, "+OK ", 4))
    {
      if (0 == strncmp (fromserver, "-ERR", 4))
	{
	  strncpy (pop_error, fromserver, ERROR_MAX);
	}
      else
	{
	  strcpy (pop_error,
		  "Unexpected response from POP server in pop_stat");
	  pop_trash (server);
	}
      return (-1);
    }

365 366 367
  errno = 0;
  *count = strtol (&fromserver[4], &end_ptr, 10);
  /* Check validity of string-to-integer conversion. */
368
  if (fromserver + 4 == end_ptr || *end_ptr != ' ' || errno)
369 370 371 372 373
    {
      strcpy (pop_error, "Unexpected response from POP server in pop_stat");
      pop_trash (server);
      return (-1);
    }
Pavel Janík's avatar
Pavel Janík committed
374

375
  fromserver = end_ptr;
Richard M. Stallman's avatar
Richard M. Stallman committed
376

377 378
  errno = 0;
  *size = strtol (fromserver + 1, &end_ptr, 10);
379
  if (fromserver + 1 == end_ptr || errno)
380 381 382 383 384
    {
      strcpy (pop_error, "Unexpected response from POP server in pop_stat");
      pop_trash (server);
      return (-1);
    }
Richard M. Stallman's avatar
Richard M. Stallman committed
385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408

  return (0);
}

/*
 * Function: pop_list
 *
 * Purpose: Performs the POP "list" command and returns (in value
 * 	parameters) two malloc'd zero-terminated arrays -- one of
 * 	message IDs, and a parallel one of sizes.
 *
 * Arguments:
 * 	server	The pop connection to talk to.
 * 	message	The number of the one message about which to get
 * 		information, or 0 to get information about all
 * 		messages.
 *
 * Return value: 0 on success, non-zero with error in pop_error on
 * 	failure.
 *
 * Side effects: On failure, may make further operations on the
 * 	connection impossible.
 */
int
409
pop_list (popserver server, int message, int **IDs, int **sizes)
Richard M. Stallman's avatar
Richard M. Stallman committed
410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446
{
  int how_many, i;
  char *fromserver;

  if (server->in_multi)
    {
      strcpy (pop_error, "In multi-line query in pop_list");
      return (-1);
    }

  if (message)
    how_many = 1;
  else
    {
      int count, size;
      if (pop_stat (server, &count, &size))
	return (-1);
      how_many = count;
    }

  *IDs = (int *) malloc ((how_many + 1) * sizeof (int));
  *sizes = (int *) malloc ((how_many + 1) * sizeof (int));
  if (! (*IDs && *sizes))
    {
      strcpy (pop_error, "Out of memory in pop_list");
      return (-1);
    }

  if (message)
    {
      sprintf (pop_error, "LIST %d", message);
      if (sendline (server, pop_error))
	{
	  free ((char *) *IDs);
	  free ((char *) *sizes);
	  return (-1);
	}
447
      if (pop_getline (server, &fromserver) < 0)
Richard M. Stallman's avatar
Richard M. Stallman committed
448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467
	{
	  free ((char *) *IDs);
	  free ((char *) *sizes);
	  return (-1);
	}
      if (strncmp (fromserver, "+OK ", 4))
	{
	  if (! strncmp (fromserver, "-ERR", 4))
	    strncpy (pop_error, fromserver, ERROR_MAX);
	  else
	    {
	      strcpy (pop_error,
		      "Unexpected response from server in pop_list");
	      pop_trash (server);
	    }
	  free ((char *) *IDs);
	  free ((char *) *sizes);
	  return (-1);
	}
      (*IDs)[0] = atoi (&fromserver[4]);
468
      fromserver = strchr (&fromserver[4], ' ');
Richard M. Stallman's avatar
Richard M. Stallman committed
469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491
      if (! fromserver)
	{
	  strcpy (pop_error,
		  "Badly formatted response from server in pop_list");
	  pop_trash (server);
	  free ((char *) *IDs);
	  free ((char *) *sizes);
	  return (-1);
	}
      (*sizes)[0] = atoi (fromserver);
      (*IDs)[1] = (*sizes)[1] = 0;
      return (0);
    }
  else
    {
      if (pop_multi_first (server, "LIST", &fromserver))
	{
	  free ((char *) *IDs);
	  free ((char *) *sizes);
	  return (-1);
	}
      for (i = 0; i < how_many; i++)
	{
492
	  if (pop_multi_next (server, &fromserver) <= 0)
Richard M. Stallman's avatar
Richard M. Stallman committed
493 494 495 496 497 498
	    {
	      free ((char *) *IDs);
	      free ((char *) *sizes);
	      return (-1);
	    }
	  (*IDs)[i] = atoi (fromserver);
499
	  fromserver = strchr (fromserver, ' ');
Richard M. Stallman's avatar
Richard M. Stallman committed
500 501 502 503 504 505 506 507 508 509 510
	  if (! fromserver)
	    {
	      strcpy (pop_error,
		      "Badly formatted response from server in pop_list");
	      free ((char *) *IDs);
	      free ((char *) *sizes);
	      pop_trash (server);
	      return (-1);
	    }
	  (*sizes)[i] = atoi (fromserver);
	}
511
      if (pop_multi_next (server, &fromserver) < 0)
Richard M. Stallman's avatar
Richard M. Stallman committed
512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540
	{
	  free ((char *) *IDs);
	  free ((char *) *sizes);
	  return (-1);
	}
      else if (fromserver)
	{
	  strcpy (pop_error,
		  "Too many response lines from server in pop_list");
	  free ((char *) *IDs);
	  free ((char *) *sizes);
	  return (-1);
	}
      (*IDs)[i] = (*sizes)[i] = 0;
      return (0);
    }
}

/*
 * Function: pop_retrieve
 *
 * Purpose: Retrieve a specified message from the maildrop.
 *
 * Arguments:
 * 	server	The server to retrieve from.
 * 	message	The message number to retrieve.
 *	markfrom
 * 		If true, then mark the string "From " at the beginning
 * 		of lines with '>'.
541 542
 *	msg_buf	Output parameter to which a buffer containing the
 * 		message is assigned.
543
 *
544 545 546
 * Return value: The number of bytes in msg_buf, which may contain
 * 	embedded nulls, not including its final null, or -1 on error
 * 	with pop_error set.
Richard M. Stallman's avatar
Richard M. Stallman committed
547 548 549
 *
 * Side effects: May kill connection on error.
 */
550
int
551
pop_retrieve (popserver server, int message, int markfrom, char **msg_buf)
Richard M. Stallman's avatar
Richard M. Stallman committed
552 553 554 555 556 557 558 559
{
  int *IDs, *sizes, bufsize, fromcount = 0, cp = 0;
  char *ptr, *fromserver;
  int ret;

  if (server->in_multi)
    {
      strcpy (pop_error, "In multi-line query in pop_retrieve");
560
      return (-1);
Richard M. Stallman's avatar
Richard M. Stallman committed
561 562 563
    }

  if (pop_list (server, message, &IDs, &sizes))
564
    return (-1);
Richard M. Stallman's avatar
Richard M. Stallman committed
565 566 567

  if (pop_retrieve_first (server, message, &fromserver))
    {
568
      return (-1);
Richard M. Stallman's avatar
Richard M. Stallman committed
569 570 571 572 573 574 575 576 577
    }

  /*
   * The "5" below is an arbitrary constant -- I assume that if
   * there are "From" lines in the text to be marked, there
   * probably won't be more than 5 of them.  If there are, I
   * allocate more space for them below.
   */
  bufsize = sizes[0] + (markfrom ? 5 : 0);
578
  ptr = (char *)malloc (bufsize);
Richard M. Stallman's avatar
Richard M. Stallman committed
579 580 581 582 583 584 585
  free ((char *) IDs);
  free ((char *) sizes);

  if (! ptr)
    {
      strcpy (pop_error, "Out of memory in pop_retrieve");
      pop_retrieve_flush (server);
586
      return (-1);
Richard M. Stallman's avatar
Richard M. Stallman committed
587 588
    }

589
  while ((ret = pop_retrieve_next (server, &fromserver)) >= 0)
Richard M. Stallman's avatar
Richard M. Stallman committed
590 591 592 593
    {
      if (! fromserver)
	{
	  ptr[cp] = '\0';
594 595
	  *msg_buf = ptr;
	  return (cp);
Richard M. Stallman's avatar
Richard M. Stallman committed
596 597 598 599 600 601 602 603
	}
      if (markfrom && fromserver[0] == 'F' && fromserver[1] == 'r' &&
	  fromserver[2] == 'o' && fromserver[3] == 'm' &&
	  fromserver[4] == ' ')
	{
	  if (++fromcount == 5)
	    {
	      bufsize += 5;
604
	      ptr = (char *)realloc (ptr, bufsize);
Richard M. Stallman's avatar
Richard M. Stallman committed
605 606 607 608
	      if (! ptr)
		{
		  strcpy (pop_error, "Out of memory in pop_retrieve");
		  pop_retrieve_flush (server);
609
		  return (-1);
Richard M. Stallman's avatar
Richard M. Stallman committed
610 611 612 613 614
		}
	      fromcount = 0;
	    }
	  ptr[cp++] = '>';
	}
615
      memcpy (&ptr[cp], fromserver, ret);
616
      cp += ret;
Richard M. Stallman's avatar
Richard M. Stallman committed
617 618 619
      ptr[cp++] = '\n';
    }

620 621
  free (ptr);
  return (-1);
622
}
Richard M. Stallman's avatar
Richard M. Stallman committed
623 624

int
625
pop_retrieve_first (popserver server, int message, char **response)
Richard M. Stallman's avatar
Richard M. Stallman committed
626 627 628 629 630
{
  sprintf (pop_error, "RETR %d", message);
  return (pop_multi_first (server, pop_error, response));
}

631 632 633 634 635 636 637 638
/*
  Returns a negative number on error, 0 to indicate that the data has
  all been read (i.e., the server has returned a "." termination
  line), or a positive number indicating the number of bytes in the
  returned buffer (which is null-terminated and may contain embedded
  nulls, but the returned bytecount doesn't include the final null).
  */

Richard M. Stallman's avatar
Richard M. Stallman committed
639
int
640
pop_retrieve_next (popserver server, char **line)
Richard M. Stallman's avatar
Richard M. Stallman committed
641 642 643 644 645
{
  return (pop_multi_next (server, line));
}

int
646
pop_retrieve_flush (popserver server)
Richard M. Stallman's avatar
Richard M. Stallman committed
647 648 649 650 651
{
  return (pop_multi_flush (server));
}

int
652
pop_top_first (popserver server, int message, int lines, char **response)
Richard M. Stallman's avatar
Richard M. Stallman committed
653 654 655 656 657
{
  sprintf (pop_error, "TOP %d %d", message, lines);
  return (pop_multi_first (server, pop_error, response));
}

658 659 660 661 662 663 664 665
/*
  Returns a negative number on error, 0 to indicate that the data has
  all been read (i.e., the server has returned a "." termination
  line), or a positive number indicating the number of bytes in the
  returned buffer (which is null-terminated and may contain embedded
  nulls, but the returned bytecount doesn't include the final null).
  */

Richard M. Stallman's avatar
Richard M. Stallman committed
666
int
667
pop_top_next (popserver server, char **line)
Richard M. Stallman's avatar
Richard M. Stallman committed
668 669 670 671 672
{
  return (pop_multi_next (server, line));
}

int
673
pop_top_flush (popserver server)
Richard M. Stallman's avatar
Richard M. Stallman committed
674 675 676 677 678
{
  return (pop_multi_flush (server));
}

int
679
pop_multi_first (popserver server, char *command, char **response)
Richard M. Stallman's avatar
Richard M. Stallman committed
680 681 682 683 684 685 686 687
{
  if (server->in_multi)
    {
      strcpy (pop_error,
	      "Already in multi-line query in pop_multi_first");
      return (-1);
    }

688
  if (sendline (server, command) || (pop_getline (server, response) < 0))
Richard M. Stallman's avatar
Richard M. Stallman committed
689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711
    {
      return (-1);
    }

  if (0 == strncmp (*response, "-ERR", 4))
    {
      strncpy (pop_error, *response, ERROR_MAX);
      return (-1);
    }
  else if (0 == strncmp (*response, "+OK", 3))
    {
      for (*response += 3; **response == ' '; (*response)++) /* empty */;
      server->in_multi = 1;
      return (0);
    }
  else
    {
      strcpy (pop_error,
	      "Unexpected response from server in pop_multi_first");
      return (-1);
    }
}

712 713 714 715 716 717 718 719 720
/*
  Read the next line of data from SERVER and place a pointer to it
  into LINE.  Return -1 on error, 0 if there are no more lines to read
  (i.e., the server has returned a line containing only "."), or a
  positive number indicating the number of bytes in the LINE buffer
  (not including the final null).  The data in that buffer may contain
  embedded nulls, but does not contain the final CRLF. When returning
  0, LINE is set to null. */

Richard M. Stallman's avatar
Richard M. Stallman committed
721
int
722
pop_multi_next (popserver server, char **line)
Richard M. Stallman's avatar
Richard M. Stallman committed
723 724
{
  char *fromserver;
725
  int ret;
Richard M. Stallman's avatar
Richard M. Stallman committed
726 727 728 729 730 731 732

  if (! server->in_multi)
    {
      strcpy (pop_error, "Not in multi-line query in pop_multi_next");
      return (-1);
    }

733
  if ((ret = pop_getline (server, &fromserver)) < 0)
Richard M. Stallman's avatar
Richard M. Stallman committed
734 735 736 737 738 739 740 741 742 743 744 745 746 747 748
    {
      return (-1);
    }

  if (fromserver[0] == '.')
    {
      if (! fromserver[1])
	{
	  *line = 0;
	  server->in_multi = 0;
	  return (0);
	}
      else
	{
	  *line = fromserver + 1;
749
	  return (ret - 1);
Richard M. Stallman's avatar
Richard M. Stallman committed
750 751 752 753 754
	}
    }
  else
    {
      *line = fromserver;
755
      return (ret);
Richard M. Stallman's avatar
Richard M. Stallman committed
756 757 758 759
    }
}

int
760
pop_multi_flush (popserver server)
Richard M. Stallman's avatar
Richard M. Stallman committed
761 762
{
  char *line;
763
  int ret;
Richard M. Stallman's avatar
Richard M. Stallman committed
764 765 766 767 768 769

  if (! server->in_multi)
    {
      return (0);
    }

770
  while ((ret = pop_multi_next (server, &line)))
Richard M. Stallman's avatar
Richard M. Stallman committed
771
    {
772 773
      if (ret < 0)
	return (-1);
Richard M. Stallman's avatar
Richard M. Stallman committed
774 775
    }

776
  return (0);
Richard M. Stallman's avatar
Richard M. Stallman committed
777 778 779 780 781 782 783 784 785 786 787 788 789 790
}

/* Function: pop_delete
 *
 * Purpose: Delete a specified message.
 *
 * Arguments:
 * 	server	Server from which to delete the message.
 * 	message	Message to delete.
 *
 * Return value: 0 on success, non-zero with error in pop_error
 * 	otherwise.
 */
int
791
pop_delete (popserver server, int message)
Richard M. Stallman's avatar
Richard M. Stallman committed
792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820
{
  if (server->in_multi)
    {
      strcpy (pop_error, "In multi-line query in pop_delete");
      return (-1);
    }

  sprintf (pop_error, "DELE %d", message);

  if (sendline (server, pop_error) || getok (server))
    return (-1);

  return (0);
}

/*
 * Function: pop_noop
 *
 * Purpose: Send a noop command to the server.
 *
 * Argument:
 * 	server	The server to send to.
 *
 * Return value: 0 on success, non-zero with error in pop_error
 * 	otherwise.
 *
 * Side effects: Closes connection on error.
 */
int
821
pop_noop (popserver server)
Richard M. Stallman's avatar
Richard M. Stallman committed
822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849
{
  if (server->in_multi)
    {
      strcpy (pop_error, "In multi-line query in pop_noop");
      return (-1);
    }

  if (sendline (server, "NOOP") || getok (server))
    return (-1);

  return (0);
}

/*
 * Function: pop_last
 *
 * Purpose: Find out the highest seen message from the server.
 *
 * Arguments:
 * 	server	The server.
 *
 * Return value: If successful, the highest seen message, which is
 * 	greater than or equal to 0.  Otherwise, a negative number with
 * 	the error explained in pop_error.
 *
 * Side effects: Closes the connection on error.
 */
int
850
pop_last (popserver server)
Richard M. Stallman's avatar
Richard M. Stallman committed
851 852
{
  char *fromserver;
Pavel Janík's avatar
Pavel Janík committed
853

Richard M. Stallman's avatar
Richard M. Stallman committed
854 855 856 857 858 859 860 861 862
  if (server->in_multi)
    {
      strcpy (pop_error, "In multi-line query in pop_last");
      return (-1);
    }

  if (sendline (server, "LAST"))
    return (-1);

863
  if (pop_getline (server, &fromserver) < 0)
Richard M. Stallman's avatar
Richard M. Stallman committed
864 865 866 867 868 869 870 871 872 873 874 875 876 877 878
    return (-1);

  if (! strncmp (fromserver, "-ERR", 4))
    {
      strncpy (pop_error, fromserver, ERROR_MAX);
      return (-1);
    }
  else if (strncmp (fromserver, "+OK ", 4))
    {
      strcpy (pop_error, "Unexpected response from server in pop_last");
      pop_trash (server);
      return (-1);
    }
  else
    {
879 880 881 882
      char *end_ptr;
      int count;
      errno = 0;
      count = strtol (&fromserver[4], &end_ptr, 10);
883
      if (fromserver + 4 == end_ptr || errno)
884 885 886 887 888 889
	{
	  strcpy (pop_error, "Unexpected response from server in pop_last");
	  pop_trash (server);
	  return (-1);
	}
      return count;
Richard M. Stallman's avatar
Richard M. Stallman committed
890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906
    }
}

/*
 * Function: pop_reset
 *
 * Purpose: Reset the server to its initial connect state
 *
 * Arguments:
 * 	server	The server.
 *
 * Return value: 0 for success, non-0 with error in pop_error
 * 	otherwise.
 *
 * Side effects: Closes the connection on error.
 */
int
907
pop_reset (popserver server)
Richard M. Stallman's avatar
Richard M. Stallman committed
908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930
{
  if (pop_retrieve_flush (server))
    {
      return (-1);
    }

  if (sendline (server, "RSET") || getok (server))
    return (-1);

  return (0);
}

/*
 * Function: pop_quit
 *
 * Purpose: Quit the connection to the server,
 *
 * Arguments:
 * 	server	The server to quit.
 *
 * Return value: 0 for success, non-zero otherwise with error in
 * 	pop_error.
 *
Karl Heuer's avatar
Karl Heuer committed
931
 * Side Effects: The popserver passed in is unusable after this
Richard M. Stallman's avatar
Richard M. Stallman committed
932 933 934
 * 	function is called, even if an error occurs.
 */
int
935
pop_quit (popserver server)
Richard M. Stallman's avatar
Richard M. Stallman committed
936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953
{
  int ret = 0;

  if (server->file >= 0)
    {
      if (pop_retrieve_flush (server))
	{
	  ret = -1;
	}

      if (sendline (server, "QUIT") || getok (server))
	{
	  ret = -1;
	}

      close (server->file);
    }

954
  free (server->buffer);
Richard M. Stallman's avatar
Richard M. Stallman committed
955 956 957 958 959
  free ((char *) server);

  return (ret);
}

960 961 962 963
#ifdef WINDOWSNT
static int have_winsock = 0;
#endif

Richard M. Stallman's avatar
Richard M. Stallman committed
964 965 966 967 968 969 970 971 972
/*
 * Function: socket_connection
 *
 * Purpose: Opens the network connection with the mail host, without
 * 	doing any sort of I/O with it or anything.
 *
 * Arguments:
 * 	host	The host to which to connect.
 *	flags	Option flags.
Pavel Janík's avatar
Pavel Janík committed
973
 *
Richard M. Stallman's avatar
Richard M. Stallman committed
974 975 976 977 978
 * Return value: A file descriptor indicating the connection, or -1
 * 	indicating failure, in which case an error has been copied
 * 	into pop_error.
 */
static int
979
socket_connection (char *host, int flags)
Richard M. Stallman's avatar
Richard M. Stallman committed
980
{
981 982 983 984 985
#ifdef HAVE_GETADDRINFO
  struct addrinfo *res, *it;
  struct addrinfo hints;
  int ret;
#else /* !HAVE_GETADDRINFO */
Richard M. Stallman's avatar
Richard M. Stallman committed
986
  struct hostent *hostent;
987
#endif
Richard M. Stallman's avatar
Richard M. Stallman committed
988 989 990 991 992
  struct servent *servent;
  struct sockaddr_in addr;
  char found_port = 0;
  char *service;
  int sock;
993
  char *realhost;
Richard M. Stallman's avatar
Richard M. Stallman committed
994
#ifdef KERBEROS
995
#ifdef KERBEROS5
Richard M. Stallman's avatar
Richard M. Stallman committed
996
  krb5_error_code rem;
997 998
  krb5_context kcontext = 0;
  krb5_auth_context auth_context = 0;
Richard M. Stallman's avatar
Richard M. Stallman committed
999 1000 1001 1002 1003 1004 1005 1006 1007 1008
  krb5_ccache ccdef;
  krb5_principal client, server;
  krb5_error *err_ret;
  register char *cp;
#else
  KTEXT ticket;
  MSG_DAT msg_data;
  CREDENTIALS cred;
  Key_schedule schedule;
  int rem;
1009
#endif /* KERBEROS5 */
Richard M. Stallman's avatar
Richard M. Stallman committed
1010 1011 1012
#endif /* KERBEROS */

  int try_count = 0;
1013
  int connect_ok;
Richard M. Stallman's avatar
Richard M. Stallman committed
1014

1015 1016 1017 1018 1019 1020 1021 1022
#ifdef WINDOWSNT
  {
    WSADATA winsockData;
    if (WSAStartup (0x101, &winsockData) == 0)
      have_winsock = 1;
  }
#endif

1023
  memset (&addr, 0, sizeof (addr));
Richard M. Stallman's avatar
Richard M. Stallman committed
1024 1025
  addr.sin_family = AF_INET;

1026
  /** "kpop" service is  never used: look for 20060515 to see why **/
Richard M. Stallman's avatar
Richard M. Stallman committed
1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052
#ifdef KERBEROS
  service = (flags & POP_NO_KERBEROS) ? POP_SERVICE : KPOP_SERVICE;
#else
  service = POP_SERVICE;
#endif

#ifdef HESIOD
  if (! (flags & POP_NO_HESIOD))
    {
      servent = hes_getservbyname (service, "tcp");
      if (servent)
	{
	  addr.sin_port = servent->s_port;
	  found_port = 1;
	}
    }
#endif
  if (! found_port)
    {
      servent = getservbyname (service, "tcp");
      if (servent)
	{
	  addr.sin_port = servent->s_port;
	}
      else
	{
1053
  /** "kpop" service is  never used: look for 20060515 to see why **/
Richard M. Stallman's avatar
Richard M. Stallman committed
1054 1055 1056 1057 1058 1059 1060 1061 1062
#ifdef KERBEROS
	  addr.sin_port = htons ((flags & POP_NO_KERBEROS) ?
				POP_PORT : KPOP_PORT);
#else
	  addr.sin_port = htons (POP_PORT);
#endif
	}
    }

1063
#define POP_SOCKET_ERROR "Could not create socket for POP connection: "
Richard M. Stallman's avatar
Richard M. Stallman committed
1064 1065 1066 1067

  sock = socket (PF_INET, SOCK_STREAM, 0);
  if (sock < 0)
    {
1068
      strcpy (pop_error, POP_SOCKET_ERROR);
Richard M. Stallman's avatar
Richard M. Stallman committed
1069
      strncat (pop_error, strerror (errno),
1070
	       ERROR_MAX - sizeof (POP_SOCKET_ERROR));
Richard M. Stallman's avatar
Richard M. Stallman committed
1071
      return (-1);
Pavel Janík's avatar
Pavel Janík committed
1072

Richard M. Stallman's avatar
Richard M. Stallman committed
1073 1074
    }

1075 1076 1077
#ifdef HAVE_GETADDRINFO
  memset (&hints, 0, sizeof(hints));
  hints.ai_socktype = SOCK_STREAM;
1078
  hints.ai_flags = AI_CANONNAME;
1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098
  hints.ai_family = AF_INET;
  do
    {
      ret = getaddrinfo (host, service, &hints, &res);
      try_count++;
      if (ret != 0 && (ret != EAI_AGAIN || try_count == 5))
	{
	  strcpy (pop_error, "Could not determine POP server's address");
	  return (-1);
	}
    } while (ret != 0);

  if (ret == 0)
    {
      it = res;
      while (it)
        {
          if (it->ai_addrlen == sizeof (addr))
            {
              struct sockaddr_in *in_a = (struct sockaddr_in *) it->ai_addr;
1099
              memcpy (&addr.sin_addr, &in_a->sin_addr, sizeof (addr.sin_addr));
1100 1101 1102 1103 1104 1105
              if (! connect (sock, (struct sockaddr *) &addr, sizeof (addr)))
                break;
            }
          it = it->ai_next;
        }
      connect_ok = it != NULL;
1106 1107 1108 1109 1110
      if (connect_ok)
        {
          realhost = alloca (strlen (it->ai_canonname) + 1);
          strcpy (realhost, it->ai_canonname);
        }
1111 1112 1113
      freeaddrinfo (res);
    }
#else /* !HAVE_GETADDRINFO */
1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124
  do
    {
      hostent = gethostbyname (host);
      try_count++;
      if ((! hostent) && ((h_errno != TRY_AGAIN) || (try_count == 5)))
	{
	  strcpy (pop_error, "Could not determine POP server's address");
	  return (-1);
	}
    } while (! hostent);

Richard M. Stallman's avatar
Richard M. Stallman committed
1125 1126
  while (*hostent->h_addr_list)
    {
1127
      memcpy (&addr.sin_addr, *hostent->h_addr_list, hostent->h_length);
Richard M. Stallman's avatar
Richard M. Stallman committed
1128 1129 1130 1131
      if (! connect (sock, (struct sockaddr *) &addr, sizeof (addr)))
	break;
      hostent->h_addr_list++;
    }
1132
  connect_ok = *hostent->h_addr_list != NULL;
1133 1134 1135 1136 1137 1138
  if (! connect_ok)
    {
      realhost = alloca (strlen (hostent->h_name) + 1);
      strcpy (realhost, hostent->h_name);
    }

1139
#endif /* !HAVE_GETADDRINFO */
Richard M. Stallman's avatar
Richard M. Stallman committed
1140 1141

#define CONNECT_ERROR "Could not connect to POP server: "
Pavel Janík's avatar
Pavel Janík committed
1142

1143
  if (! connect_ok)
Richard M. Stallman's avatar
Richard M. Stallman committed
1144
    {
1145
      CLOSESOCKET (sock);
Richard M. Stallman's avatar
Richard M. Stallman committed
1146 1147 1148 1149
      strcpy (pop_error, CONNECT_ERROR);
      strncat (pop_error, strerror (errno),
	       ERROR_MAX - sizeof (CONNECT_ERROR));
      return (-1);
Pavel Janík's avatar
Pavel Janík committed
1150

Richard M. Stallman's avatar
Richard M. Stallman committed
1151 1152 1153
    }

#ifdef KERBEROS
1154

Richard M. Stallman's avatar
Richard M. Stallman committed
1155 1156 1157
#define KRB_ERROR "Kerberos error connecting to POP server: "
  if (! (flags & POP_NO_KERBEROS))
    {
1158 1159
#ifdef KERBEROS5
      if ((rem = krb5_init_context (&kcontext)))
Richard M. Stallman's avatar
Richard M. Stallman committed
1160 1161
	{
	krb5error:
1162 1163 1164 1165
	  if (auth_context)
	    krb5_auth_con_free (kcontext, auth_context);
	  if (kcontext)
	    krb5_free_context (kcontext);
Richard M. Stallman's avatar
Richard M. Stallman committed
1166 1167 1168
	  strcpy (pop_error, KRB_ERROR);
	  strncat (pop_error, error_message (rem),
		   ERROR_MAX - sizeof(KRB_ERROR));
1169
	  CLOSESOCKET (sock);
Richard M. Stallman's avatar
Richard M. Stallman committed
1170 1171 1172
	  return (-1);
	}

1173 1174
      if ((rem = krb5_auth_con_init (kcontext, &auth_context)))
	goto krb5error;
Pavel Janík's avatar
Pavel Janík committed
1175

1176 1177 1178 1179 1180
      if (rem = krb5_cc_default (kcontext, &ccdef))
	goto krb5error;

      if (rem = krb5_cc_get_principal (kcontext, ccdef, &client))
	goto krb5error;
Richard M. Stallman's avatar
Richard M. Stallman committed
1181

1182
      for (cp = realhost; *cp; cp++)
Richard M. Stallman's avatar
Richard M. Stallman committed
1183 1184 1185 1186 1187 1188 1189
	{
	  if (isupper (*cp))
	    {
	      *cp = tolower (*cp);
	    }
	}

1190
      if (rem = krb5_sname_to_principal (kcontext, realhost,
1191 1192
					 POP_SERVICE, FALSE, &server))
	goto krb5error;
Richard M. Stallman's avatar
Richard M. Stallman committed
1193

1194 1195
      rem = krb5_sendauth (kcontext, &auth_context,
			   (krb5_pointer) &sock, "KPOPV1.0", client, server,
Richard M. Stallman's avatar
Richard M. Stallman committed
1196 1197 1198 1199 1200
			  AP_OPTS_MUTUAL_REQUIRED,
			  0,	/* no checksum */
			  0,	/* no creds, use ccache instead */
			  ccdef,
			  &err_ret,
1201
			  0,	/* don't need subsession key */
Richard M. Stallman's avatar
Richard M. Stallman committed
1202
			  0);	/* don't need reply */
1203
      krb5_free_principal (kcontext, server);
Richard M. Stallman's avatar
Richard M. Stallman committed
1204 1205
      if (rem)
	{
1206 1207 1208 1209
	  strcpy (pop_error, KRB_ERROR);
	  strncat (pop_error, error_message (rem),
		   ERROR_MAX - sizeof (KRB_ERROR));
#if defined HAVE_KRB5_ERROR_TEXT
Richard M. Stallman's avatar
Richard M. Stallman committed
1210 1211 1212 1213 1214 1215 1216 1217 1218 1219
	  if (err_ret && err_ret->text.length)
	    {
	      strncat (pop_error, " [server says '",
		       ERROR_MAX - strlen (pop_error) - 1);
	      strncat (pop_error, err_ret->text.data,
		       min (ERROR_MAX - strlen (pop_error) - 1,
			    err_ret->text.length));
	      strncat (pop_error, "']",
		       ERROR_MAX - strlen (pop_error) - 1);
	    }
1220 1221
#elif defined HAVE_KRB5_ERROR_E_TEXT
	  if (err_ret && err_ret->e_text && strlen(*err_ret->e_text))
Richard M. Stallman's avatar
Richard M. Stallman committed
1222
	    {
1223 1224 1225 1226 1227 1228
	      strncat (pop_error, " [server says '",
		       ERROR_MAX - strlen (pop_error) - 1);
	      strncat (pop_error, *err_ret->e_text,
		       ERROR_MAX - strlen (pop_error) - 1);
	      strncat (pop_error, "']",
		       ERROR_MAX - strlen (pop_error) - 1);
Richard M. Stallman's avatar
Richard M. Stallman committed
1229
	    }
1230
#endif
Richard M. Stallman's avatar
Richard M. Stallman committed
1231
	  if (err_ret)
1232 1233 1234
	    krb5_free_error (kcontext, err_ret);
	  krb5_auth_con_free (kcontext, auth_context);
	  krb5_free_context (kcontext);
Richard M. Stallman's avatar
Richard M. Stallman committed
1235

1236
	  CLOSESOCKET (sock);
Richard M. Stallman's avatar
Richard M. Stallman committed
1237 1238
	  return (-1);
	}
Pavel Janík's avatar
Pavel Janík committed
1239
#else  /* ! KERBEROS5 */
Richard M. Stallman's avatar
Richard M. Stallman committed
1240
      ticket = (KTEXT) malloc (sizeof (KTEXT_ST));
1241 1242
      rem = krb_sendauth (0L, sock, ticket, "pop", realhost,
			  (char *) krb_realmofhost (realhost),
Richard M. Stallman's avatar
Richard M. Stallman committed
1243 1244 1245 1246 1247 1248 1249 1250 1251 1252
			  (unsigned long) 0, &msg_data, &cred, schedule,
			  (struct sockaddr_in *) 0,
			  (struct sockaddr_in *) 0,
			  "KPOPV0.1");
      free ((char *) ticket);
      if (rem != KSUCCESS)
	{
	  strcpy (pop_error, KRB_ERROR);
	  strncat (pop_error, krb_err_txt[rem],
		   ERROR_MAX - sizeof (KRB_ERROR));
1253
	  CLOSESOCKET (sock);
Richard M. Stallman's avatar
Richard M. Stallman committed
1254 1255
	  return (-1);
	}
1256
#endif /* KERBEROS5 */
Richard M. Stallman's avatar
Richard M. Stallman committed
1257 1258 1259 1260 1261 1262 1263
    }
#endif /* KERBEROS */

  return (sock);
} /* socket_connection */

/*
1264
 * Function: pop_getline
Richard M. Stallman's avatar
Richard M. Stallman committed
1265 1266 1267 1268 1269 1270 1271 1272 1273
 *
 * Purpose: Get a line of text from the connection and return a
 * 	pointer to it.  The carriage return and linefeed at the end of
 * 	the line are stripped, but periods at the beginnings of lines
 * 	are NOT dealt with in any special way.
 *
 * Arguments:
 * 	server	The server from which to get the line of text.
 *
1274 1275 1276 1277 1278
 * Returns: The number of characters in the line, which is returned in
 * 	LINE, not including the final null.  A return value of 0
 * 	indicates a blank line.  A negative return value indicates an
 * 	error (in which case the contents of LINE are undefined.  In
 * 	case of error, an error message is copied into pop_error.
Richard M. Stallman's avatar
Richard M. Stallman committed
1279
 *
1280
 * Notes: The line returned is overwritten with each call to pop_getline.
Richard M. Stallman's avatar
Richard M. Stallman committed
1281 1282
 *
 * Side effects: Closes the connection on error.
1283 1284
 *
 * THE RETURNED LINE MAY CONTAIN EMBEDDED NULLS!
Richard M. Stallman's avatar
Richard M. Stallman committed
1285
 */
1286
static int
1287
pop_getline (popserver server, char **line)
Richard M. Stallman's avatar
Richard M. Stallman committed
1288 1289 1290 1291
{
#define GETLINE_ERROR "Error reading from server: "

  int ret;
1292 1293
  int search_offset = 0;

Richard M. Stallman's avatar
Richard M. Stallman committed
1294 1295
  if (server->data)
    {
1296 1297
      char *cp = find_crlf (server->buffer + server->buffer_index,
			    server->data);
Richard M. Stallman's avatar
Richard M. Stallman committed
1298 1299 1300 1301 1302 1303 1304
      if (cp)
	{
	  int found;
	  int data_used;

	  found = server->buffer_index;
	  data_used = (cp + 2) - server->buffer - found;
Pavel Janík's avatar
Pavel Janík committed
1305

Richard M. Stallman's avatar
Richard M. Stallman committed
1306 1307 1308 1309 1310
	  *cp = '\0';		/* terminate the string to be returned */
	  server->data -= data_used;
	  server->buffer_index += data_used;

	  if (pop_debug)
1311 1312
	    /* Embedded nulls will truncate this output prematurely,
	       but that's OK because it's just for debugging anyway. */
Richard M. Stallman's avatar
Richard M. Stallman committed
1313
	    fprintf (stderr, "<<< %s\n", server->buffer + found);
1314 1315
	  *line = server->buffer + found;
	  return (data_used - 2);
Richard M. Stallman's avatar
Richard M. Stallman committed
1316 1317 1318
	}
      else
	{
1319 1320
	  memmove (server->buffer, server->buffer + server->buffer_index,
		   server->data);
1321 1322 1323 1324 1325 1326 1327 1328
	  /* Record the fact that we've searched the data already in
             the buffer for a CRLF, so that when we search below, we
             don't have to search the same data twice.  There's a "-
             1" here to account for the fact that the last character
             of the data we have may be the CR of a CRLF pair, of
             which we haven't read the second half yet, so we may have
             to search it again when we read more data. */
	  search_offset = server->data - 1;
Richard M. Stallman's avatar
Richard M. Stallman committed
1329 1330 1331 1332 1333 1334 1335 1336 1337 1338
	  server->buffer_index = 0;
	}
    }
  else
    {
      server->buffer_index = 0;
    }

  while (1)
    {
Richard M. Stallman's avatar
Richard M. Stallman committed
1339 1340 1341 1342
      /* There's a "- 1" here to leave room for the null that we put
         at the end of the read data below.  We put the null there so
         that find_crlf knows where to stop when we call it. */
      if (server->data == server->buffer_size - 1)
Richard M. Stallman's avatar
Richard M. Stallman committed
1343
	{
Richard M. Stallman's avatar
Richard M. Stallman committed
1344 1345 1346
	  server->buffer_size += GETLINE_INCR;
	  server->buffer = (char *)realloc (server->buffer, server->buffer_size);
	  if (! server->buffer)
Richard M. Stallman's avatar
Richard M. Stallman committed
1347
	    {
Richard M. Stallman's avatar
Richard M. Stallman committed
1348 1349 1350
	      strcpy (pop_error, "Out of memory in pop_getline");
	      pop_trash (server);
	      return (-1);