From: "mrbff (Code Review)" Date: Thu, 28 Nov 2024 15:20:27 +0000 In-Reply-To: References: Reply-To: marco@...2726..., arne-openvpn@...1227..., openvpn-devel@lists.sourceforge.net, frank@...2641..., lstipakov@...277... Message-ID: <0e03c580cb84f1973d6a3fec7b2ba3df1bb2b936-EmailReplacePatchSet-HTML@...2715...> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Disposition: inline Content-Type: multipart/alternative; boundary="JWkatHQLLDs="; charset=UTF-8 Subject: [Openvpn-devel] [L] Change in openvpn[master]: PUSH_UPDATE: Allow OpenVPN in client mode to receive and handle PUSH ... List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: plaisthos , flichtenheld Cc: openvpn-devel , stipa --JWkatHQLLDs= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Attention is currently required from: flichtenheld, mrbff, plaisthos. Hello flichtenheld, plaisthos, I'd like you to reexamine a change. Please visit http://gerrit.openvpn.net/c/openvpn/+/808?usp=3Demail to look at the new patch set (#5). The following approvals got outdated and were removed: Code-Review-1 by flichtenheld Change subject: PUSH_UPDATE: Allow OpenVPN in client mode to receive and ha= ndle PUSH UPDATE control messages to allow options updating at runtime. ...................................................................... PUSH_UPDATE: Allow OpenVPN in client mode to receive and handle PUSH UPDATE= control messages to allow options updating at runtime. * Added IV_PROTO_PUSH_UPDATE flag bit to support push-updates. * Added process_incoming_push_update(), in a separate file to create tests = more easily. * Modified incoming_push_message(), process_incoming_push_msg(), apply_push= _options(), apply_pull_filter() to process also push-update messages. * Added the check_push_update_option_flags() function used in apply_pull_fi= lter() to check options formatting inside push-update messages, if the options are = updatables and to check for '?' and '-' flags that may be present in front of the op= tions. The '-' flag is used to indicate that the option in question should be re= moved, while the '?' indicates that the option is optional and to do not generate errors if the client cannot update that option. For more info you can read the RFC at https://github.com/OpenVPN/openvpn-= rfc . * Created some unit tests for the push-update message handling in test_push= _update_msg.c. Change-Id: I6ecd4cb47571cc8c20e46de8595c742aeec6064a Signed-off-by: Marco Baffo --- M CMakeLists.txt M src/openvpn/Makefile.am M src/openvpn/forward.c M src/openvpn/init.c M src/openvpn/options.c M src/openvpn/options.h M src/openvpn/options_util.c M src/openvpn/options_util.h M src/openvpn/push.c M src/openvpn/push.h A src/openvpn/push_util.c M src/openvpn/ssl.c M src/openvpn/ssl.h M tests/unit_tests/openvpn/Makefile.am A tests/unit_tests/openvpn/test_push_update_msg.c 15 files changed, 645 insertions(+), 112 deletions(-) git pull ssh://gerrit.openvpn.net:29418/openvpn refs/changes/08/808/5 diff --git a/CMakeLists.txt b/CMakeLists.txt index 5db207d..d9daeae 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -496,6 +496,7 @@ src/openvpn/ps.c src/openvpn/ps.h src/openvpn/push.c + src/openvpn/push_util.c src/openvpn/push.h src/openvpn/pushlist.h src/openvpn/reflect_filter.c @@ -612,6 +613,7 @@ "test_provider" "test_ssl" "test_user_pass" + "test_push_update_msg" ) if (WIN32) @@ -808,6 +810,16 @@ src/openvpn/run_command.c ) + target_sources(test_push_update_msg PRIVATE + tests/unit_tests/openvpn/mock_msg.c + tests/unit_tests/openvpn/mock_get_random.c + src/openvpn/buffer.c + src/openvpn/platform.c + src/openvpn/push_util.c + src/openvpn/options_util.c + src/openvpn/otime.c + ) + if (TARGET test_argv) target_link_options(test_argv PRIVATE -Wl,--wrap=3Dparse_line) target_sources(test_argv PRIVATE diff --git a/src/openvpn/Makefile.am b/src/openvpn/Makefile.am index ecb2bcf..55ec565 100644 --- a/src/openvpn/Makefile.am +++ b/src/openvpn/Makefile.am @@ -114,7 +114,7 @@ proto.c proto.h \ proxy.c proxy.h \ ps.c ps.h \ - push.c push.h \ + push.c push_util.c push.h \ pushlist.h \ reflect_filter.c reflect_filter.h \ reliable.c reliable.h \ diff --git a/src/openvpn/forward.c b/src/openvpn/forward.c index d50b24c..2c75953 100644 --- a/src/openvpn/forward.c +++ b/src/openvpn/forward.c @@ -2031,7 +2031,7 @@ } /* check for incoming control messages on the control channel like - * push request/reply, or authentication failure and 2FA messages */ + * push request/reply/update, or authentication failure and 2FA messag= es */ if (tls_test_payload_len(c->c2.tls_multi) > 0) { check_incoming_control_channel(c); diff --git a/src/openvpn/init.c b/src/openvpn/init.c index 9371024..f8d9d06 100644 --- a/src/openvpn/init.c +++ b/src/openvpn/init.c @@ -2030,8 +2030,8 @@ /* possibly add routes */ if ((route_order(c->c1.tuntap) =3D=3D ROUTE_AFTER_TUN) && (!c->opt= ions.route_delay_defined)) { - int status =3D do_route(&c->options, c->c1.route_list, c->c1.r= oute_ipv6_list, - c->c1.tuntap, c->plugins, c->c2.es, &c->= net_ctx); + bool status =3D do_route(&c->options, c->c1.route_list, c->c1.= route_ipv6_list, + c->c1.tuntap, c->plugins, c->c2.es, &c-= >net_ctx); *error_flags |=3D (status ? 0 : ISC_ROUTE_ERRORS); } diff --git a/src/openvpn/options.c b/src/openvpn/options.c index 043b240..6f97fcd 100644 --- a/src/openvpn/options.c +++ b/src/openvpn/options.c @@ -63,6 +63,7 @@ #include #include "memdbg.h" +#include "options_util.h" const char title_string[] =3D PACKAGE_STRING @@ -927,24 +928,6 @@ } } -struct pull_filter -{ -#define PUF_TYPE_UNDEF 0 /**< undefined filter type */ -#define PUF_TYPE_ACCEPT 1 /**< filter type to accept a matching option = */ -#define PUF_TYPE_IGNORE 2 /**< filter type to ignore a matching option = */ -#define PUF_TYPE_REJECT 3 /**< filter type to reject and trigger SIGUSR= 1 */ - int type; - int size; - char *pattern; - struct pull_filter *next; -}; - -struct pull_filter_list -{ - struct pull_filter *head; - struct pull_filter *tail; -}; - #ifndef ENABLE_SMALL static const char * @@ -5469,84 +5452,6 @@ } } -/** - * Filter an option line by all pull filters. - * - * If a match is found, the line is modified depending on - * the filter type, and returns true. If the filter type is - * reject, SIGUSR1 is triggered and the return value is false. - * In that case the caller must end the push processing. - */ -static bool -apply_pull_filter(const struct options *o, char *line) -{ - struct pull_filter *f; - - if (!o->pull_filter_list) - { - return true; - } - - /* skip leading spaces matching the behaviour of parse_line */ - while (isspace(*line)) - { - line++; - } - - for (f =3D o->pull_filter_list->head; f; f =3D f->next) - { - if (f->type =3D=3D PUF_TYPE_ACCEPT && strncmp(line, f->pattern, f-= >size) =3D=3D 0) - { - msg(D_LOW, "Pushed option accepted by filter: '%s'", line); - return true; - } - else if (f->type =3D=3D PUF_TYPE_IGNORE && strncmp(line, f->patter= n, f->size) =3D=3D 0) - { - msg(D_PUSH, "Pushed option removed by filter: '%s'", line); - *line =3D '\0'; - return true; - } - else if (f->type =3D=3D PUF_TYPE_REJECT && strncmp(line, f->patter= n, f->size) =3D=3D 0) - { - msg(M_WARN, "Pushed option rejected by filter: '%s'. Restartin= g.", line); - *line =3D '\0'; - throw_signal_soft(SIGUSR1, "Offending option received from ser= ver"); - return false; - } - } - return true; -} - -bool -apply_push_options(struct options *options, - struct buffer *buf, - unsigned int permission_mask, - unsigned int *option_types_found, - struct env_set *es) -{ - char line[OPTION_PARM_SIZE]; - int line_num =3D 0; - const char *file =3D "[PUSH-OPTIONS]"; - const int msglevel =3D D_PUSH_ERRORS|M_OPTERR; - - while (buf_parse(buf, ',', line, sizeof(line))) - { - char *p[MAX_PARMS+1]; - CLEAR(p); - ++line_num; - if (!apply_pull_filter(options, line)) - { - return false; /* Cause push/pull error and stop push processin= g */ - } - if (parse_line(line, p, SIZE(p)-1, file, line_num, msglevel, &opti= ons->gc)) - { - add_option(options, p, false, file, line_num, 0, msglevel, - permission_mask, option_types_found, es); - } - } - return true; -} - void options_server_import(struct options *o, const char *filename, @@ -5680,6 +5585,44 @@ return options->forward_compatible ? M_WARN : msglevel; } +bool +apply_push_options(struct context *c, + struct options *options, + struct buffer *buf, + unsigned int permission_mask, + unsigned int *option_types_found, + struct env_set *es, + bool is_update) +{ + char line[OPTION_PARM_SIZE]; + int line_num =3D 0; + const char *file =3D "[PUSH-OPTIONS]"; + const int msglevel =3D D_PUSH_ERRORS|M_OPTERR; + + while (buf_parse(buf, ',', line, sizeof(line))) + { + char *p[MAX_PARMS+1]; + CLEAR(p); + ++line_num; + unsigned int push_update_option_flags =3D 0; + + if (!apply_pull_filter(options, line, is_update, &push_update_opti= on_flags)) + { + throw_signal_soft(SIGUSR1, "Offending option received from ser= ver"); + return false; /* Cause push/pull error and stop push processin= g */ + } + if (parse_line(line, p, SIZE(p)-1, file, line_num, msglevel, &opti= ons->gc)) + { + if (!is_update) + { + add_option(options, p, false, file, line_num, 0, msglevel, + permission_mask, option_types_found, es); + } + } + } + return true; +} + static void set_user_script(struct options *options, const char **script, diff --git a/src/openvpn/options.h b/src/openvpn/options.h index 6ab92e2..b4d486f 100644 --- a/src/openvpn/options.h +++ b/src/openvpn/options.h @@ -777,6 +777,33 @@ #define MAN_CLIENT_AUTH_ENABLED(opt) (false) #endif +/* + * some PUSH_UPDATE options + */ +#define OPT_P_U_ROUTE (1<<0) +#define OPT_P_U_ROUTE6 (1<<1) +#define OPT_P_U_DNS (1<<2) +#define OPT_P_U_DHCP (1<<3) +#define OPT_P_U_REDIR_GATEWAY (1<<4) + +struct pull_filter +{ +#define PUF_TYPE_UNDEF 0 /** undefined filter type */ +#define PUF_TYPE_ACCEPT 1 /** filter type to accept a matching option */ +#define PUF_TYPE_IGNORE 2 /** filter type to ignore a matching option */ +#define PUF_TYPE_REJECT 3 /** filter type to reject and trigger SIGUSR1= */ + int type; + int size; + char *pattern; + struct pull_filter *next; +}; + +struct pull_filter_list +{ + struct pull_filter *head; + struct pull_filter *tail; +}; + void parse_argv(struct options *options, const int argc, char *argv[], @@ -845,11 +872,13 @@ void pre_connect_restore(struct options *o, struct gc_arena *gc); -bool apply_push_options(struct options *options, +bool apply_push_options(struct context *c, + struct options *options, struct buffer *buf, unsigned int permission_mask, unsigned int *option_types_found, - struct env_set *es); + struct env_set *es, + bool is_update); void options_detach(struct options *o); diff --git a/src/openvpn/options_util.c b/src/openvpn/options_util.c index a9e020a..405f023 100644 --- a/src/openvpn/options_util.c +++ b/src/openvpn/options_util.c @@ -30,6 +30,8 @@ #include "options_util.h" +#include "push.h" + const char * parse_auth_failed_temp(struct options *o, const char *reason) { @@ -98,3 +100,174 @@ gc_free(&gc); return message; } + +static const char *updatable_options[] =3D { + "block-ipv6", + "block-outside-dns", + "dhcp-option", + "dns", + "ifconfig", + "ifconfig-ipv6", + "push-continuation", + "redirect-gateway", + "redirect-private", + "route", + "route-gateway", + "route-ipv6", + "route-metric", + "topology", + "tun-mtu", + "keepalive" +}; + +/** + * @brief Checks the formatting and validity of options inside push-update= messages. + * + * This function is used in `apply_pull_filter()` to validate and process = options + * in push-update messages. It performs the following checks: + * - Determines if the options are updatable. + * - Checks for the presence of the `-` flag, which indicates that the opt= ion + * should be removed. + * - Checks for the `?` flag, which marks the option as optional and suppr= esses + * errors if the client cannot update it. + * - Modifies the original string (`*line`) by removing the `'-'` and `'?'= ` flags + * after validating them and updating the appropriate flags in the `flag= s` variable. + * - `-?option`, `-option`, `?option` are valid formats, `?-option` is not= a valid format. + * + * @param line A pointer to an option string. This string is the option be= ing validated. + * @param flags A pointer where flags will be stored: + * - `PUSH_OPT_TO_REMOVE`: Set if the `-` flag is present. + * - `PUSH_OPT_OPTIONAL`: Set if the `?` flag is present. + * + * @return true if the flags and option combination are valid. + * @return false if: + * - The `-` and `?` flags are not formatted correctly. + * - The `line` parameter is empty or `NULL`. + * - The `?` flag is absent and the option is not updatable. + */ +static bool +check_push_update_option_flags(char **line, unsigned int *flags) +{ + if (!line || !*line || !**line) + { + return false; + } + *flags =3D 0; + bool opt_is_updatable =3D false; + char *str =3D *line; + char c =3D **line; + + if (c =3D=3D '-') + { + if (!(str)[1]) + { + return false; + } + *flags |=3D PUSH_OPT_TO_REMOVE; + c =3D *(++(str)); + } + if (c =3D=3D '?') + { + if (!(str)[1] || (str)[1] =3D=3D '-') + { + return false; + } + *flags |=3D PUSH_OPT_OPTIONAL; + c =3D *(++(str)); + } + + /* Skip '?' and '-' if they are present */ + size_t len =3D strlen(str); + memmove(*line, str, len); + (*line)[len] =3D '\0'; + str =3D *line; + + int count =3D sizeof(updatable_options)/sizeof(char *); + for (int i =3D 0; i < count; ++i) + { + size_t opt_len =3D strlen(updatable_options[i]); + if (len < opt_len) + { + continue; + } + if (!strncmp(str, updatable_options[i], opt_len) + && (!str[opt_len] || str[opt_len] =3D=3D ' ')) + { + opt_is_updatable =3D true; + break; + } + } + + if (!opt_is_updatable) + { + if (*flags & PUSH_OPT_OPTIONAL) + { + msg(D_PUSH, "Pushed option is not updatable: '%s'", *line); + return true; + } + else + { + msg(M_WARN, "Pushed option is not updatable: '%s'. Restarting.= ", *line); + return false; + } + } + + return true; +} + +bool +apply_pull_filter(const struct options *o, char *line, bool is_update, uns= igned int *push_update_option_flags) +{ + struct pull_filter *f; + + if (!o->pull_filter_list && !(is_update)) + { + return true; + } + + /* skip leading spaces matching the behaviour of parse_line */ + while (isspace(*line)) + { + line++; + } + + if (is_update) + { + if (!check_push_update_option_flags(&line, push_update_option_flag= s)) + { + return false; + } + if (!o->pull_filter_list) + { + return true; + } + } + + for (f =3D o->pull_filter_list->head; f; f =3D f->next) + { + if (f->type =3D=3D PUF_TYPE_ACCEPT && strncmp(line, f->pattern, f-= >size) =3D=3D 0) + { + msg(D_LOW, "Pushed option accepted by filter: '%s'", line); + return true; + } + else if (f->type =3D=3D PUF_TYPE_IGNORE && strncmp(line, f->patter= n, f->size) =3D=3D 0) + { + msg(D_PUSH, "Pushed option removed by filter: '%s'", line); + return true; + } + else if (f->type =3D=3D PUF_TYPE_REJECT && strncmp(line, f->patter= n, f->size) =3D=3D 0) + { + if (is_update && (*push_update_option_flags & PUSH_OPT_OPTIONA= L)) + { + msg(D_PUSH, "Pushed option removed by filter: '%s'", line); + return true; + } + else + { + msg(M_WARN, "Pushed option rejected by filter: '%s'. Resta= rting.", line); + return false; + } + } + } + return true; +} diff --git a/src/openvpn/options_util.h b/src/openvpn/options_util.h index 29bc9dc..0825bfa 100644 --- a/src/openvpn/options_util.h +++ b/src/openvpn/options_util.h @@ -30,4 +30,18 @@ const char * parse_auth_failed_temp(struct options *o, const char *reason); =20 +/** + * Filter an option line by all pull filters. + * + * If a match is found, the line is modified depending on + * the filter type, and returns true. If the filter type is + * reject, SIGUSR1 is triggered and the return value is false. + * In that case the caller must end the push processing. + */ +bool +apply_pull_filter(const struct options *o, + char *line, + bool is_update, + unsigned int *push_update_option_flags); + #endif diff --git a/src/openvpn/push.c b/src/openvpn/push.c index 6c06374..71a0372 100644 --- a/src/openvpn/push.c +++ b/src/openvpn/push.c @@ -39,8 +39,6 @@ #include "ssl_util.h" #include "options_util.h" -static char push_reply_cmd[] =3D "PUSH_REPLY"; - /* * Auth username/password * @@ -519,21 +517,31 @@ { msg(D_PUSH_ERRORS, "WARNING: Received bad push/pull message: %s", = sanitize_control_message(BSTR(buffer), &gc)); } - else if (status =3D=3D PUSH_MSG_REPLY || status =3D=3D PUSH_MSG_CONTIN= UATION) + else if (status =3D=3D PUSH_MSG_REPLY || status =3D=3D PUSH_MSG_UPDATE= || status =3D=3D PUSH_MSG_CONTINUATION) { c->options.push_option_types_found |=3D option_types_found; /* delay bringing tun/tap up until --push parms received from remo= te */ - if (status =3D=3D PUSH_MSG_REPLY) + if (status =3D=3D PUSH_MSG_REPLY || status =3D=3D PUSH_MSG_UPDATE) { if (!options_postprocess_pull(&c->options, c->c2.es)) { goto error; } - if (!do_up(c, true, c->options.push_option_types_found)) + if (status =3D=3D PUSH_MSG_REPLY) { - msg(D_PUSH_ERRORS, "Failed to open tun/tap interface"); - goto error; + if (!do_up(c, true, c->options.push_option_types_found)) + { + msg(D_PUSH_ERRORS, "Failed to open tun/tap interface"); + goto error; + } + } + else + { + if (!option_types_found) + { + msg(M_WARN, "No option found"); + } } } event_timeout_clear(&c->c2.push_request_interval); @@ -1048,11 +1056,13 @@ md_ctx_init(c->c2.pulled_options_state, "SHA256"); c->c2.pulled_options_digest_init_done =3D true; } - if (apply_push_options(&c->options, + if (apply_push_options(c, + &c->options, buf, permission_mask, option_types_found, - c->c2.es)) + c->c2.es, + false)) { push_update_digest(c->c2.pulled_options_state, &buf_orig, &c->options); @@ -1103,6 +1113,12 @@ return process_incoming_push_reply(c, permission_mask, option_types_found, &buf); } + else if (honor_received_options + && buf_string_compare_advance(&buf, push_update_cmd)) + { + return process_incoming_push_update(c, permission_mask, + option_types_found, &buf); + } else { return PUSH_MSG_ERROR; diff --git a/src/openvpn/push.h b/src/openvpn/push.h index 4a13327..b930c6c 100644 --- a/src/openvpn/push.h +++ b/src/openvpn/push.h @@ -33,9 +33,42 @@ #define PUSH_MSG_AUTH_FAILURE 4 #define PUSH_MSG_CONTINUATION 5 #define PUSH_MSG_ALREADY_REPLIED 6 +#define PUSH_MSG_UPDATE 7 + +#define push_reply_cmd "PUSH_REPLY" +#define push_update_cmd "PUSH_UPDATE" + +/* Push-update options flags */ +#define PUSH_OPT_TO_REMOVE (1<<0) +#define PUSH_OPT_OPTIONAL (1<<1) int process_incoming_push_request(struct context *c); +/** + * @brief Handles the receiving of a push-update message and applies updat= es to the specified options. + * + * This function processes a push-update message, validating its content a= nd applying updates + * to the options specified in the message. It also handles split messages= if the complete + * message has not yet been received. + * + * @param c The context for the operation. + * @param permission_mask The permission mask specifying which options are= allowed to be pulled. + * @param option_types_found A pointer to a variable that will be filled w= ith the types of options + * found in the message. + * @param buf A buffer containing the received message. + * + * @return + * - `PUSH_MSG_UPDATE`: The message was processed successfully, and the up= dates were applied. + * - `PUSH_MSG_CONTINUATION`: The message is a fragment of a larger messag= e, and the program is + * waiting for the final part. + * - `PUSH_MSG_ERROR`: An error occurred during message processing, or the= message is invalid. + */ + +int process_incoming_push_update(struct context *c, + unsigned int permission_mask, + unsigned int *option_types_found, + struct buffer *buf); + int process_incoming_push_msg(struct context *c, const struct buffer *buffer, bool honor_received_options, diff --git a/src/openvpn/push_util.c b/src/openvpn/push_util.c new file mode 100644 index 0000000..b4d1e8b --- /dev/null +++ b/src/openvpn/push_util.c @@ -0,0 +1,44 @@ +#ifdef HAVE_CONFIG_H +#include "config.h" +#endif + +#include "push.h" + +int +process_incoming_push_update(struct context *c, + unsigned int permission_mask, + unsigned int *option_types_found, + struct buffer *buf) +{ + int ret =3D PUSH_MSG_ERROR; + const uint8_t ch =3D buf_read_u8(buf); + if (ch =3D=3D ',') + { + if (apply_push_options(c, + &c->options, + buf, + permission_mask, + option_types_found, + c->c2.es, + true)) + { + switch (c->options.push_continuation) + { + case 0: + case 1: + ret =3D PUSH_MSG_UPDATE; + break; + + case 2: + ret =3D PUSH_MSG_CONTINUATION; + break; + } + } + } + else if (ch =3D=3D '\0') + { + ret =3D PUSH_MSG_UPDATE; + } + + return ret; +} diff --git a/src/openvpn/ssl.c b/src/openvpn/ssl.c index 1f8eb1e..4b621f1 100644 --- a/src/openvpn/ssl.c +++ b/src/openvpn/ssl.c @@ -1947,6 +1947,9 @@ /* support for exit notify via control channel */ iv_proto |=3D IV_PROTO_CC_EXIT_NOTIFY; + /* support push-updates */ + iv_proto |=3D IV_PROTO_PUSH_UPDATE; + if (session->opt->pull) { /* support for receiving push_reply before sending diff --git a/src/openvpn/ssl.h b/src/openvpn/ssl.h index eea1323..53b7f2c 100644 --- a/src/openvpn/ssl.h +++ b/src/openvpn/ssl.h @@ -110,6 +110,9 @@ /** Supports the --dns option after all the incompatible changes */ #define IV_PROTO_DNS_OPTION_V2 (1<<11) +/** Supports push-update */ +#define IV_PROTO_PUSH_UPDATE (1<<12) + /* Default field in X509 to be username */ #define X509_USERNAME_FIELD_DEFAULT "CN" diff --git a/tests/unit_tests/openvpn/Makefile.am b/tests/unit_tests/openvp= n/Makefile.am index a4e6235..ac2241e 100644 --- a/tests/unit_tests/openvpn/Makefile.am +++ b/tests/unit_tests/openvpn/Makefile.am @@ -11,7 +11,7 @@ endif test_binaries +=3D crypto_testdriver packet_id_testdriver auth_token_testd= river ncp_testdriver misc_testdriver \ - pkt_testdriver ssl_testdriver user_pass_testdriver + pkt_testdriver ssl_testdriver user_pass_testdriver push_update_msg_testdr= iver if HAVE_LD_WRAP_SUPPORT if !WIN32 @@ -307,3 +307,21 @@ $(top_srcdir)/src/openvpn/win32-util.c \ $(top_srcdir)/src/openvpn/platform.c \ $(top_srcdir)/src/openvpn/list.c + +push_update_msg_testdriver_CFLAGS =3D -I$(top_srcdir)/src/openvpn \ + -I$(top_srcdir)/src/compat \ + -I$(top_srcdir)/tests/unit_tests/openvpn \ + @TEST_CFLAGS@ + +push_update_msg_testdriver_LDFLAGS =3D \ + @TEST_LDFLAGS@ \ + -L$(top_srcdir)/src/openvpn + +push_update_msg_testdriver_SOURCES =3D test_push_update_msg.c \ + mock_msg.c \ + mock_get_random.c \ + $(top_srcdir)/src/openvpn/buffer.c \ + $(top_srcdir)/src/openvpn/platform.c \ + $(top_srcdir)/src/openvpn/push_util.c \ + $(top_srcdir)/src/openvpn/options_util.c \ + $(top_srcdir)/src/openvpn/otime.c \ No newline at end of file diff --git a/tests/unit_tests/openvpn/test_push_update_msg.c b/tests/unit_t= ests/openvpn/test_push_update_msg.c new file mode 100644 index 0000000..d0876bc --- /dev/null +++ b/tests/unit_tests/openvpn/test_push_update_msg.c @@ -0,0 +1,245 @@ +#ifdef HAVE_CONFIG_H +#include "config.h" +#endif + +#include +#include +#include +#include +#include "push.h" +#include "options_util.h" + +/* mocks */ + +unsigned int +pull_permission_mask(const struct context *c) +{ + unsigned int flags =3D + OPT_P_UP + | OPT_P_ROUTE_EXTRAS + | OPT_P_SOCKBUF + | OPT_P_SOCKFLAGS + | OPT_P_SETENV + | OPT_P_SHAPER + | OPT_P_TIMER + | OPT_P_COMP + | OPT_P_PERSIST + | OPT_P_MESSAGES + | OPT_P_EXPLICIT_NOTIFY + | OPT_P_ECHO + | OPT_P_PULL_MODE + | OPT_P_PEER_ID + | OPT_P_NCP + | OPT_P_PUSH_MTU + | OPT_P_ROUTE + | OPT_P_DHCPDNS; + return flags; +} + +bool +apply_push_options(struct context *c, + struct options *options, + struct buffer *buf, + unsigned int permission_mask, + unsigned int *option_types_found, + struct env_set *es, + bool is_update) +{ + char line[OPTION_PARM_SIZE]; + + while (buf_parse(buf, ',', line, sizeof(line))) + { + unsigned int push_update_option_flags =3D 0; + + if (!apply_pull_filter(options, line, is_update, &push_update_opti= on_flags)) + { + msg(M_WARN, "Offending option received from server"); + return false; + } + /* + * No need to test also the application part here + * (add_option/remove_option/update_option) + */ + } + return true; +} + +int +process_incoming_push_msg(struct context *c, + const struct buffer *buffer, + bool honor_received_options, + unsigned int permission_mask, + unsigned int *option_types_found) +{ + struct buffer buf =3D *buffer; + + if (buf_string_compare_advance(&buf, "PUSH_REQUEST")) + { + return PUSH_MSG_REQUEST; + } + else if (honor_received_options + && buf_string_compare_advance(&buf, push_reply_cmd)) + { + return PUSH_MSG_REPLY; + } + else if (honor_received_options + && buf_string_compare_advance(&buf, push_update_cmd)) + { + return process_incoming_push_update(c, permission_mask, + option_types_found, &buf); + } + else + { + return PUSH_MSG_ERROR; + } +} + +/* tests */ + +static void +test_incoming_push_message_basic(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATE,dhcp-option DNS 8.8.8.8, route= 0.0.0.0 0.0.0.0 10.10.10.1"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_UPDATE); + + free_buf(&buf); +} + +static void +test_incoming_push_message_error1(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATEerr,dhcp-option DNS 8.8.8.8"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_ERROR); + + free_buf(&buf); +} + + +static void +test_incoming_push_message_error2(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATE ,dhcp-option DNS 8.8.8.8"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_ERROR); + + free_buf(&buf); +} + +static void +test_incoming_push_message_1(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATE, -?dns, route something, ?dhcp= -option DNS 8.8.8.8"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_UPDATE); + + free_buf(&buf); +} + +static void +test_incoming_push_message_bad_format(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATE, -dhcp-option, ?-dns"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_ERROR); + + free_buf(&buf); +} + +static void +test_incoming_push_message_not_updatable_option(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATE, dev tun"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_ERROR); + + free_buf(&buf); +} + +static void +test_incoming_push_message_mix(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATE,-dhcp-option, route 10.10.10.0= , dhcp-option DNS 1.1.1.1, route 10.11.12.0, dhcp-option DOMAIN corp.local,= keepalive 10 60"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_UPDATE); + + free_buf(&buf); +} + +static void +test_incoming_push_message_mix2(void **state) +{ + struct context *c =3D *state; + struct buffer buf =3D alloc_buf(256); + const char *update_msg =3D "PUSH_UPDATE,-dhcp-option,dhcp-option DNS 8= .8.8.8,redirect-gateway local,route 192.168.1.0 255.255.255.0"; + buf_write(&buf, update_msg, strlen(update_msg)); + unsigned int option_types_found =3D 0; + + assert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, p= ull_permission_mask(c), &option_types_found), PUSH_MSG_UPDATE); + + free_buf(&buf); +} + +static int +setup(void **state) +{ + struct context *c =3D calloc(1, sizeof(struct context)); + c->options.pull =3D true; + c->options.route_nopull =3D false; + *state =3D c; + return 0; +} + +static int +teardown(void **state) +{ + struct context *c =3D *state; + free(c); + return 0; +} + +int +main(void) +{ + const struct CMUnitTest tests[] =3D { + cmocka_unit_test_setup_teardown(test_incoming_push_message_basic, = setup, teardown), + cmocka_unit_test_setup_teardown(test_incoming_push_message_error1,= setup, teardown), + cmocka_unit_test_setup_teardown(test_incoming_push_message_error2,= setup, teardown), + cmocka_unit_test_setup_teardown(test_incoming_push_message_not_upd= atable_option, setup, teardown), + cmocka_unit_test_setup_teardown(test_incoming_push_message_1, setu= p, teardown), + cmocka_unit_test_setup_teardown(test_incoming_push_message_bad_for= mat, setup, teardown), + cmocka_unit_test_setup_teardown(test_incoming_push_message_mix, se= tup, teardown), + cmocka_unit_test_setup_teardown(test_incoming_push_message_mix2, s= etup, teardown) + }; + + return cmocka_run_group_tests(tests, NULL, NULL); +} -- To view, visit http://gerrit.openvpn.net/c/openvpn/+/808?usp=3Demail To unsubscribe, or for help writing mail filters, visit http://gerrit.openv= pn.net/settings Gerrit-Project: openvpn Gerrit-Branch: master Gerrit-Change-Id: I6ecd4cb47571cc8c20e46de8595c742aeec6064a Gerrit-Change-Number: 808 Gerrit-PatchSet: 5 Gerrit-Owner: mrbff Gerrit-Reviewer: flichtenheld Gerrit-Reviewer: plaisthos Gerrit-CC: openvpn-devel Gerrit-CC: stipa Gerrit-Attention: plaisthos Gerrit-Attention: flichtenheld Gerrit-Attention: mrbff Gerrit-MessageType: newpatchset --JWkatHQLLDs= Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

Attention is currently required from: flichtenheld, mrbff, plaisthos. <= /p>

mrbff uploaded patch set #5 to this change.

View Change

The following approvals got outdated and were removed: Code-Review-1 by flichtenheld

PUSH_UPDATE: Allow OpenVPN in client mode to =
receive and handle PUSH UPDATE control messages to allow options updating a=
t runtime.

* Added IV_PROTO_PUSH_UPDATE flag bit to support push-upd= ates.
* Added process_incoming_push_update(), in a separate file to crea= te tests more easily.
* Modified incoming_push_message(), process_incomi= ng_push_msg(), apply_push_options(),
apply_pull_filter() to process al= so push-update messages.
* Added the check_push_update_option_flags() fu= nction used in apply_pull_filter() to
check options formatting inside = push-update messages, if the options are updatables
and to check for &= #39;?' and '-' flags that may be present in front of the option= s.
The '-' flag is used to indicate that the option in questio= n should be removed,
while the '?' indicates that the option i= s optional and to do not generate
errors if the client cannot update t= hat option.
For more info you can read the RFC at https://github.com/O= penVPN/openvpn-rfc .
* Created some unit tests for the push-update messa= ge handling in test_push_update_msg.c.

Change-Id: I6ecd4cb47571cc8c2= 0e46de8595c742aeec6064a
Signed-off-by: Marco Baffo <marco@...2726...&= gt;
---
M CMakeLists.txt
M src/openvpn/Makefile.am
M src/openvp= n/forward.c
M src/openvpn/init.c
M src/openvpn/options.c
M src/ope= nvpn/options.h
M src/openvpn/options_util.c
M src/openvpn/options_uti= l.h
M src/openvpn/push.c
M src/openvpn/push.h
A src/openvpn/push_u= til.c
M src/openvpn/ssl.c
M src/openvpn/ssl.h
M tests/unit_tests/o= penvpn/Makefile.am
A tests/unit_tests/openvpn/test_push_update_msg.c
= 15 files changed, 645 insertions(+), 112 deletions(-)

git pull ss=
h://gerrit.openvpn.net:29418/openvpn refs/changes/08/808/5
diff --=
git a/CMakeLists.txt b/CMakeLists.txt
index 5db207d..d9daea= e 100644
--- a/CMakeLists.txt
+++ b/CMakeLi= sts.txt
@@ -496,6 +496,7 @@
src/openvp= n/ps.c
src/openvpn/ps.h
src/openv= pn/push.c
+ src/op= envpn/push_util.c
src/openvpn/push.h
= src/openvpn/pushlist.h
src/openvpn/reflect_filter.= c
@@ -612,6 +613,7 @@
"test_p= rovider"
"test_ssl"
"test_user_pass"
+ "test_push_update_msg"
= )

if (WIN32)
@@ -808,6 +810,16 @@
src/openvpn/run_command.c
)

+ target_sources(test_push_update_msg PRIVATE
+ tests/unit_tests= /openvpn/mock_msg.c
+= tests/unit_tests/openvpn/mock_get_random.c
+ src/openvpn/buffer.c
+ src/openvpn/platform.c
= + src/openvpn/push_util.c
+ src/openvpn/opti= ons_util.c
+ src/= openvpn/otime.c
+ = )
+
if (TARGET test_argv)

target_link_options(= test_argv PRIVATE -Wl,--wrap=3Dparse_line)
target_= sources(test_argv PRIVATE
diff --git a/src/openvpn/Makefile= .am b/src/openvpn/Makefile.am
index ecb2bcf..55ec565 100644=
--- a/src/openvpn/Makefile.am
+++ b/src/op= envpn/Makefile.am
@@ -114,7 +114,7 @@
pro= to.c proto.h \
proxy.c proxy.h \
ps.c p= s.h \
- push.c push.h \=
+ push.c push_util.c= push.h \
pushlist.h \
reflect_filter.c= reflect_filter.h \
reliable.c reliable.h \
diff --git a/src/openvpn/forward.c b/src/openvpn/forward.c

index d50b24c..2c75953 100644

--- a/src/openvpn/forward.= c
+++ b/src/openvpn/forward.c
@@ -2031,7 +2= 031,7 @@
}

/* c= heck for incoming control messages on the control channel like
- * push request/reply, or auth= entication failure and 2FA messages */
+ * push request/reply/update, or authentication fail= ure and 2FA messages */
if (tls_test_payload_len(c->= ;c2.tls_multi) > 0)
{
chec= k_incoming_control_channel(c);
diff --git a/src/openvpn/ini= t.c b/src/openvpn/init.c
index 9371024..f8d9d06 100644
--- a/src/openvpn/init.c
+++ b/src/openvpn/init= .c
@@ -2030,8 +2030,8 @@
/* possib= ly add routes */
if ((route_order(c->c1.tuntap)= =3D=3D ROUTE_AFTER_TUN) && (!c->options.route_delay_defined))
{
- int status =3D do_route(&c->options, c->c1.route_= list, c->c1.route_ipv6_list,
- c->c1.tuntap, c->plugins,= c->c2.es, &c->net_ctx);
+ bool status =3D do_route(&c->options, c-&= gt;c1.route_list, c->c1.route_ipv6_list,
+ c->c1.tuntap,= c->plugins, c->c2.es, &c->net_ctx);
= *error_flags |=3D (status ? 0 : ISC_ROUTE_ERRORS);
= }

diff --git a/src/openvpn/options.c= b/src/openvpn/options.c
index 043b240..6f97fcd 100644
--- a/src/openvpn/options.c
+++ b/src/openvpn/o= ptions.c
@@ -63,6 +63,7 @@
#include <ct= ype.h>

#include "memdbg.h"<= /span>
+#include "optio= ns_util.h"

const char title_string[= ] =3D
PACKAGE_STRING
@@ -927,24 +928,6= @@
}
}

<= span style=3D"color: hsl(0, 100%, 40%);">-struct pull_filter

-{

-#define PUF_TYPE_UNDEF 0 /**< undefined filter ty= pe */
-#define PUF_TYPE= _ACCEPT 1 /**< filter type to accept a matching option */
<= span style=3D"color: hsl(0, 100%, 40%);">-#define PUF_TYPE_IGNORE 2 /**&= lt; filter type to ignore a matching option */

-#define PUF_TYPE_REJECT 3 /**< filter type t= o reject and trigger SIGUSR1 */
- int type;
- int size;
- ch= ar *pattern;
- struc= t pull_filter *next;
-}= ;
-
-struct pull_filter_list
-{
- struct pull_filter *head;
- struct pull_filter *tail;
-};
-
#ifndef ENABLE_SMALL

static const char *
@@ -5469,84 +5452,6 @@
}
}

-/**
- * Filter an option line by all pull filters.
- *

- * If a match is found, the line is modified depending= on
- * the filter type= , and returns true. If the filter type is
- * reject, SIGUSR1 is triggered and the return value is= false.
- * In that cas= e the caller must end the push processing.
- */
-apply_p= ull_filter(const struct options *o, char *line)
-{
- struct pull_filter *f;
-
- if (!o= ->pull_filter_list)
= - {
- return = true;
- }
= -
- /* skip leading spaces matching the behaviour of = parse_line */
- whil= e (isspace(*line))
- = {
- line++;
- }
-
- for (f =3D o->pull_filter_list->head; f; f =3D f->= ;next)
- {- if (f->type =3D=3D P= UF_TYPE_ACCEPT && strncmp(line, f->pattern, f->size) =3D=3D 0= )
- {
= - msg(D_LOW, "Pus= hed option accepted by filter: '%s'", line);
- return true;
- }

- else if (f->type =3D=3D PUF_TYPE_IGNO= RE && strncmp(line, f->pattern, f->size) =3D=3D 0)
= - {
- msg(D_PUSH, "Pushed option= removed by filter: '%s'", line);
- *line =3D '\0';
- return true;
<= span style=3D"color: hsl(0, 100%, 40%);">- }
- else if (f->type =3D=3D PUF_TYPE= _REJECT && strncmp(line, f->pattern, f->size) =3D=3D 0)

- {
- msg(M_WARN, "Pushed op= tion rejected by filter: '%s'. Restarting.", line);
= - *line =3D '\0= 9;;
- throw_= signal_soft(SIGUSR1, "Offending option received from server");
- return false= ;
- }
= - }
- return true;
-}
-
-bool
-apply_push_options(struct options *o= ptions,

- = struct buffer *buf,
- unsigned int *option_typ= es_found,
- = struct env_set *es)
-{
- char line[O= PTION_PARM_SIZE];
- = int line_num =3D 0;
- = const char *file =3D "[PUSH-OPTIONS]";
- const int msglevel =3D D_PUSH_ERRORS|M_OPT= ERR;
-
- while (buf_parse(buf, ',',= line, sizeof(line)))
-= {
- char *p[= MAX_PARMS+1];
- = CLEAR(p);
- ++li= ne_num;
- if (!a= pply_pull_filter(options, line))
- {
- = return false; /* Cause push/pull error and stop push processing = */
- }- if (parse_line(line, p,= SIZE(p)-1, file, line_num, msglevel, &options->gc))
- {
- add_option(options, p, false, file, l= ine_num, 0, msglevel,
-= permission_mask, option_types_found, es);
= - }
- }
- return true;
-}
- void
options_server_import(struct options *o,
const char *filename,
@= @ -5680,6 +5585,44 @@
return options->forward_compa= tible ? M_WARN : msglevel;
}

<= span style=3D"color: hsl(120, 100%, 40%);">+bool

+apply_push_options(struct context *c,+ struct op= tions *options,
+ = struct buffer *buf,
+ unsigned int permission_mask,
<= span style=3D"color: hsl(120, 100%, 40%);">+ unsigned int= *option_types_found,
+ struct env_set *es,
+ bool is_update)
+{
+ char line[OPTION_PARM_SIZE];
+ int line_num =3D 0;
+ const char *file =3D "[PUSH-OPT= IONS]";
+ con= st int msglevel =3D D_PUSH_ERRORS|M_OPTERR;
+
+ while (buf_parse(buf, ',', line, sizeof(line)))
= + {
+ char *p[MAX_PARMS+1];
+ CLEAR(p);
+ ++line_num;
+ unsigned int push_update_opt= ion_flags =3D 0;
+
+ if (!apply_pul= l_filter(options, line, is_update, &push_update_option_flags))+ {
+ throw_signal_soft(SIGUSR1,= "Offending option received from server");
+ return false; /* Cause push/p= ull error and stop push processing */
+ }
+ if (parse_line(line, p, SIZE(p)-1, file, line_num, msglevel= , &options->gc))
+ {
+ = if (!is_update)
+ {
+ = add_option(options, p, false, file, line_num, 0, msglevel,

+ = permission_mask, option_types_found, es);
+ }
+ }
+ }
+ r= eturn true;
+}=
+
static v= oid
set_user_script(struct options *options,
const char **script,
diff --git a/src/o= penvpn/options.h b/src/openvpn/options.h
index 6ab92e2..b4d= 486f 100644
--- a/src/openvpn/options.h
+++= b/src/openvpn/options.h
@@ -777,6 +777,33 @@
#define MAN_CLIENT_AUTH_ENABLED(opt) (false)
#endif

+/*
+ * some PUSH_UPDATE o= ptions
+ */+#define OPT_P_U_ROUTE = (1<<0)
+#def= ine OPT_P_U_ROUTE6 (1<<1)
+#define OPT_P_U_DNS (1<<2)+#define OPT_P_U_DHCP = (1<<3)
+#def= ine OPT_P_U_REDIR_GATEWAY (1<<4)
+
+struct pull_filter
= +{
+#define PUF_TYPE_= UNDEF 0 /** undefined filter type */
+#define PUF_TYPE_ACCEPT 1 /** filter type to accept= a matching option */
+#define PUF_TYPE_IGNORE 2 /** filter type to ignore a matching option = */
+#define PUF_TYPE_= REJECT 3 /** filter type to reject and trigger SIGUSR1 */
+ int type;

+ int size;
+ char *pattern;
+ struct pull_filter *next;
+};
+
+struct pull_filter_list
+{
+ struct p= ull_filter *head;
+ = struct pull_filter *tail;
+};
+ void parse_argv(struct options *options,
= const int argc,
char *argv[],
@@ -845,11 +872,13 @@

void p= re_connect_restore(struct options *o, struct gc_arena *gc);

-bool apply_push_opt= ions(struct options *options,
+bool apply_push_options(struct context *c,
+ struct options *o= ptions,
struct buffer *buf,=
unsigned int permission_mask,
= unsigned int *option_types_found,
= - struct e= nv_set *es);
+ = struct env_set *es,
+ bool is_update);
=
void options_detach(struct options *o);
=
diff --git a/src/openvpn/options_util.c b/src/openvpn/opti= ons_util.c
index a9e020a..405f023 100644
--= - a/src/openvpn/options_util.c
+++ b/src/openvpn/options_ut= il.c
@@ -30,6 +30,8 @@

#= include "options_util.h"

+#include "push.h"
+

const char *
parse_auth_failed_temp(struct options *o, const char *reason= )
{
@@ -98,3 +100,174 @@
= gc_free(&gc);
return message;
= }
+
+static const char *updatable_options= [] =3D {
+ "b= lock-ipv6",
+ = "block-outside-dns",
+ "dhcp-option",
+ "dns",
+ "ifconfig",
+ "ifconfig-ipv6",
+ "push-continuation",
+ "redirect-ga= teway",
+ &qu= ot;redirect-private",
+ "route",
+ "route-gateway",
+ "route-ipv6",
+ "route-metric",
+ "topology",
= + "tun-mtu",

+ "keepalive"=
+};
+
+/**
+ * @brief Checks the formatting and validity of options inside push-upd= ate messages.
+ *
+ * This function is use= d in `apply_pull_filter()` to validate and process options
+ * in push-update messages. It perfo= rms the following checks:
+ * - Determines if the options are updatable.
+ * - Checks for the presence of the `-` f= lag, which indicates that the option
+ * should be removed.
+ * - Checks for the `?` flag, which marks the option a= s optional and suppresses
+ * errors if the client cannot update it.
+ * - Modifies the original string (`*line`) b= y removing the `'-'` and `'?'` flags
+ * after validating them and updating t= he appropriate flags in the `flags` variable.
+ * - `-?option`, `-option`, `?option` are valid f= ormats, `?-option` is not a valid format.
+ *
+ * @param line A pointer to an option string. This string is the optio= n being validated.
+ = * @param flags A pointer where flags will be stored:
+ * - `PUSH_OPT_TO_REMOVE`: S= et if the `-` flag is present.
+ * - `PUSH_OPT_OPTIONAL`: Set if the `?` flag is pr= esent.
+ *
= + * @return true if the flags a= nd option combination are valid.
+ * @return false if:
+ * - The `-` and `?` flags are not formatted correctl= y.
+ * - The = `line` parameter is empty or `NULL`.
+ * - The `?` flag is absent and the option is not = updatable.
+ */
+static bool
+check_push_update_option_flags(ch= ar **line, unsigned int *flags)

+{
+ if= (!line || !*line || !**line)
+ {
+ = return false;
+ = }
+ *flags =3D 0= ;
+ bool opt_is_up= datable =3D false;
+ = char *str =3D *line;
+ char c =3D **line;
+
+ if (c = =3D=3D '-')
+= {
+ if (!(= str)[1])
+ {
+ return fa= lse;
+ }
+ *flags |=3D PUSH_= OPT_TO_REMOVE;
+ = c =3D *(++(str));
= + }
+ if (c =3D= =3D '?')
+ = {
+ if (!(str= )[1] || (str)[1] =3D=3D '-')
+ {
+ return false;
+ }
+ c =3D *(++(str));
+ }
+
+ /= * Skip '?' and '-' if they are present */
+ size_t len =3D strlen(str);
+ memmove(*line, str, l= en);
+ (*line)[len= ] =3D '\0';
+= str =3D *line;
+<= /span>
+ int count =3D si= zeof(updatable_options)/sizeof(char *);
+ for (int i =3D 0; i < count; ++i)
+ {

+ size_t opt_len =3D strlen(updatable_opti= ons[i]);
+ if = (len < opt_len)
+ = {
+ = continue;
+ }=
+ if (!strncm= p(str, updatable_options[i], opt_len)
+ && (!str[opt_len] || str[opt_len] =3D= =3D ' '))
+ = {
+ = opt_is_updatable =3D true;
+ break;
+ }
+ = }
+
+ if (!opt_is_updatable)
= + {
+ if (*flags & PUSH_OPT_OPTIONAL)<= /span>
+ {
= + msg(D_PUSH, "= Pushed option is not updatable: '%s'", *line);
+ return true;

= + }
+ else
+ {
+ msg(M_WARN, "Pushed option is not updata= ble: '%s'. Restarting.", *line);
+ return false;
+ }
+ }
+
+ retur= n true;
+}
= +
+bool
+apply_pull_filter(const struct options *o, char *line, bool is_u= pdate, unsigned int *push_update_option_flags)
+{
+ struct pull_filter *f;
+
+ = if (!o->pull_filter_list && !(is_update))
+ {
+ return true;
+ }
+
+ /* skip = leading spaces matching the behaviour of parse_line */
+ while (isspace(*line))
+ {

+ line++;
+ }
+
+ if (i= s_update)
+ {
+ if (!check_push_= update_option_flags(&line, push_update_option_flags))
+ {
+ return false;
+ }
+ if (!o->pull_filter_list)
+ {

+ return true;
+ }
+ }
+
+ for= (f =3D o->pull_filter_list->head; f; f =3D f->next)
+ {

+ if (f->type =3D=3D PUF_TYPE_ACCEPT &= amp;& strncmp(line, f->pattern, f->size) =3D=3D 0)
+ {

+ msg(D_LOW, "Pushed option a= ccepted by filter: '%s'", line);
+ return true;
+ }
+ else if (f->type =3D=3D PUF_TYPE_IGNORE &am= p;& strncmp(line, f->pattern, f->size) =3D=3D 0)
+ {
+ msg(D_PUSH, "Pushed option re= moved by filter: '%s'", line);
+ return true;
+ }
+ else if (f->type =3D=3D PUF_TYPE_REJECT &= & strncmp(line, f->pattern, f->size) =3D=3D 0)
+ {
+ if (is_update && (*push_upda= te_option_flags & PUSH_OPT_OPTIONAL))
+ {
+ msg(D_PUSH, "Pushed option removed by = filter: '%s'", line);
+ return true;
+ }
+ else
+ {
+ msg(M_WARN, "Pushed option rejected by filter= : '%s'. Restarting.", line);
+ return false;
+ }
+ }
+ }
+ return true;
= +}
diff --git a/src/openvpn/options_util.h b/src/openvpn/op= tions_util.h
index 29bc9dc..0825bfa 100644
= --- a/src/openvpn/options_util.h
+++ b/src/openvpn/options_= util.h
@@ -30,4 +30,18 @@
const char *
parse_auth_failed_temp(struct options *o, const char *reason)= ;

+= /**
+ * Filter an opt= ion line by all pull filters.
+ *
+ * If a= match is found, the line is modified depending on
+ * the filter type, and returns true. If the= filter type is
+ * r= eject, SIGUSR1 is triggered and the return value is false.
+ * In that case the caller must end = the push processing.
= + */
+bool
= +apply_pull_filter(const struct= options *o,
+ = char *line,
+ unsigned int *push_update_option_flags);=
+
#= endif
diff --git a/src/openvpn/push.c b/src/openvpn/push.c<= /span>
index 6c06374..71a0372 100644
--- a/src/ope= nvpn/push.c
+++ b/src/openvpn/push.c
@@ -39= ,8 +39,6 @@
#include "ssl_util.h"
#include "options_util.h"


-static char push_reply_cmd[] =3D "P= USH_REPLY";
-
/*
* Auth username/password
= *
@@ -519,21 +517,31 @@
{
= msg(D_PUSH_ERRORS, "WARNING: Received bad push/pull mes= sage: %s", sanitize_control_message(BSTR(buffer), &gc)); }
- else= if (status =3D=3D PUSH_MSG_REPLY || status =3D=3D PUSH_MSG_CONTINUATION)
+ else if (status = =3D=3D PUSH_MSG_REPLY || status =3D=3D PUSH_MSG_UPDATE || status =3D=3D PUS= H_MSG_CONTINUATION)
{
c->o= ptions.push_option_types_found |=3D option_types_found;

/* delay bringing tun/tap up until --push parms rec= eived from remote */
- = if (status =3D=3D PUSH_MSG_REPLY)
+ if (status =3D=3D PUSH_MSG_REPLY || status =3D= =3D PUSH_MSG_UPDATE)
{
= if (!options_postprocess_pull(&c->options, c->c2.es)) {
goto error; }
= - if (!do_up(c, true, c->options.push_option_types_found))
+ if (status= =3D=3D PUSH_MSG_REPLY)
{
- msg(D_PUSH_ERRORS, "F= ailed to open tun/tap interface");
- goto error;
+ if (!do_up(c, true, c->options= .push_option_types_found))
+ {
+ msg(D_PUSH_ERRORS, "Failed to open tun/tap in= terface");
+ = goto error;
+ }
+ }
+= else
+ = {
+ = if (!option_types_found)
+ {
+ msg(M_WARN, "No option found");
+ }
}
}
= event_timeout_clear(&c->c2.push_request_interval);
@@ -1048,11 +1056,13 @@

md_ctx_init(c->c2= .pulled_options_state, "SHA256");
c-= >c2.pulled_options_digest_init_done =3D true;
}=
- if (apply_pus= h_options(&c->options,
+ if (apply_push_options(c,
+ &c->options,<= /span>
buf,
= permission_mask,
= option_types_found,
- c->c2.es))
+ c->= ;c2.es,
+ = false))
{
= push_update_digest(c->c2.pulled_options_state, &buf_orig,
&c->options);@@ -1103,6 +1113,12 @@
return process_inco= ming_push_reply(c, permission_mask,
= option_types_found, &buf);
}<= /span>
+ else if (honor_r= eceived_options
+ = && buf_string_compare_advance(&buf, push_update_cmd))<= /span>
+ {
+ return process_incoming_pu= sh_update(c, permission_mask,

+ option_types_found, &= amp;buf);
+ }
else
{
retur= n PUSH_MSG_ERROR;
diff --git a/src/openvpn/push.h b/src/ope= nvpn/push.h
index 4a13327..b930c6c 100644
-= -- a/src/openvpn/push.h
+++ b/src/openvpn/push.h
= @@ -33,9 +33,42 @@
#define PUSH_MSG_AUTH_FAILURE = 4
#define PUSH_MSG_CONTINUATION 5
#d= efine PUSH_MSG_ALREADY_REPLIED 6
+#define PUSH_MSG_UPDATE 7
+
+#define push_reply_cmd "PUSH_REPLY"
+#define push_update_cmd "PUSH_UPD= ATE"
++/* Push-update options flags = */
+#define PUSH_OPT_= TO_REMOVE (1<<0)
+/**
+ * @brief Handles the receiving of a = push-update message and applies updates to the specified options.+ *
+ * This function processes a push-update messa= ge, validating its content and applying updates
+ * to the options specified in the message. It = also handles split messages if the complete
+ * message has not yet been received.
+ *

+ * @param c The context for the operation.<= br>+ * @param permission_mask T= he permission mask specifying which options are allowed to be pulled.
+ * @param option_types_fo= und A pointer to a variable that will be filled with the types of options
+ * = found in the message.
+ * @param buf A buffer containing the received message.+ *
+ * @return
+ * - `PUSH_MSG_UPDATE`: The message was processed succe= ssfully, and the updates were applied.
+ * - `PUSH_MSG_CONTINUATION`: The message is a fragment = of a larger message, and the program is
+ * waiting for the final par= t.
+ * - `PUSH_MSG_ER= ROR`: An error occurred during message processing, or the message is invali= d.
+ */
+

+int process_incoming_push_update(struct context *c,<= /span>
+ = unsigned int permission_mask,
+ unsigned int *optio= n_types_found,
+ = struct buffer *buf);
+
int process_incoming_push_ms= g(struct context *c,
const s= truct buffer *buffer,
bool h= onor_received_options,
diff --git a/src/openvpn/push_util.c= b/src/openvpn/push_util.c
new file mode 100644
<= span>index 0000000..b4d1e8b

--- /dev/null
+= ++ b/src/openvpn/push_util.c
@@ -0,0 +1,44 @@
+#ifdef HAVE_CONFIG_H

+#include "config.h"
+#endif
+

+#include "push.h"
+
+int
+proces= s_incoming_push_update(struct context *c,
+ unsigned int permission_= mask,
+ = unsigned int *option_types_found,
+ struct buffer *bu= f)
+{
+ int ret =3D PUSH_MSG_ERROR;
+ const uint8_t ch = =3D buf_read_u8(buf);
+ if (ch =3D=3D ',')
+ {
+ = if (apply_push_options(c,
+ &c->options,
<= span style=3D"color: hsl(120, 100%, 40%);">+ = buf,

+ = permission_mask,
+ option_types_found,
<= span style=3D"color: hsl(120, 100%, 40%);">+ = c->c2.es,

+ = true))
+ {
= + switch (c->options.push_continuation)
+ {
+ case 0:
+ case 1:
+ ret =3D PUSH_MSG_= UPDATE;
+ = break;
+
+ case 2:<= /span>
+ = ret =3D PUSH_MSG_CONTINUATION;
+ break;
+ }
+ }
+ }
+ else if = (ch =3D=3D '\0')
+ {
+ r= et =3D PUSH_MSG_UPDATE;
+ }
++ return ret;
+}

diff --git a/sr= c/openvpn/ssl.c b/src/openvpn/ssl.c
index 1f8eb1e..4b621f1 = 100644
--- a/src/openvpn/ssl.c
+++ b/src/op= envpn/ssl.c
@@ -1947,6 +1947,9 @@
= /* support for exit notify via control channel */
= iv_proto |=3D IV_PROTO_CC_EXIT_NOTIFY;

+ /* support push-updates */
+ iv_proto |=3D I= V_PROTO_PUSH_UPDATE;
= +
if (session->opt->pull)
= {
/* support for receiving push_reply b= efore sending
diff --git a/src/openvpn/ssl.h b/src/openvpn/= ssl.h
index eea1323..53b7f2c 100644
--- a/s= rc/openvpn/ssl.h
+++ b/src/openvpn/ssl.h
@@= -110,6 +110,9 @@
/** Supports the --dns option after all = the incompatible changes */
#define IV_PROTO_DNS_OPTION_V2= (1<<11)

+/** Supports push-update */
+#define IV_PROTO_PUSH_UPDATE (1<<12)
+
/* Defa= ult field in X509 to be username */
#define X509_USERNAME_= FIELD_DEFAULT "CN"

diff --git a= /tests/unit_tests/openvpn/Makefile.am b/tests/unit_tests/openvpn/Makefile.a= m
index a4e6235..ac2241e 100644
--- a/tests= /unit_tests/openvpn/Makefile.am
+++ b/tests/unit_tests/open= vpn/Makefile.am
@@ -11,7 +11,7 @@
endif

test_binaries +=3D crypto_testdriver packe= t_id_testdriver auth_token_testdriver ncp_testdriver misc_testdriver \
- pkt_testdriver ssl_testdr= iver user_pass_testdriver
+ pkt_testdriver ssl_testdriver user_pass_testdriver push_update_msg_t= estdriver

if HAVE_LD_WRAP_SUPPORT=
if !WIN32
@@ -307,3 +307,21 @@
= $(top_srcdir)/src/openvpn/win32-util.c \
$(top_srcdir)/s= rc/openvpn/platform.c \
$(top_srcdir)/src/openvpn/list.c<= /span>
+
+push_update_msg_testdriver_CFLAGS =3D -= I$(top_srcdir)/src/openvpn \
+ -I$(top_srcdir)/src/compat \
+ -I$(top_srcdir)/tests/unit_tests/openvpn \
+ @TEST_CFLAGS@

+
+push_update_msg_testdriver_LDFLAGS =3D \
+ @TEST_LDFLAGS@ \

+ -L$(top_srcdir)/src/openvpn+
+push_update_msg_testdriver_SOURCES =3D test_pus= h_update_msg.c \
+ mo= ck_msg.c \
+ mock_get= _random.c \
+ $(top_s= rcdir)/src/openvpn/buffer.c \
+ $(top_srcdir)/src/openvpn/platform.c \
+ $(top_srcdir)/src/openvpn/push_util.c \
+ $(top_srcdir)/src/openv= pn/options_util.c \
+= $(top_srcdir)/src/openvpn/otime.c
\ No newline at end of f= ile
diff --git a/tests/unit_tests/openvpn/test_push_update_= msg.c b/tests/unit_tests/openvpn/test_push_update_msg.c
new= file mode 100644
index 0000000..d0876bc
--= - /dev/null
+++ b/tests/unit_tests/openvpn/test_push_update= _msg.c
@@ -0,0 +1,245 @@
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <stdlib.h>
+#include <stdarg.h>
+#include <setjmp.h>
+#include <cmocka.h>
+#include "push.h"
+#include "options_util.h"
+
+/* mocks */
+
+unsigned int
+pul= l_permission_mask(const struct context *c)
+{
+ unsigned int flags =3D
+ OPT_P_UP
+ | OPT_P_ROUTE_EXTRAS
+ | OPT_P_SOCKBUF
+ | OPT_P_SOCKFLAGS
+ | OPT_P_SETENV
+ | OPT_P_SHAPER
+ | OPT_P_TIMER
+ | OPT_P_COMP
+ | OPT_P_PERSIST
+ | OPT_P_MESSAGES
+ | OPT_P_EXPLICIT_NOTI= FY
+ | OPT_P_E= CHO
+ | OPT_P_= PULL_MODE
+ | = OPT_P_PEER_ID
+ = | OPT_P_NCP
+ = | OPT_P_PUSH_MTU
+ = | OPT_P_ROUTE
= + | OPT_P_DHCPDNS;
+ return flags;
+}
+
+bool

+apply_push_options(struct context *c,
= + struct opti= ons *options,
+ = struct buffer *buf,
+ unsigned int permission_mask,
+ unsigned int *= option_types_found,

+= struct env_set *es,
+ bool is_update)
+{
+ char line[OPTION_PARM_SIZE];
+
+ while (buf_parse(buf, ',', line, sizeof(line)))
+ {
+ unsigned int push_update_option= _flags =3D 0;
+
+ if (!apply_pull_f= ilter(options, line, is_update, &push_update_option_flags))
<= span style=3D"color: hsl(120, 100%, 40%);">+ {

+ msg(M_WARN, "Offending o= ption received from server");
+ return false;
+ }
+ /*
+ * No need to test also the application part here
+ * (add_option/remove_optio= n/update_option)

+ = */
+ }
+ return true;+}
+
+int
+proces= s_incoming_push_msg(struct context *c,
+ const struct buffer *buffer,
+ = bool honor_received_options,
+ unsigned int permission_mask,
+ = unsigned int *option_types_found)
+{
+ = struct buffer buf =3D *buffer;
+
+ if = (buf_string_compare_advance(&buf, "PUSH_REQUEST"))
= + {
+ return PUSH_MSG_REQUEST;
<= span style=3D"color: hsl(120, 100%, 40%);">+ }

+ else if (honor_received_options+ && buf_s= tring_compare_advance(&buf, push_reply_cmd))
+ {
+ return PUSH_MSG_REPLY;
+ }
+ else if (honor_received_options
+ && buf_string_compare_adva= nce(&buf, push_update_cmd))
+ {
+ = return process_incoming_push_update(c, permission_mask,
+ = option_types_found, &buf);

+ }
+ else
+ = {
+ return PU= SH_MSG_ERROR;
+ }<= /span>
+}
+
+/* tests */
+
+static vo= id
+test_incoming_pus= h_message_basic(void **state)
+{
+ stru= ct context *c =3D *state;
+ struct buffer buf =3D alloc_buf(256);
+ const char *update_msg =3D "PUSH_UPDAT= E,dhcp-option DNS 8.8.8.8, route 0.0.0.0 0.0.0.0 10.10.10.1";+ buf_write(&buf, upda= te_msg, strlen(update_msg));
+ unsigned int option_types_found =3D 0;
+
+ assert_int_equal(process_incoming_push_msg(c, &buf, = c->options.pull, pull_permission_mask(c), &option_types_found), PUSH= _MSG_UPDATE);
+
+ free_buf(&buf);
+}
+
+static void
+test_incoming_push_message_error1(void **state)
+{
+ struct context *c =3D *state;
+ struct buffer buf =3D alloc_buf(256);=
+ const char *upd= ate_msg =3D "PUSH_UPDATEerr,dhcp-option DNS 8.8.8.8";
<= span style=3D"color: hsl(120, 100%, 40%);">+ buf_write(&buf, update_= msg, strlen(update_msg));

+ unsigned int option_types_found =3D 0;
+
+ assert_int_equal(process_incoming_push_msg(c, &buf, c->= ;options.pull, pull_permission_mask(c), &option_types_found), PUSH_MSG_= ERROR);
+
<= span style=3D"color: hsl(120, 100%, 40%);">+ free_buf(&buf);
<= br>+}
+
+
+static v= oid
+test_incoming_pu= sh_message_error2(void **state)
+{
+ st= ruct context *c =3D *state;
+ struct buffer buf =3D alloc_buf(256);
+ const char *update_msg =3D "PUSH_UPD= ATE ,dhcp-option DNS 8.8.8.8";
+ buf_write(&buf, update_msg, strlen(update_msg));
+ unsigned int optio= n_types_found =3D 0;
= +
+ assert_int_equ= al(process_incoming_push_msg(c, &buf, c->options.pull, pull_permissi= on_mask(c), &option_types_found), PUSH_MSG_ERROR);
+
+ free_buf(&buf);
+}
+
+static void
+test_incoming_push_messag= e_1(void **state)
+{<= /span>
+ struct context *= c =3D *state;
+ st= ruct buffer buf =3D alloc_buf(256);
+ const char *update_msg =3D "PUSH_UPDATE, -?dns, ro= ute something, ?dhcp-option DNS 8.8.8.8";
+ buf_write(&buf, update_msg, strlen(updat= e_msg));
+ unsigne= d int option_types_found =3D 0;
+
+ ass= ert_int_equal(process_incoming_push_msg(c, &buf, c->options.pull, pu= ll_permission_mask(c), &option_types_found), PUSH_MSG_UPDATE);+
+ free_buf(&buf);
+}
+
+sta= tic void
+test_incomi= ng_push_message_bad_format(void **state)
+{
+ struct buffer buf =3D alloc_buf(256);
+ const char *update_msg =3D "= ;PUSH_UPDATE, -dhcp-option, ?-dns";
+ buf_write(&buf, update_msg, strlen(update_msg)= );
+ unsigned int = option_types_found =3D 0;
+
+ assert_in= t_equal(process_incoming_push_msg(c, &buf, c->options.pull, pull_per= mission_mask(c), &option_types_found), PUSH_MSG_ERROR);
+

+ free_buf(&buf);
+}
+
+static void<= /span>
+test_incoming_push_m= essage_not_updatable_option(void **state)
+{
+ struct context *c =3D *state;
+ struct buffer buf =3D alloc_buf(256);
+ const char *update_msg =3D &quo= t;PUSH_UPDATE, dev tun";

+ buf_write(&buf, update_msg, strlen(update_msg));+ unsigned int option_type= s_found =3D 0;
+
+ assert_int_equal(pro= cess_incoming_push_msg(c, &buf, c->options.pull, pull_permission_mas= k(c), &option_types_found), PUSH_MSG_ERROR);
+
+ free_buf(&buf);
+}
+
+static void
<= span style=3D"color: hsl(120, 100%, 40%);">+test_incoming_push_message_mix(= void **state)

+{
+ struct context *c = =3D *state;
+ stru= ct buffer buf =3D alloc_buf(256);
+ const char *update_msg =3D "PUSH_UPDATE,-dhcp-option= , route 10.10.10.0, dhcp-option DNS 1.1.1.1, route 10.11.12.0, dhcp-option = DOMAIN corp.local, keepalive 10 60";
+ buf_write(&buf, update_msg, strlen(update_msg= ));
+ unsigned int= option_types_found =3D 0;
+
+ assert_i= nt_equal(process_incoming_push_msg(c, &buf, c->options.pull, pull_pe= rmission_mask(c), &option_types_found), PUSH_MSG_UPDATE);
+

+ free_buf(&buf);
+}
+
+static voi= d
+test_incoming_push= _message_mix2(void **state)
+{
+ struct= context *c =3D *state;
+ struct buffer buf =3D alloc_buf(256);
+ const char *update_msg =3D "PUSH_UPDATE,= -dhcp-option,dhcp-option DNS 8.8.8.8,redirect-gateway local,route 192.168.1= .0 255.255.255.0";
+ buf_write(&buf, update_msg, strlen(update_msg));
+ unsigned int option_types_foun= d =3D 0;

+
= + assert_int_equal(process_i= ncoming_push_msg(c, &buf, c->options.pull, pull_permission_mask(c), = &option_types_found), PUSH_MSG_UPDATE);
+
+ free_buf(&buf);
+}
++static int
+setup(void **state)
+{
+ struct context *c =3D calloc(1, sizeof(struct conte= xt));
+ c->opti= ons.pull =3D true;
+ = c->options.route_nopull =3D false;
+ *state =3D c;
+ return 0;
+}
+
+static int
+teardown(void **state)

= +{
+ struct context *c =3D *state;
+ free(c);

+ return 0;
+}
+
+int
+main(void)
+{

+ const struct CMUnitTest tests[] =3D {
= + cmocka_unit_test_setup= _teardown(test_incoming_push_message_basic, setup, teardown),
+ cmocka_unit_test_setup_te= ardown(test_incoming_push_message_error1, setup, teardown),

+ cmocka_unit_test_setup_tear= down(test_incoming_push_message_error2, setup, teardown),

+ cmocka_unit_test_setup_teardo= wn(test_incoming_push_message_not_updatable_option, setup, teardown),
+ cmocka_unit_test_= setup_teardown(test_incoming_push_message_1, setup, teardown),
+ cmocka_unit_test_setup_t= eardown(test_incoming_push_message_bad_format, setup, teardown),

= + cmocka_unit_test_setup= _teardown(test_incoming_push_message_mix, setup, teardown),
+ cmocka_unit_test_setup_tear= down(test_incoming_push_message_mix2, setup, teardown)

+ };
+
+}

= To view, visit change 808. To unsubscribe, or for help writing mail filters, vis= it settings.

Gerrit-Project: openvpn
Gerrit-Branch: master
Gerrit-Change-Id: I6ecd4cb47571cc8c20e46de8595= c742aeec6064a
Gerrit-Change-Number: 808
Gerrit-PatchSet: 5
Gerrit-Owner: mrbff <marco@...2726...> <= /div>
Gerrit-Reviewer: flichtenheld <frank@...2716...= 1...>
Gerrit-Reviewer: plaisthos <arne-openvpn@...1186...= .1227...>
Gerrit-CC: openvpn-devel <openvpn-devel@...1484...= ts.sourceforge.net>
Gerrit-CC: stipa <lstipakov@...277...> <= /div>
Gerrit-Attention: plaisthos <arne-openvpn@...220...= ..1227...>
Gerrit-Attention: flichtenheld <frank@...2375...= 41...>
Gerrit-Attention: mrbff <marco@...2726...&g= t;
Gerrit-MessageType: newpatchset
--JWkatHQLLDs=--