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 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License
12 * as published by the Free Software Foundation; either version 2
13 * of the License, or (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
36 /* Include for unlink */
40 #ifdef HAVE_SYS_TYPES_H
41 #include <sys/types.h>
43 #ifdef HAVE_SYS_WAIT_H
50 #include <epan/prefs.h>
52 #include "ui/iface_toolbar.h"
54 #include <wsutil/glib-compat.h>
55 #include <wsutil/file_util.h>
56 #include <wsutil/filesystem.h>
57 #include <wsutil/tempfile.h>
59 #include "capture_opts.h"
62 #include "extcap_parser.h"
63 #include "extcap_spawn.h"
66 static HANDLE pipe_h = NULL;
69 static void extcap_child_watch_cb(GPid pid, gint status, gpointer user_data);
71 /* internal container, for all the extcap executables that have been found.
72 * Will be resetted if extcap_clear_interfaces() is being explicitly called
73 * and is being used for printing information about all extcap interfaces found,
74 * as well as storing all sub-interfaces
76 static GHashTable * _loaded_interfaces = NULL;
78 /* Internal container, which maps each ifname to the tool providing it, for faster
79 * lookup. The key and string value are owned by this table.
81 static GHashTable * _tool_for_ifname = NULL;
83 /* internal container, for all the extcap executables that have been found
84 * and that provides a toolbar with controls to be added to a Interface Toolbar
86 static GHashTable *_toolbars = NULL;
88 /* internal container, to map preference names to pointers that hold preference
89 * values. These ensure that preferences can survive extcap if garbage
90 * collection, and does not lead to dangling pointers in the prefs subsystem.
92 static GHashTable *extcap_prefs_dynamic_vals = NULL;
94 typedef struct _extcap_callback_info_t
101 } extcap_callback_info_t;
103 /* Callback definition for extcap_foreach */
104 typedef gboolean(*extcap_cb_t)(extcap_callback_info_t info_structure);
106 static void extcap_load_interface_list(void);
109 extcap_loaded_interfaces(void)
111 if ( !_loaded_interfaces || g_hash_table_size(_loaded_interfaces) == 0 )
112 extcap_load_interface_list();
114 return _loaded_interfaces;
118 extcap_clear_interfaces(void)
120 if ( _loaded_interfaces )
121 g_hash_table_destroy(_loaded_interfaces);
122 _loaded_interfaces = NULL;
124 if ( _tool_for_ifname )
125 g_hash_table_destroy(_tool_for_ifname);
126 _tool_for_ifname = NULL;
129 guint extcap_count(void)
131 const char *dirname = get_extcap_dir();
137 if ((dir = g_dir_open(dirname, 0, NULL)) != NULL)
139 GString *extcap_path = NULL;
142 extcap_path = g_string_new("");
143 while ((file = g_dir_read_name(dir)) != NULL)
145 /* full path to extcap binary */
146 g_string_printf(extcap_path, "%s" G_DIR_SEPARATOR_S "%s", dirname, file);
147 /* treat anything executable as an extcap binary */
148 if (g_file_test(extcap_path->str, G_FILE_TEST_IS_REGULAR) &&
149 g_file_test(extcap_path->str, G_FILE_TEST_IS_EXECUTABLE))
156 g_string_free(extcap_path, TRUE);
162 extcap_if_exists(const gchar *ifname)
164 if (!ifname || !_tool_for_ifname)
169 if (g_hash_table_lookup(_tool_for_ifname, ifname))
177 static extcap_interface *
178 extcap_find_interface_for_ifname(const gchar *ifname)
180 extcap_interface * result = NULL;
182 if ( !ifname || ! _tool_for_ifname || ! _loaded_interfaces )
185 gchar * extcap_util = (gchar *)g_hash_table_lookup(_tool_for_ifname, ifname);
189 extcap_info * element = (extcap_info *)g_hash_table_lookup(_loaded_interfaces, extcap_util);
193 GList * walker = element->interfaces;
194 while ( walker && walker->data && ! result )
196 extcap_interface * interface = (extcap_interface *)walker->data;
197 if ( g_strcmp0(interface->call, ifname) == 0 )
203 walker = g_list_next ( walker );
210 extcap_free_toolbar_value(iface_toolbar_value *value)
217 g_free(value->value);
218 g_free(value->display);
223 extcap_free_toolbar_control(iface_toolbar_control *control)
230 g_free(control->display);
231 g_free(control->validation);
232 g_free(control->tooltip);
233 if (control->ctrl_type == INTERFACE_TYPE_STRING) {
234 g_free(control->default_value.string);
236 g_list_foreach(control->values, (GFunc)extcap_free_toolbar_value, NULL);
237 g_list_free(control->values);
242 extcap_free_toolbar(gpointer data)
249 iface_toolbar *toolbar = (iface_toolbar *)data;
251 g_free(toolbar->menu_title);
252 g_free(toolbar->help);
253 g_list_free_full(toolbar->ifnames, g_free);
254 g_list_foreach(toolbar->controls, (GFunc)extcap_free_toolbar_control, NULL);
255 g_list_free(toolbar->controls);
260 extcap_if_exists_for_extcap(const gchar *ifname, const gchar *extcap)
262 extcap_interface *entry = extcap_find_interface_for_ifname(ifname);
264 if (entry && strcmp(entry->extcap_path, extcap) == 0)
273 extcap_if_executable(const gchar *ifname)
275 extcap_interface *interface = extcap_find_interface_for_ifname(ifname);
276 return interface != NULL ? interface->extcap_path : NULL;
280 extcap_iface_toolbar_add(const gchar *extcap, iface_toolbar *toolbar_entry)
284 if (!extcap || !toolbar_entry)
289 toolname = g_path_get_basename(extcap);
291 if (!g_hash_table_lookup(_toolbars, toolname))
293 g_hash_table_insert(_toolbars, g_strdup(toolname), toolbar_entry);
299 /* Note: args does not need to be NULL-terminated. */
300 static gboolean extcap_foreach(gint argc, gchar **args,
301 extcap_cb_t cb, extcap_callback_info_t cb_info)
305 const char *dirname = get_extcap_dir();
309 if ((dir = g_dir_open(dirname, 0, NULL)) != NULL)
311 GString *extcap_path = NULL;
314 extcap_path = g_string_new("");
315 while (keep_going && (file = g_dir_read_name(dir)) != NULL)
317 gchar *command_output = NULL;
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 (extcap_spawn_sync((gchar *) dirname, extcap_path->str, argc, 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)
433 if_capabilities_t *caps = NULL;
440 if (extcap_if_exists(ifname))
442 argv[0] = g_strdup(EXTCAP_ARGUMENT_LIST_DLTS);
443 argv[1] = g_strdup(EXTCAP_ARGUMENT_INTERFACE);
444 argv[2] = g_strdup(ifname);
446 extcap_callback_info_t cb_info;
447 cb_info.data = ∩︀
448 cb_info.err_str = err_str;
449 cb_info.ifname = ifname;
451 extcap_foreach(3, argv, cb_dlt, cb_info);
453 for (i = 0; i < 3; ++i)
462 static void extcap_free_interface(gpointer i)
465 extcap_interface *interface = (extcap_interface *)i;
472 g_free(interface->call);
473 g_free(interface->display);
474 g_free(interface->version);
475 g_free(interface->help);
476 g_free(interface->extcap_path);
480 static void extcap_free_interfaces(GList *interfaces)
482 if (interfaces == NULL)
487 g_list_foreach(interfaces, (GFunc)extcap_free_interface, NULL);
488 g_list_free(interfaces);
492 if_info_compare(gconstpointer a, gconstpointer b)
495 const if_info_t *if_a = (const if_info_t *)a;
496 const if_info_t *if_b = (const if_info_t *)b;
498 if ((comp = g_strcmp0(if_a->name, if_b->name)) == 0)
500 return g_strcmp0(if_a->friendly_name, if_b->friendly_name);
507 extcap_get_help_for_ifname(const char *ifname)
509 extcap_interface *interface = extcap_find_interface_for_ifname(ifname);
510 return interface != NULL ? interface->help : NULL;
514 append_extcap_interface_list(GList *list, char **err_str _U_)
516 GList *interface_list = NULL;
517 extcap_interface *data = NULL;
518 GList *ifutilkeys_head = NULL, *ifutilkeys = NULL;
520 /* Update the extcap interfaces and get a list of their if_infos */
521 if ( !_loaded_interfaces || g_hash_table_size(_loaded_interfaces) == 0 )
522 extcap_load_interface_list();
524 ifutilkeys_head = g_hash_table_get_keys(_loaded_interfaces);
525 ifutilkeys = ifutilkeys_head;
526 while ( ifutilkeys && ifutilkeys->data )
528 extcap_info * extinfo =
529 (extcap_info *) g_hash_table_lookup(_loaded_interfaces, (gchar *)ifutilkeys->data);
530 GList * walker = extinfo->interfaces;
531 while ( walker && walker->data )
533 interface_list = g_list_append(interface_list, walker->data);
534 walker = g_list_next(walker);
537 ifutilkeys = g_list_next(ifutilkeys);
539 g_list_free(ifutilkeys_head);
542 interface_list = g_list_sort(interface_list, if_info_compare);
544 /* Append the interfaces in that list to the list we're handed. */
545 while (interface_list != NULL)
547 GList *entry = g_list_first(interface_list);
548 data = (extcap_interface *)entry->data;
549 interface_list = g_list_delete_link(interface_list, entry);
551 if_info_t * if_info = g_new0(if_info_t, 1);
552 if_info->name = g_strdup(data->call);
553 if_info->friendly_name = g_strdup(data->display);
555 if_info->type = IF_EXTCAP;
557 if_info->extcap = g_strdup(data->extcap_path);
559 list = g_list_append(list, if_info);
566 extcap_register_preferences_callback(gpointer key, gpointer value _U_, gpointer user_data _U_)
570 arguments = extcap_get_if_configuration((gchar *)key);
571 /* Memory for prefs are external to an interface, they are part of
572 * extcap core, so the parsed arguments can be freed. */
573 extcap_free_if_configuration(arguments, TRUE);
576 void extcap_register_preferences(void)
578 module_t *dev_module = prefs_find_module("extcap");
585 if ( !_loaded_interfaces || g_hash_table_size(_loaded_interfaces) == 0 )
586 extcap_load_interface_list();
589 g_hash_table_foreach(_tool_for_ifname, extcap_register_preferences_callback, NULL);
593 * Releases the dynamic preference value pointers. Must not be called before
594 * prefs_cleanup since these pointers could still be in use.
596 void extcap_cleanup(void)
598 if (extcap_prefs_dynamic_vals)
599 g_hash_table_destroy(extcap_prefs_dynamic_vals);
601 if (_loaded_interfaces)
602 g_hash_table_destroy(_loaded_interfaces);
604 if (_tool_for_ifname)
605 g_hash_table_destroy(_tool_for_ifname);
608 void extcap_pref_store(extcap_arg *arg, const char *newval)
610 if (arg && arg->pref_valptr != NULL)
612 g_free(*arg->pref_valptr);
613 *arg->pref_valptr = g_strdup(newval);
619 * Obtains a pointer which can store a value for the given preference name.
620 * The preference name that can be passed to the prefs API is stored into
623 * Extcap interfaces (and their preferences) are dynamic, they can be created
624 * and destroyed at will. Thus their data structures are insufficient to pass to
625 * the preferences APIs which require pointers which are valid until the
626 * preferences are removed (at exit).
628 static gchar **extcap_prefs_dynamic_valptr(const char *name, char **pref_name)
631 if (!extcap_prefs_dynamic_vals)
633 /* Initialize table only as needed, most preferences are not dynamic */
634 extcap_prefs_dynamic_vals = g_hash_table_new_full(g_str_hash, g_str_equal,
637 if (!g_hash_table_lookup_extended(extcap_prefs_dynamic_vals, name,
638 (gpointer *)pref_name, (gpointer *)&valp))
640 /* New dynamic pref, allocate, initialize and store. */
641 valp = g_new0(gchar *, 1);
642 *pref_name = g_strdup(name);
643 g_hash_table_insert(extcap_prefs_dynamic_vals, *pref_name, valp);
648 void extcap_free_if_configuration(GList *list, gboolean free_args)
652 for (elem = g_list_first(list); elem; elem = elem->next)
654 if (elem->data != NULL)
656 sl = g_list_first((GList *)elem->data);
659 extcap_free_arg_list(sl);
671 extcap_pref_for_argument(const gchar *ifname, struct _extcap_arg *arg)
673 struct preference *pref = NULL;
675 GRegex *regex_name = g_regex_new("[-]+", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
676 GRegex *regex_ifname = g_regex_new("(?![a-zA-Z1-9_]).", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
677 if (regex_name && regex_ifname)
679 if (prefs_find_module("extcap"))
681 gchar *pref_name = g_regex_replace(regex_name, arg->call, strlen(arg->call), 0, "", (GRegexMatchFlags) 0, NULL);
682 gchar *ifname_underscore = g_regex_replace(regex_ifname, ifname, strlen(ifname), 0, "_", (GRegexMatchFlags) 0, NULL);
683 gchar *ifname_lowercase = g_ascii_strdown(ifname_underscore, -1);
684 gchar *pref_ifname = g_strconcat(ifname_lowercase, ".", pref_name, NULL);
686 pref = prefs_find_preference(prefs_find_module("extcap"), pref_ifname);
689 g_free(ifname_underscore);
690 g_free(ifname_lowercase);
696 g_regex_unref(regex_name);
700 g_regex_unref(regex_ifname);
706 static gboolean cb_preference(extcap_callback_info_t cb_info)
708 GList *arguments = NULL;
709 GList **il = (GList **) cb_info.data;
710 module_t *dev_module = NULL;
712 arguments = extcap_parse_args(cb_info.output);
714 dev_module = prefs_find_module("extcap");
718 GList *walker = arguments;
720 GRegex *regex_name = g_regex_new("[-]+", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
721 GRegex *regex_ifname = g_regex_new("(?![a-zA-Z1-9_]).", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL);
722 if (regex_name && regex_ifname)
724 while (walker != NULL)
726 extcap_arg *arg = (extcap_arg *)walker->data;
727 arg->device_name = g_strdup(cb_info.ifname);
731 struct preference *pref = NULL;
733 gchar *pref_name = g_regex_replace(regex_name, arg->call, strlen(arg->call), 0, "", (GRegexMatchFlags) 0, NULL);
734 gchar *ifname_underscore = g_regex_replace(regex_ifname, cb_info.ifname, strlen(cb_info.ifname), 0, "_", (GRegexMatchFlags) 0, NULL);
735 gchar *ifname_lowercase = g_ascii_strdown(ifname_underscore, -1);
736 gchar *pref_ifname = g_strconcat(ifname_lowercase, ".", pref_name, NULL);
738 if ((pref = prefs_find_preference(dev_module, pref_ifname)) == NULL)
740 char *pref_name_for_prefs;
741 char *pref_title = wmem_strdup(wmem_epan_scope(), arg->display);
743 arg->pref_valptr = extcap_prefs_dynamic_valptr(pref_ifname, &pref_name_for_prefs);
744 /* Set an initial value if any (the string will be copied at registration) */
745 if (arg->default_complex)
747 *arg->pref_valptr = arg->default_complex->_val;
750 prefs_register_string_preference(dev_module, pref_name_for_prefs,
751 pref_title, pref_title, (const char **)arg->pref_valptr);
755 /* Been here before, restore stored value */
756 if (arg->pref_valptr == NULL)
758 arg->pref_valptr = (gchar**)g_hash_table_lookup(extcap_prefs_dynamic_vals, pref_ifname);
763 g_free(ifname_underscore);
764 g_free(ifname_lowercase);
768 walker = g_list_next(walker);
773 g_regex_unref(regex_name);
777 g_regex_unref(regex_ifname);
781 *il = g_list_append(*il, arguments);
783 /* By returning false, extcap_foreach will break on first found */
788 extcap_get_if_configuration(const char *ifname)
792 gchar **err_str = NULL;
795 if (extcap_if_exists(ifname))
797 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap path %s",
800 argv[0] = g_strdup(EXTCAP_ARGUMENT_CONFIG);
801 argv[1] = g_strdup(EXTCAP_ARGUMENT_INTERFACE);
802 argv[2] = g_strdup(ifname);
804 extcap_callback_info_t cb_info;
806 cb_info.err_str = err_str;
807 cb_info.ifname = ifname;
809 extcap_foreach(3, argv, cb_preference, cb_info);
811 for (i = 0; i < 3; i++)
821 * If is_required is FALSE: returns TRUE if the extcap interface has
822 * configurable options.
823 * If is_required is TRUE: returns TRUE when the extcap interface has
824 * configurable options that required modification. (For example, when an
825 * argument is required but empty.)
828 extcap_has_configuration(const char *ifname, gboolean is_required)
830 GList *arguments = 0;
831 GList *walker = 0, * item = 0;
833 gboolean found = FALSE;
835 arguments = extcap_get_if_configuration((const char *)(ifname));
836 walker = g_list_first(arguments);
838 while (walker != NULL && !found)
840 item = g_list_first((GList *)(walker->data));
841 while (item != NULL && !found)
843 if ((extcap_arg *)(item->data) != NULL)
845 extcap_arg *arg = (extcap_arg *)(item->data);
846 /* Should required options be present, or any kind of options */
851 else if (arg->is_required)
853 const gchar *stored = NULL;
854 const gchar *defval = NULL;
856 if (arg->pref_valptr != NULL)
858 stored = *arg->pref_valptr;
861 if (arg->default_complex != NULL && arg->default_complex->_val != NULL)
863 defval = arg->default_complex->_val;
866 if (arg->is_required)
868 /* If stored and defval is identical and the argument is required,
869 * configuration is needed */
870 if (defval && stored && g_strcmp0(stored, defval) == 0)
874 else if (!defval && (!stored || !*stored))
880 if (arg->arg_type == EXTCAP_ARG_FILESELECT)
882 if (arg->fileexists && !(file_exists(defval) || file_exists(stored)))
892 walker = walker->next;
894 extcap_free_if_configuration(arguments, TRUE);
899 static gboolean cb_verify_filter(extcap_callback_info_t cb_info)
901 extcap_filter_status *status = (extcap_filter_status *)cb_info.data;
902 size_t output_size, i;
904 output_size = strlen(cb_info.output);
905 if (output_size == 0) {
906 *status = EXTCAP_FILTER_VALID;
908 *status = EXTCAP_FILTER_INVALID;
909 for (i = 0; i < output_size; i++) {
910 if (cb_info.output[i] == '\n' || cb_info.output[i] == '\r') {
911 cb_info.output[i] = '\0';
915 *cb_info.err_str = g_strdup(cb_info.output);
922 extcap_verify_capture_filter(const char *ifname, const char *filter, gchar **err_str)
925 extcap_filter_status status = EXTCAP_FILTER_UNKNOWN;
927 if (extcap_if_exists(ifname))
929 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap path %s",
932 argv[0] = EXTCAP_ARGUMENT_CAPTURE_FILTER;
933 argv[1] = (gchar*)filter;
934 argv[2] = EXTCAP_ARGUMENT_INTERFACE;
935 argv[3] = (gchar*)ifname;
937 extcap_callback_info_t cb_info;
938 cb_info.data = &status;
939 cb_info.err_str = err_str;
940 cb_info.ifname = ifname;
942 extcap_foreach(4, argv, cb_verify_filter, cb_info);
949 extcap_has_toolbar(const char *ifname)
951 if (!iface_toolbar_use())
956 GList *toolbar_list = g_hash_table_get_values (_toolbars);
957 for (GList *walker = toolbar_list; walker; walker = walker->next)
959 iface_toolbar *toolbar = (iface_toolbar *) walker->data;
960 if (g_list_find_custom(toolbar->ifnames, ifname, (GCompareFunc) strcmp))
969 /* taken from capchild/capture_sync.c */
970 static gboolean pipe_data_available(int pipe_fd)
972 #ifdef _WIN32 /* PeekNamedPipe */
973 HANDLE hPipe = (HANDLE) _get_osfhandle(pipe_fd);
976 if (hPipe == INVALID_HANDLE_VALUE)
981 if (! PeekNamedPipe(hPipe, NULL, 0, NULL, &bytes_avail, NULL))
993 struct timeval timeout;
996 FD_SET(pipe_fd, &rfds);
1000 if (select(pipe_fd + 1, &rfds, NULL, NULL, &timeout) > 0)
1009 void extcap_if_cleanup(capture_options *capture_opts, gchar **errormsg)
1011 interface_options interface_opts;
1012 extcap_userdata *userdata;
1014 gboolean overwrite_exitcode;
1016 #define STDERR_BUFFER_SIZE 1024
1018 for (icnt = 0; icnt < capture_opts->ifaces->len; icnt++)
1020 interface_opts = g_array_index(capture_opts->ifaces, interface_options,
1023 /* skip native interfaces */
1024 if (interface_opts.if_type != IF_EXTCAP)
1029 overwrite_exitcode = FALSE;
1031 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
1032 "Extcap [%s] - Cleaning up fifo: %s; PID: %d", interface_opts.name,
1033 interface_opts.extcap_fifo, interface_opts.extcap_pid);
1037 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
1038 "Extcap [%s] - Closing pipe", interface_opts.name);
1039 FlushFileBuffers(pipe_h);
1040 DisconnectNamedPipe(pipe_h);
1041 CloseHandle(pipe_h);
1044 if (interface_opts.extcap_fifo != NULL && file_exists(interface_opts.extcap_fifo))
1046 /* the fifo will not be freed here, but with the other capture_opts in capture_sync */
1047 ws_unlink(interface_opts.extcap_fifo);
1048 interface_opts.extcap_fifo = NULL;
1050 if (interface_opts.extcap_control_in && file_exists(interface_opts.extcap_control_in))
1052 ws_unlink(interface_opts.extcap_control_in);
1053 interface_opts.extcap_control_in = NULL;
1055 if (interface_opts.extcap_control_out && file_exists(interface_opts.extcap_control_out))
1057 ws_unlink(interface_opts.extcap_control_out);
1058 interface_opts.extcap_control_out = NULL;
1061 /* Maybe the client closed and removed fifo, but ws should check if
1062 * pid should be closed */
1063 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
1064 "Extcap [%s] - Closing spawned PID: %d", interface_opts.name,
1065 interface_opts.extcap_pid);
1067 userdata = (extcap_userdata *) interface_opts.extcap_userdata;
1070 if (userdata->extcap_stderr_rd > 0 && pipe_data_available(userdata->extcap_stderr_rd))
1072 buffer = (gchar *)g_malloc0(sizeof(gchar) * STDERR_BUFFER_SIZE + 1);
1074 win32_readfrompipe((HANDLE)_get_osfhandle(userdata->extcap_stderr_rd), STDERR_BUFFER_SIZE, buffer);
1076 if (read(userdata->extcap_stderr_rd, buffer, sizeof(gchar) * STDERR_BUFFER_SIZE) <= 0)
1081 if (strlen(buffer) > 0)
1083 userdata->extcap_stderr = g_strdup_printf("%s", buffer);
1084 userdata->exitcode = 1;
1090 /* Final child watch may not have been called */
1091 if (interface_opts.extcap_child_watch != 0)
1093 extcap_child_watch_cb(userdata->pid, 0, capture_opts);
1094 /* it will have changed in extcap_child_watch_cb */
1095 interface_opts = g_array_index(capture_opts->ifaces, interface_options,
1100 if (userdata->extcap_stderr != NULL)
1102 overwrite_exitcode = TRUE;
1105 if (overwrite_exitcode || userdata->exitcode != 0)
1107 if (userdata->extcap_stderr != 0)
1109 if (*errormsg == NULL)
1111 *errormsg = g_strdup_printf("Error by extcap pipe: %s", userdata->extcap_stderr);
1115 gchar *temp = g_strconcat(*errormsg, "\nError by extcap pipe: " , userdata->extcap_stderr, NULL);
1119 g_free(userdata->extcap_stderr);
1122 userdata->extcap_stderr = NULL;
1123 userdata->exitcode = 0;
1127 if (interface_opts.extcap_child_watch > 0)
1129 g_source_remove(interface_opts.extcap_child_watch);
1130 interface_opts.extcap_child_watch = 0;
1133 if (interface_opts.extcap_pid != INVALID_EXTCAP_PID)
1136 TerminateProcess(interface_opts.extcap_pid, 0);
1138 g_spawn_close_pid(interface_opts.extcap_pid);
1139 interface_opts.extcap_pid = INVALID_EXTCAP_PID;
1141 g_free(interface_opts.extcap_userdata);
1142 interface_opts.extcap_userdata = NULL;
1145 /* Make sure modified interface_opts is saved in capture_opts. */
1146 capture_opts->ifaces = g_array_remove_index(capture_opts->ifaces, icnt);
1147 g_array_insert_val(capture_opts->ifaces, icnt, interface_opts);
1152 extcap_add_arg_and_remove_cb(gpointer key, gpointer value, gpointer data)
1154 GPtrArray *args = (GPtrArray *)data;
1158 g_ptr_array_add(args, g_strdup((const gchar *)key));
1162 g_ptr_array_add(args, g_strdup((const gchar *)value));
1171 void extcap_child_watch_cb(GPid pid, gint status, gpointer user_data)
1174 interface_options interface_opts;
1175 extcap_userdata *userdata = NULL;
1176 capture_options *capture_opts = (capture_options *)(user_data);
1178 if (capture_opts == NULL || capture_opts->ifaces == NULL || capture_opts->ifaces->len == 0)
1183 /* Close handle to child process. */
1184 g_spawn_close_pid(pid);
1186 /* Update extcap_pid in interface options structure. */
1187 for (i = 0; i < capture_opts->ifaces->len; i++)
1189 interface_opts = g_array_index(capture_opts->ifaces, interface_options, i);
1190 if (interface_opts.extcap_pid == pid)
1192 userdata = (extcap_userdata *)interface_opts.extcap_userdata;
1193 if (userdata != NULL)
1195 interface_opts.extcap_pid = INVALID_EXTCAP_PID;
1196 userdata->exitcode = 0;
1198 if (WIFEXITED(status))
1200 if (WEXITSTATUS(status) != 0)
1202 userdata->exitcode = WEXITSTATUS(status);
1207 userdata->exitcode = G_SPAWN_ERROR_FAILED;
1212 userdata->exitcode = status;
1215 if (status == 0 && userdata->extcap_stderr != NULL)
1217 userdata->exitcode = 1;
1220 g_source_remove(interface_opts.extcap_child_watch);
1221 interface_opts.extcap_child_watch = 0;
1223 capture_opts->ifaces = g_array_remove_index(capture_opts->ifaces, i);
1224 g_array_insert_val(capture_opts->ifaces, i, interface_opts);
1231 GPtrArray *extcap_prepare_arguments(interface_options interface_opts)
1233 GPtrArray *result = NULL;
1235 if (interface_opts.if_type == IF_EXTCAP)
1237 result = g_ptr_array_new();
1239 #define add_arg(X) g_ptr_array_add(result, g_strdup(X))
1241 add_arg(interface_opts.extcap);
1242 add_arg(EXTCAP_ARGUMENT_RUN_CAPTURE);
1243 add_arg(EXTCAP_ARGUMENT_INTERFACE);
1244 add_arg(interface_opts.name);
1245 if (interface_opts.cfilter && strlen(interface_opts.cfilter) > 0)
1247 add_arg(EXTCAP_ARGUMENT_CAPTURE_FILTER);
1248 add_arg(interface_opts.cfilter);
1250 add_arg(EXTCAP_ARGUMENT_RUN_PIPE);
1251 add_arg(interface_opts.extcap_fifo);
1252 if (interface_opts.extcap_control_in)
1254 add_arg(EXTCAP_ARGUMENT_CONTROL_OUT);
1255 add_arg(interface_opts.extcap_control_in);
1257 if (interface_opts.extcap_control_out)
1259 add_arg(EXTCAP_ARGUMENT_CONTROL_IN);
1260 add_arg(interface_opts.extcap_control_out);
1262 if (interface_opts.extcap_args == NULL || g_hash_table_size(interface_opts.extcap_args) == 0)
1264 /* User did not perform interface configuration.
1266 * Check if there are any boolean flags that are set by default
1267 * and hence their argument should be added.
1272 arglist = extcap_get_if_configuration(interface_opts.name);
1273 for (elem = g_list_first(arglist); elem; elem = elem->next)
1276 extcap_arg *arg_iter;
1278 if (elem->data == NULL)
1283 arg_list = g_list_first((GList *)elem->data);
1284 while (arg_list != NULL)
1286 const gchar *stored = NULL;
1287 /* In case of boolflags only first element in arg_list is relevant. */
1288 arg_iter = (extcap_arg *)(arg_list->data);
1289 if (arg_iter->pref_valptr != NULL)
1291 stored = *arg_iter->pref_valptr;
1294 if (arg_iter->arg_type == EXTCAP_ARG_BOOLFLAG)
1296 if (extcap_complex_get_bool(arg_iter->default_complex))
1298 add_arg(arg_iter->call);
1300 else if (g_strcmp0(stored, "true") == 0)
1302 add_arg(arg_iter->call);
1308 add_arg(arg_iter->call);
1313 arg_list = arg_list->next;
1317 extcap_free_if_configuration(arglist, TRUE);
1321 g_hash_table_foreach_remove(interface_opts.extcap_args, extcap_add_arg_and_remove_cb, result);
1331 /* call mkfifo for each extcap,
1332 * returns FALSE if there's an error creating a FIFO */
1334 extcap_init_interfaces(capture_options *capture_opts)
1337 interface_options interface_opts;
1338 extcap_userdata *userdata;
1340 for (i = 0; i < capture_opts->ifaces->len; i++)
1342 GPtrArray *args = NULL;
1343 GPid pid = INVALID_EXTCAP_PID;
1345 interface_opts = g_array_index(capture_opts->ifaces, interface_options, i);
1347 /* skip native interfaces */
1348 if (interface_opts.if_type != IF_EXTCAP)
1353 /* create control pipes if having toolbar */
1354 if (extcap_has_toolbar(interface_opts.name))
1356 extcap_create_pipe(&interface_opts.extcap_control_in);
1357 extcap_create_pipe(&interface_opts.extcap_control_out);
1360 /* create pipe for fifo */
1361 if (!extcap_create_pipe(&interface_opts.extcap_fifo))
1366 /* Create extcap call */
1367 args = extcap_prepare_arguments(interface_opts);
1369 userdata = g_new0(extcap_userdata, 1);
1371 pid = extcap_spawn_async(userdata, args);
1373 g_ptr_array_foreach(args, (GFunc)g_free, NULL);
1374 g_ptr_array_free(args, TRUE);
1376 if (pid == INVALID_EXTCAP_PID)
1382 interface_opts.extcap_pid = pid;
1384 interface_opts.extcap_child_watch =
1385 g_child_watch_add(pid, extcap_child_watch_cb, (gpointer)capture_opts);
1388 /* On Windows, wait for extcap to connect to named pipe.
1389 * Some extcaps will present UAC screen to user.
1390 * 30 second timeout should be reasonable timeout for extcap to
1391 * connect to named pipe (including user interaction).
1392 * Wait on multiple object in case of extcap termination
1393 * without opening pipe.
1395 * Minimum supported version of Windows: XP / Server 2003.
1397 if (pid != INVALID_EXTCAP_PID)
1399 extcap_wait_for_pipe(pipe_h, pid);
1404 interface_opts.extcap_userdata = (gpointer) userdata;
1406 capture_opts->ifaces = g_array_remove_index(capture_opts->ifaces, i);
1407 g_array_insert_val(capture_opts->ifaces, i, interface_opts);
1414 /* called by capture_sync to get the CreatNamedPipe handle*/
1416 extcap_get_win32_handle()
1422 gboolean extcap_create_pipe(char **fifo)
1425 gchar timestr[ 14 + 1 ];
1426 time_t current_time;
1428 gchar *pipename = NULL;
1430 SECURITY_ATTRIBUTES security;
1431 /* create pipename */
1432 current_time = time(NULL);
1434 * XXX - we trust Windows not to return a time before the Epoch here,
1435 * so we won't get a null pointer back from localtime().
1437 strftime(timestr, sizeof(timestr), "%Y%m%d%H%M%S", localtime(¤t_time));
1438 pipename = g_strconcat("\\\\.\\pipe\\", EXTCAP_PIPE_PREFIX, "_", timestr, NULL);
1440 /* Security struct to enable Inheritable HANDLE */
1441 memset(&security, 0, sizeof(SECURITY_ATTRIBUTES));
1442 security.nLength = sizeof(SECURITY_ATTRIBUTES);
1443 security.bInheritHandle = TRUE;
1444 security.lpSecurityDescriptor = NULL;
1446 /* create a namedPipe*/
1447 pipe_h = CreateNamedPipe(
1448 utf_8to16(pipename),
1449 PIPE_ACCESS_DUPLEX | FILE_FLAG_OVERLAPPED,
1450 PIPE_TYPE_MESSAGE | PIPE_READMODE_MESSAGE | PIPE_WAIT,
1455 if (pipe_h == INVALID_HANDLE_VALUE)
1457 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "\nError creating pipe => (%d)", GetLastError());
1462 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "\nWireshark Created pipe =>(%s)", pipename);
1463 *fifo = g_strdup(pipename);
1466 gchar *temp_name = NULL;
1469 if ((fd = create_tempfile(&temp_name, EXTCAP_PIPE_PREFIX, NULL)) < 0)
1476 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
1477 "Extcap - Creating fifo: %s", temp_name);
1479 if (file_exists(temp_name))
1481 ws_unlink(temp_name);
1484 if (mkfifo(temp_name, 0600) == 0)
1486 *fifo = g_strdup(temp_name);
1493 /************* EXTCAP LOAD INTERFACE LIST ***************
1495 * The following code handles loading and reloading the interface list. It is explicitly
1496 * kept separate from the rest
1501 extcap_free_interface_info(gpointer data)
1503 extcap_info *info = (extcap_info *)data;
1505 g_free(info->basename);
1506 g_free(info->full_path);
1507 g_free(info->version);
1510 extcap_free_interfaces(info->interfaces);
1515 static extcap_info *
1516 extcap_ensure_interface(const gchar * toolname, gboolean create_if_nonexist)
1518 extcap_info * element = 0;
1523 if ( ! _loaded_interfaces )
1524 _loaded_interfaces = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, extcap_free_interface);
1526 element = (extcap_info *) g_hash_table_lookup(_loaded_interfaces, toolname );
1527 if ( ! element && create_if_nonexist )
1529 g_hash_table_insert(_loaded_interfaces, g_strdup(toolname), g_new0(extcap_info, 1));
1530 element = (extcap_info *) g_hash_table_lookup(_loaded_interfaces, toolname );
1537 extcap_get_tool_by_ifname(const gchar *ifname)
1539 if ( ifname && _tool_for_ifname )
1541 gchar * toolname = (gchar *)g_hash_table_lookup(_tool_for_ifname, ifname);
1543 return extcap_ensure_interface(toolname, FALSE);
1550 extcap_get_tool_info(const gchar * toolname)
1552 return extcap_ensure_interface(toolname, FALSE);
1555 static void remove_extcap_entry(gpointer entry, gpointer data _U_)
1557 extcap_interface *int_iter = (extcap_interface*)entry;
1559 if (int_iter->if_type == EXTCAP_SENTENCE_EXTCAP)
1560 extcap_free_interface(entry);
1563 static gboolean cb_load_interfaces(extcap_callback_info_t cb_info)
1565 GList * interfaces = NULL, * control_items = NULL, * walker = NULL;
1566 extcap_interface * int_iter = NULL;
1567 extcap_info * element = NULL;
1568 iface_toolbar * toolbar_entry = NULL;
1569 gchar * toolname = g_path_get_basename(cb_info.extcap);
1571 GList * interface_keys = g_hash_table_get_keys(_loaded_interfaces);
1573 /* Load interfaces from utility */
1574 interfaces = extcap_parse_interfaces(cb_info.output, &control_items);
1578 toolbar_entry = g_new0(iface_toolbar, 1);
1579 toolbar_entry->controls = control_items;
1582 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Loading interface list for %s ", cb_info.extcap);
1584 /* Seems, that there where no interfaces to be loaded */
1585 if ( ! interfaces || g_list_length(interfaces) == 0 )
1587 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Cannot load interfaces for %s", cb_info.extcap );
1588 /* Some utilities, androiddump for example, may actually don't present any interfaces, even
1589 * if the utility itself is present. In such a case, we return here, but do not return
1590 * FALSE, or otherwise further loading of other utilities will be stopped */
1591 g_list_free(interface_keys);
1596 /* Load or create the storage element for the tool */
1597 element = extcap_ensure_interface(toolname, TRUE);
1598 if ( element == NULL )
1600 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_ERROR, "Cannot store interface %s, maybe duplicate?", cb_info.extcap );
1601 g_list_foreach(interfaces, remove_extcap_entry, NULL);
1602 g_list_free(interfaces);
1603 g_list_free(interface_keys);
1608 walker = interfaces;
1610 while (walker != NULL)
1612 int_iter = (extcap_interface *)walker->data;
1614 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Interface found %s\n", int_iter->call);
1616 /* Help is not necessarily stored with the interface, but rather with the version string.
1617 * As the version string allways comes in front of the interfaces, this ensures, that it get's
1618 * properly stored with the interface */
1619 if (int_iter->if_type == EXTCAP_SENTENCE_EXTCAP)
1621 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " Extcap [%s] ", int_iter->call);
1622 /* Only initialize values if none are set. Need to check only one element here */
1623 if ( ! element->version )
1625 element->version = g_strdup(int_iter->version);
1626 element->basename = g_strdup(toolname);
1627 element->full_path = g_strdup(cb_info.extcap);
1628 element->help = g_strdup(int_iter->help);
1631 help = int_iter->help;
1634 toolbar_entry->menu_title = g_strdup(int_iter->display);
1635 toolbar_entry->help = g_strdup(int_iter->help);
1638 walker = g_list_next(walker);
1642 /* Only interface definitions will be parsed here. help is already set by the extcap element,
1643 * which makes it necessary to have version in the list before the interfaces. This is normally
1644 * the case by design, but could be changed by separating the information in extcap-base. */
1645 if ( int_iter->if_type == EXTCAP_SENTENCE_INTERFACE )
1647 if ( g_list_find(interface_keys, int_iter->call) )
1649 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_WARNING, "Extcap interface \"%s\" is already provided by \"%s\" ",
1650 int_iter->call, (gchar *)extcap_if_executable(int_iter->call));
1651 walker = g_list_next(walker);
1655 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " Interface [%s] \"%s\" ",
1656 int_iter->call, int_iter->display);
1658 int_iter->extcap_path = g_strdup(cb_info.extcap);
1660 /* Only set the help, if it exists and no parsed help information is present */
1661 if ( ! int_iter->help && help )
1662 int_iter->help = g_strdup(help);
1664 element->interfaces = g_list_append(element->interfaces, int_iter);
1665 g_hash_table_insert(_tool_for_ifname, g_strdup(int_iter->call), g_strdup(toolname));
1669 if (!toolbar_entry->menu_title)
1671 toolbar_entry->menu_title = g_strdup(int_iter->display);
1673 toolbar_entry->ifnames = g_list_append(toolbar_entry->ifnames, g_strdup(int_iter->call));
1677 walker = g_list_next(walker);
1680 if (toolbar_entry && toolbar_entry->menu_title)
1682 iface_toolbar_add(toolbar_entry);
1683 extcap_iface_toolbar_add(cb_info.extcap, toolbar_entry);
1686 g_list_foreach(interfaces, remove_extcap_entry, NULL);
1687 g_list_free(interfaces);
1688 g_list_free(interface_keys);
1694 /* Handles loading of the interfaces.
1696 * A list of interfaces can be obtained by calling \ref extcap_loaded_interfaces
1699 extcap_load_interface_list(void)
1706 // Remove existing interface toolbars here instead of in extcap_clear_interfaces()
1707 // to avoid flicker in shown toolbars when refreshing interfaces.
1708 GList *toolbar_list = g_hash_table_get_values (_toolbars);
1709 for (GList *walker = toolbar_list; walker; walker = walker->next)
1711 iface_toolbar *toolbar = (iface_toolbar *) walker->data;
1712 iface_toolbar_remove(toolbar->menu_title);
1714 g_hash_table_remove_all(_toolbars);
1716 _toolbars = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, extcap_free_toolbar);
1719 if (_loaded_interfaces == NULL)
1721 _loaded_interfaces = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, extcap_free_interface_info);
1722 /* Cleanup lookup table */
1723 if ( _tool_for_ifname )
1725 g_hash_table_remove_all(_tool_for_ifname);
1726 _tool_for_ifname = 0;
1728 _tool_for_ifname = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, g_free);
1731 argv = g_strdup(EXTCAP_ARGUMENT_LIST_INTERFACES);
1733 extcap_callback_info_t cb_info;
1734 cb_info.data = NULL;
1735 cb_info.ifname = NULL;
1736 cb_info.err_str = &error;
1738 extcap_foreach(1, &argv, cb_load_interfaces, cb_info);
1745 * Editor modelines - http://www.wireshark.org/tools/modelines.html
1750 * indent-tabs-mode: nil
1753 * vi: set shiftwidth=4 tabstop=8 expandtab:
1754 * :indentSize=4:tabSize=8:noTabs=true: