3 * Routines for extcap external capture
4 * Copyright 2013, Mike Ryan <mikeryan@lacklustre.net>
6 * Wireshark - Network traffic analyzer
7 * By Gerald Combs <gerald@wireshark.org>
8 * Copyright 1998 Gerald Combs
10 * SPDX-License-Identifier: GPL-2.0-or-later
24 /* Include for unlink */
28 #ifdef HAVE_SYS_TYPES_H
29 #include <sys/types.h>
31 #ifdef HAVE_SYS_WAIT_H
38 #include <epan/prefs.h>
40 #include "ui/iface_toolbar.h"
42 #include <wsutil/glib-compat.h>
43 #include <wsutil/file_util.h>
44 #include <wsutil/filesystem.h>
45 #include <wsutil/ws_pipe.h>
46 #include <wsutil/tempfile.h>
48 #include "capture_opts.h"
51 #include "extcap_parser.h"
54 static HANDLE pipe_h = INVALID_HANDLE_VALUE;
57 static void extcap_child_watch_cb(GPid pid, gint status, gpointer user_data);
59 /* internal container, for all the extcap executables that have been found.
60 * Will be resetted if extcap_clear_interfaces() is being explicitly called
61 * and is being used for printing information about all extcap interfaces found,
62 * as well as storing all sub-interfaces
64 static GHashTable * _loaded_interfaces = NULL;
66 /* Internal container, which maps each ifname to the tool providing it, for faster
67 * lookup. The key and string value are owned by this table.
69 static GHashTable * _tool_for_ifname = NULL;
71 /* internal container, for all the extcap executables that have been found
72 * and that provides a toolbar with controls to be added to a Interface Toolbar
74 static GHashTable *_toolbars = NULL;
76 /* internal container, to map preference names to pointers that hold preference
77 * values. These ensure that preferences can survive extcap if garbage
78 * collection, and does not lead to dangling pointers in the prefs subsystem.
80 static GHashTable *extcap_prefs_dynamic_vals = NULL;
82 typedef struct _extcap_callback_info_t
89 } extcap_callback_info_t;
91 /* Callback definition for extcap_foreach */
92 typedef gboolean(*extcap_cb_t)(extcap_callback_info_t info_structure);
94 static void extcap_load_interface_list(void);
97 extcap_loaded_interfaces(void)
99 if (prefs.capture_no_extcap)
102 if ( !_loaded_interfaces || g_hash_table_size(_loaded_interfaces) == 0 )
103 extcap_load_interface_list();
105 return _loaded_interfaces;
109 extcap_clear_interfaces(void)
111 if ( _loaded_interfaces )
112 g_hash_table_destroy(_loaded_interfaces);
113 _loaded_interfaces = NULL;
115 if ( _tool_for_ifname )
116 g_hash_table_destroy(_tool_for_ifname);
117 _tool_for_ifname = NULL;
120 guint extcap_count(void)
122 const char *dirname = get_extcap_dir();
128 if ((dir = g_dir_open(dirname, 0, NULL)) != NULL)
130 GString *extcap_path = NULL;
133 extcap_path = g_string_new("");
134 while ((file = g_dir_read_name(dir)) != NULL)
136 /* full path to extcap binary */
137 g_string_printf(extcap_path, "%s" G_DIR_SEPARATOR_S "%s", dirname, file);
138 /* treat anything executable as an extcap binary */
139 if (g_file_test(extcap_path->str, G_FILE_TEST_IS_REGULAR) &&
140 g_file_test(extcap_path->str, G_FILE_TEST_IS_EXECUTABLE))
147 g_string_free(extcap_path, TRUE);
153 extcap_if_exists(const gchar *ifname)
155 if (!ifname || !_tool_for_ifname)
160 if (g_hash_table_lookup(_tool_for_ifname, ifname))
168 static extcap_interface *
169 extcap_find_interface_for_ifname(const gchar *ifname)
171 extcap_interface * result = NULL;
173 if ( !ifname || ! _tool_for_ifname || ! _loaded_interfaces )
176 gchar * extcap_util = (gchar *)g_hash_table_lookup(_tool_for_ifname, ifname);
180 extcap_info * element = (extcap_info *)g_hash_table_lookup(_loaded_interfaces, extcap_util);
184 GList * walker = element->interfaces;
185 while ( walker && walker->data && ! result )
187 extcap_interface * interface = (extcap_interface *)walker->data;
188 if ( g_strcmp0(interface->call, ifname) == 0 )
194 walker = g_list_next ( walker );
201 extcap_free_toolbar_value(iface_toolbar_value *value)
208 g_free(value->value);
209 g_free(value->display);
214 extcap_free_toolbar_control(iface_toolbar_control *control)
221 g_free(control->display);
222 g_free(control->validation);
223 g_free(control->tooltip);
224 if (control->ctrl_type == INTERFACE_TYPE_STRING) {
225 g_free(control->default_value.string);
227 g_list_foreach(control->values, (GFunc)extcap_free_toolbar_value, NULL);
228 g_list_free(control->values);
233 extcap_free_toolbar(gpointer data)
240 iface_toolbar *toolbar = (iface_toolbar *)data;
242 g_free(toolbar->menu_title);
243 g_free(toolbar->help);
244 g_list_free_full(toolbar->ifnames, g_free);
245 g_list_foreach(toolbar->controls, (GFunc)extcap_free_toolbar_control, NULL);
246 g_list_free(toolbar->controls);
251 extcap_if_exists_for_extcap(const gchar *ifname, const gchar *extcap)
253 extcap_interface *entry = extcap_find_interface_for_ifname(ifname);
255 if (entry && strcmp(entry->extcap_path, extcap) == 0)
264 extcap_if_executable(const gchar *ifname)
266 extcap_interface *interface = extcap_find_interface_for_ifname(ifname);
267 return interface != NULL ? interface->extcap_path : NULL;
271 extcap_iface_toolbar_add(const gchar *extcap, iface_toolbar *toolbar_entry)
275 if (!extcap || !toolbar_entry)
280 toolname = g_path_get_basename(extcap);
282 if (!g_hash_table_lookup(_toolbars, toolname))
284 g_hash_table_insert(_toolbars, g_strdup(toolname), toolbar_entry);
290 /* Note: args does not need to be NULL-terminated. */
291 static gboolean extcap_foreach(GList * arguments,
292 extcap_cb_t cb, extcap_callback_info_t cb_info)
296 const char *dirname = get_extcap_dir();
300 if (arguments && (dir = g_dir_open(dirname, 0, NULL)) != NULL)
302 GString *extcap_path = NULL;
305 extcap_path = g_string_new("");
306 while (keep_going && (file = g_dir_read_name(dir)) != NULL)
308 gchar *command_output = NULL;
309 gchar ** args = (gchar **) g_malloc0(sizeof(gchar *) * (g_list_length(arguments)));
310 GList * walker = g_list_first(arguments);
314 args[cnt] = g_strdup((const gchar *)walker->data);
315 walker = g_list_next(walker);
319 /* full path to extcap binary */
320 g_string_printf(extcap_path, "%s" G_DIR_SEPARATOR_S "%s", dirname, file);
321 /* treat anything executable as an extcap binary */
322 if (g_file_test(extcap_path->str, G_FILE_TEST_IS_REGULAR) &&
323 g_file_test(extcap_path->str, G_FILE_TEST_IS_EXECUTABLE))
325 if (extcap_if_exists(cb_info.ifname) && !extcap_if_exists_for_extcap(cb_info.ifname, extcap_path->str))
330 if (ws_pipe_spawn_sync((gchar *) dirname, extcap_path->str, cnt, args, &command_output))
332 cb_info.output = command_output;
333 cb_info.extcap = extcap_path->str;
335 keep_going = cb(cb_info);
338 g_free(command_output);
343 g_string_free(extcap_path, TRUE);
349 static void extcap_free_dlt(gpointer d, gpointer user_data _U_)
356 g_free(((extcap_dlt *)d)->name);
357 g_free(((extcap_dlt *)d)->display);
361 static void extcap_free_dlts(GList *dlts)
363 g_list_foreach(dlts, extcap_free_dlt, NULL);
367 static gboolean cb_dlt(extcap_callback_info_t cb_info)
369 GList *dlts = NULL, *temp = NULL;
371 if_capabilities_t *caps;
372 GList *linktype_list = NULL;
373 data_link_info_t *data_link_info;
374 extcap_dlt *dlt_item;
376 dlts = extcap_parse_dlts(cb_info.output);
379 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap pipe %s ", cb_info.extcap);
382 * Allocate the interface capabilities structure.
384 caps = (if_capabilities_t *) g_malloc(sizeof * caps);
385 caps->can_set_rfmon = FALSE;
386 caps->timestamp_types = NULL;
390 dlt_item = (extcap_dlt *)dlts->data;
393 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
394 " DLT %d name=\"%s\" display=\"%s\" ", dlt_item->number,
395 dlt_item->name, dlt_item->display);
397 data_link_info = g_new(data_link_info_t, 1);
398 data_link_info->dlt = dlt_item->number;
399 data_link_info->name = g_strdup(dlt_item->name);
400 data_link_info->description = g_strdup(dlt_item->display);
401 linktype_list = g_list_append(linktype_list, data_link_info);
404 dlts = g_list_next(dlts);
407 /* Check to see if we built a list */
408 if (linktype_list != NULL && cb_info.data != NULL)
410 caps->data_link_types = linktype_list;
411 *(if_capabilities_t **) cb_info.data = caps;
417 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " returned no DLTs");
418 *(cb_info.err_str) = g_strdup("Extcap returned no DLTs");
423 extcap_free_dlts(temp);
429 extcap_get_if_dlts(const gchar *ifname, char **err_str)
431 GList * arguments = NULL;
432 if_capabilities_t *caps = NULL;
439 if (extcap_if_exists(ifname))
441 arguments = g_list_append(arguments, g_strdup(EXTCAP_ARGUMENT_LIST_DLTS) );
442 arguments = g_list_append(arguments, g_strdup(EXTCAP_ARGUMENT_INTERFACE) );
443 arguments = g_list_append(arguments, g_strdup(ifname) );
445 extcap_callback_info_t cb_info;
446 cb_info.data = ∩︀
447 cb_info.err_str = err_str;
448 cb_info.ifname = ifname;
450 extcap_foreach(arguments, cb_dlt, cb_info);
452 g_list_free_full(arguments, g_free);
458 static void extcap_free_interface(gpointer i)
461 extcap_interface *interface = (extcap_interface *)i;
468 g_free(interface->call);
469 g_free(interface->display);
470 g_free(interface->version);
471 g_free(interface->help);
472 g_free(interface->extcap_path);
476 static void extcap_free_interfaces(GList *interfaces)
478 if (interfaces == NULL)
483 g_list_foreach(interfaces, (GFunc)extcap_free_interface, NULL);
484 g_list_free(interfaces);
488 if_info_compare(gconstpointer a, gconstpointer b)
491 const if_info_t *if_a = (const if_info_t *)a;
492 const if_info_t *if_b = (const if_info_t *)b;
494 if ((comp = g_strcmp0(if_a->name, if_b->name)) == 0)
496 return g_strcmp0(if_a->friendly_name, if_b->friendly_name);
503 extcap_get_help_for_ifname(const char *ifname)
505 extcap_interface *interface = extcap_find_interface_for_ifname(ifname);
506 return interface != NULL ? interface->help : NULL;
510 append_extcap_interface_list(GList *list, char **err_str _U_)
512 GList *interface_list = NULL;
513 extcap_interface *data = NULL;
514 GList *ifutilkeys_head = NULL, *ifutilkeys = NULL;
516 if (prefs.capture_no_extcap)
519 /* Update the extcap interfaces and get a list of their if_infos */
520 if ( !_loaded_interfaces || g_hash_table_size(_loaded_interfaces) == 0 )
521 extcap_load_interface_list();
523 ifutilkeys_head = g_hash_table_get_keys(_loaded_interfaces);
524 ifutilkeys = ifutilkeys_head;
525 while ( ifutilkeys && ifutilkeys->data )
527 extcap_info * extinfo =
528 (extcap_info *) g_hash_table_lookup(_loaded_interfaces, (gchar *)ifutilkeys->data);
529 GList * walker = extinfo->interfaces;
530 while ( walker && walker->data )
532 interface_list = g_list_append(interface_list, walker->data);
533 walker = g_list_next(walker);
536 ifutilkeys = g_list_next(ifutilkeys);
538 g_list_free(ifutilkeys_head);
541 interface_list = g_list_sort(interface_list, if_info_compare);
543 /* Append the interfaces in that list to the list we're handed. */
544 while (interface_list != NULL)
546 GList *entry = g_list_first(interface_list);
547 data = (extcap_interface *)entry->data;
548 interface_list = g_list_delete_link(interface_list, entry);
550 if_info_t * if_info = g_new0(if_info_t, 1);
551 if_info->name = g_strdup(data->call);
552 if_info->friendly_name = g_strdup(data->display);
554 if_info->type = IF_EXTCAP;
556 if_info->extcap = g_strdup(data->extcap_path);
558 list = g_list_append(list, if_info);
565 extcap_register_preferences_callback(gpointer key, gpointer value _U_, gpointer user_data _U_)
569 arguments = extcap_get_if_configuration((gchar *)key);
570 /* Memory for prefs are external to an interface, they are part of
571 * extcap core, so the parsed arguments can be freed. */
572 extcap_free_if_configuration(arguments, TRUE);
575 void extcap_register_preferences(void)
577 if (prefs.capture_no_extcap)
580 module_t *dev_module = prefs_find_module("extcap");
587 if ( !_loaded_interfaces || g_hash_table_size(_loaded_interfaces) == 0 )
588 extcap_load_interface_list();
591 g_hash_table_foreach(_tool_for_ifname, extcap_register_preferences_callback, NULL);
595 * Releases the dynamic preference value pointers. Must not be called before
596 * prefs_cleanup since these pointers could still be in use.
598 void extcap_cleanup(void)
600 if (extcap_prefs_dynamic_vals)
601 g_hash_table_destroy(extcap_prefs_dynamic_vals);
603 if (_loaded_interfaces)
604 g_hash_table_destroy(_loaded_interfaces);
606 if (_tool_for_ifname)
607 g_hash_table_destroy(_tool_for_ifname);
611 * Obtains a pointer which can store a value for the given preference name.
612 * The preference name that can be passed to the prefs API is stored into
615 * Extcap interfaces (and their preferences) are dynamic, they can be created
616 * and destroyed at will. Thus their data structures are insufficient to pass to
617 * the preferences APIs which require pointers which are valid until the
618 * preferences are removed (at exit).
620 static gchar **extcap_prefs_dynamic_valptr(const char *name, char **pref_name)
623 if (!extcap_prefs_dynamic_vals)
625 /* Initialize table only as needed, most preferences are not dynamic */
626 extcap_prefs_dynamic_vals = g_hash_table_new_full(g_str_hash, g_str_equal,
629 if (!g_hash_table_lookup_extended(extcap_prefs_dynamic_vals, name,
630 (gpointer *)pref_name, (gpointer *)&valp))
632 /* New dynamic pref, allocate, initialize and store. */
633 valp = g_new0(gchar *, 1);
634 *pref_name = g_strdup(name);
635 g_hash_table_insert(extcap_prefs_dynamic_vals, *pref_name, valp);
640 void extcap_free_if_configuration(GList *list, gboolean free_args)
644 for (elem = g_list_first(list); elem; elem = elem->next)
646 if (elem->data != NULL)
648 sl = g_list_first((GList *)elem->data);
651 extcap_free_arg_list(sl);
663 extcap_pref_for_argument(const gchar *ifname, struct _extcap_arg *arg)
665 struct preference *pref = NULL;
667 GRegex *regex_name = g_regex_new("[-]+", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
668 GRegex *regex_ifname = g_regex_new("(?![a-zA-Z1-9_]).", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
669 if (regex_name && regex_ifname)
671 if (prefs_find_module("extcap"))
673 gchar *pref_name = g_regex_replace(regex_name, arg->call, strlen(arg->call), 0, "", (GRegexMatchFlags) 0, NULL);
674 gchar *ifname_underscore = g_regex_replace(regex_ifname, ifname, strlen(ifname), 0, "_", (GRegexMatchFlags) 0, NULL);
675 gchar *ifname_lowercase = g_ascii_strdown(ifname_underscore, -1);
676 gchar *pref_ifname = g_strconcat(ifname_lowercase, ".", pref_name, NULL);
678 pref = prefs_find_preference(prefs_find_module("extcap"), pref_ifname);
681 g_free(ifname_underscore);
682 g_free(ifname_lowercase);
688 g_regex_unref(regex_name);
692 g_regex_unref(regex_ifname);
698 static gboolean cb_preference(extcap_callback_info_t cb_info)
700 GList *arguments = NULL;
701 GList **il = (GList **) cb_info.data;
702 module_t *dev_module = NULL;
704 arguments = extcap_parse_args(cb_info.output);
706 dev_module = prefs_find_module("extcap");
710 GList *walker = arguments;
712 GRegex *regex_name = g_regex_new("[-]+", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
713 GRegex *regex_ifname = g_regex_new("(?![a-zA-Z1-9_]).", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
714 if (regex_name && regex_ifname)
716 while (walker != NULL)
718 extcap_arg *arg = (extcap_arg *)walker->data;
719 arg->device_name = g_strdup(cb_info.ifname);
723 struct preference *pref = NULL;
725 gchar *pref_name = g_regex_replace(regex_name, arg->call, strlen(arg->call), 0, "", (GRegexMatchFlags) 0, NULL);
726 gchar *ifname_underscore = g_regex_replace(regex_ifname, cb_info.ifname, strlen(cb_info.ifname), 0, "_", (GRegexMatchFlags) 0, NULL);
727 gchar *ifname_lowercase = g_ascii_strdown(ifname_underscore, -1);
728 gchar *pref_ifname = g_strconcat(ifname_lowercase, ".", pref_name, NULL);
730 if ((pref = prefs_find_preference(dev_module, pref_ifname)) == NULL)
732 char *pref_name_for_prefs;
733 char *pref_title = wmem_strdup(wmem_epan_scope(), arg->display);
735 arg->pref_valptr = extcap_prefs_dynamic_valptr(pref_ifname, &pref_name_for_prefs);
736 /* Set an initial value if any (the string will be copied at registration) */
737 if (arg->default_complex)
739 *arg->pref_valptr = arg->default_complex->_val;
742 prefs_register_string_preference(dev_module, pref_name_for_prefs,
743 pref_title, pref_title, (const char **)arg->pref_valptr);
747 /* Been here before, restore stored value */
748 if (arg->pref_valptr == NULL)
750 arg->pref_valptr = (gchar**)g_hash_table_lookup(extcap_prefs_dynamic_vals, pref_ifname);
755 g_free(ifname_underscore);
756 g_free(ifname_lowercase);
760 walker = g_list_next(walker);
765 g_regex_unref(regex_name);
769 g_regex_unref(regex_ifname);
773 *il = g_list_append(*il, arguments);
775 /* By returning false, extcap_foreach will break on first found */
780 extcap_get_if_configuration(const char *ifname)
782 GList * arguments = NULL;
784 gchar **err_str = NULL;
786 if (extcap_if_exists(ifname))
788 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap path %s",
791 arguments = g_list_append(arguments, g_strdup(EXTCAP_ARGUMENT_CONFIG) );
792 arguments = g_list_append(arguments, g_strdup(EXTCAP_ARGUMENT_INTERFACE) );
793 arguments = g_list_append(arguments, g_strdup(ifname) );
795 extcap_callback_info_t cb_info;
797 cb_info.err_str = err_str;
798 cb_info.ifname = ifname;
800 extcap_foreach(arguments, cb_preference, cb_info);
802 g_list_free_full(arguments, g_free);
809 * If is_required is FALSE: returns TRUE if the extcap interface has
810 * configurable options.
811 * If is_required is TRUE: returns TRUE when the extcap interface has
812 * configurable options that required modification. (For example, when an
813 * argument is required but empty.)
816 extcap_has_configuration(const char *ifname, gboolean is_required)
818 GList *arguments = 0;
819 GList *walker = 0, * item = 0;
821 gboolean found = FALSE;
823 arguments = extcap_get_if_configuration((const char *)(ifname));
824 walker = g_list_first(arguments);
826 while (walker != NULL && !found)
828 item = g_list_first((GList *)(walker->data));
829 while (item != NULL && !found)
831 if ((extcap_arg *)(item->data) != NULL)
833 extcap_arg *arg = (extcap_arg *)(item->data);
834 /* Should required options be present, or any kind of options */
839 else if (arg->is_required)
841 const gchar *stored = NULL;
842 const gchar *defval = NULL;
844 if (arg->pref_valptr != NULL)
846 stored = *arg->pref_valptr;
849 if (arg->default_complex != NULL && arg->default_complex->_val != NULL)
851 defval = arg->default_complex->_val;
854 if (arg->is_required)
856 /* If stored and defval is identical and the argument is required,
857 * configuration is needed */
858 if (defval && stored && g_strcmp0(stored, defval) == 0)
862 else if (!defval && (!stored || !*stored))
868 if (arg->arg_type == EXTCAP_ARG_FILESELECT)
870 if (arg->fileexists && !(file_exists(defval) || file_exists(stored)))
880 walker = walker->next;
882 extcap_free_if_configuration(arguments, TRUE);
887 static gboolean cb_verify_filter(extcap_callback_info_t cb_info)
889 extcap_filter_status *status = (extcap_filter_status *)cb_info.data;
890 size_t output_size, i;
892 output_size = strlen(cb_info.output);
893 if (output_size == 0) {
894 *status = EXTCAP_FILTER_VALID;
896 *status = EXTCAP_FILTER_INVALID;
897 for (i = 0; i < output_size; i++) {
898 if (cb_info.output[i] == '\n' || cb_info.output[i] == '\r') {
899 cb_info.output[i] = '\0';
903 *cb_info.err_str = g_strdup(cb_info.output);
910 extcap_verify_capture_filter(const char *ifname, const char *filter, gchar **err_str)
912 GList * arguments = NULL;
913 extcap_filter_status status = EXTCAP_FILTER_UNKNOWN;
915 if (extcap_if_exists(ifname))
917 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap path %s",
920 arguments = g_list_append(arguments, EXTCAP_ARGUMENT_CAPTURE_FILTER);
921 arguments = g_list_append(arguments, g_strdup(filter));
922 arguments = g_list_append(arguments, EXTCAP_ARGUMENT_INTERFACE);
923 arguments = g_list_append(arguments, g_strdup(ifname));
925 extcap_callback_info_t cb_info;
926 cb_info.data = &status;
927 cb_info.err_str = err_str;
928 cb_info.ifname = ifname;
930 extcap_foreach(arguments, cb_verify_filter, cb_info);
931 g_list_free_full(arguments, g_free);
938 extcap_has_toolbar(const char *ifname)
940 if (!iface_toolbar_use())
945 GList *toolbar_list = g_hash_table_get_values (_toolbars);
946 for (GList *walker = toolbar_list; walker; walker = walker->next)
948 iface_toolbar *toolbar = (iface_toolbar *) walker->data;
949 if (g_list_find_custom(toolbar->ifnames, ifname, (GCompareFunc) strcmp))
958 void extcap_if_cleanup(capture_options *capture_opts, gchar **errormsg)
960 interface_options *interface_opts;
963 gboolean overwrite_exitcode;
965 #define STDERR_BUFFER_SIZE 1024
967 for (icnt = 0; icnt < capture_opts->ifaces->len; icnt++)
969 interface_opts = &g_array_index(capture_opts->ifaces, interface_options,
972 /* skip native interfaces */
973 if (interface_opts->if_type != IF_EXTCAP)
978 overwrite_exitcode = FALSE;
980 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
981 "Extcap [%s] - Cleaning up fifo: %s; PID: %d", interface_opts->name,
982 interface_opts->extcap_fifo, interface_opts->extcap_pid);
984 if (interface_opts->extcap_pipe_h != INVALID_HANDLE_VALUE)
986 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
987 "Extcap [%s] - Closing pipe", interface_opts->name);
988 FlushFileBuffers(interface_opts->extcap_pipe_h);
989 DisconnectNamedPipe(interface_opts->extcap_pipe_h);
990 CloseHandle(interface_opts->extcap_pipe_h);
991 interface_opts->extcap_pipe_h = INVALID_HANDLE_VALUE;
993 if (interface_opts->extcap_control_in_h != INVALID_HANDLE_VALUE)
995 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
996 "Extcap [%s] - Closing control_in pipe", interface_opts->name);
997 FlushFileBuffers(interface_opts->extcap_control_in_h);
998 DisconnectNamedPipe(interface_opts->extcap_control_in_h);
999 CloseHandle(interface_opts->extcap_control_in_h);
1000 interface_opts->extcap_control_in_h = INVALID_HANDLE_VALUE;
1002 if (interface_opts->extcap_control_out_h != INVALID_HANDLE_VALUE)
1004 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
1005 "Extcap [%s] - Closing control_out pipe", interface_opts->name);
1006 FlushFileBuffers(interface_opts->extcap_control_out_h);
1007 DisconnectNamedPipe(interface_opts->extcap_control_out_h);
1008 CloseHandle(interface_opts->extcap_control_out_h);
1009 interface_opts->extcap_control_out_h = INVALID_HANDLE_VALUE;
1012 if (interface_opts->extcap_fifo != NULL && file_exists(interface_opts->extcap_fifo))
1014 /* the fifo will not be freed here, but with the other capture_opts in capture_sync */
1015 ws_unlink(interface_opts->extcap_fifo);
1016 interface_opts->extcap_fifo = NULL;
1018 if (interface_opts->extcap_control_in && file_exists(interface_opts->extcap_control_in))
1020 ws_unlink(interface_opts->extcap_control_in);
1021 interface_opts->extcap_control_in = NULL;
1023 if (interface_opts->extcap_control_out && file_exists(interface_opts->extcap_control_out))
1025 ws_unlink(interface_opts->extcap_control_out);
1026 interface_opts->extcap_control_out = NULL;
1029 /* Maybe the client closed and removed fifo, but ws should check if
1030 * pid should be closed */
1031 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
1032 "Extcap [%s] - Closing spawned PID: %d", interface_opts->name,
1033 interface_opts->extcap_pid);
1035 pipedata = (ws_pipe_t *) interface_opts->extcap_pipedata;
1038 if (pipedata->stderr_fd > 0 && ws_pipe_data_available(pipedata->stderr_fd))
1040 buffer = (gchar *)g_malloc0(STDERR_BUFFER_SIZE + 1);
1041 ws_read_string_from_pipe(ws_get_pipe_handle(pipedata->stderr_fd), buffer, STDERR_BUFFER_SIZE + 1);
1042 if (strlen(buffer) > 0)
1044 pipedata->stderr_msg = g_strdup_printf("%s", buffer);
1045 pipedata->exitcode = 1;
1051 /* Final child watch may not have been called */
1052 if (interface_opts->extcap_child_watch != 0)
1054 extcap_child_watch_cb(pipedata->pid, 0, capture_opts);
1055 /* it will have changed in extcap_child_watch_cb */
1056 interface_opts = &g_array_index(capture_opts->ifaces, interface_options,
1061 if (pipedata->stderr_msg != NULL)
1063 overwrite_exitcode = TRUE;
1066 if (overwrite_exitcode || pipedata->exitcode != 0)
1068 if (pipedata->stderr_msg != 0)
1070 if (*errormsg == NULL)
1072 *errormsg = g_strdup_printf("Error by extcap pipe: %s", pipedata->stderr_msg);
1076 gchar *temp = g_strconcat(*errormsg, "\nError by extcap pipe: " , pipedata->stderr_msg, NULL);
1080 g_free(pipedata->stderr_msg);
1083 pipedata->stderr_msg = NULL;
1084 pipedata->exitcode = 0;
1088 if (interface_opts->extcap_child_watch > 0)
1090 g_source_remove(interface_opts->extcap_child_watch);
1091 interface_opts->extcap_child_watch = 0;
1094 if (interface_opts->extcap_pid != WS_INVALID_PID)
1097 TerminateProcess(interface_opts->extcap_pid, 0);
1099 g_spawn_close_pid(interface_opts->extcap_pid);
1100 interface_opts->extcap_pid = WS_INVALID_PID;
1102 g_free(interface_opts->extcap_pipedata);
1103 interface_opts->extcap_pipedata = NULL;
1109 extcap_add_arg_and_remove_cb(gpointer key, gpointer value, gpointer data)
1111 GPtrArray *args = (GPtrArray *)data;
1115 g_ptr_array_add(args, g_strdup((const gchar *)key));
1119 g_ptr_array_add(args, g_strdup((const gchar *)value));
1128 void extcap_child_watch_cb(GPid pid, gint status, gpointer user_data)
1131 interface_options *interface_opts;
1132 ws_pipe_t *pipedata = NULL;
1133 capture_options *capture_opts = (capture_options *)(user_data);
1135 if (capture_opts == NULL || capture_opts->ifaces == NULL || capture_opts->ifaces->len == 0)
1140 /* Close handle to child process. */
1141 g_spawn_close_pid(pid);
1143 /* Update extcap_pid in interface options structure. */
1144 for (i = 0; i < capture_opts->ifaces->len; i++)
1146 interface_opts = &g_array_index(capture_opts->ifaces, interface_options, i);
1147 if (interface_opts->extcap_pid == pid)
1149 pipedata = (ws_pipe_t *)interface_opts->extcap_pipedata;
1150 if (pipedata != NULL)
1152 interface_opts->extcap_pid = WS_INVALID_PID;
1153 pipedata->exitcode = 0;
1155 if (WIFEXITED(status))
1157 if (WEXITSTATUS(status) != 0)
1159 pipedata->exitcode = WEXITSTATUS(status);
1164 pipedata->exitcode = G_SPAWN_ERROR_FAILED;
1169 pipedata->exitcode = status;
1172 if (status == 0 && pipedata->stderr_msg != NULL)
1174 pipedata->exitcode = 1;
1177 g_source_remove(interface_opts->extcap_child_watch);
1178 interface_opts->extcap_child_watch = 0;
1185 GPtrArray *extcap_prepare_arguments(interface_options *interface_opts)
1187 GPtrArray *result = NULL;
1189 if (interface_opts->if_type == IF_EXTCAP)
1191 result = g_ptr_array_new();
1193 #define add_arg(X) g_ptr_array_add(result, g_strdup(X))
1195 add_arg(interface_opts->extcap);
1196 add_arg(EXTCAP_ARGUMENT_RUN_CAPTURE);
1197 add_arg(EXTCAP_ARGUMENT_INTERFACE);
1198 add_arg(interface_opts->name);
1199 if (interface_opts->cfilter && strlen(interface_opts->cfilter) > 0)
1201 add_arg(EXTCAP_ARGUMENT_CAPTURE_FILTER);
1202 add_arg(interface_opts->cfilter);
1204 add_arg(EXTCAP_ARGUMENT_RUN_PIPE);
1205 add_arg(interface_opts->extcap_fifo);
1206 if (interface_opts->extcap_control_in)
1208 add_arg(EXTCAP_ARGUMENT_CONTROL_OUT);
1209 add_arg(interface_opts->extcap_control_in);
1211 if (interface_opts->extcap_control_out)
1213 add_arg(EXTCAP_ARGUMENT_CONTROL_IN);
1214 add_arg(interface_opts->extcap_control_out);
1216 if (interface_opts->extcap_args == NULL || g_hash_table_size(interface_opts->extcap_args) == 0)
1218 /* User did not perform interface configuration.
1220 * Check if there are any boolean flags that are set by default
1221 * and hence their argument should be added.
1226 arglist = extcap_get_if_configuration(interface_opts->name);
1227 for (elem = g_list_first(arglist); elem; elem = elem->next)
1230 extcap_arg *arg_iter;
1232 if (elem->data == NULL)
1237 arg_list = g_list_first((GList *)elem->data);
1238 while (arg_list != NULL)
1240 const gchar *stored = NULL;
1241 /* In case of boolflags only first element in arg_list is relevant. */
1242 arg_iter = (extcap_arg *)(arg_list->data);
1243 if (arg_iter->pref_valptr != NULL)
1245 stored = *arg_iter->pref_valptr;
1248 if (arg_iter->arg_type == EXTCAP_ARG_BOOLFLAG)
1250 if (extcap_complex_get_bool(arg_iter->default_complex))
1252 add_arg(arg_iter->call);
1254 else if (g_strcmp0(stored, "true") == 0)
1256 add_arg(arg_iter->call);
1261 if (stored && strlen(stored) > 0) {
1262 add_arg(arg_iter->call);
1267 arg_list = arg_list->next;
1271 extcap_free_if_configuration(arglist, TRUE);
1275 g_hash_table_foreach_remove(interface_opts->extcap_args, extcap_add_arg_and_remove_cb, result);
1285 /* call mkfifo for each extcap,
1286 * returns FALSE if there's an error creating a FIFO */
1288 extcap_init_interfaces(capture_options *capture_opts)
1291 interface_options *interface_opts;
1292 ws_pipe_t *pipedata;
1294 for (i = 0; i < capture_opts->ifaces->len; i++)
1296 GPtrArray *args = NULL;
1297 GPid pid = WS_INVALID_PID;
1299 interface_opts = &g_array_index(capture_opts->ifaces, interface_options, i);
1301 /* skip native interfaces */
1302 if (interface_opts->if_type != IF_EXTCAP)
1307 /* create control pipes if having toolbar */
1308 if (extcap_has_toolbar(interface_opts->name))
1310 extcap_create_pipe(interface_opts->name, &interface_opts->extcap_control_in,
1311 EXTCAP_CONTROL_IN_PREFIX, FALSE);
1313 interface_opts->extcap_control_in_h = pipe_h;
1315 extcap_create_pipe(interface_opts->name, &interface_opts->extcap_control_out,
1316 EXTCAP_CONTROL_OUT_PREFIX, FALSE);
1318 interface_opts->extcap_control_out_h = pipe_h;
1322 /* create pipe for fifo */
1323 if (!extcap_create_pipe(interface_opts->name, &interface_opts->extcap_fifo,
1324 EXTCAP_PIPE_PREFIX, TRUE))
1329 interface_opts->extcap_pipe_h = pipe_h;
1332 /* Create extcap call */
1333 args = extcap_prepare_arguments(interface_opts);
1335 pipedata = g_new0(ws_pipe_t, 1);
1337 pid = ws_pipe_spawn_async(pipedata, args);
1339 g_ptr_array_foreach(args, (GFunc)g_free, NULL);
1340 g_ptr_array_free(args, TRUE);
1342 if (pid == WS_INVALID_PID)
1348 ws_close(pipedata->stdin_fd);
1349 interface_opts->extcap_pid = pid;
1351 interface_opts->extcap_child_watch =
1352 g_child_watch_add(pid, extcap_child_watch_cb, (gpointer)capture_opts);
1355 /* On Windows, wait for extcap to connect to named pipe.
1356 * Some extcaps will present UAC screen to user.
1357 * 30 second timeout should be reasonable timeout for extcap to
1358 * connect to named pipe (including user interaction).
1359 * Wait on multiple object in case of extcap termination
1360 * without opening pipe.
1362 if (pid != WS_INVALID_PID)
1364 HANDLE pipe_handles[3];
1365 int num_pipe_handles = 1;
1366 pipe_handles[0] = interface_opts->extcap_pipe_h;
1368 if (extcap_has_toolbar(interface_opts->name))
1370 pipe_handles[1] = interface_opts->extcap_control_in_h;
1371 pipe_handles[2] = interface_opts->extcap_control_out_h;
1372 num_pipe_handles += 2;
1375 ws_pipe_wait_for_pipe(pipe_handles, num_pipe_handles, pid);
1379 interface_opts->extcap_pipedata = (gpointer) pipedata;
1386 gboolean extcap_create_pipe(const gchar *ifname, gchar **fifo, const gchar *pipe_prefix, gboolean byte_mode)
1388 gchar timestr[ 14 + 1 ];
1389 time_t current_time;
1390 gchar *pipename = NULL;
1391 SECURITY_ATTRIBUTES security;
1393 /* create pipename */
1394 current_time = time(NULL);
1396 * XXX - we trust Windows not to return a time before the Epoch here,
1397 * so we won't get a null pointer back from localtime().
1399 strftime(timestr, sizeof(timestr), "%Y%m%d%H%M%S", localtime(¤t_time));
1400 pipename = g_strconcat("\\\\.\\pipe\\", pipe_prefix, "_", ifname, "_", timestr, NULL);
1402 /* Security struct to enable Inheritable HANDLE */
1403 memset(&security, 0, sizeof(SECURITY_ATTRIBUTES));
1404 security.nLength = sizeof(SECURITY_ATTRIBUTES);
1405 security.bInheritHandle = TRUE;
1406 security.lpSecurityDescriptor = NULL;
1408 /* create a namedPipe */
1409 pipe_h = CreateNamedPipe(
1410 utf_8to16(pipename),
1411 PIPE_ACCESS_DUPLEX | FILE_FLAG_OVERLAPPED,
1412 (byte_mode ? (PIPE_TYPE_BYTE | PIPE_READMODE_BYTE | PIPE_WAIT) :
1413 (PIPE_TYPE_MESSAGE | PIPE_READMODE_MESSAGE | PIPE_WAIT)),
1418 if (pipe_h == INVALID_HANDLE_VALUE)
1420 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "\nError creating pipe => (%d)", GetLastError());
1426 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "\nWireshark Created pipe =>(%s)", pipename);
1427 *fifo = g_strdup(pipename);
1433 gboolean extcap_create_pipe(const gchar *ifname, gchar **fifo, const gchar *pipe_prefix, gboolean byte_mode _U_)
1435 gchar *temp_name = NULL;
1438 gchar *pfx = g_strconcat(pipe_prefix, "_", ifname, NULL);
1439 if ((fd = create_tempfile(&temp_name, pfx, NULL)) < 0)
1448 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
1449 "Extcap - Creating fifo: %s", temp_name);
1451 if (file_exists(temp_name))
1453 ws_unlink(temp_name);
1456 if (mkfifo(temp_name, 0600) == 0)
1458 *fifo = g_strdup(temp_name);
1465 /************* EXTCAP LOAD INTERFACE LIST ***************
1467 * The following code handles loading and reloading the interface list. It is explicitly
1468 * kept separate from the rest
1473 extcap_free_interface_info(gpointer data)
1475 extcap_info *info = (extcap_info *)data;
1477 g_free(info->basename);
1478 g_free(info->full_path);
1479 g_free(info->version);
1482 extcap_free_interfaces(info->interfaces);
1487 static extcap_info *
1488 extcap_ensure_interface(const gchar * toolname, gboolean create_if_nonexist)
1490 extcap_info * element = 0;
1492 if ( prefs.capture_no_extcap )
1498 if ( ! _loaded_interfaces )
1499 _loaded_interfaces = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, extcap_free_interface);
1501 element = (extcap_info *) g_hash_table_lookup(_loaded_interfaces, toolname );
1502 if ( ! element && create_if_nonexist )
1504 g_hash_table_insert(_loaded_interfaces, g_strdup(toolname), g_new0(extcap_info, 1));
1505 element = (extcap_info *) g_hash_table_lookup(_loaded_interfaces, toolname );
1512 extcap_get_tool_by_ifname(const gchar *ifname)
1514 if ( ifname && _tool_for_ifname )
1516 gchar * toolname = (gchar *)g_hash_table_lookup(_tool_for_ifname, ifname);
1518 return extcap_ensure_interface(toolname, FALSE);
1525 extcap_get_tool_info(const gchar * toolname)
1527 return extcap_ensure_interface(toolname, FALSE);
1530 static void remove_extcap_entry(gpointer entry, gpointer data _U_)
1532 extcap_interface *int_iter = (extcap_interface*)entry;
1534 if (int_iter->if_type == EXTCAP_SENTENCE_EXTCAP)
1535 extcap_free_interface(entry);
1538 static gboolean cb_load_interfaces(extcap_callback_info_t cb_info)
1540 GList * interfaces = NULL, * control_items = NULL, * walker = NULL;
1541 extcap_interface * int_iter = NULL;
1542 extcap_info * element = NULL;
1543 iface_toolbar * toolbar_entry = NULL;
1544 gchar * toolname = g_path_get_basename(cb_info.extcap);
1546 GList * interface_keys = g_hash_table_get_keys(_loaded_interfaces);
1548 /* Load interfaces from utility */
1549 interfaces = extcap_parse_interfaces(cb_info.output, &control_items);
1553 toolbar_entry = g_new0(iface_toolbar, 1);
1554 toolbar_entry->controls = control_items;
1557 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Loading interface list for %s ", cb_info.extcap);
1559 /* Seems, that there where no interfaces to be loaded */
1560 if ( ! interfaces || g_list_length(interfaces) == 0 )
1562 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Cannot load interfaces for %s", cb_info.extcap );
1563 /* Some utilities, androiddump for example, may actually don't present any interfaces, even
1564 * if the utility itself is present. In such a case, we return here, but do not return
1565 * FALSE, or otherwise further loading of other utilities will be stopped */
1566 g_list_free(interface_keys);
1571 /* Load or create the storage element for the tool */
1572 element = extcap_ensure_interface(toolname, TRUE);
1573 if ( element == NULL )
1575 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_ERROR, "Cannot store interface %s, maybe duplicate?", cb_info.extcap );
1576 g_list_foreach(interfaces, remove_extcap_entry, NULL);
1577 g_list_free(interfaces);
1578 g_list_free(interface_keys);
1583 walker = interfaces;
1585 while (walker != NULL)
1587 int_iter = (extcap_interface *)walker->data;
1589 if (int_iter->call != NULL)
1590 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Interface found %s\n", int_iter->call);
1592 /* Help is not necessarily stored with the interface, but rather with the version string.
1593 * As the version string allways comes in front of the interfaces, this ensures, that it get's
1594 * properly stored with the interface */
1595 if (int_iter->if_type == EXTCAP_SENTENCE_EXTCAP)
1597 if (int_iter->call != NULL)
1598 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " Extcap [%s] ", int_iter->call);
1600 /* Only initialize values if none are set. Need to check only one element here */
1601 if ( ! element->version )
1603 element->version = g_strdup(int_iter->version);
1604 element->basename = g_strdup(toolname);
1605 element->full_path = g_strdup(cb_info.extcap);
1606 element->help = g_strdup(int_iter->help);
1609 help = int_iter->help;
1612 toolbar_entry->menu_title = g_strdup(int_iter->display);
1613 toolbar_entry->help = g_strdup(int_iter->help);
1616 walker = g_list_next(walker);
1620 /* Only interface definitions will be parsed here. help is already set by the extcap element,
1621 * which makes it necessary to have version in the list before the interfaces. This is normally
1622 * the case by design, but could be changed by separating the information in extcap-base. */
1623 if ( int_iter->if_type == EXTCAP_SENTENCE_INTERFACE )
1625 if ( g_list_find(interface_keys, int_iter->call) )
1627 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_WARNING, "Extcap interface \"%s\" is already provided by \"%s\" ",
1628 int_iter->call, (gchar *)extcap_if_executable(int_iter->call));
1629 walker = g_list_next(walker);
1633 if ((int_iter->call != NULL) && (int_iter->display))
1634 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " Interface [%s] \"%s\" ", int_iter->call, int_iter->display);
1636 int_iter->extcap_path = g_strdup(cb_info.extcap);
1638 /* Only set the help, if it exists and no parsed help information is present */
1639 if ( ! int_iter->help && help )
1640 int_iter->help = g_strdup(help);
1642 element->interfaces = g_list_append(element->interfaces, int_iter);
1643 g_hash_table_insert(_tool_for_ifname, g_strdup(int_iter->call), g_strdup(toolname));
1647 if (!toolbar_entry->menu_title)
1649 toolbar_entry->menu_title = g_strdup(int_iter->display);
1651 toolbar_entry->ifnames = g_list_append(toolbar_entry->ifnames, g_strdup(int_iter->call));
1655 walker = g_list_next(walker);
1658 if (toolbar_entry && toolbar_entry->menu_title)
1660 iface_toolbar_add(toolbar_entry);
1661 extcap_iface_toolbar_add(cb_info.extcap, toolbar_entry);
1664 g_list_foreach(interfaces, remove_extcap_entry, NULL);
1665 g_list_free(interfaces);
1666 g_list_free(interface_keys);
1672 /* Handles loading of the interfaces.
1674 * A list of interfaces can be obtained by calling \ref extcap_loaded_interfaces
1677 extcap_load_interface_list(void)
1681 if (prefs.capture_no_extcap)
1686 // Remove existing interface toolbars here instead of in extcap_clear_interfaces()
1687 // to avoid flicker in shown toolbars when refreshing interfaces.
1688 GList *toolbar_list = g_hash_table_get_values (_toolbars);
1689 for (GList *walker = toolbar_list; walker; walker = walker->next)
1691 iface_toolbar *toolbar = (iface_toolbar *) walker->data;
1692 iface_toolbar_remove(toolbar->menu_title);
1694 g_hash_table_remove_all(_toolbars);
1696 _toolbars = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, extcap_free_toolbar);
1699 if (_loaded_interfaces == NULL)
1701 GList * arguments = NULL;
1703 _loaded_interfaces = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, extcap_free_interface_info);
1704 /* Cleanup lookup table */
1705 if ( _tool_for_ifname )
1707 g_hash_table_remove_all(_tool_for_ifname);
1708 _tool_for_ifname = 0;
1710 _tool_for_ifname = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, g_free);
1713 arguments = g_list_append(arguments, g_strdup(EXTCAP_ARGUMENT_LIST_INTERFACES));
1715 extcap_callback_info_t cb_info;
1716 cb_info.data = NULL;
1717 cb_info.ifname = NULL;
1718 cb_info.err_str = &error;
1720 extcap_foreach(arguments, cb_load_interfaces, cb_info);
1722 g_list_free_full(arguments, g_free);
1727 * Editor modelines - http://www.wireshark.org/tools/modelines.html
1732 * indent-tabs-mode: nil
1735 * vi: set shiftwidth=4 tabstop=8 expandtab:
1736 * :indentSize=4:tabSize=8:noTabs=true: