1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
#ifndef POP3C_CLIENT_H
#define POP3C_CLIENT_H
#include "net.h"
#include "pop3c-settings.h"
#include "iostream-ssl.h"
enum pop3c_capability {
POP3C_CAPABILITY_PIPELINING = 0x01,
POP3C_CAPABILITY_TOP = 0x02,
POP3C_CAPABILITY_UIDL = 0x04
};
enum pop3c_command_state {
POP3C_COMMAND_STATE_OK,
POP3C_COMMAND_STATE_ERR,
POP3C_COMMAND_STATE_DISCONNECTED
};
enum pop3c_client_ssl_mode {
POP3C_CLIENT_SSL_MODE_NONE,
POP3C_CLIENT_SSL_MODE_IMMEDIATE,
POP3C_CLIENT_SSL_MODE_STARTTLS
};
struct pop3c_client_settings {
const char *host;
in_port_t port;
const char *master_user;
const char *username;
const char *password;
const char *dns_client_socket_path;
const char *temp_path_prefix;
enum pop3c_client_ssl_mode ssl_mode;
enum pop3c_features parsed_features;
struct ssl_iostream_settings ssl_set;
const char *rawlog_dir;
const char *ssl_crypto_device;
bool debug;
};
typedef void pop3c_login_callback_t(enum pop3c_command_state state,
const char *reply, void *context);
typedef void pop3c_cmd_callback_t(enum pop3c_command_state state,
const char *reply, void *context);
struct pop3c_client *
pop3c_client_init(const struct pop3c_client_settings *set,
struct event *event_parent);
void pop3c_client_deinit(struct pop3c_client **client);
void pop3c_client_login(struct pop3c_client *client,
pop3c_login_callback_t *callback, void *context);
bool pop3c_client_is_connected(struct pop3c_client *client);
enum pop3c_capability
pop3c_client_get_capabilities(struct pop3c_client *client);
/* Returns 0 if received +OK reply, reply contains the text without the +OK.
Returns -1 if received -ERR reply or disconnected. */
int pop3c_client_cmd_line(struct pop3c_client *client, const char *cmdline,
const char **reply_r);
/* Start the command asynchronously. Call the callback when finished. */
struct pop3c_client_cmd *
pop3c_client_cmd_line_async(struct pop3c_client *client, const char *cmdline,
pop3c_cmd_callback_t *callback, void *context);
/* Send a command, don't care if it succeeds or not. */
void pop3c_client_cmd_line_async_nocb(struct pop3c_client *client,
const char *cmdline);
/* Returns 0 and stream if succeeded, -1 and error if received -ERR reply or
disconnected. */
int pop3c_client_cmd_stream(struct pop3c_client *client, const char *cmdline,
struct istream **input_r, const char **error_r);
/* Start the command asynchronously. Call the callback when finished. */
struct istream *
pop3c_client_cmd_stream_async(struct pop3c_client *client, const char *cmdline,
pop3c_cmd_callback_t *callback, void *context);
/* Wait for the next async command to finish. It's an error to call this when
there are no pending async commands. */
void pop3c_client_wait_one(struct pop3c_client *client);
#endif
|
