From e4ba6dbc3f1e76890b22773807ea37fe8fa2b1bc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 10 Apr 2024 22:34:10 +0200 Subject: Adding upstream version 4.2.2. Signed-off-by: Daniel Baumann --- extcap/extcap-base.h | 129 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 extcap/extcap-base.h (limited to 'extcap/extcap-base.h') diff --git a/extcap/extcap-base.h b/extcap/extcap-base.h new file mode 100644 index 0000000..4bbfb1b --- /dev/null +++ b/extcap/extcap-base.h @@ -0,0 +1,129 @@ +/** @file + * + * Base function for extcaps + * + * Copyright 2016, Dario Lombardo + * + * Wireshark - Network traffic analyzer + * By Gerald Combs + * Copyright 1998 Gerald Combs + * + * SPDX-License-Identifier: GPL-2.0-or-later + */ +#ifndef __EXTCAP_BASE_H__ +#define __EXTCAP_BASE_H__ + +#include +#include +#include +#include +#include + +#include + +#ifdef _WIN32 +#include +#endif + +#include + +#ifdef __cplusplus +extern "C" { +#endif // __cplusplus + +#define EXTCAP_BASE_OPTIONS_ENUM \ + EXTCAP_OPT_LIST_INTERFACES, \ + EXTCAP_OPT_VERSION, \ + EXTCAP_OPT_LIST_DLTS, \ + EXTCAP_OPT_INTERFACE, \ + EXTCAP_OPT_CONFIG, \ + EXTCAP_OPT_CAPTURE, \ + EXTCAP_OPT_CAPTURE_FILTER, \ + EXTCAP_OPT_FIFO, \ + EXTCAP_OPT_LOG_LEVEL, \ + EXTCAP_OPT_LOG_FILE + + +#define EXTCAP_BASE_OPTIONS \ + { "extcap-interfaces", ws_no_argument, NULL, EXTCAP_OPT_LIST_INTERFACES}, \ + { "extcap-version", ws_optional_argument, NULL, EXTCAP_OPT_VERSION}, \ + { "extcap-dlts", ws_no_argument, NULL, EXTCAP_OPT_LIST_DLTS}, \ + { "extcap-interface", ws_required_argument, NULL, EXTCAP_OPT_INTERFACE}, \ + { "extcap-config", ws_no_argument, NULL, EXTCAP_OPT_CONFIG}, \ + { "capture", ws_no_argument, NULL, EXTCAP_OPT_CAPTURE}, \ + { "extcap-capture-filter", ws_required_argument, NULL, EXTCAP_OPT_CAPTURE_FILTER}, \ + { "fifo", ws_required_argument, NULL, EXTCAP_OPT_FIFO}, \ + { "log-level", ws_required_argument, NULL, EXTCAP_OPT_LOG_LEVEL}, \ + { "log-file", ws_required_argument, NULL, EXTCAP_OPT_LOG_FILE} + +typedef struct _extcap_parameters +{ + char * exename; + char * fifo; + char * interface; + char * capture_filter; + + char * version; + char * compiled_with; + char * running_with; + char * helppage; + uint8_t capture; + uint8_t show_config; + + char * ws_version; + + /* private content */ + GList * interfaces; + uint8_t do_version; + uint8_t do_list_dlts; + uint8_t do_list_interfaces; + + char * help_header; + GList * help_options; + + bool debug; +} extcap_parameters; + +/* used to inform to extcap application that end of application is requested */ +extern bool extcap_end_application; + +void extcap_base_register_interface(extcap_parameters * extcap, const char * interface, const char * ifdescription, uint16_t dlt, const char * dltdescription ); +void extcap_base_register_interface_ext(extcap_parameters * extcap, const char * interface, const char * ifdescription, uint16_t dlt, const char * dltname, const char * dltdescription ); + +/* used to inform extcap framework that graceful shutdown supported by the extcap + */ +bool extcap_base_register_graceful_shutdown_cb(extcap_parameters * extcap, void (*callback)(void)); + +void extcap_base_set_util_info(extcap_parameters * extcap, const char * exename, const char * major, const char * minor, const char * release, const char * helppage); +void extcap_base_set_compiled_with(extcap_parameters * extcap, const char *fmt, ...); +void extcap_base_set_running_with(extcap_parameters * extcap, const char *fmt, ...); +uint8_t extcap_base_parse_options(extcap_parameters * extcap, int result, char * optargument); +uint8_t extcap_base_handle_interface(extcap_parameters * extcap); +void extcap_base_cleanup(extcap_parameters ** extcap); +void extcap_help_add_header(extcap_parameters * extcap, char * help_header); +void extcap_help_add_option(extcap_parameters * extcap, const char * help_option_name, const char * help_optionn_desc); +void extcap_version_print(extcap_parameters * extcap); +void extcap_help_print(extcap_parameters * extcap); +void extcap_cmdline_debug(char** ar, const unsigned n); +void extcap_config_debug(unsigned* count); +void extcap_base_help(void); +void extcap_log_init(const char *progname); + +#ifdef __cplusplus +} +#endif // __cplusplus + +#endif // __EXTCAP_BASE_H__ + +/* + * Editor modelines - https://www.wireshark.org/tools/modelines.html + * + * Local variables: + * c-basic-offset: 4 + * tab-width: 8 + * indent-tabs-mode: nil + * End: + * + * vi: set shiftwidth=4 tabstop=8 expandtab: + * :indentSize=4:tabSize=8:noTabs=true: + */ -- cgit v1.2.3