Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1 | /* |
| 2 | * "tcp" rules processing |
| 3 | * |
| 4 | * Copyright 2000-2016 Willy Tarreau <w@1wt.eu> |
| 5 | * |
| 6 | * This program is free software; you can redistribute it and/or |
| 7 | * modify it under the terms of the GNU General Public License |
| 8 | * as published by the Free Software Foundation; either version |
| 9 | * 2 of the License, or (at your option) any later version. |
| 10 | * |
| 11 | */ |
Willy Tarreau | dcc048a | 2020-06-04 19:11:43 +0200 | [diff] [blame] | 12 | #include <haproxy/acl.h> |
Willy Tarreau | 122eba9 | 2020-06-04 10:15:32 +0200 | [diff] [blame] | 13 | #include <haproxy/action.h> |
Willy Tarreau | 4c7e4b7 | 2020-05-27 12:58:42 +0200 | [diff] [blame] | 14 | #include <haproxy/api.h> |
Willy Tarreau | b255105 | 2020-06-09 09:07:15 +0200 | [diff] [blame] | 15 | #include <haproxy/arg-t.h> |
Willy Tarreau | 278161c | 2020-06-04 11:18:28 +0200 | [diff] [blame] | 16 | #include <haproxy/capture-t.h> |
Willy Tarreau | 6be7849 | 2020-06-05 00:00:29 +0200 | [diff] [blame] | 17 | #include <haproxy/cfgparse.h> |
Willy Tarreau | f1d32c4 | 2020-06-04 21:07:02 +0200 | [diff] [blame] | 18 | #include <haproxy/channel.h> |
Willy Tarreau | 7ea393d | 2020-06-04 18:02:10 +0200 | [diff] [blame] | 19 | #include <haproxy/connection.h> |
Willy Tarreau | f268ee8 | 2020-06-04 17:05:57 +0200 | [diff] [blame] | 20 | #include <haproxy/global.h> |
Willy Tarreau | 853b297 | 2020-05-27 18:01:47 +0200 | [diff] [blame] | 21 | #include <haproxy/list.h> |
Willy Tarreau | aeed4a8 | 2020-06-04 22:01:04 +0200 | [diff] [blame] | 22 | #include <haproxy/log.h> |
Willy Tarreau | a264d96 | 2020-06-04 22:29:18 +0200 | [diff] [blame] | 23 | #include <haproxy/proxy.h> |
Willy Tarreau | e6ce10b | 2020-06-04 15:33:47 +0200 | [diff] [blame] | 24 | #include <haproxy/sample.h> |
Willy Tarreau | dfd3de8 | 2020-06-04 23:46:14 +0200 | [diff] [blame] | 25 | #include <haproxy/stick_table.h> |
| 26 | #include <haproxy/stream-t.h> |
Willy Tarreau | 5e539c9 | 2020-06-04 20:45:39 +0200 | [diff] [blame] | 27 | #include <haproxy/stream_interface.h> |
Willy Tarreau | 8b550af | 2020-06-04 17:42:48 +0200 | [diff] [blame] | 28 | #include <haproxy/tcp_rules.h> |
Willy Tarreau | c2f7c58 | 2020-06-02 18:15:32 +0200 | [diff] [blame] | 29 | #include <haproxy/ticks.h> |
Willy Tarreau | 92b4f13 | 2020-06-01 11:05:15 +0200 | [diff] [blame] | 30 | #include <haproxy/time.h> |
Willy Tarreau | b255105 | 2020-06-09 09:07:15 +0200 | [diff] [blame] | 31 | #include <haproxy/tools.h> |
Willy Tarreau | dfd3de8 | 2020-06-04 23:46:14 +0200 | [diff] [blame] | 32 | #include <haproxy/trace.h> |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 33 | |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 34 | |
Christopher Faulet | eea8fc7 | 2019-11-05 16:18:10 +0100 | [diff] [blame] | 35 | #define TRACE_SOURCE &trace_strm |
| 36 | |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 37 | /* List head of all known action keywords for "tcp-request connection" */ |
| 38 | struct list tcp_req_conn_keywords = LIST_HEAD_INIT(tcp_req_conn_keywords); |
| 39 | struct list tcp_req_sess_keywords = LIST_HEAD_INIT(tcp_req_sess_keywords); |
| 40 | struct list tcp_req_cont_keywords = LIST_HEAD_INIT(tcp_req_cont_keywords); |
| 41 | struct list tcp_res_cont_keywords = LIST_HEAD_INIT(tcp_res_cont_keywords); |
| 42 | |
| 43 | /* |
| 44 | * Register keywords. |
| 45 | */ |
| 46 | void tcp_req_conn_keywords_register(struct action_kw_list *kw_list) |
| 47 | { |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 48 | LIST_APPEND(&tcp_req_conn_keywords, &kw_list->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 49 | } |
| 50 | |
| 51 | void tcp_req_sess_keywords_register(struct action_kw_list *kw_list) |
| 52 | { |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 53 | LIST_APPEND(&tcp_req_sess_keywords, &kw_list->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 54 | } |
| 55 | |
| 56 | void tcp_req_cont_keywords_register(struct action_kw_list *kw_list) |
| 57 | { |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 58 | LIST_APPEND(&tcp_req_cont_keywords, &kw_list->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 59 | } |
| 60 | |
| 61 | void tcp_res_cont_keywords_register(struct action_kw_list *kw_list) |
| 62 | { |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 63 | LIST_APPEND(&tcp_res_cont_keywords, &kw_list->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 64 | } |
| 65 | |
| 66 | /* |
| 67 | * Return the struct tcp_req_action_kw associated to a keyword. |
| 68 | */ |
Thierry Fournier | 7a71a6d | 2020-11-28 17:40:24 +0100 | [diff] [blame] | 69 | struct action_kw *tcp_req_conn_action(const char *kw) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 70 | { |
| 71 | return action_lookup(&tcp_req_conn_keywords, kw); |
| 72 | } |
| 73 | |
Thierry Fournier | 7a71a6d | 2020-11-28 17:40:24 +0100 | [diff] [blame] | 74 | struct action_kw *tcp_req_sess_action(const char *kw) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 75 | { |
| 76 | return action_lookup(&tcp_req_sess_keywords, kw); |
| 77 | } |
| 78 | |
Thierry Fournier | 7a71a6d | 2020-11-28 17:40:24 +0100 | [diff] [blame] | 79 | struct action_kw *tcp_req_cont_action(const char *kw) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 80 | { |
| 81 | return action_lookup(&tcp_req_cont_keywords, kw); |
| 82 | } |
| 83 | |
Thierry Fournier | 7a71a6d | 2020-11-28 17:40:24 +0100 | [diff] [blame] | 84 | struct action_kw *tcp_res_cont_action(const char *kw) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 85 | { |
| 86 | return action_lookup(&tcp_res_cont_keywords, kw); |
| 87 | } |
| 88 | |
| 89 | /* This function performs the TCP request analysis on the current request. It |
| 90 | * returns 1 if the processing can continue on next analysers, or zero if it |
| 91 | * needs more data, encounters an error, or wants to immediately abort the |
| 92 | * request. It relies on buffers flags, and updates s->req->analysers. The |
| 93 | * function may be called for frontend rules and backend rules. It only relies |
| 94 | * on the backend pointer so this works for both cases. |
| 95 | */ |
| 96 | int tcp_inspect_request(struct stream *s, struct channel *req, int an_bit) |
| 97 | { |
| 98 | struct session *sess = s->sess; |
| 99 | struct act_rule *rule; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 100 | int partial; |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 101 | int act_opts = 0; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 102 | |
Christopher Faulet | eea8fc7 | 2019-11-05 16:18:10 +0100 | [diff] [blame] | 103 | DBG_TRACE_ENTER(STRM_EV_STRM_ANA|STRM_EV_TCP_ANA, s); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 104 | |
| 105 | /* We don't know whether we have enough data, so must proceed |
| 106 | * this way : |
| 107 | * - iterate through all rules in their declaration order |
| 108 | * - if one rule returns MISS, it means the inspect delay is |
| 109 | * not over yet, then return immediately, otherwise consider |
| 110 | * it as a non-match. |
| 111 | * - if one rule returns OK, then return OK |
| 112 | * - if one rule returns KO, then return KO |
| 113 | */ |
| 114 | |
Willy Tarreau | 2375233 | 2018-06-15 14:54:53 +0200 | [diff] [blame] | 115 | if ((req->flags & CF_SHUTR) || channel_full(req, global.tune.maxrewrite) || |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 116 | !s->be->tcp_req.inspect_delay || tick_is_expired(s->rules_exp, now_ms)) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 117 | partial = SMP_OPT_FINAL; |
| 118 | else |
| 119 | partial = 0; |
| 120 | |
| 121 | /* If "the current_rule_list" match the executed rule list, we are in |
| 122 | * resume condition. If a resume is needed it is always in the action |
| 123 | * and never in the ACL or converters. In this case, we initialise the |
| 124 | * current rule, and go to the action execution point. |
| 125 | */ |
| 126 | if (s->current_rule) { |
| 127 | rule = s->current_rule; |
| 128 | s->current_rule = NULL; |
| 129 | if (s->current_rule_list == &s->be->tcp_req.inspect_rules) |
| 130 | goto resume_execution; |
| 131 | } |
| 132 | s->current_rule_list = &s->be->tcp_req.inspect_rules; |
| 133 | |
| 134 | list_for_each_entry(rule, &s->be->tcp_req.inspect_rules, list) { |
| 135 | enum acl_test_res ret = ACL_TEST_PASS; |
| 136 | |
| 137 | if (rule->cond) { |
| 138 | ret = acl_exec_cond(rule->cond, s->be, sess, s, SMP_OPT_DIR_REQ | partial); |
| 139 | if (ret == ACL_TEST_MISS) |
| 140 | goto missing_data; |
| 141 | |
| 142 | ret = acl_pass(ret); |
| 143 | if (rule->cond->pol == ACL_COND_UNLESS) |
| 144 | ret = !ret; |
| 145 | } |
| 146 | |
| 147 | if (ret) { |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 148 | act_opts |= ACT_OPT_FIRST; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 149 | resume_execution: |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 150 | |
| 151 | /* Always call the action function if defined */ |
| 152 | if (rule->action_ptr) { |
| 153 | if (partial & SMP_OPT_FINAL) |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 154 | act_opts |= ACT_OPT_FINAL; |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 155 | |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 156 | switch (rule->action_ptr(rule, s->be, s->sess, s, act_opts)) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 157 | case ACT_RET_CONT: |
| 158 | break; |
| 159 | case ACT_RET_STOP: |
| 160 | case ACT_RET_DONE: |
| 161 | goto end; |
| 162 | case ACT_RET_YIELD: |
| 163 | s->current_rule = rule; |
Christopher Faulet | 99aaca9 | 2020-07-28 11:30:19 +0200 | [diff] [blame] | 164 | if (partial & SMP_OPT_FINAL) { |
| 165 | send_log(s->be, LOG_WARNING, |
| 166 | "Internal error: yield not allowed if the inspect-delay expired " |
| 167 | "for the tcp-request content actions."); |
| 168 | goto internal; |
| 169 | } |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 170 | goto missing_data; |
| 171 | case ACT_RET_DENY: |
| 172 | goto deny; |
| 173 | case ACT_RET_ABRT: |
| 174 | goto abort; |
| 175 | case ACT_RET_ERR: |
| 176 | goto internal; |
| 177 | case ACT_RET_INV: |
| 178 | goto invalid; |
| 179 | } |
| 180 | continue; /* eval the next rule */ |
| 181 | } |
| 182 | |
| 183 | /* If not action function defined, check for known actions */ |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 184 | if (rule->action == ACT_ACTION_ALLOW) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 185 | goto end; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 186 | } |
| 187 | else if (rule->action == ACT_ACTION_DENY) { |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 188 | goto deny; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 189 | } |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 190 | } |
| 191 | } |
| 192 | |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 193 | end: |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 194 | /* if we get there, it means we have no rule which matches, or |
| 195 | * we have an explicit accept, so we apply the default accept. |
| 196 | */ |
| 197 | req->analysers &= ~an_bit; |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 198 | req->analyse_exp = s->rules_exp = TICK_ETERNITY; |
Christopher Faulet | eea8fc7 | 2019-11-05 16:18:10 +0100 | [diff] [blame] | 199 | DBG_TRACE_LEAVE(STRM_EV_STRM_ANA|STRM_EV_TCP_ANA, s); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 200 | return 1; |
| 201 | |
| 202 | missing_data: |
| 203 | channel_dont_connect(req); |
| 204 | /* just set the request timeout once at the beginning of the request */ |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 205 | if (!tick_isset(s->rules_exp) && s->be->tcp_req.inspect_delay) |
| 206 | s->rules_exp = tick_add(now_ms, s->be->tcp_req.inspect_delay); |
| 207 | req->analyse_exp = tick_first((tick_is_expired(req->analyse_exp, now_ms) ? 0 : req->analyse_exp), s->rules_exp); |
Christopher Faulet | eea8fc7 | 2019-11-05 16:18:10 +0100 | [diff] [blame] | 208 | DBG_TRACE_DEVEL("waiting for more data", STRM_EV_STRM_ANA|STRM_EV_TCP_ANA, s); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 209 | return 0; |
| 210 | |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 211 | deny: |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 212 | _HA_ATOMIC_INC(&sess->fe->fe_counters.denied_req); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 213 | if (sess->listener && sess->listener->counters) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 214 | _HA_ATOMIC_INC(&sess->listener->counters->denied_req); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 215 | goto reject; |
| 216 | |
| 217 | internal: |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 218 | _HA_ATOMIC_INC(&sess->fe->fe_counters.internal_errors); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 219 | if (sess->listener && sess->listener->counters) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 220 | _HA_ATOMIC_INC(&sess->listener->counters->internal_errors); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 221 | if (!(s->flags & SF_ERR_MASK)) |
| 222 | s->flags |= SF_ERR_INTERNAL; |
| 223 | goto reject; |
| 224 | |
| 225 | invalid: |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 226 | _HA_ATOMIC_INC(&sess->fe->fe_counters.failed_req); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 227 | if (sess->listener && sess->listener->counters) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 228 | _HA_ATOMIC_INC(&sess->listener->counters->failed_req); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 229 | |
| 230 | reject: |
| 231 | si_must_kill_conn(chn_prod(req)); |
| 232 | channel_abort(req); |
| 233 | channel_abort(&s->res); |
| 234 | |
| 235 | abort: |
| 236 | req->analysers &= AN_REQ_FLT_END; |
| 237 | |
| 238 | if (!(s->flags & SF_ERR_MASK)) |
| 239 | s->flags |= SF_ERR_PRXCOND; |
| 240 | if (!(s->flags & SF_FINST_MASK)) |
| 241 | s->flags |= SF_FINST_R; |
| 242 | DBG_TRACE_DEVEL("leaving on error|deny|abort", STRM_EV_STRM_ANA|STRM_EV_TCP_ANA|STRM_EV_TCP_ERR, s); |
| 243 | return 0; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 244 | } |
| 245 | |
| 246 | /* This function performs the TCP response analysis on the current response. It |
| 247 | * returns 1 if the processing can continue on next analysers, or zero if it |
| 248 | * needs more data, encounters an error, or wants to immediately abort the |
| 249 | * response. It relies on buffers flags, and updates s->rep->analysers. The |
| 250 | * function may be called for backend rules. |
| 251 | */ |
| 252 | int tcp_inspect_response(struct stream *s, struct channel *rep, int an_bit) |
| 253 | { |
| 254 | struct session *sess = s->sess; |
| 255 | struct act_rule *rule; |
| 256 | int partial; |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 257 | int act_opts = 0; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 258 | |
Christopher Faulet | eea8fc7 | 2019-11-05 16:18:10 +0100 | [diff] [blame] | 259 | DBG_TRACE_ENTER(STRM_EV_STRM_ANA|STRM_EV_TCP_ANA, s); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 260 | |
| 261 | /* We don't know whether we have enough data, so must proceed |
| 262 | * this way : |
| 263 | * - iterate through all rules in their declaration order |
| 264 | * - if one rule returns MISS, it means the inspect delay is |
| 265 | * not over yet, then return immediately, otherwise consider |
| 266 | * it as a non-match. |
| 267 | * - if one rule returns OK, then return OK |
| 268 | * - if one rule returns KO, then return KO |
| 269 | */ |
Willy Tarreau | 55ae1ab | 2020-06-15 18:08:07 +0200 | [diff] [blame] | 270 | if ((rep->flags & CF_SHUTR) || channel_full(rep, global.tune.maxrewrite) || |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 271 | !s->be->tcp_rep.inspect_delay || tick_is_expired(s->rules_exp, now_ms)) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 272 | partial = SMP_OPT_FINAL; |
| 273 | else |
| 274 | partial = 0; |
| 275 | |
| 276 | /* If "the current_rule_list" match the executed rule list, we are in |
| 277 | * resume condition. If a resume is needed it is always in the action |
| 278 | * and never in the ACL or converters. In this case, we initialise the |
| 279 | * current rule, and go to the action execution point. |
| 280 | */ |
| 281 | if (s->current_rule) { |
| 282 | rule = s->current_rule; |
| 283 | s->current_rule = NULL; |
| 284 | if (s->current_rule_list == &s->be->tcp_rep.inspect_rules) |
| 285 | goto resume_execution; |
| 286 | } |
| 287 | s->current_rule_list = &s->be->tcp_rep.inspect_rules; |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 288 | s->rules_exp = TICK_ETERNITY; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 289 | |
| 290 | list_for_each_entry(rule, &s->be->tcp_rep.inspect_rules, list) { |
| 291 | enum acl_test_res ret = ACL_TEST_PASS; |
| 292 | |
| 293 | if (rule->cond) { |
| 294 | ret = acl_exec_cond(rule->cond, s->be, sess, s, SMP_OPT_DIR_RES | partial); |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 295 | if (ret == ACL_TEST_MISS) |
| 296 | goto missing_data; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 297 | |
| 298 | ret = acl_pass(ret); |
| 299 | if (rule->cond->pol == ACL_COND_UNLESS) |
| 300 | ret = !ret; |
| 301 | } |
| 302 | |
| 303 | if (ret) { |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 304 | act_opts |= ACT_OPT_FIRST; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 305 | resume_execution: |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 306 | /* Always call the action function if defined */ |
| 307 | if (rule->action_ptr) { |
| 308 | if (partial & SMP_OPT_FINAL) |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 309 | act_opts |= ACT_OPT_FINAL; |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 310 | |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 311 | switch (rule->action_ptr(rule, s->be, s->sess, s, act_opts)) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 312 | case ACT_RET_CONT: |
| 313 | break; |
| 314 | case ACT_RET_STOP: |
| 315 | case ACT_RET_DONE: |
| 316 | goto end; |
| 317 | case ACT_RET_YIELD: |
| 318 | s->current_rule = rule; |
Christopher Faulet | 99aaca9 | 2020-07-28 11:30:19 +0200 | [diff] [blame] | 319 | if (partial & SMP_OPT_FINAL) { |
| 320 | send_log(s->be, LOG_WARNING, |
| 321 | "Internal error: yield not allowed if the inspect-delay expired " |
| 322 | "for the tcp-response content actions."); |
| 323 | goto internal; |
| 324 | } |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 325 | channel_dont_close(rep); |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 326 | goto missing_data; |
| 327 | case ACT_RET_DENY: |
| 328 | goto deny; |
| 329 | case ACT_RET_ABRT: |
| 330 | goto abort; |
| 331 | case ACT_RET_ERR: |
| 332 | goto internal; |
| 333 | case ACT_RET_INV: |
| 334 | goto invalid; |
| 335 | } |
| 336 | continue; /* eval the next rule */ |
| 337 | } |
| 338 | |
| 339 | /* If not action function defined, check for known actions */ |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 340 | if (rule->action == ACT_ACTION_ALLOW) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 341 | goto end; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 342 | } |
| 343 | else if (rule->action == ACT_ACTION_DENY) { |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 344 | goto deny; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 345 | } |
| 346 | else if (rule->action == ACT_TCP_CLOSE) { |
| 347 | chn_prod(rep)->flags |= SI_FL_NOLINGER | SI_FL_NOHALF; |
Willy Tarreau | 0f9cd7b | 2019-01-31 19:02:43 +0100 | [diff] [blame] | 348 | si_must_kill_conn(chn_prod(rep)); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 349 | si_shutr(chn_prod(rep)); |
| 350 | si_shutw(chn_prod(rep)); |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 351 | goto end; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 352 | } |
| 353 | } |
| 354 | } |
| 355 | |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 356 | end: |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 357 | /* if we get there, it means we have no rule which matches, or |
| 358 | * we have an explicit accept, so we apply the default accept. |
| 359 | */ |
| 360 | rep->analysers &= ~an_bit; |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 361 | rep->analyse_exp = s->rules_exp = TICK_ETERNITY; |
Christopher Faulet | eea8fc7 | 2019-11-05 16:18:10 +0100 | [diff] [blame] | 362 | DBG_TRACE_LEAVE(STRM_EV_STRM_ANA|STRM_EV_TCP_ANA, s); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 363 | return 1; |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 364 | |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 365 | missing_data: |
Christopher Faulet | 54f3e18 | 2020-07-29 12:00:23 +0200 | [diff] [blame] | 366 | /* just set the analyser timeout once at the beginning of the response */ |
Christopher Faulet | 2747fbb | 2020-07-28 11:56:13 +0200 | [diff] [blame] | 367 | if (!tick_isset(s->rules_exp) && s->be->tcp_rep.inspect_delay) |
| 368 | s->rules_exp = tick_add(now_ms, s->be->tcp_rep.inspect_delay); |
| 369 | rep->analyse_exp = tick_first((tick_is_expired(rep->analyse_exp, now_ms) ? 0 : rep->analyse_exp), s->rules_exp); |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 370 | DBG_TRACE_DEVEL("waiting for more data", STRM_EV_STRM_ANA|STRM_EV_TCP_ANA, s); |
| 371 | return 0; |
| 372 | |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 373 | deny: |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 374 | _HA_ATOMIC_INC(&s->sess->fe->fe_counters.denied_resp); |
| 375 | _HA_ATOMIC_INC(&s->be->be_counters.denied_resp); |
William Lallemand | 36119de | 2021-03-08 15:26:48 +0100 | [diff] [blame] | 376 | if (s->sess->listener && s->sess->listener->counters) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 377 | _HA_ATOMIC_INC(&s->sess->listener->counters->denied_resp); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 378 | if (objt_server(s->target)) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 379 | _HA_ATOMIC_INC(&__objt_server(s->target)->counters.denied_resp); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 380 | goto reject; |
| 381 | |
| 382 | internal: |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 383 | _HA_ATOMIC_INC(&s->sess->fe->fe_counters.internal_errors); |
| 384 | _HA_ATOMIC_INC(&s->be->be_counters.internal_errors); |
William Lallemand | 36119de | 2021-03-08 15:26:48 +0100 | [diff] [blame] | 385 | if (s->sess->listener && s->sess->listener->counters) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 386 | _HA_ATOMIC_INC(&s->sess->listener->counters->internal_errors); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 387 | if (objt_server(s->target)) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 388 | _HA_ATOMIC_INC(&__objt_server(s->target)->counters.internal_errors); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 389 | if (!(s->flags & SF_ERR_MASK)) |
| 390 | s->flags |= SF_ERR_INTERNAL; |
| 391 | goto reject; |
| 392 | |
| 393 | invalid: |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 394 | _HA_ATOMIC_INC(&s->be->be_counters.failed_resp); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 395 | if (objt_server(s->target)) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 396 | _HA_ATOMIC_INC(&__objt_server(s->target)->counters.failed_resp); |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 397 | |
| 398 | reject: |
| 399 | si_must_kill_conn(chn_prod(rep)); |
| 400 | channel_abort(rep); |
| 401 | channel_abort(&s->req); |
| 402 | |
| 403 | abort: |
Christopher Faulet | 19dbf2d | 2020-07-28 11:40:07 +0200 | [diff] [blame] | 404 | rep->analysers &= AN_RES_FLT_END; |
Christopher Faulet | 282992e | 2019-12-16 12:34:31 +0100 | [diff] [blame] | 405 | |
| 406 | if (!(s->flags & SF_ERR_MASK)) |
| 407 | s->flags |= SF_ERR_PRXCOND; |
| 408 | if (!(s->flags & SF_FINST_MASK)) |
| 409 | s->flags |= SF_FINST_D; |
| 410 | DBG_TRACE_DEVEL("leaving on error", STRM_EV_STRM_ANA|STRM_EV_TCP_ANA|STRM_EV_TCP_ERR, s); |
| 411 | return 0; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 412 | } |
| 413 | |
| 414 | |
| 415 | /* This function performs the TCP layer4 analysis on the current request. It |
| 416 | * returns 0 if a reject rule matches, otherwise 1 if either an accept rule |
| 417 | * matches or if no more rule matches. It can only use rules which don't need |
| 418 | * any data. This only works on connection-based client-facing stream interfaces. |
| 419 | */ |
| 420 | int tcp_exec_l4_rules(struct session *sess) |
| 421 | { |
| 422 | struct act_rule *rule; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 423 | struct connection *conn = objt_conn(sess->origin); |
| 424 | int result = 1; |
| 425 | enum acl_test_res ret; |
| 426 | |
| 427 | if (!conn) |
| 428 | return result; |
| 429 | |
| 430 | list_for_each_entry(rule, &sess->fe->tcp_req.l4_rules, list) { |
| 431 | ret = ACL_TEST_PASS; |
| 432 | |
| 433 | if (rule->cond) { |
| 434 | ret = acl_exec_cond(rule->cond, sess->fe, sess, NULL, SMP_OPT_DIR_REQ|SMP_OPT_FINAL); |
| 435 | ret = acl_pass(ret); |
| 436 | if (rule->cond->pol == ACL_COND_UNLESS) |
| 437 | ret = !ret; |
| 438 | } |
| 439 | |
| 440 | if (ret) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 441 | /* Always call the action function if defined */ |
| 442 | if (rule->action_ptr) { |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 443 | switch (rule->action_ptr(rule, sess->fe, sess, NULL, ACT_OPT_FINAL | ACT_OPT_FIRST)) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 444 | case ACT_RET_YIELD: |
| 445 | /* yield is not allowed at this point. If this return code is |
| 446 | * used it is a bug, so I prefer to abort the process. |
| 447 | */ |
| 448 | send_log(sess->fe, LOG_WARNING, |
| 449 | "Internal error: yield not allowed with tcp-request connection actions."); |
| 450 | /* fall through */ |
| 451 | case ACT_RET_STOP: |
| 452 | case ACT_RET_DONE: |
| 453 | goto end; |
| 454 | case ACT_RET_CONT: |
| 455 | break; |
| 456 | case ACT_RET_DENY: |
| 457 | case ACT_RET_ABRT: |
| 458 | case ACT_RET_ERR: |
| 459 | case ACT_RET_INV: |
| 460 | result = 0; |
| 461 | goto end; |
| 462 | } |
| 463 | continue; /* eval the next rule */ |
| 464 | } |
| 465 | |
| 466 | /* If not action function defined, check for known actions */ |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 467 | if (rule->action == ACT_ACTION_ALLOW) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 468 | goto end; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 469 | } |
| 470 | else if (rule->action == ACT_ACTION_DENY) { |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 471 | _HA_ATOMIC_INC(&sess->fe->fe_counters.denied_conn); |
Willy Tarreau | a12dde0 | 2016-12-22 18:14:41 +0100 | [diff] [blame] | 472 | if (sess->listener && sess->listener->counters) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 473 | _HA_ATOMIC_INC(&sess->listener->counters->denied_conn); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 474 | |
| 475 | result = 0; |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 476 | goto end; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 477 | } |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 478 | else if (rule->action == ACT_TCP_EXPECT_PX) { |
Willy Tarreau | 4450b58 | 2020-01-23 15:23:13 +0100 | [diff] [blame] | 479 | if (!(conn->flags & CO_FL_HANDSHAKE)) { |
Olivier Houchard | fe50bfb | 2019-05-27 12:09:19 +0200 | [diff] [blame] | 480 | if (xprt_add_hs(conn) < 0) { |
| 481 | result = 0; |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 482 | goto end; |
Olivier Houchard | fe50bfb | 2019-05-27 12:09:19 +0200 | [diff] [blame] | 483 | } |
| 484 | } |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 485 | conn->flags |= CO_FL_ACCEPT_PROXY; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 486 | } |
| 487 | else if (rule->action == ACT_TCP_EXPECT_CIP) { |
Willy Tarreau | 4450b58 | 2020-01-23 15:23:13 +0100 | [diff] [blame] | 488 | if (!(conn->flags & CO_FL_HANDSHAKE)) { |
Olivier Houchard | fe50bfb | 2019-05-27 12:09:19 +0200 | [diff] [blame] | 489 | if (xprt_add_hs(conn) < 0) { |
| 490 | result = 0; |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 491 | goto end; |
Olivier Houchard | fe50bfb | 2019-05-27 12:09:19 +0200 | [diff] [blame] | 492 | } |
| 493 | } |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 494 | conn->flags |= CO_FL_ACCEPT_CIP; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 495 | } |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 496 | } |
| 497 | } |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 498 | end: |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 499 | return result; |
| 500 | } |
| 501 | |
| 502 | /* This function performs the TCP layer5 analysis on the current request. It |
| 503 | * returns 0 if a reject rule matches, otherwise 1 if either an accept rule |
| 504 | * matches or if no more rule matches. It can only use rules which don't need |
| 505 | * any data. This only works on session-based client-facing stream interfaces. |
| 506 | * An example of valid use case is to track a stick-counter on the source |
| 507 | * address extracted from the proxy protocol. |
| 508 | */ |
| 509 | int tcp_exec_l5_rules(struct session *sess) |
| 510 | { |
| 511 | struct act_rule *rule; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 512 | int result = 1; |
| 513 | enum acl_test_res ret; |
| 514 | |
| 515 | list_for_each_entry(rule, &sess->fe->tcp_req.l5_rules, list) { |
| 516 | ret = ACL_TEST_PASS; |
| 517 | |
| 518 | if (rule->cond) { |
| 519 | ret = acl_exec_cond(rule->cond, sess->fe, sess, NULL, SMP_OPT_DIR_REQ|SMP_OPT_FINAL); |
| 520 | ret = acl_pass(ret); |
| 521 | if (rule->cond->pol == ACL_COND_UNLESS) |
| 522 | ret = !ret; |
| 523 | } |
| 524 | |
| 525 | if (ret) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 526 | /* Always call the action function if defined */ |
| 527 | if (rule->action_ptr) { |
Christopher Faulet | 105ba6c | 2019-12-18 14:41:51 +0100 | [diff] [blame] | 528 | switch (rule->action_ptr(rule, sess->fe, sess, NULL, ACT_OPT_FINAL | ACT_OPT_FIRST)) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 529 | case ACT_RET_YIELD: |
| 530 | /* yield is not allowed at this point. If this return code is |
| 531 | * used it is a bug, so I prefer to abort the process. |
| 532 | */ |
| 533 | send_log(sess->fe, LOG_WARNING, |
| 534 | "Internal error: yield not allowed with tcp-request session actions."); |
| 535 | /* fall through */ |
| 536 | case ACT_RET_STOP: |
| 537 | case ACT_RET_DONE: |
| 538 | goto end; |
| 539 | case ACT_RET_CONT: |
| 540 | break; |
| 541 | case ACT_RET_DENY: |
| 542 | case ACT_RET_ABRT: |
| 543 | case ACT_RET_ERR: |
| 544 | case ACT_RET_INV: |
| 545 | result = 0; |
| 546 | goto end; |
| 547 | } |
| 548 | continue; /* eval the next rule */ |
| 549 | } |
| 550 | |
| 551 | /* If not action function defined, check for known actions */ |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 552 | if (rule->action == ACT_ACTION_ALLOW) { |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 553 | goto end; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 554 | } |
| 555 | else if (rule->action == ACT_ACTION_DENY) { |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 556 | _HA_ATOMIC_INC(&sess->fe->fe_counters.denied_sess); |
Willy Tarreau | a12dde0 | 2016-12-22 18:14:41 +0100 | [diff] [blame] | 557 | if (sess->listener && sess->listener->counters) |
Willy Tarreau | 4781b15 | 2021-04-06 13:53:36 +0200 | [diff] [blame] | 558 | _HA_ATOMIC_INC(&sess->listener->counters->denied_sess); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 559 | |
| 560 | result = 0; |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 561 | goto end; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 562 | } |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 563 | } |
| 564 | } |
Christopher Faulet | cd26e8a | 2019-12-18 11:13:39 +0100 | [diff] [blame] | 565 | end: |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 566 | return result; |
| 567 | } |
| 568 | |
| 569 | /* Parse a tcp-response rule. Return a negative value in case of failure */ |
| 570 | static int tcp_parse_response_rule(char **args, int arg, int section_type, |
Willy Tarreau | 0182516 | 2021-03-09 09:53:46 +0100 | [diff] [blame] | 571 | struct proxy *curpx, const struct proxy *defpx, |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 572 | struct act_rule *rule, char **err, |
| 573 | unsigned int where, |
| 574 | const char *file, int line) |
| 575 | { |
| 576 | if (curpx == defpx || !(curpx->cap & PR_CAP_BE)) { |
| 577 | memprintf(err, "%s %s is only allowed in 'backend' sections", |
| 578 | args[0], args[1]); |
| 579 | return -1; |
| 580 | } |
| 581 | |
| 582 | if (strcmp(args[arg], "accept") == 0) { |
| 583 | arg++; |
| 584 | rule->action = ACT_ACTION_ALLOW; |
Christopher Faulet | 245cf79 | 2019-12-18 14:58:12 +0100 | [diff] [blame] | 585 | rule->flags |= ACT_FLAG_FINAL; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 586 | } |
| 587 | else if (strcmp(args[arg], "reject") == 0) { |
| 588 | arg++; |
| 589 | rule->action = ACT_ACTION_DENY; |
Christopher Faulet | 245cf79 | 2019-12-18 14:58:12 +0100 | [diff] [blame] | 590 | rule->flags |= ACT_FLAG_FINAL; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 591 | } |
| 592 | else if (strcmp(args[arg], "close") == 0) { |
| 593 | arg++; |
| 594 | rule->action = ACT_TCP_CLOSE; |
Christopher Faulet | 245cf79 | 2019-12-18 14:58:12 +0100 | [diff] [blame] | 595 | rule->flags |= ACT_FLAG_FINAL; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 596 | } |
| 597 | else { |
| 598 | struct action_kw *kw; |
| 599 | kw = tcp_res_cont_action(args[arg]); |
| 600 | if (kw) { |
| 601 | arg++; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 602 | rule->kw = kw; |
| 603 | if (kw->parse((const char **)args, &arg, curpx, rule, err) == ACT_RET_PRS_ERR) |
| 604 | return -1; |
| 605 | } else { |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 606 | const char *extra[] = { "accept", "reject", "close", NULL }; |
| 607 | const char *best = action_suggest(args[arg], &tcp_res_cont_keywords, extra); |
| 608 | |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 609 | action_build_list(&tcp_res_cont_keywords, &trash); |
| 610 | memprintf(err, |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 611 | "'%s %s' expects 'accept', 'close', 'reject', %s in %s '%s' (got '%s').%s%s%s", |
Willy Tarreau | 843b7cb | 2018-07-13 10:54:26 +0200 | [diff] [blame] | 612 | args[0], args[1], trash.area, |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 613 | proxy_type_str(curpx), curpx->id, args[arg], |
| 614 | best ? " Did you mean '" : "", |
| 615 | best ? best : "", |
| 616 | best ? "' maybe ?" : ""); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 617 | return -1; |
| 618 | } |
| 619 | } |
| 620 | |
| 621 | if (strcmp(args[arg], "if") == 0 || strcmp(args[arg], "unless") == 0) { |
Christopher Faulet | 1b421ea | 2017-09-22 14:38:56 +0200 | [diff] [blame] | 622 | if ((rule->cond = build_acl_cond(file, line, &curpx->acl, curpx, (const char **)args+arg, err)) == NULL) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 623 | memprintf(err, |
| 624 | "'%s %s %s' : error detected in %s '%s' while parsing '%s' condition : %s", |
| 625 | args[0], args[1], args[2], proxy_type_str(curpx), curpx->id, args[arg], *err); |
| 626 | return -1; |
| 627 | } |
| 628 | } |
| 629 | else if (*args[arg]) { |
| 630 | memprintf(err, |
| 631 | "'%s %s %s' only accepts 'if' or 'unless', in %s '%s' (got '%s')", |
| 632 | args[0], args[1], args[2], proxy_type_str(curpx), curpx->id, args[arg]); |
| 633 | return -1; |
| 634 | } |
| 635 | return 0; |
| 636 | } |
| 637 | |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 638 | |
| 639 | /* This function executes a track-sc* actions. On success, it returns |
| 640 | * ACT_RET_CONT. If it must yield, it return ACT_RET_YIELD. Otherwsize |
| 641 | * ACT_RET_ERR is returned. |
| 642 | */ |
| 643 | static enum act_return tcp_action_track_sc(struct act_rule *rule, struct proxy *px, |
| 644 | struct session *sess, struct stream *s, int flags) |
| 645 | { |
| 646 | struct stksess *ts; |
| 647 | struct stktable *t; |
| 648 | struct stktable_key *key; |
| 649 | struct sample smp; |
| 650 | int opt; |
| 651 | |
Christopher Faulet | 6730779 | 2020-02-10 09:54:49 +0100 | [diff] [blame] | 652 | opt = SMP_OPT_DIR_REQ; |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 653 | if (flags & ACT_FLAG_FINAL) |
| 654 | opt |= SMP_OPT_FINAL; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 655 | |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 656 | t = rule->arg.trk_ctr.table.t; |
Christopher Faulet | 6730779 | 2020-02-10 09:54:49 +0100 | [diff] [blame] | 657 | if (rule->from == ACT_F_TCP_REQ_CNT) { /* L7 rules: use the stream */ |
| 658 | if (stkctr_entry(&s->stkctr[rule->action])) |
| 659 | goto end; |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 660 | |
Christopher Faulet | 6730779 | 2020-02-10 09:54:49 +0100 | [diff] [blame] | 661 | key = stktable_fetch_key(t, s->be, sess, s, opt, rule->arg.trk_ctr.expr, &smp); |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 662 | |
Christopher Faulet | 6730779 | 2020-02-10 09:54:49 +0100 | [diff] [blame] | 663 | if ((smp.flags & SMP_F_MAY_CHANGE) && !(flags & ACT_FLAG_FINAL)) |
| 664 | return ACT_RET_YIELD; /* key might appear later */ |
| 665 | |
| 666 | if (key && (ts = stktable_get_entry(t, key))) { |
| 667 | stream_track_stkctr(&s->stkctr[rule->action], t, ts); |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 668 | stkctr_set_flags(&s->stkctr[rule->action], STKCTR_TRACK_CONTENT); |
| 669 | if (sess->fe != s->be) |
| 670 | stkctr_set_flags(&s->stkctr[rule->action], STKCTR_TRACK_BACKEND); |
| 671 | } |
| 672 | } |
Christopher Faulet | 6730779 | 2020-02-10 09:54:49 +0100 | [diff] [blame] | 673 | else { /* L4/L5 rules: use the session */ |
| 674 | if (stkctr_entry(&sess->stkctr[rule->action])) |
| 675 | goto end; |
| 676 | |
| 677 | key = stktable_fetch_key(t, sess->fe, sess, NULL, opt, rule->arg.trk_ctr.expr, NULL); |
| 678 | if (key && (ts = stktable_get_entry(t, key))) |
| 679 | stream_track_stkctr(&sess->stkctr[rule->action], t, ts); |
| 680 | } |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 681 | |
| 682 | end: |
| 683 | return ACT_RET_CONT; |
| 684 | } |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 685 | |
Christopher Faulet | d73b96d | 2019-12-19 17:27:03 +0100 | [diff] [blame] | 686 | /* This function executes a capture actions. It executes a fetch expression, |
| 687 | * turns the result into a string and puts it in a capture slot. On success, it |
| 688 | * returns ACT_RET_CONT. If it must yield, it return ACT_RET_YIELD. Otherwsize |
| 689 | * ACT_RET_ERR is returned. |
| 690 | */ |
| 691 | static enum act_return tcp_action_capture(struct act_rule *rule, struct proxy *px, |
| 692 | struct session *sess, struct stream *s, int flags) |
| 693 | { |
| 694 | struct sample *key; |
| 695 | struct cap_hdr *h = rule->arg.cap.hdr; |
| 696 | char **cap = s->req_cap; |
| 697 | int len, opt; |
| 698 | |
| 699 | opt = ((rule->from == ACT_F_TCP_REQ_CNT) ? SMP_OPT_DIR_REQ : SMP_OPT_DIR_RES); |
| 700 | if (flags & ACT_FLAG_FINAL) |
| 701 | opt |= SMP_OPT_FINAL; |
| 702 | |
| 703 | key = sample_fetch_as_type(s->be, sess, s, opt, rule->arg.cap.expr, SMP_T_STR); |
| 704 | if (!key) |
| 705 | goto end; |
| 706 | |
| 707 | if ((key->flags & SMP_F_MAY_CHANGE) && !(flags & ACT_FLAG_FINAL)) |
| 708 | return ACT_RET_YIELD; /* key might appear later */ |
| 709 | |
| 710 | if (cap[h->index] == NULL) { |
| 711 | cap[h->index] = pool_alloc(h->pool); |
| 712 | if (cap[h->index] == NULL) /* no more capture memory, ignore error */ |
| 713 | goto end; |
| 714 | } |
| 715 | |
| 716 | len = key->data.u.str.data; |
| 717 | if (len > h->len) |
| 718 | len = h->len; |
| 719 | |
| 720 | memcpy(cap[h->index], key->data.u.str.area, len); |
| 721 | cap[h->index][len] = 0; |
| 722 | |
| 723 | end: |
| 724 | return ACT_RET_CONT; |
| 725 | } |
| 726 | |
Christopher Faulet | adfc6e8 | 2020-01-14 15:05:33 +0100 | [diff] [blame] | 727 | static void release_tcp_capture(struct act_rule * rule) |
| 728 | { |
| 729 | release_sample_expr(rule->arg.cap.expr); |
| 730 | } |
| 731 | |
| 732 | |
| 733 | static void release_tcp_track_sc(struct act_rule * rule) |
| 734 | { |
| 735 | release_sample_expr(rule->arg.trk_ctr.expr); |
| 736 | } |
| 737 | |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 738 | /* Parse a tcp-request rule. Return a negative value in case of failure */ |
| 739 | static int tcp_parse_request_rule(char **args, int arg, int section_type, |
Willy Tarreau | 0182516 | 2021-03-09 09:53:46 +0100 | [diff] [blame] | 740 | struct proxy *curpx, const struct proxy *defpx, |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 741 | struct act_rule *rule, char **err, |
| 742 | unsigned int where, const char *file, int line) |
| 743 | { |
| 744 | if (curpx == defpx) { |
| 745 | memprintf(err, "%s %s is not allowed in 'defaults' sections", |
| 746 | args[0], args[1]); |
| 747 | return -1; |
| 748 | } |
| 749 | |
Tim Duesterhus | e5ff141 | 2021-01-02 22:31:53 +0100 | [diff] [blame] | 750 | if (strcmp(args[arg], "accept") == 0) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 751 | arg++; |
| 752 | rule->action = ACT_ACTION_ALLOW; |
Christopher Faulet | 245cf79 | 2019-12-18 14:58:12 +0100 | [diff] [blame] | 753 | rule->flags |= ACT_FLAG_FINAL; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 754 | } |
Tim Duesterhus | e5ff141 | 2021-01-02 22:31:53 +0100 | [diff] [blame] | 755 | else if (strcmp(args[arg], "reject") == 0) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 756 | arg++; |
| 757 | rule->action = ACT_ACTION_DENY; |
Christopher Faulet | 245cf79 | 2019-12-18 14:58:12 +0100 | [diff] [blame] | 758 | rule->flags |= ACT_FLAG_FINAL; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 759 | } |
| 760 | else if (strcmp(args[arg], "capture") == 0) { |
| 761 | struct sample_expr *expr; |
| 762 | struct cap_hdr *hdr; |
| 763 | int kw = arg; |
| 764 | int len = 0; |
| 765 | |
| 766 | if (!(curpx->cap & PR_CAP_FE)) { |
| 767 | memprintf(err, |
| 768 | "'%s %s %s' : proxy '%s' has no frontend capability", |
| 769 | args[0], args[1], args[kw], curpx->id); |
| 770 | return -1; |
| 771 | } |
| 772 | |
| 773 | if (!(where & SMP_VAL_FE_REQ_CNT)) { |
| 774 | memprintf(err, |
| 775 | "'%s %s' is not allowed in '%s %s' rules in %s '%s'", |
| 776 | args[arg], args[arg+1], args[0], args[1], proxy_type_str(curpx), curpx->id); |
| 777 | return -1; |
| 778 | } |
| 779 | |
| 780 | arg++; |
| 781 | |
| 782 | curpx->conf.args.ctx = ARGC_CAP; |
Willy Tarreau | e3b57bf | 2020-02-14 16:50:14 +0100 | [diff] [blame] | 783 | expr = sample_parse_expr(args, &arg, file, line, err, &curpx->conf.args, NULL); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 784 | if (!expr) { |
| 785 | memprintf(err, |
| 786 | "'%s %s %s' : %s", |
| 787 | args[0], args[1], args[kw], *err); |
| 788 | return -1; |
| 789 | } |
| 790 | |
| 791 | if (!(expr->fetch->val & where)) { |
| 792 | memprintf(err, |
| 793 | "'%s %s %s' : fetch method '%s' extracts information from '%s', none of which is available here", |
| 794 | args[0], args[1], args[kw], args[arg-1], sample_src_names(expr->fetch->use)); |
Christopher Faulet | fdb6fbf | 2020-01-14 15:05:56 +0100 | [diff] [blame] | 795 | release_sample_expr(expr); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 796 | return -1; |
| 797 | } |
| 798 | |
| 799 | if (strcmp(args[arg], "len") == 0) { |
| 800 | arg++; |
| 801 | if (!args[arg]) { |
| 802 | memprintf(err, |
| 803 | "'%s %s %s' : missing length value", |
| 804 | args[0], args[1], args[kw]); |
Christopher Faulet | fdb6fbf | 2020-01-14 15:05:56 +0100 | [diff] [blame] | 805 | release_sample_expr(expr); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 806 | return -1; |
| 807 | } |
| 808 | /* we copy the table name for now, it will be resolved later */ |
| 809 | len = atoi(args[arg]); |
| 810 | if (len <= 0) { |
| 811 | memprintf(err, |
| 812 | "'%s %s %s' : length must be > 0", |
| 813 | args[0], args[1], args[kw]); |
Christopher Faulet | fdb6fbf | 2020-01-14 15:05:56 +0100 | [diff] [blame] | 814 | release_sample_expr(expr); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 815 | return -1; |
| 816 | } |
| 817 | arg++; |
| 818 | } |
| 819 | |
| 820 | if (!len) { |
| 821 | memprintf(err, |
| 822 | "'%s %s %s' : a positive 'len' argument is mandatory", |
| 823 | args[0], args[1], args[kw]); |
| 824 | free(expr); |
| 825 | return -1; |
| 826 | } |
| 827 | |
| 828 | hdr = calloc(1, sizeof(*hdr)); |
| 829 | hdr->next = curpx->req_cap; |
| 830 | hdr->name = NULL; /* not a header capture */ |
| 831 | hdr->namelen = 0; |
| 832 | hdr->len = len; |
| 833 | hdr->pool = create_pool("caphdr", hdr->len + 1, MEM_F_SHARED); |
| 834 | hdr->index = curpx->nb_req_cap++; |
| 835 | |
| 836 | curpx->req_cap = hdr; |
| 837 | curpx->to_log |= LW_REQHDR; |
| 838 | |
Christopher Faulet | 711ed6a | 2019-07-16 14:16:10 +0200 | [diff] [blame] | 839 | /* check if we need to allocate an http_txn struct for HTTP parsing */ |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 840 | curpx->http_needed |= !!(expr->fetch->use & SMP_USE_HTTP_ANY); |
| 841 | |
| 842 | rule->arg.cap.expr = expr; |
| 843 | rule->arg.cap.hdr = hdr; |
Christopher Faulet | d73b96d | 2019-12-19 17:27:03 +0100 | [diff] [blame] | 844 | rule->action = ACT_CUSTOM; |
| 845 | rule->action_ptr = tcp_action_capture; |
| 846 | rule->check_ptr = check_capture; |
Christopher Faulet | adfc6e8 | 2020-01-14 15:05:33 +0100 | [diff] [blame] | 847 | rule->release_ptr = release_tcp_capture; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 848 | } |
Frédéric Lécaille | a41d531 | 2018-01-29 12:05:07 +0100 | [diff] [blame] | 849 | else if (strncmp(args[arg], "track-sc", 8) == 0) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 850 | struct sample_expr *expr; |
| 851 | int kw = arg; |
Frédéric Lécaille | a41d531 | 2018-01-29 12:05:07 +0100 | [diff] [blame] | 852 | unsigned int tsc_num; |
| 853 | const char *tsc_num_str; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 854 | |
| 855 | arg++; |
| 856 | |
Frédéric Lécaille | a41d531 | 2018-01-29 12:05:07 +0100 | [diff] [blame] | 857 | tsc_num_str = &args[kw][8]; |
| 858 | if (cfg_parse_track_sc_num(&tsc_num, tsc_num_str, tsc_num_str + strlen(tsc_num_str), err) == -1) { |
| 859 | memprintf(err, "'%s %s %s' : %s", args[0], args[1], args[kw], *err); |
| 860 | return -1; |
| 861 | } |
| 862 | |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 863 | curpx->conf.args.ctx = ARGC_TRK; |
Willy Tarreau | e3b57bf | 2020-02-14 16:50:14 +0100 | [diff] [blame] | 864 | expr = sample_parse_expr(args, &arg, file, line, err, &curpx->conf.args, NULL); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 865 | if (!expr) { |
| 866 | memprintf(err, |
| 867 | "'%s %s %s' : %s", |
| 868 | args[0], args[1], args[kw], *err); |
| 869 | return -1; |
| 870 | } |
| 871 | |
| 872 | if (!(expr->fetch->val & where)) { |
| 873 | memprintf(err, |
| 874 | "'%s %s %s' : fetch method '%s' extracts information from '%s', none of which is available here", |
| 875 | args[0], args[1], args[kw], args[arg-1], sample_src_names(expr->fetch->use)); |
Christopher Faulet | fdb6fbf | 2020-01-14 15:05:56 +0100 | [diff] [blame] | 876 | release_sample_expr(expr); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 877 | return -1; |
| 878 | } |
| 879 | |
Christopher Faulet | 711ed6a | 2019-07-16 14:16:10 +0200 | [diff] [blame] | 880 | /* check if we need to allocate an http_txn struct for HTTP parsing */ |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 881 | curpx->http_needed |= !!(expr->fetch->use & SMP_USE_HTTP_ANY); |
| 882 | |
| 883 | if (strcmp(args[arg], "table") == 0) { |
| 884 | arg++; |
| 885 | if (!args[arg]) { |
| 886 | memprintf(err, |
| 887 | "'%s %s %s' : missing table name", |
| 888 | args[0], args[1], args[kw]); |
Christopher Faulet | fdb6fbf | 2020-01-14 15:05:56 +0100 | [diff] [blame] | 889 | release_sample_expr(expr); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 890 | return -1; |
| 891 | } |
| 892 | /* we copy the table name for now, it will be resolved later */ |
| 893 | rule->arg.trk_ctr.table.n = strdup(args[arg]); |
| 894 | arg++; |
| 895 | } |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 896 | rule->action = tsc_num; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 897 | rule->arg.trk_ctr.expr = expr; |
Christopher Faulet | ac98d81 | 2019-12-18 09:20:16 +0100 | [diff] [blame] | 898 | rule->action_ptr = tcp_action_track_sc; |
Christopher Faulet | 78880fb | 2017-09-18 14:43:55 +0200 | [diff] [blame] | 899 | rule->check_ptr = check_trk_action; |
Christopher Faulet | adfc6e8 | 2020-01-14 15:05:33 +0100 | [diff] [blame] | 900 | rule->release_ptr = release_tcp_track_sc; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 901 | } |
| 902 | else if (strcmp(args[arg], "expect-proxy") == 0) { |
| 903 | if (strcmp(args[arg+1], "layer4") != 0) { |
| 904 | memprintf(err, |
| 905 | "'%s %s %s' only supports 'layer4' in %s '%s' (got '%s')", |
| 906 | args[0], args[1], args[arg], proxy_type_str(curpx), curpx->id, args[arg+1]); |
| 907 | return -1; |
| 908 | } |
| 909 | |
| 910 | if (!(where & SMP_VAL_FE_CON_ACC)) { |
| 911 | memprintf(err, |
| 912 | "'%s %s' is not allowed in '%s %s' rules in %s '%s'", |
| 913 | args[arg], args[arg+1], args[0], args[1], proxy_type_str(curpx), curpx->id); |
| 914 | return -1; |
| 915 | } |
| 916 | |
| 917 | arg += 2; |
| 918 | rule->action = ACT_TCP_EXPECT_PX; |
| 919 | } |
| 920 | else if (strcmp(args[arg], "expect-netscaler-cip") == 0) { |
| 921 | if (strcmp(args[arg+1], "layer4") != 0) { |
| 922 | memprintf(err, |
| 923 | "'%s %s %s' only supports 'layer4' in %s '%s' (got '%s')", |
| 924 | args[0], args[1], args[arg], proxy_type_str(curpx), curpx->id, args[arg+1]); |
| 925 | return -1; |
| 926 | } |
| 927 | |
| 928 | if (!(where & SMP_VAL_FE_CON_ACC)) { |
| 929 | memprintf(err, |
| 930 | "'%s %s' is not allowed in '%s %s' rules in %s '%s'", |
| 931 | args[arg], args[arg+1], args[0], args[1], proxy_type_str(curpx), curpx->id); |
| 932 | return -1; |
| 933 | } |
| 934 | |
| 935 | arg += 2; |
| 936 | rule->action = ACT_TCP_EXPECT_CIP; |
| 937 | } |
| 938 | else { |
| 939 | struct action_kw *kw; |
| 940 | if (where & SMP_VAL_FE_CON_ACC) { |
| 941 | /* L4 */ |
| 942 | kw = tcp_req_conn_action(args[arg]); |
| 943 | rule->kw = kw; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 944 | } else if (where & SMP_VAL_FE_SES_ACC) { |
| 945 | /* L5 */ |
| 946 | kw = tcp_req_sess_action(args[arg]); |
| 947 | rule->kw = kw; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 948 | } else { |
| 949 | /* L6 */ |
| 950 | kw = tcp_req_cont_action(args[arg]); |
| 951 | rule->kw = kw; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 952 | } |
| 953 | if (kw) { |
| 954 | arg++; |
| 955 | if (kw->parse((const char **)args, &arg, curpx, rule, err) == ACT_RET_PRS_ERR) |
| 956 | return -1; |
| 957 | } else { |
Christopher Faulet | a561ffb | 2021-03-19 08:53:26 +0100 | [diff] [blame] | 958 | const char *extra[] = { "accept", "reject", "capture", "track-sc", "expect-proxy", "expect-netscaler-cip", NULL }; |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 959 | const char *best = NULL; |
| 960 | |
| 961 | |
| 962 | if (where & SMP_VAL_FE_CON_ACC) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 963 | action_build_list(&tcp_req_conn_keywords, &trash); |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 964 | best = action_suggest(args[arg], &tcp_req_conn_keywords, extra); |
| 965 | } |
| 966 | else if (where & SMP_VAL_FE_SES_ACC) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 967 | action_build_list(&tcp_req_sess_keywords, &trash); |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 968 | best = action_suggest(args[arg], &tcp_req_sess_keywords, extra); |
| 969 | } |
| 970 | else { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 971 | action_build_list(&tcp_req_cont_keywords, &trash); |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 972 | best = action_suggest(args[arg], &tcp_req_cont_keywords, extra); |
| 973 | } |
| 974 | |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 975 | memprintf(err, |
Christopher Faulet | a561ffb | 2021-03-19 08:53:26 +0100 | [diff] [blame] | 976 | "'%s %s' expects 'accept', 'reject', 'capture', 'expect-proxy', 'expect-netscaler-cip', 'track-sc0' ... 'track-sc%d', %s " |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 977 | "in %s '%s' (got '%s').%s%s%s\n", |
Willy Tarreau | 843b7cb | 2018-07-13 10:54:26 +0200 | [diff] [blame] | 978 | args[0], args[1], MAX_SESS_STKCTR-1, |
| 979 | trash.area, proxy_type_str(curpx), |
Willy Tarreau | db67b0e | 2021-03-12 13:46:10 +0100 | [diff] [blame] | 980 | curpx->id, args[arg], |
| 981 | best ? " Did you mean '" : "", |
| 982 | best ? best : "", |
| 983 | best ? "' maybe ?" : ""); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 984 | return -1; |
| 985 | } |
| 986 | } |
| 987 | |
| 988 | if (strcmp(args[arg], "if") == 0 || strcmp(args[arg], "unless") == 0) { |
Christopher Faulet | 1b421ea | 2017-09-22 14:38:56 +0200 | [diff] [blame] | 989 | if ((rule->cond = build_acl_cond(file, line, &curpx->acl, curpx, (const char **)args+arg, err)) == NULL) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 990 | memprintf(err, |
| 991 | "'%s %s %s' : error detected in %s '%s' while parsing '%s' condition : %s", |
| 992 | args[0], args[1], args[2], proxy_type_str(curpx), curpx->id, args[arg], *err); |
| 993 | return -1; |
| 994 | } |
| 995 | } |
| 996 | else if (*args[arg]) { |
| 997 | memprintf(err, |
| 998 | "'%s %s %s' only accepts 'if' or 'unless', in %s '%s' (got '%s')", |
| 999 | args[0], args[1], args[2], proxy_type_str(curpx), curpx->id, args[arg]); |
| 1000 | return -1; |
| 1001 | } |
| 1002 | return 0; |
| 1003 | } |
| 1004 | |
| 1005 | /* This function should be called to parse a line starting with the "tcp-response" |
| 1006 | * keyword. |
| 1007 | */ |
| 1008 | static int tcp_parse_tcp_rep(char **args, int section_type, struct proxy *curpx, |
Willy Tarreau | 0182516 | 2021-03-09 09:53:46 +0100 | [diff] [blame] | 1009 | const struct proxy *defpx, const char *file, int line, |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1010 | char **err) |
| 1011 | { |
| 1012 | const char *ptr = NULL; |
| 1013 | unsigned int val; |
| 1014 | int warn = 0; |
| 1015 | int arg; |
| 1016 | struct act_rule *rule; |
| 1017 | unsigned int where; |
| 1018 | const struct acl *acl; |
| 1019 | const char *kw; |
| 1020 | |
| 1021 | if (!*args[1]) { |
| 1022 | memprintf(err, "missing argument for '%s' in %s '%s'", |
| 1023 | args[0], proxy_type_str(curpx), curpx->id); |
| 1024 | return -1; |
| 1025 | } |
| 1026 | |
| 1027 | if (strcmp(args[1], "inspect-delay") == 0) { |
| 1028 | if (curpx == defpx || !(curpx->cap & PR_CAP_BE)) { |
| 1029 | memprintf(err, "%s %s is only allowed in 'backend' sections", |
| 1030 | args[0], args[1]); |
| 1031 | return -1; |
| 1032 | } |
| 1033 | |
| 1034 | if (!*args[2] || (ptr = parse_time_err(args[2], &val, TIME_UNIT_MS))) { |
| 1035 | memprintf(err, |
| 1036 | "'%s %s' expects a positive delay in milliseconds, in %s '%s'", |
| 1037 | args[0], args[1], proxy_type_str(curpx), curpx->id); |
Willy Tarreau | 9faebe3 | 2019-06-07 19:00:37 +0200 | [diff] [blame] | 1038 | |
| 1039 | if (ptr == PARSE_TIME_OVER) |
| 1040 | memprintf(err, "%s (timer overflow in '%s', maximum value is 2147483647 ms or ~24.8 days)", *err, args[2]); |
| 1041 | else if (ptr == PARSE_TIME_UNDER) |
| 1042 | memprintf(err, "%s (timer underflow in '%s', minimum non-null value is 1 ms)", *err, args[2]); |
| 1043 | else if (ptr) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1044 | memprintf(err, "%s (unexpected character '%c')", *err, *ptr); |
| 1045 | return -1; |
| 1046 | } |
| 1047 | |
| 1048 | if (curpx->tcp_rep.inspect_delay) { |
| 1049 | memprintf(err, "ignoring %s %s (was already defined) in %s '%s'", |
| 1050 | args[0], args[1], proxy_type_str(curpx), curpx->id); |
| 1051 | return 1; |
| 1052 | } |
| 1053 | curpx->tcp_rep.inspect_delay = val; |
| 1054 | return 0; |
| 1055 | } |
| 1056 | |
| 1057 | rule = calloc(1, sizeof(*rule)); |
| 1058 | LIST_INIT(&rule->list); |
| 1059 | arg = 1; |
| 1060 | where = 0; |
| 1061 | |
| 1062 | if (strcmp(args[1], "content") == 0) { |
| 1063 | arg++; |
| 1064 | |
| 1065 | if (curpx->cap & PR_CAP_FE) |
| 1066 | where |= SMP_VAL_FE_RES_CNT; |
| 1067 | if (curpx->cap & PR_CAP_BE) |
| 1068 | where |= SMP_VAL_BE_RES_CNT; |
Christopher Faulet | cb9106b | 2019-12-19 15:23:17 +0100 | [diff] [blame] | 1069 | rule->from = ACT_F_TCP_RES_CNT; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1070 | if (tcp_parse_response_rule(args, arg, section_type, curpx, defpx, rule, err, where, file, line) < 0) |
| 1071 | goto error; |
| 1072 | |
| 1073 | acl = rule->cond ? acl_cond_conflicts(rule->cond, where) : NULL; |
| 1074 | if (acl) { |
| 1075 | if (acl->name && *acl->name) |
| 1076 | memprintf(err, |
| 1077 | "acl '%s' will never match in '%s %s' because it only involves keywords that are incompatible with '%s'", |
| 1078 | acl->name, args[0], args[1], sample_ckp_names(where)); |
| 1079 | else |
| 1080 | memprintf(err, |
| 1081 | "anonymous acl will never match in '%s %s' because it uses keyword '%s' which is incompatible with '%s'", |
| 1082 | args[0], args[1], |
| 1083 | LIST_ELEM(acl->expr.n, struct acl_expr *, list)->kw, |
| 1084 | sample_ckp_names(where)); |
| 1085 | |
| 1086 | warn++; |
| 1087 | } |
| 1088 | else if (rule->cond && acl_cond_kw_conflicts(rule->cond, where, &acl, &kw)) { |
| 1089 | if (acl->name && *acl->name) |
| 1090 | memprintf(err, |
| 1091 | "acl '%s' involves keyword '%s' which is incompatible with '%s'", |
| 1092 | acl->name, kw, sample_ckp_names(where)); |
| 1093 | else |
| 1094 | memprintf(err, |
| 1095 | "anonymous acl involves keyword '%s' which is incompatible with '%s'", |
| 1096 | kw, sample_ckp_names(where)); |
| 1097 | warn++; |
| 1098 | } |
| 1099 | |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 1100 | LIST_APPEND(&curpx->tcp_rep.inspect_rules, &rule->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1101 | } |
| 1102 | else { |
| 1103 | memprintf(err, |
| 1104 | "'%s' expects 'inspect-delay' or 'content' in %s '%s' (got '%s')", |
| 1105 | args[0], proxy_type_str(curpx), curpx->id, args[1]); |
| 1106 | goto error; |
| 1107 | } |
| 1108 | |
| 1109 | return warn; |
| 1110 | error: |
| 1111 | free(rule); |
| 1112 | return -1; |
| 1113 | } |
| 1114 | |
| 1115 | |
| 1116 | /* This function should be called to parse a line starting with the "tcp-request" |
| 1117 | * keyword. |
| 1118 | */ |
| 1119 | static int tcp_parse_tcp_req(char **args, int section_type, struct proxy *curpx, |
Willy Tarreau | 0182516 | 2021-03-09 09:53:46 +0100 | [diff] [blame] | 1120 | const struct proxy *defpx, const char *file, int line, |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1121 | char **err) |
| 1122 | { |
| 1123 | const char *ptr = NULL; |
| 1124 | unsigned int val; |
| 1125 | int warn = 0; |
| 1126 | int arg; |
| 1127 | struct act_rule *rule; |
| 1128 | unsigned int where; |
| 1129 | const struct acl *acl; |
| 1130 | const char *kw; |
| 1131 | |
| 1132 | if (!*args[1]) { |
| 1133 | if (curpx == defpx) |
| 1134 | memprintf(err, "missing argument for '%s' in defaults section", args[0]); |
| 1135 | else |
| 1136 | memprintf(err, "missing argument for '%s' in %s '%s'", |
| 1137 | args[0], proxy_type_str(curpx), curpx->id); |
| 1138 | return -1; |
| 1139 | } |
| 1140 | |
Tim Duesterhus | e5ff141 | 2021-01-02 22:31:53 +0100 | [diff] [blame] | 1141 | if (strcmp(args[1], "inspect-delay") == 0) { |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1142 | if (curpx == defpx) { |
| 1143 | memprintf(err, "%s %s is not allowed in 'defaults' sections", |
| 1144 | args[0], args[1]); |
| 1145 | return -1; |
| 1146 | } |
| 1147 | |
| 1148 | if (!*args[2] || (ptr = parse_time_err(args[2], &val, TIME_UNIT_MS))) { |
| 1149 | memprintf(err, |
| 1150 | "'%s %s' expects a positive delay in milliseconds, in %s '%s'", |
| 1151 | args[0], args[1], proxy_type_str(curpx), curpx->id); |
Willy Tarreau | 9faebe3 | 2019-06-07 19:00:37 +0200 | [diff] [blame] | 1152 | |
| 1153 | if (ptr == PARSE_TIME_OVER) |
| 1154 | memprintf(err, "%s (timer overflow in '%s', maximum value is 2147483647 ms or ~24.8 days)", *err, args[2]); |
| 1155 | else if (ptr == PARSE_TIME_UNDER) |
| 1156 | memprintf(err, "%s (timer underflow in '%s', minimum non-null value is 1 ms)", *err, args[2]); |
| 1157 | else if (ptr) |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1158 | memprintf(err, "%s (unexpected character '%c')", *err, *ptr); |
| 1159 | return -1; |
| 1160 | } |
| 1161 | |
| 1162 | if (curpx->tcp_req.inspect_delay) { |
| 1163 | memprintf(err, "ignoring %s %s (was already defined) in %s '%s'", |
| 1164 | args[0], args[1], proxy_type_str(curpx), curpx->id); |
| 1165 | return 1; |
| 1166 | } |
| 1167 | curpx->tcp_req.inspect_delay = val; |
| 1168 | return 0; |
| 1169 | } |
| 1170 | |
| 1171 | rule = calloc(1, sizeof(*rule)); |
| 1172 | LIST_INIT(&rule->list); |
| 1173 | arg = 1; |
| 1174 | where = 0; |
| 1175 | |
| 1176 | if (strcmp(args[1], "content") == 0) { |
| 1177 | arg++; |
| 1178 | |
| 1179 | if (curpx->cap & PR_CAP_FE) |
| 1180 | where |= SMP_VAL_FE_REQ_CNT; |
| 1181 | if (curpx->cap & PR_CAP_BE) |
| 1182 | where |= SMP_VAL_BE_REQ_CNT; |
Christopher Faulet | cb9106b | 2019-12-19 15:23:17 +0100 | [diff] [blame] | 1183 | rule->from = ACT_F_TCP_REQ_CNT; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1184 | if (tcp_parse_request_rule(args, arg, section_type, curpx, defpx, rule, err, where, file, line) < 0) |
| 1185 | goto error; |
| 1186 | |
| 1187 | acl = rule->cond ? acl_cond_conflicts(rule->cond, where) : NULL; |
| 1188 | if (acl) { |
| 1189 | if (acl->name && *acl->name) |
| 1190 | memprintf(err, |
| 1191 | "acl '%s' will never match in '%s %s' because it only involves keywords that are incompatible with '%s'", |
| 1192 | acl->name, args[0], args[1], sample_ckp_names(where)); |
| 1193 | else |
| 1194 | memprintf(err, |
| 1195 | "anonymous acl will never match in '%s %s' because it uses keyword '%s' which is incompatible with '%s'", |
| 1196 | args[0], args[1], |
| 1197 | LIST_ELEM(acl->expr.n, struct acl_expr *, list)->kw, |
| 1198 | sample_ckp_names(where)); |
| 1199 | |
| 1200 | warn++; |
| 1201 | } |
| 1202 | else if (rule->cond && acl_cond_kw_conflicts(rule->cond, where, &acl, &kw)) { |
| 1203 | if (acl->name && *acl->name) |
| 1204 | memprintf(err, |
| 1205 | "acl '%s' involves keyword '%s' which is incompatible with '%s'", |
| 1206 | acl->name, kw, sample_ckp_names(where)); |
| 1207 | else |
| 1208 | memprintf(err, |
| 1209 | "anonymous acl involves keyword '%s' which is incompatible with '%s'", |
| 1210 | kw, sample_ckp_names(where)); |
| 1211 | warn++; |
| 1212 | } |
| 1213 | |
| 1214 | /* the following function directly emits the warning */ |
| 1215 | warnif_misplaced_tcp_cont(curpx, file, line, args[0]); |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 1216 | LIST_APPEND(&curpx->tcp_req.inspect_rules, &rule->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1217 | } |
| 1218 | else if (strcmp(args[1], "connection") == 0) { |
| 1219 | arg++; |
| 1220 | |
| 1221 | if (!(curpx->cap & PR_CAP_FE)) { |
| 1222 | memprintf(err, "%s %s is not allowed because %s %s is not a frontend", |
| 1223 | args[0], args[1], proxy_type_str(curpx), curpx->id); |
| 1224 | goto error; |
| 1225 | } |
| 1226 | |
| 1227 | where |= SMP_VAL_FE_CON_ACC; |
Christopher Faulet | cb9106b | 2019-12-19 15:23:17 +0100 | [diff] [blame] | 1228 | rule->from = ACT_F_TCP_REQ_CON; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1229 | if (tcp_parse_request_rule(args, arg, section_type, curpx, defpx, rule, err, where, file, line) < 0) |
| 1230 | goto error; |
| 1231 | |
| 1232 | acl = rule->cond ? acl_cond_conflicts(rule->cond, where) : NULL; |
| 1233 | if (acl) { |
| 1234 | if (acl->name && *acl->name) |
| 1235 | memprintf(err, |
| 1236 | "acl '%s' will never match in '%s %s' because it only involves keywords that are incompatible with '%s'", |
| 1237 | acl->name, args[0], args[1], sample_ckp_names(where)); |
| 1238 | else |
| 1239 | memprintf(err, |
| 1240 | "anonymous acl will never match in '%s %s' because it uses keyword '%s' which is incompatible with '%s'", |
| 1241 | args[0], args[1], |
| 1242 | LIST_ELEM(acl->expr.n, struct acl_expr *, list)->kw, |
| 1243 | sample_ckp_names(where)); |
| 1244 | |
| 1245 | warn++; |
| 1246 | } |
| 1247 | else if (rule->cond && acl_cond_kw_conflicts(rule->cond, where, &acl, &kw)) { |
| 1248 | if (acl->name && *acl->name) |
| 1249 | memprintf(err, |
| 1250 | "acl '%s' involves keyword '%s' which is incompatible with '%s'", |
| 1251 | acl->name, kw, sample_ckp_names(where)); |
| 1252 | else |
| 1253 | memprintf(err, |
| 1254 | "anonymous acl involves keyword '%s' which is incompatible with '%s'", |
| 1255 | kw, sample_ckp_names(where)); |
| 1256 | warn++; |
| 1257 | } |
| 1258 | |
| 1259 | /* the following function directly emits the warning */ |
| 1260 | warnif_misplaced_tcp_conn(curpx, file, line, args[0]); |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 1261 | LIST_APPEND(&curpx->tcp_req.l4_rules, &rule->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1262 | } |
| 1263 | else if (strcmp(args[1], "session") == 0) { |
| 1264 | arg++; |
| 1265 | |
| 1266 | if (!(curpx->cap & PR_CAP_FE)) { |
| 1267 | memprintf(err, "%s %s is not allowed because %s %s is not a frontend", |
| 1268 | args[0], args[1], proxy_type_str(curpx), curpx->id); |
| 1269 | goto error; |
| 1270 | } |
| 1271 | |
| 1272 | where |= SMP_VAL_FE_SES_ACC; |
Christopher Faulet | cb9106b | 2019-12-19 15:23:17 +0100 | [diff] [blame] | 1273 | rule->from = ACT_F_TCP_REQ_SES; |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1274 | if (tcp_parse_request_rule(args, arg, section_type, curpx, defpx, rule, err, where, file, line) < 0) |
| 1275 | goto error; |
| 1276 | |
| 1277 | acl = rule->cond ? acl_cond_conflicts(rule->cond, where) : NULL; |
| 1278 | if (acl) { |
| 1279 | if (acl->name && *acl->name) |
| 1280 | memprintf(err, |
| 1281 | "acl '%s' will never match in '%s %s' because it only involves keywords that are incompatible with '%s'", |
| 1282 | acl->name, args[0], args[1], sample_ckp_names(where)); |
| 1283 | else |
| 1284 | memprintf(err, |
| 1285 | "anonymous acl will never match in '%s %s' because it uses keyword '%s' which is incompatible with '%s'", |
| 1286 | args[0], args[1], |
| 1287 | LIST_ELEM(acl->expr.n, struct acl_expr *, list)->kw, |
| 1288 | sample_ckp_names(where)); |
| 1289 | warn++; |
| 1290 | } |
| 1291 | else if (rule->cond && acl_cond_kw_conflicts(rule->cond, where, &acl, &kw)) { |
| 1292 | if (acl->name && *acl->name) |
| 1293 | memprintf(err, |
| 1294 | "acl '%s' involves keyword '%s' which is incompatible with '%s'", |
| 1295 | acl->name, kw, sample_ckp_names(where)); |
| 1296 | else |
| 1297 | memprintf(err, |
| 1298 | "anonymous acl involves keyword '%s' which is incompatible with '%s'", |
| 1299 | kw, sample_ckp_names(where)); |
| 1300 | warn++; |
| 1301 | } |
| 1302 | |
| 1303 | /* the following function directly emits the warning */ |
| 1304 | warnif_misplaced_tcp_sess(curpx, file, line, args[0]); |
Willy Tarreau | 2b71810 | 2021-04-21 07:32:39 +0200 | [diff] [blame] | 1305 | LIST_APPEND(&curpx->tcp_req.l5_rules, &rule->list); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1306 | } |
| 1307 | else { |
| 1308 | if (curpx == defpx) |
| 1309 | memprintf(err, |
| 1310 | "'%s' expects 'inspect-delay', 'connection', or 'content' in defaults section (got '%s')", |
| 1311 | args[0], args[1]); |
| 1312 | else |
| 1313 | memprintf(err, |
| 1314 | "'%s' expects 'inspect-delay', 'connection', or 'content' in %s '%s' (got '%s')", |
| 1315 | args[0], proxy_type_str(curpx), curpx->id, args[1]); |
| 1316 | goto error; |
| 1317 | } |
| 1318 | |
| 1319 | return warn; |
| 1320 | error: |
| 1321 | free(rule); |
| 1322 | return -1; |
| 1323 | } |
| 1324 | |
| 1325 | static struct cfg_kw_list cfg_kws = {ILH, { |
| 1326 | { CFG_LISTEN, "tcp-request", tcp_parse_tcp_req }, |
| 1327 | { CFG_LISTEN, "tcp-response", tcp_parse_tcp_rep }, |
| 1328 | { 0, NULL, NULL }, |
| 1329 | }}; |
| 1330 | |
Willy Tarreau | 0108d90 | 2018-11-25 19:14:37 +0100 | [diff] [blame] | 1331 | INITCALL1(STG_REGISTER, cfg_register_keywords, &cfg_kws); |
Willy Tarreau | 3971310 | 2016-11-25 15:49:32 +0100 | [diff] [blame] | 1332 | |
| 1333 | /* |
| 1334 | * Local variables: |
| 1335 | * c-indent-level: 8 |
| 1336 | * c-basic-offset: 8 |
| 1337 | * End: |
| 1338 | */ |