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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
#ifndef MANAGESIEVE_ARG_H
#define MANAGESIEVE_ARG_H
#include "array.h"
/*
* QUOTED-SPECIALS = <"> / "\"
*/
#define IS_QUOTED_SPECIAL(c) \
((c) == '"' || (c) == '\\')
/*
* ATOM-SPECIALS = "(" / ")" / "{" / SP / CTL / QUOTED-SPECIALS
*/
#define IS_ATOM_SPECIAL(c) \
((c) == '(' || (c) == ')' || (c) == '{' || \
(c) <= 32 || (c) == 0x7f || \
IS_QUOTED_SPECIAL(c))
/*
* CHAR = %x01-7F
*/
#define IS_CHAR(c) \
(((c) & 0x80) == 0)
/*
* TEXT-CHAR = %x01-09 / %x0B-0C / %x0E-7F
* ;; any CHAR except CR and LF
*/
#define IS_TEXT_CHAR(c) \
(IS_CHAR(c) && (c) != '\r' && (c) != '\n')
/*
* SAFE-CHAR = %x01-09 / %x0B-0C / %x0E-21 /
* %x23-5B / %x5D-7F
* ;; any TEXT-CHAR except QUOTED-SPECIALS
*/
#define IS_SAFE_CHAR(c) \
(IS_TEXT_CHAR(c) && !IS_QUOTED_SPECIAL(c))
enum managesieve_arg_type {
MANAGESIEVE_ARG_NONE = 0,
MANAGESIEVE_ARG_ATOM,
MANAGESIEVE_ARG_STRING,
MANAGESIEVE_ARG_STRING_STREAM,
MANAGESIEVE_ARG_LIST,
/* literals are returned as MANAGESIEVE_ARG_STRING by default */
MANAGESIEVE_ARG_LITERAL,
MANAGESIEVE_ARG_EOL /* end of argument list */
};
ARRAY_DEFINE_TYPE(managesieve_arg_list, struct managesieve_arg);
struct managesieve_arg {
enum managesieve_arg_type type;
/* parent argument; always of type MANAGESIEVE_ARG_LIST */
struct managesieve_arg *parent;
/* Set when _data.str is set */
size_t str_len;
union {
const char *str;
struct istream *str_stream;
ARRAY_TYPE(managesieve_arg_list) list;
} _data;
};
#define MANAGESIEVE_ARG_IS_EOL(arg) \
((arg)->type == MANAGESIEVE_ARG_EOL)
bool managesieve_arg_get_atom(const struct managesieve_arg *arg,
const char **str_r) ATTR_WARN_UNUSED_RESULT;
bool managesieve_arg_get_number(const struct managesieve_arg *arg,
uoff_t *number_r) ATTR_WARN_UNUSED_RESULT;
bool managesieve_arg_get_quoted(const struct managesieve_arg *arg,
const char **str_r) ATTR_WARN_UNUSED_RESULT;
bool managesieve_arg_get_string(const struct managesieve_arg *arg,
const char **str_r) ATTR_WARN_UNUSED_RESULT;
bool managesieve_arg_get_string_stream(const struct managesieve_arg *arg,
struct istream **stream_r)
ATTR_WARN_UNUSED_RESULT;
bool managesieve_arg_get_list(const struct managesieve_arg *arg,
const struct managesieve_arg **list_r)
ATTR_WARN_UNUSED_RESULT;
bool managesieve_arg_get_list_full(const struct managesieve_arg *arg,
const struct managesieve_arg **list_r,
unsigned int *list_count_r)
ATTR_WARN_UNUSED_RESULT;
/* Similar to above, but assumes that arg is already of correct type. */
const char *managesieve_arg_as_atom(const struct managesieve_arg *arg);
const char *managesieve_arg_as_string(const struct managesieve_arg *arg);
struct istream *
managesieve_arg_as_string_stream(const struct managesieve_arg *arg);
const struct managesieve_arg *
managesieve_arg_as_list(const struct managesieve_arg *arg);
/* Returns TRUE if arg is atom and case-insensitively matches str */
bool managesieve_arg_atom_equals(const struct managesieve_arg *arg,
const char *str);
/* Write ManageSieve arg to the given string. Because
MANAGESIVE_ARG_LITERAL_SIZE* have no content, they're written as
"{size}\r\n<too large>". */
void managesieve_write_arg(string_t *dest, const struct managesieve_arg *arg);
/* Same as managesieve_write_arg(), but write all the args until EOL. */
void managesieve_write_args(string_t *dest, const struct managesieve_arg *args);
/* Like managesieve_write_args(), but return the string allocated from data
stack. */
const char *managesieve_args_to_str(const struct managesieve_arg *args);
#endif
|
