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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
/**
* @file expressions.h
* Rspamd expressions API
*/
#ifndef RSPAMD_EXPRESSIONS_H
#define RSPAMD_EXPRESSIONS_H
#include "config.h"
#include <lua.h>
struct worker_task;
struct rspamd_regexp;
/**
* Rspamd expression function
*/
struct expression_function {
gchar *name; /**< name of function */
GList *args; /**< its args */
};
/**
* Function's argument
*/
struct expression_argument {
enum {
EXPRESSION_ARGUMENT_NORMAL,
EXPRESSION_ARGUMENT_BOOL,
EXPRESSION_ARGUMENT_EXPR,
} type; /**< type of argument (text or other function) */
void *data; /**< pointer to its data */
};
/**
* Logic expression
*/
struct expression {
enum {
EXPR_REGEXP,
EXPR_OPERATION,
EXPR_FUNCTION,
EXPR_STR,
EXPR_REGEXP_PARSED,
} type; /**< expression type */
union {
void *operand;
gchar operation;
} content; /**< union for storing operand or operation code */
const gchar *orig; /**< original line */
struct expression *next; /**< chain link */
};
typedef gboolean (*rspamd_internal_func_t)(struct worker_task *, GList *args, void *user_data);
/**
* Parse regexp line to regexp structure
* @param pool memory pool to use
* @param line incoming line
* @return regexp structure or NULL in case of error
*/
struct rspamd_regexp* parse_regexp (memory_pool_t *pool, const gchar *line, gboolean raw_mode);
/**
* Parse composites line to composites structure (eg. "SYMBOL1&SYMBOL2|!SYMBOL3")
* @param pool memory pool to use
* @param line incoming line
* @return expression structure or NULL in case of error
*/
struct expression* parse_expression (memory_pool_t *pool, gchar *line);
/**
* Call specified fucntion and return boolean result
* @param func function to call
* @param task task object
* @param L lua specific state
* @return TRUE or FALSE depending on function result
*/
gboolean call_expression_function (struct expression_function *func, struct worker_task *task, lua_State *L);
/**
* Register specified function to rspamd internal functions list
* @param name name of function
* @param func pointer to function
*/
void register_expression_function (const gchar *name, rspamd_internal_func_t func, void *user_data);
/**
* Add regexp to regexp cache
* @param line symbolic representation
* @param pointer regexp data
*/
void re_cache_add (const gchar *line, void *pointer, memory_pool_t *pool);
/**
* Check regexp in cache
* @param line symbolic representation
* @return pointer to regexp data or NULL if regexp is not found
*/
void * re_cache_check (const gchar *line, memory_pool_t *pool);
/**
* Remove regexp from regexp cache
* @param line symbolic representation
*/
void re_cache_del (const gchar *line, memory_pool_t *pool);
/**
* Add regexp to regexp task cache
* @param task task object
* @param pointer regexp data
* @param result numeric result of this regexp
*/
void task_cache_add (struct worker_task *task, struct rspamd_regexp *re, gint32 result);
/**
* Check regexp in cache
* @param task task object
* @param pointer regexp data
* @return numeric result if value exists or -1 if not
*/
gint32 task_cache_check (struct worker_task *task, struct rspamd_regexp *re);
/**
* Parse and return a single function argument for a function (may recurse)
* @param expr expression structure that represents function's argument
* @param task task object
* @param want_string return NULL if argument is not a string
* @return expression argument structure or NULL if failed
*/
struct expression_argument *get_function_arg (struct expression *expr, struct worker_task *task, gboolean want_string);
#endif
|
