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 */
43 #include <epan/prefs.h>
44 #include <epan/prefs-int.h>
46 #include <wsutil/file_util.h>
47 #include <wsutil/filesystem.h>
48 #include <wsutil/tempfile.h>
50 #include "capture_opts.h"
53 #include "extcap_parser.h"
56 static HANDLE pipe_h = NULL;
59 /* internal container, for all the extcap interfaces that have been found.
60 * will be resetted by every call to extcap_interface_list() and is being
61 * used in extcap_get_if_* as well as extcap_init_interfaces to ensure,
62 * that only extcap interfaces are being given to underlying extcap programs
64 static GHashTable *ifaces = NULL;
66 /* internal container, for all the extcap executables that have been found.
67 * will be resetted by every call to extcap_interface_list() and is being
68 * used for printing information about all extcap interfaces found
70 static GHashTable *tools = NULL;
72 /* Callback definition for extcap_foreach */
73 typedef gboolean (*extcap_cb_t)(const gchar *extcap, const gchar *ifname, gchar *output, void *data,
76 /* #define ARG_DEBUG */
78 static void extcap_debug_arguments ( extcap_arg *arg_iter );
82 extcap_if_exists(const gchar *ifname)
84 if ( !ifname || !ifaces )
87 if ( g_hash_table_lookup(ifaces, ifname) )
94 extcap_if_exists_for_extcap(const gchar *ifname, const gchar *extcap)
96 gchar *entry = (gchar *)g_hash_table_lookup(ifaces, ifname);
98 if ( entry && strcmp(entry, extcap) == 0 )
105 extcap_if_executable(const gchar *ifname)
107 return (gchar *)g_hash_table_lookup(ifaces, ifname);
111 extcap_if_add(const gchar *ifname, const gchar *extcap)
113 if ( !g_hash_table_lookup(ifaces, ifname) )
114 g_hash_table_insert(ifaces, g_strdup(ifname), g_strdup(extcap));
118 extcap_free_info (gpointer data) {
119 extcap_info * info = (extcap_info *)data;
121 g_free (info->basename);
122 g_free (info->full_path);
123 g_free (info->version);
128 extcap_tool_add(const gchar *extcap, const extcap_interface *interface)
132 if ( !extcap || !interface )
135 toolname = g_path_get_basename(extcap);
137 if ( !g_hash_table_lookup(tools, toolname) ) {
138 extcap_info * store = (extcap_info *)g_new0(extcap_info, 1);
139 store->version = g_strdup(interface->version);
140 store->full_path = g_strdup(extcap);
141 store->basename = g_strdup(toolname);
143 g_hash_table_insert(tools, g_strdup(toolname), store);
149 /* Note: args does not need to be NULL-terminated. */
150 static void extcap_foreach(gint argc, gchar **args, extcap_cb_t cb,
151 void *cb_data, char **err_str, const char * ifname _U_) {
152 const char *dirname = get_extcap_dir();
159 gchar **dll_search_envp;
165 argv = (gchar **) g_malloc0(sizeof(gchar *) * (argc + 2));
169 * Make sure executables can find dependent DLLs and that they're *our*
170 * DLLs: https://msdn.microsoft.com/en-us/library/windows/desktop/ms682586.aspx
171 * Alternatively we could create a simple wrapper exe similar to Create
172 * Hidden Process (http://www.commandline.co.uk/chp/).
174 dll_search_envp = g_get_environ();
175 progfile_dir = g_strdup_printf("%s;%s", get_progfile_dir(), g_environ_getenv(dll_search_envp, "Path"));
176 dll_search_envp = g_environ_setenv(dll_search_envp, "Path", progfile_dir, TRUE);
177 g_free(progfile_dir);
180 if ((dir = g_dir_open(dirname, 0, NULL)) != NULL) {
181 GString *extcap_path = NULL;
183 extcap_path = g_string_new("");
184 while (keep_going && (file = g_dir_read_name(dir)) != NULL ) {
185 gchar *command_output = NULL;
186 gboolean status = FALSE;
187 gint exit_status = 0;
190 /* full path to extcap binary */
192 g_string_printf(extcap_path, "%s\\%s", dirname, file);
193 envp = dll_search_envp;
195 g_string_printf(extcap_path, "%s/%s", dirname, file);
197 if ( extcap_if_exists(ifname) && !extcap_if_exists_for_extcap(ifname, extcap_path->str ) )
201 argv[0] = g_strescape(extcap_path->str, NULL);
203 argv[0] = g_strdup(extcap_path->str);
205 for (i = 0; i < argc; ++i)
209 status = g_spawn_sync(dirname, argv, envp,
210 (GSpawnFlags) 0, NULL, NULL,
211 &command_output, NULL, &exit_status, NULL);
213 if (status && exit_status == 0)
214 keep_going = cb(extcap_path->str, ifname, command_output, cb_data, err_str);
217 g_free(command_output);
221 g_string_free(extcap_path, TRUE);
225 g_strfreev(dll_search_envp);
230 static gboolean dlt_cb(const gchar *extcap _U_, const gchar *ifname _U_, gchar *output, void *data,
232 extcap_token_sentence *tokens;
233 extcap_dlt *dlts, *dlt_iter, *next;
234 if_capabilities_t *caps;
235 GList *linktype_list = NULL;
236 data_link_info_t *data_link_info;
238 tokens = extcap_tokenize_sentences(output);
239 extcap_parse_dlts(tokens, &dlts);
241 extcap_free_tokenized_sentence_list(tokens);
243 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap pipe %s ", extcap);
246 * Allocate the interface capabilities structure.
248 caps = (if_capabilities_t *) g_malloc(sizeof *caps);
249 caps->can_set_rfmon = FALSE;
252 while (dlt_iter != NULL ) {
253 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
254 " DLT %d name=\"%s\" display=\"%s\" ", dlt_iter->number,
255 dlt_iter->name, dlt_iter->display);
257 data_link_info = g_new(data_link_info_t, 1);
258 data_link_info->dlt = dlt_iter->number;
259 data_link_info->name = g_strdup(dlt_iter->name);
260 data_link_info->description = g_strdup(dlt_iter->display);
261 linktype_list = g_list_append(linktype_list, data_link_info);
262 dlt_iter = dlt_iter->next_dlt;
265 /* Check to see if we built a list */
266 if (linktype_list != NULL && data != NULL) {
267 caps->data_link_types = linktype_list;
268 *(if_capabilities_t **) data = caps;
271 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " returned no DLTs");
272 *err_str = g_strdup("Extcap returned no DLTs");
278 while (dlt_iter != NULL ) {
279 next = dlt_iter->next_dlt;
280 extcap_free_dlt(dlt_iter);
288 extcap_get_if_dlts(const gchar *ifname, char **err_str) {
291 if_capabilities_t *caps = NULL;
296 if ( extcap_if_exists(ifname) )
298 argv[0] = g_strdup(EXTCAP_ARGUMENT_LIST_DLTS);
299 argv[1] = g_strdup(EXTCAP_ARGUMENT_INTERFACE);
300 argv[2] = g_strdup(ifname);
302 extcap_foreach(3, argv, dlt_cb, &caps, err_str, ifname);
304 for (i = 0; i < 3; ++i)
311 static gboolean interfaces_cb(const gchar *extcap, const gchar *ifname _U_, gchar *output, void *data,
312 char **err_str _U_) {
313 GList **il = (GList **) data;
314 extcap_token_sentence *tokens;
315 extcap_interface *interfaces, *int_iter; /*, *next; */
318 tokens = extcap_tokenize_sentences(output);
319 extcap_parse_interfaces(tokens, &interfaces);
321 extcap_free_tokenized_sentence_list(tokens);
323 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap pipe %s ", extcap);
325 int_iter = interfaces;
326 while (int_iter != NULL ) {
327 if ( int_iter->if_type == EXTCAP_SENTENCE_INTERFACE && extcap_if_exists(int_iter->call) )
329 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_WARNING, "Extcap interface \"%s\" is already provided by \"%s\" ",
330 int_iter->call, (gchar *)extcap_if_executable(int_iter->call) );
331 int_iter = int_iter->next_interface;
335 if ( int_iter->if_type == EXTCAP_SENTENCE_INTERFACE )
336 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " Interface [%s] \"%s\" ",
337 int_iter->call, int_iter->display);
338 else if ( int_iter->if_type == EXTCAP_SENTENCE_EXTCAP )
339 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, " Extcap [%s] ", int_iter->call);
341 if ( int_iter->if_type == EXTCAP_SENTENCE_INTERFACE ) {
343 if_info = g_new0(if_info_t, 1);
344 if_info->name = g_strdup(int_iter->call);
345 if_info->friendly_name = g_strdup(int_iter->display);
347 if_info->type = IF_EXTCAP;
349 if_info->extcap = g_strdup(extcap);
350 *il = g_list_append(*il, if_info);
353 extcap_if_add(int_iter->call, extcap);
356 /* Call for interfaces and tools alike. Multiple calls (because a tool has multiple
357 * interfaces) are handled internally */
358 extcap_tool_add(extcap, int_iter);
360 int_iter = int_iter->next_interface;
362 extcap_free_interface(interfaces);
368 if_info_compare(gconstpointer a, gconstpointer b)
371 const if_info_t * if_a = (const if_info_t *)a;
372 const if_info_t * if_b = (const if_info_t *)b;
374 if ( (comp = g_strcmp0(if_a->name, if_b->name)) == 0 )
375 return g_strcmp0(if_a->friendly_name, if_b->friendly_name);
381 extcap_reload_interface_list(GList **retp, char **err_str) {
387 /* ifaces is used as cache, do not destroy its contents when
388 * returning or no extcap interfaces can be queried for options */
390 ifaces = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, g_free);
392 g_hash_table_remove_all(ifaces);
395 tools = g_hash_table_new_full(g_str_hash, g_str_equal, g_free, extcap_free_info);
397 g_hash_table_remove_all(tools);
399 argv = g_strdup(EXTCAP_ARGUMENT_LIST_INTERFACES);
401 extcap_foreach(1, &argv, interfaces_cb, retp, err_str, NULL);
407 extcap_tools_list(void) {
408 if ( tools == NULL || g_hash_table_size(tools) == 0 )
409 extcap_reload_interface_list(NULL, NULL);
415 append_extcap_interface_list(GList *list, char **err_str) {
420 /* Update the extcap interfaces and get a list of their if_infos */
421 extcap_reload_interface_list(&ret, err_str);
424 ret = g_list_sort(ret, if_info_compare);
426 /* Append the interfaces in that list to the list we're handed. */
427 while (ret != NULL) {
428 entry = g_list_first(ret);
430 ret = g_list_delete_link(ret, entry);
431 list = g_list_append(list, data);
436 static void extcap_free_arg_elem(gpointer data, gpointer user_data _U_) {
437 extcap_free_arg((extcap_arg *) data);
441 void extcap_register_preferences(void)
443 GList * interfaces = NULL;
445 module_t * dev_module = prefs_find_module("extcap");
450 if ( ! ifaces || g_hash_table_size(ifaces) == 0 )
451 extcap_reload_interface_list(NULL, NULL);
453 interfaces = g_hash_table_get_keys(ifaces);
455 while ( interfaces ) {
456 extcap_get_if_configuration((gchar *)interfaces->data);
458 interfaces = g_list_next(interfaces);
462 static void extcap_free_if_configuration(GList *list)
466 for (elem = g_list_first(list); elem; elem = elem->next)
468 if (elem->data != NULL) {
469 /* g_list_free_full() only exists since 2.28. */
470 sl = g_list_first((GList *)elem->data);
471 g_list_foreach(sl, (GFunc)extcap_free_arg_elem, NULL);
478 gchar * extcap_settings_key(const gchar * ifname, const gchar * setting)
480 gchar * setting_nohyphen;
481 gchar * ifname_underscore;
482 gchar * ifname_lower;
484 GRegex * regex = g_regex_new ("(?![a-zA-Z1-9_]).", (GRegexCompileFlags) 0, (GRegexMatchFlags) 0, NULL );
490 g_regex_replace_literal(regex, setting, strlen(setting), 0,
491 "", (GRegexMatchFlags) 0, NULL );
493 g_regex_replace_literal(regex, ifname, strlen(ifname), 0,
494 "_", (GRegexMatchFlags) 0, NULL );
495 ifname_lower = g_utf8_strdown(ifname_underscore, -1);
496 key = g_strconcat(ifname_lower, ".", setting_nohyphen, NULL);
498 g_free(setting_nohyphen);
499 g_free(ifname_underscore);
500 g_free(ifname_lower);
501 g_regex_unref(regex);
506 static gboolean search_cb(const gchar *extcap _U_, const gchar *ifname _U_, gchar *output, void *data,
507 char **err_str _U_) {
508 extcap_token_sentence *tokens = NULL;
509 GList *arguments = NULL;
510 GList **il = (GList **) data;
511 module_t * dev_module = NULL;
513 tokens = extcap_tokenize_sentences(output);
514 arguments = extcap_parse_args(tokens);
516 extcap_free_tokenized_sentence_list(tokens);
519 extcap_debug_arguments ( arguments );
522 dev_module = prefs_find_module("extcap");
525 GList * walker = arguments;
527 while ( walker != NULL ) {
528 extcap_arg * arg = (extcap_arg *)walker->data;
531 struct preference * pref = NULL;
532 gchar * pref_ifname = extcap_settings_key(ifname, arg->call);
534 if ( ( pref = prefs_find_preference(dev_module, pref_ifname) ) == NULL ) {
535 /* Set an initial value */
536 if ( ! arg->storeval && arg->default_complex )
537 arg->storeval = g_strdup(arg->default_complex->_val);
539 prefs_register_string_preference(dev_module, g_strdup(pref_ifname),
540 arg->display, arg->display, (const gchar **)(void*)(&arg->storeval));
542 /* Been here before, restore stored value */
543 if (! arg->storeval && pref->varp.string)
544 arg->storeval = g_strdup(*(pref->varp.string));
549 walker = g_list_next(walker);
553 *il = g_list_append(*il, arguments);
555 /* By returning false, extcap_foreach will break on first found */
560 extcap_get_if_configuration(const char * ifname) {
563 gchar **err_str = NULL;
566 if ( extcap_if_exists(ifname) )
568 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "Extcap path %s",
571 argv[0] = g_strdup(EXTCAP_ARGUMENT_CONFIG);
572 argv[1] = g_strdup(EXTCAP_ARGUMENT_INTERFACE);
573 argv[2] = g_strdup(ifname);
575 extcap_foreach(3, argv, search_cb, &ret, err_str, ifname);
577 for (i = 0; i < 3; i++)
585 extcap_has_configuration(const char * ifname, gboolean is_required) {
586 GList * arguments = 0;
587 GList * walker = 0, * item = 0;
589 gboolean found = FALSE;
591 arguments = extcap_get_if_configuration((const char *)( ifname ) );
592 walker = g_list_first(arguments);
594 while ( walker != NULL && ! found ) {
595 item = g_list_first((GList *)(walker->data));
596 while ( item != NULL && ! found ) {
597 if ( (extcap_arg *)(item->data) != NULL ) {
598 extcap_arg * arg = (extcap_arg *)(item->data);
599 /* Should required options be present, or any kind of options */
602 else if ( arg->is_required ) {
603 gchar * stored = NULL;
604 gchar * defval = NULL;
606 if ( arg->storeval != NULL )
607 stored = arg->storeval;
609 if ( arg->default_complex != NULL && arg->default_complex->_val != NULL )
610 defval = arg->default_complex->_val;
612 if ( arg->is_required ) {
613 /* If stored and defval is identical and the argument is required,
614 * configuration is needed */
615 if ( defval && stored && g_strcmp0(stored, defval) == 0 )
617 else if ( ! defval && (!stored || strlen(g_strchomp(stored)) <= (size_t)0) )
621 if ( arg->arg_type == EXTCAP_ARG_FILESELECT ) {
622 if ( arg->fileexists && ! ( file_exists(defval) || file_exists(stored) ) )
630 walker = walker->next;
632 extcap_free_if_configuration(arguments);
637 void extcap_cleanup(capture_options * capture_opts) {
638 interface_options interface_opts;
641 for (icnt = 0; icnt < capture_opts->ifaces->len; icnt++) {
642 interface_opts = g_array_index(capture_opts->ifaces, interface_options,
645 /* skip native interfaces */
646 if (interface_opts.if_type != IF_EXTCAP)
649 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
650 "Extcap [%s] - Cleaning up fifo: %s; PID: %d", interface_opts.name,
651 interface_opts.extcap_fifo, interface_opts.extcap_pid);
655 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
656 "Extcap [%s] - Closing pipe", interface_opts.name);
657 FlushFileBuffers(pipe_h);
658 DisconnectNamedPipe(pipe_h);
662 if (interface_opts.extcap_fifo != NULL && file_exists(interface_opts.extcap_fifo))
664 /* the fifo will not be freed here, but with the other capture_opts in capture_sync */
665 ws_unlink(interface_opts.extcap_fifo);
666 interface_opts.extcap_fifo = NULL;
669 /* Maybe the client closed and removed fifo, but ws should check if
670 * pid should be closed */
671 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
672 "Extcap [%s] - Closing spawned PID: %d", interface_opts.name,
673 interface_opts.extcap_pid);
675 if (interface_opts.extcap_pid != INVALID_EXTCAP_PID)
678 TerminateProcess(interface_opts.extcap_pid, 0);
680 g_spawn_close_pid(interface_opts.extcap_pid);
681 interface_opts.extcap_pid = INVALID_EXTCAP_PID;
684 /* Make sure modified interface_opts is saved in capture_opts. */
685 capture_opts->ifaces = g_array_remove_index(capture_opts->ifaces, icnt);
686 g_array_insert_val(capture_opts->ifaces, icnt, interface_opts);
691 extcap_add_arg_and_remove_cb(gpointer key, gpointer value, gpointer data) {
692 GPtrArray *args = (GPtrArray *)data;
696 g_ptr_array_add(args, g_strdup((const gchar*)key));
699 g_ptr_array_add(args, g_strdup((const gchar*)value));
707 static void extcap_child_watch_cb(GPid pid, gint status _U_, gpointer user_data)
710 interface_options interface_opts;
711 capture_options *capture_opts = (capture_options *)user_data;
713 /* Close handle to child process. */
714 g_spawn_close_pid(pid);
716 /* Update extcap_pid in interface options structure. */
717 for (i = 0; i < capture_opts->ifaces->len; i++)
719 interface_opts = g_array_index(capture_opts->ifaces, interface_options, i);
720 if (interface_opts.extcap_pid == pid)
722 interface_opts.extcap_pid = INVALID_EXTCAP_PID;
723 g_source_remove(interface_opts.extcap_child_watch);
724 interface_opts.extcap_child_watch = 0;
726 capture_opts->ifaces = g_array_remove_index(capture_opts->ifaces, i);
727 g_array_insert_val(capture_opts->ifaces, i, interface_opts);
733 /* call mkfifo for each extcap,
734 * returns FALSE if there's an error creating a FIFO */
736 extcap_init_interfaces(capture_options *capture_opts)
739 interface_options interface_opts;
741 for (i = 0; i < capture_opts->ifaces->len; i++)
743 GPtrArray *args = NULL;
744 GPid pid = INVALID_EXTCAP_PID;
748 interface_opts = g_array_index(capture_opts->ifaces, interface_options, i);
750 /* skip native interfaces */
751 if (interface_opts.if_type != IF_EXTCAP )
754 /* create pipe for fifo */
755 if ( ! extcap_create_pipe ( &interface_opts.extcap_fifo ) )
758 /* Create extcap call */
759 args = g_ptr_array_new();
760 #define add_arg(X) g_ptr_array_add(args, g_strdup(X))
762 add_arg(interface_opts.extcap);
763 add_arg(EXTCAP_ARGUMENT_RUN_CAPTURE);
764 add_arg(EXTCAP_ARGUMENT_INTERFACE);
765 add_arg(interface_opts.name);
766 if (interface_opts.cfilter && strlen(interface_opts.cfilter) > 0) {
767 add_arg(EXTCAP_ARGUMENT_CAPTURE_FILTER);
768 add_arg(interface_opts.cfilter);
770 add_arg(EXTCAP_ARGUMENT_RUN_PIPE);
771 add_arg(interface_opts.extcap_fifo);
772 if (interface_opts.extcap_args == NULL || g_hash_table_size(interface_opts.extcap_args) == 0)
774 /* User did not perform interface configuration.
776 * Check if there are any boolean flags that are set by default
777 * and hence their argument should be added.
782 arglist = extcap_get_if_configuration(interface_opts.name);
783 for (elem = g_list_first(arglist); elem; elem = elem->next)
786 extcap_arg *arg_iter;
788 if (elem->data == NULL)
793 arg_list = g_list_first((GList *)elem->data);
794 while (arg_list != NULL) {
795 gchar * stored = NULL, * defval = NULL;
796 /* In case of boolflags only first element in arg_list is relevant. */
797 arg_iter = (extcap_arg*) (arg_list->data);
798 if ( arg_iter->storeval != NULL )
799 stored = arg_iter->storeval;
801 if ( arg_iter->default_complex != NULL && arg_iter->default_complex->_val != NULL )
802 defval = arg_iter->default_complex->_val;
804 /* Different data in storage then set for default */
805 if ( g_strcmp0(stored, defval) != 0 ) {
806 if ( arg_iter->arg_type == EXTCAP_ARG_BOOLFLAG ) {
807 if ( g_strcmp0(stored, "true") == 0 )
808 add_arg(arg_iter->call);
810 gchar * call = g_strconcat(arg_iter->call, " ", stored, NULL);
814 } else if (arg_iter->arg_type == EXTCAP_ARG_BOOLFLAG) {
815 if (extcap_complex_get_bool(arg_iter->default_complex))
816 add_arg(arg_iter->call);
819 arg_list = arg_list->next;
823 extcap_free_if_configuration(arglist);
827 g_hash_table_foreach_remove(interface_opts.extcap_args, extcap_add_arg_and_remove_cb, args);
832 /* Dump commandline parameters sent to extcap. */
833 for (tmp = (gchar **)args->pdata, tmp_i = 0; *tmp && **tmp; ++tmp_i, ++tmp)
835 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "argv[%d]: %s", tmp_i, *tmp);
838 /* Wireshark for windows crashes here sometimes *
839 * Access violation reading location 0x... */
840 g_spawn_async(NULL, (gchar **)args->pdata, NULL,
841 (GSpawnFlags) G_SPAWN_DO_NOT_REAP_CHILD, NULL, NULL,
844 g_ptr_array_foreach(args, (GFunc)g_free, NULL);
845 g_ptr_array_free(args, TRUE);
846 interface_opts.extcap_pid = pid;
847 interface_opts.extcap_child_watch =
848 g_child_watch_add(pid, extcap_child_watch_cb, (gpointer)capture_opts);
849 capture_opts->ifaces = g_array_remove_index(capture_opts->ifaces, i);
850 g_array_insert_val(capture_opts->ifaces, i, interface_opts);
853 /* On Windows, wait for extcap to connect to named pipe.
854 * Some extcaps will present UAC screen to user.
855 * 30 second timeout should be reasonable timeout for extcap to
856 * connect to named pipe (including user interaction).
857 * Wait on multiple object in case of extcap termination
858 * without opening pipe.
860 * Minimum supported version of Windows: XP / Server 2003.
862 if (pid != INVALID_EXTCAP_PID)
868 ov.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL);
870 ConnectNamedPipe(pipe_h, &ov);
871 handles[0] = ov.hEvent;
874 if (GetLastError() == ERROR_PIPE_CONNECTED)
876 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "extcap connected to pipe");
880 dw = WaitForMultipleObjects(2, handles, FALSE, 30000);
881 if (dw == WAIT_OBJECT_0)
883 /* ConnectNamedPipe finished. */
886 code = GetLastError();
887 if (code == ERROR_IO_PENDING)
890 if (!GetOverlappedResult(ov.hEvent, &ov, &dummy, TRUE))
892 code = GetLastError();
896 code = ERROR_SUCCESS;
900 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "ConnectNamedPipe code: %d", code);
902 else if (dw == (WAIT_OBJECT_0 + 1))
904 /* extcap process terminated. */
905 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "extcap terminated without connecting to pipe!");
907 else if (dw == WAIT_TIMEOUT)
909 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "extcap didn't connect to pipe within 30 seconds!");
913 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG, "WaitForMultipleObjects returned 0x%08X. Error %d", dw, GetLastError());
917 CloseHandle(ov.hEvent);
926 /* called by capture_sync to get the CreatNamedPipe handle*/
928 extcap_get_win32_handle()
934 gboolean extcap_create_pipe(char ** fifo)
937 gchar timestr[ 14+1 ];
940 gchar *pipename = NULL;
942 SECURITY_ATTRIBUTES security;
943 /* create pipename */
944 current_time = time(NULL);
945 strftime(timestr, sizeof(timestr), "%Y%m%d%H%M%S", localtime(¤t_time));
946 pipename = g_strconcat ( "\\\\.\\pipe\\", EXTCAP_PIPE_PREFIX, "_", timestr, NULL );
948 /* Security struct to enable Inheritable HANDLE */
949 memset(&security, 0, sizeof(SECURITY_ATTRIBUTES));
950 security.nLength = sizeof(SECURITY_ATTRIBUTES);
951 security.bInheritHandle = TRUE;
952 security.lpSecurityDescriptor = NULL;
954 /* create a namedPipe*/
955 pipe_h = CreateNamedPipe(
957 PIPE_ACCESS_DUPLEX | FILE_FLAG_OVERLAPPED,
958 PIPE_TYPE_MESSAGE| PIPE_READMODE_MESSAGE | PIPE_WAIT,
963 if (pipe_h == INVALID_HANDLE_VALUE)
965 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,"\nError creating pipe => (%d)", GetLastError());
970 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,"\nWireshark Created pipe =>(%s)",pipename);
971 *fifo = g_strdup(pipename);
974 gchar *temp_name = NULL;
977 if ((fd = create_tempfile(&temp_name, EXTCAP_PIPE_PREFIX, NULL)) < 0 )
982 g_log(LOG_DOMAIN_CAPTURE, G_LOG_LEVEL_DEBUG,
983 "Extcap - Creating fifo: %s", temp_name);
985 if ( file_exists(temp_name) )
986 ws_unlink(temp_name);
988 if (mkfifo(temp_name, 0600) == 0)
989 *fifo = g_strdup(temp_name);
996 void extcap_debug_arguments ( extcap_arg *arg_iter )
998 extcap_value *v = NULL;
999 GList *walker = NULL;
1001 printf("debug - parser dump\n");
1002 while (arg_iter != NULL) {
1003 printf("ARG %d call=%s display=\"%s\" type=", arg_iter->arg_num, arg_iter->call, arg_iter->display);
1005 switch (arg_iter->arg_type) {
1006 case EXTCAP_ARG_INTEGER:
1009 case EXTCAP_ARG_UNSIGNED:
1010 printf("unsigned\n");
1012 case EXTCAP_ARG_LONG:
1015 case EXTCAP_ARG_DOUBLE:
1018 case EXTCAP_ARG_BOOLEAN:
1019 printf("boolean\n");
1021 case EXTCAP_ARG_MENU:
1024 case EXTCAP_ARG_RADIO:
1027 case EXTCAP_ARG_SELECTOR:
1028 printf("selctor\n");
1030 case EXTCAP_ARG_STRING:
1031 printf ( "string\n" );
1033 case EXTCAP_ARG_PASSWORD:
1034 printf ( "PASSWORD\n" );
1036 case EXTCAP_ARG_MULTICHECK:
1037 printf ( "unknown\n" );
1039 case EXTCAP_ARG_UNKNOWN:
1040 printf ( "unknown\n" );
1044 if (arg_iter->range_start != NULL && arg_iter->range_end != NULL) {
1045 printf("\tRange: ");
1046 extcap_printf_complex(arg_iter->range_start);
1048 extcap_printf_complex(arg_iter->range_end);
1052 for ( walker = g_list_first ( arg_iter->value_list ); walker; walker = walker->next )
1054 v = (extcap_value *)walker->data;
1057 printf("\tcall=\"%p\" display=\"%p\"\n", v->call, v->display);
1058 printf("\tcall=\"%s\" display=\"%s\"\n", v->call, v->display);
1061 arg_iter = arg_iter->next_arg;
1067 * Editor modelines - http://www.wireshark.org/tools/modelines.html
1072 * indent-tabs-mode: nil
1075 * vi: set shiftwidth=4 tabstop=8 expandtab:
1076 * :indentSize=4:tabSize=8:noTabs=true: