NeoMutt
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
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 -.
 
static int fetch_auth (const char *line, void *data)
 Fetch list of the authentication mechanisms - Implements pop_fetch_t -.
 
static int check_uidl (const char *line, void *data)
 Find message with this UIDL and set refno - Implements pop_fetch_t -.
 
static int fetch_message (const char *line, void *data)
 Write line to file - Implements pop_fetch_t -.
 
static int fetch_uidl (const char *line, void *data)
 Parse UIDL - Implements pop_fetch_t -.
 

Detailed Description

Prototype for a function to handle POP server responses.

Parameters
strString to parse
dataPrivate data passed to pop_fetch_data()
Return values
0Success
-1Failure

Function Documentation

◆ fetch_capa()

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

Parse CAPA output - Implements pop_fetch_t -.

Parameters
lineList of capabilities
dataPOP data
Return values
0(always)

Definition at line 146 of file lib.c.

147{
148 struct PopAccountData *adata = data;
149
150 if (mutt_istr_startswith(line, "SASL"))
151 {
152 const char *c = mutt_str_skip_email_wsp(line + 4);
153 buf_strcpy(&adata->auth_list, c);
154 }
155 else if (mutt_istr_startswith(line, "STLS"))
156 {
157 adata->cmd_stls = true;
158 }
159 else if (mutt_istr_startswith(line, "USER"))
160 {
161 adata->cmd_user = 1;
162 }
163 else if (mutt_istr_startswith(line, "UIDL"))
164 {
165 adata->cmd_uidl = 1;
166 }
167 else if (mutt_istr_startswith(line, "TOP"))
168 {
169 adata->cmd_top = 1;
170 }
171
172 return 0;
173}
size_t buf_strcpy(struct Buffer *buf, const char *s)
Copy a string into a Buffer.
Definition: buffer.c:407
char * mutt_str_skip_email_wsp(const char *s)
Skip over whitespace as defined by RFC5322.
Definition: string.c:680
size_t mutt_istr_startswith(const char *str, const char *prefix)
Check whether a string starts with a prefix, ignoring case.
Definition: string.c:240
void * adata
Private data (for Mailbox backends)
Definition: account.h:43
POP-specific Account data -.
Definition: adata.h:37
+ 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
lineList of authentication methods
dataPOP data
Return values
0(always)

Definition at line 181 of file lib.c.

182{
183 struct PopAccountData *adata = data;
184
185 if (!buf_is_empty(&adata->auth_list))
186 {
187 buf_addstr(&adata->auth_list, " ");
188 }
189 buf_addstr(&adata->auth_list, line);
190
191 return 0;
192}
bool buf_is_empty(const struct Buffer *buf)
Is the Buffer empty?
Definition: buffer.c:303
size_t buf_addstr(struct Buffer *buf, const char *s)
Add a string to a Buffer.
Definition: buffer.c:238
+ 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
lineString containing UIDL
dataPOP data
Return values
0Success
-1Error

Definition at line 572 of file lib.c.

573{
574 if (!line || !data)
575 return -1;
576
577 char *endp = NULL;
578
579 errno = 0;
580 unsigned int index = strtoul(line, &endp, 10);
581 if (errno != 0)
582 return -1;
583 while (*endp == ' ')
584 endp++;
585
586 struct Mailbox *m = data;
587 for (int i = 0; i < m->msg_count; i++)
588 {
589 struct PopEmailData *edata = pop_edata_get(m->emails[i]);
590 if (mutt_str_equal(edata->uid, endp))
591 {
592 edata->refno = index;
593 break;
594 }
595 }
596
597 return 0;
598}
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition: string.c:798
struct PopEmailData * pop_edata_get(struct Email *e)
Get the private data for this Email.
Definition: edata.c:68
void * edata
Driver-specific data.
Definition: email.h:72
int index
The absolute (unsorted) message number.
Definition: email.h:109
A mailbox.
Definition: mailbox.h:79
int msg_count
Total number of messages.
Definition: mailbox.h:88
struct Email ** emails
Array of Emails.
Definition: mailbox.h:96
POP-specific Email data -.
Definition: edata.h:32
+ 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
lineString to write
dataFILE pointer to write to
Return values
0Success
-1Failure

Definition at line 97 of file pop.c.

98{
99 FILE *fp = data;
100
101 fputs(line, fp);
102 if (fputc('\n', fp) == EOF)
103 return -1;
104
105 return 0;
106}
+ 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
lineString to parse
dataMailbox
Return values
0Success
-1Failure

Definition at line 200 of file pop.c.

201{
202 struct Mailbox *m = data;
204 char *endp = NULL;
205
206 errno = 0;
207 int index = strtol(line, &endp, 10);
208 if (errno)
209 return -1;
210 while (*endp == ' ')
211 endp++;
212 line = endp;
213
214 /* uid must be at least be 1 byte */
215 if (strlen(line) == 0)
216 return -1;
217
218 int i;
219 for (i = 0; i < m->msg_count; i++)
220 {
221 struct PopEmailData *edata = pop_edata_get(m->emails[i]);
222 if (mutt_str_equal(line, edata->uid))
223 break;
224 }
225
226 if (i == m->msg_count)
227 {
228 mutt_debug(LL_DEBUG1, "new header %d %s\n", index, line);
229
230 mx_alloc_memory(m, i);
231
232 m->msg_count++;
233 m->emails[i] = email_new();
234
235 m->emails[i]->edata = pop_edata_new(line);
237 }
238 else if (m->emails[i]->index != index - 1)
239 {
240 adata->clear_cache = true;
241 }
242
243 m->emails[i]->index = index - 1;
244
245 struct PopEmailData *edata = pop_edata_get(m->emails[i]);
246 edata->refno = index;
247
248 return 0;
249}
struct Email * email_new(void)
Create a new Email.
Definition: email.c:78
#define mutt_debug(LEVEL,...)
Definition: logging2.h:89
@ LL_DEBUG1
Log at debug level 1.
Definition: logging2.h:43
void mx_alloc_memory(struct Mailbox *m, int req_size)
Create storage for the emails.
Definition: mx.c:1232
struct PopAccountData * pop_adata_get(struct Mailbox *m)
Get the Account data for this mailbox.
Definition: adata.c:73
struct PopEmailData * pop_edata_new(const char *uid)
Create a new PopEmailData for an email.
Definition: edata.c:56
void pop_edata_free(void **ptr)
Free the private Email data - Implements Email::edata_free()
Definition: edata.c:41
void(* edata_free)(void **ptr)
Free the private data attached to the Email.
Definition: email.h:86
bool clear_cache
Definition: adata.h:49
+ Here is the call graph for this function:
+ Here is the caller graph for this function: