| 1 | /* pop.h: Header file for the "pop.c" client POP3 protocol. |
| 2 | Copyright (C) 1991, 1993, 2001-2012 Free Software Foundation, Inc. |
| 3 | |
| 4 | Author: Jonathan Kamens <jik@security.ov.com> |
| 5 | |
| 6 | This file is part of GNU Emacs. |
| 7 | |
| 8 | GNU Emacs is free software: you can redistribute it and/or modify |
| 9 | it under the terms of the GNU General Public License as published by |
| 10 | the Free Software Foundation, either version 3 of the License, or |
| 11 | (at your option) any later version. |
| 12 | |
| 13 | GNU Emacs is distributed in the hope that it will be useful, |
| 14 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 16 | GNU General Public License for more details. |
| 17 | |
| 18 | You should have received a copy of the GNU General Public License |
| 19 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */ |
| 20 | |
| 21 | |
| 22 | #include <stdio.h> |
| 23 | |
| 24 | #define GETLINE_MIN 1024 /* the getline buffer starts out this */ |
| 25 | /* size */ |
| 26 | #define GETLINE_INCR 1024 /* the getline buffer is grown by this */ |
| 27 | /* size when it needs to grow */ |
| 28 | |
| 29 | extern char pop_error[]; |
| 30 | extern int pop_debug; |
| 31 | |
| 32 | struct _popserver |
| 33 | { |
| 34 | int file, data; |
| 35 | char *buffer; |
| 36 | int buffer_size, buffer_index; |
| 37 | int in_multi; |
| 38 | int trash_started; |
| 39 | }; |
| 40 | |
| 41 | typedef struct _popserver *popserver; |
| 42 | |
| 43 | /* |
| 44 | * Valid flags for the pop_open function. |
| 45 | */ |
| 46 | |
| 47 | #define POP_NO_KERBEROS (1<<0) |
| 48 | #define POP_NO_HESIOD (1<<1) |
| 49 | #define POP_NO_GETPASS (1<<2) |
| 50 | |
| 51 | extern popserver pop_open (char *host, char *username, char *password, |
| 52 | int flags); |
| 53 | extern int pop_stat (popserver server, int *count, int *size); |
| 54 | extern int pop_list (popserver server, int message, int **IDs, |
| 55 | int **size); |
| 56 | extern int pop_retrieve (popserver server, int message, int markfrom, |
| 57 | char **); |
| 58 | extern int pop_retrieve_first (popserver server, int message, |
| 59 | char **response); |
| 60 | extern int pop_retrieve_next (popserver server, char **line); |
| 61 | extern int pop_retrieve_flush (popserver server); |
| 62 | extern int pop_top_first (popserver server, int message, int lines, |
| 63 | char **response); |
| 64 | extern int pop_top_next (popserver server, char **line); |
| 65 | extern int pop_top_flush (popserver server); |
| 66 | extern int pop_multi_first (popserver server, const char *command, |
| 67 | char **response); |
| 68 | extern int pop_multi_next (popserver server, char **line); |
| 69 | extern int pop_multi_flush (popserver server); |
| 70 | extern int pop_delete (popserver server, int message); |
| 71 | extern int pop_noop (popserver server); |
| 72 | extern int pop_last (popserver server); |
| 73 | extern int pop_reset (popserver server); |
| 74 | extern int pop_quit (popserver server); |
| 75 | extern void pop_close (popserver); |
| 76 | |