POP Response Parser API

Prototype for a function to handle POP server responses. More...

Functions
static int	fetch_capa (const char *line, void *data)
	Parse CAPA output - Implements pop_fetch_t -. More...
static int	fetch_auth (const char *line, void *data)
	Fetch list of the authentication mechanisms - Implements pop_fetch_t -. More...
static int	check_uidl (const char *line, void *data)
	Find message with this UIDL and set refno - Implements pop_fetch_t -. More...
static int	fetch_message (const char *line, void *data)
	Write line to file - Implements pop_fetch_t -. More...
static int	fetch_uidl (const char *line, void *data)
	Parse UIDL - Implements pop_fetch_t -. More...

Detailed Description

Prototype for a function to handle POP server responses.

Parameters

str	String to parse
data	Private data passed to pop_fetch_data()

Return values

0	Success
-1	Failure

Function Documentation

fetch_capa()

static int fetch_capa ( const char *  line, void *  data  )

static

Parse CAPA output - Implements pop_fetch_t -.

Parameters

line	List of capabilities
data	POP data

Return values

0

(always)

Definition at line 146 of file lib.c.

{
  struct PopAccountData *adata = data;
 
  if (mutt_istr_startswith(line, "SASL"))
  {
    const char *c = mutt_str_skip_email_wsp(line + 4);
    mutt_buffer_strcpy(&adata->auth_list, c);
  }
  else if (mutt_istr_startswith(line, "STLS"))
    adata->cmd_stls = true;
  else if (mutt_istr_startswith(line, "USER"))
    adata->cmd_user = 1;
  else if (mutt_istr_startswith(line, "UIDL"))
    adata->cmd_uidl = 1;
  else if (mutt_istr_startswith(line, "TOP"))
    adata->cmd_top = 1;
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

fetch_auth()

static int fetch_auth ( const char *  line, void *  data  )

static

Fetch list of the authentication mechanisms - Implements pop_fetch_t -.

Parameters

line	List of authentication methods
data	POP data

Return values

0

(always)

Definition at line 173 of file lib.c.

{
  struct PopAccountData *adata = data;
 
  if (!mutt_buffer_is_empty(&adata->auth_list))
  {
    mutt_buffer_addstr(&adata->auth_list, " ");
  }
  mutt_buffer_addstr(&adata->auth_list, line);
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

check_uidl()

static int check_uidl ( const char *  line, void *  data  )

static

Find message with this UIDL and set refno - Implements pop_fetch_t -.

Parameters

line	String containing UIDL
data	POP data

Return values

0	Success
-1	Error

Definition at line 565 of file lib.c.

{
  if (!line || !data)
    return -1;
 
  char *endp = NULL;
 
  errno = 0;
  unsigned int index = strtoul(line, &endp, 10);
  if (errno != 0)
    return -1;
  while (*endp == ' ')
    endp++;
 
  struct Mailbox *m = data;
  for (int i = 0; i < m->msg_count; i++)
  {
    struct PopEmailData *edata = pop_edata_get(m->emails[i]);
    if (mutt_str_equal(edata->uid, endp))
    {
      edata->refno = index;
      break;
    }
  }
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

fetch_message()

static int fetch_message ( const char *  line, void *  data  )

static

Write line to file - Implements pop_fetch_t -.

Parameters

line	String to write
data	FILE pointer to write to

Return values

0	Success
-1	Failure

Definition at line 98 of file pop.c.

{
  FILE *fp = data;
 
  fputs(line, fp);
  if (fputc('\n', fp) == EOF)
    return -1;
 
  return 0;
}

Here is the caller graph for this function:

fetch_uidl()

static int fetch_uidl ( const char *  line, void *  data  )

static

Parse UIDL - Implements pop_fetch_t -.

Parameters

line	String to parse
data	Mailbox

Return values

0	Success
-1	Failure

Definition at line 200 of file pop.c.

{
  struct Mailbox *m = data;
  struct PopAccountData *adata = pop_adata_get(m);
  char *endp = NULL;
 
  errno = 0;
  int index = strtol(line, &endp, 10);
  if (errno)
    return -1;
  while (*endp == ' ')
    endp++;
  line = endp;
 
  /* uid must be at least be 1 byte */
  if (strlen(line) == 0)
    return -1;
 
  int i;
  for (i = 0; i < m->msg_count; i++)
  {
    struct PopEmailData *edata = pop_edata_get(m->emails[i]);
    if (mutt_str_equal(line, edata->uid))
      break;
  }
 
  if (i == m->msg_count)
  {
    mutt_debug(LL_DEBUG1, "new header %d %s\n", index, line);
 
    if (i >= m->email_max)
      mx_alloc_memory(m);
 
    m->msg_count++;
    m->emails[i] = email_new();
 
    m->emails[i]->edata = pop_edata_new(line);
    m->emails[i]->edata_free = pop_edata_free;
  }
  else if (m->emails[i]->index != index - 1)
    adata->clear_cache = true;
 
  m->emails[i]->index = index - 1;
 
  struct PopEmailData *edata = pop_edata_get(m->emails[i]);
  edata->refno = index;
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function: