/* prefs.c * Routines for handling preferences * * Wireshark - Network traffic analyzer * By Gerald Combs * Copyright 1998 Gerald Combs * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #include "config.h" #include #include #include #include #include #include #include #include #include #ifdef HAVE_GEOIP #include #endif #include #include #include #include #include #include #include "print.h" #include #include /* ws_g_warning */ #include #include #include #include "epan/filter_expressions.h" #include "epan/wmem/wmem.h" #include /* Internal functions */ static module_t *find_subtree(module_t *parent, const char *tilte); static module_t *prefs_register_module_or_subtree(module_t *parent, const char *name, const char *title, const char *description, gboolean is_subtree, void (*apply_cb)(void), gboolean use_gui); static void prefs_register_modules(void); static prefs_set_pref_e set_pref(gchar*, const gchar*, void *, gboolean); static void free_col_info(GList *); static void pre_init_prefs(void); static gboolean prefs_is_column_visible(const gchar *cols_hidden, fmt_data *cfmt); static gboolean parse_column_format(fmt_data *cfmt, const char *fmt); static void try_convert_to_custom_column(gpointer *el_data); static guint prefs_module_list_foreach(wmem_tree_t *module_list, module_cb callback, gpointer user_data, gboolean skip_obsolete); #define IS_PREF_OBSOLETE(p) ((p) & PREF_OBSOLETE) #define SET_PREF_OBSOLETE(p) ((p) |= PREF_OBSOLETE) #define RESET_PREF_OBSOLETE(p) ((p) &= ~PREF_OBSOLETE) #define PF_NAME "preferences" #define OLD_GPF_NAME "wireshark.conf" /* old name for global preferences file */ static gboolean prefs_initialized = FALSE; static gchar *gpf_path = NULL; static gchar *cols_hidden_list = NULL; static gboolean gui_theme_is_dark = FALSE; /* * XXX - variables to allow us to attempt to interpret the first * "mgcp.{tcp,udp}.port" in a preferences file as * "mgcp.{tcp,udp}.gateway_port" and the second as * "mgcp.{tcp,udp}.callagent_port". */ static int mgcp_tcp_port_count; static int mgcp_udp_port_count; e_prefs prefs; static const enum_val_t gui_ptree_line_style[] = { {"NONE", "NONE", 0}, {"SOLID", "SOLID", 1}, {"DOTTED", "DOTTED", 2}, {"TABBED", "TABBED", 3}, {NULL, NULL, -1} }; static const enum_val_t gui_ptree_expander_style[] = { {"NONE", "NONE", 0}, {"SQUARE", "SQUARE", 1}, {"TRIANGLE", "TRIANGLE", 2}, {"CIRCULAR", "CIRCULAR", 3}, {NULL, NULL, -1} }; static const enum_val_t gui_hex_dump_highlight_style[] = { {"BOLD", "BOLD", 0}, {"INVERSE", "INVERSE", 1}, {NULL, NULL, -1} }; static const enum_val_t gui_console_open_type[] = { {"NEVER", "NEVER", console_open_never}, {"AUTOMATIC", "AUTOMATIC", console_open_auto}, {"ALWAYS", "ALWAYS", console_open_always}, {NULL, NULL, -1} }; static const enum_val_t gui_version_placement_type[] = { {"WELCOME", "WELCOME", version_welcome_only}, {"TITLE", "TITLE", version_title_only}, {"BOTH", "BOTH", version_both}, {"NEITHER", "NEITHER", version_neither}, {NULL, NULL, -1} }; static const enum_val_t gui_fileopen_style[] = { {"LAST_OPENED", "LAST_OPENED", 0}, {"SPECIFIED", "SPECIFIED", 1}, {NULL, NULL, -1} }; /* GTK knows of two ways representing "both", vertical and horizontal aligned. * as this may not work on other guis, we use only "both" in general here */ static const enum_val_t gui_toolbar_style[] = { {"ICONS", "ICONS", 0}, {"TEXT", "TEXT", 1}, {"BOTH", "BOTH", 2}, {NULL, NULL, -1} }; static const enum_val_t gui_layout_content[] = { {"NONE", "NONE", 0}, {"PLIST", "PLIST", 1}, {"PDETAILS", "PDETAILS", 2}, {"PBYTES", "PBYTES", 3}, {NULL, NULL, -1} }; static const enum_val_t gui_update_channel[] = { {"DEVELOPMENT", "DEVELOPMENT", UPDATE_CHANNEL_DEVELOPMENT}, {"STABLE", "STABLE", UPDATE_CHANNEL_STABLE}, {NULL, NULL, -1} }; #if defined(HAVE_PCAP_CREATE) /* Can set monitor mode and buffer size. */ static gint num_capture_cols = 7; static const gchar *capture_cols[7] = { "INTERFACE", "LINK", "PMODE", "SNAPLEN", "MONITOR", "BUFFER", "FILTER" }; #define CAPTURE_COL_TYPE_DESCRIPTION \ "Possible values: INTERFACE, LINK, PMODE, SNAPLEN, MONITOR, BUFFER, FILTER\n" #elif defined(CAN_SET_CAPTURE_BUFFER_SIZE) /* Can set buffer size but not monitor mode. */ static gint num_capture_cols = 6; static const gchar *capture_cols[6] = { "INTERFACE", "LINK", "PMODE", "SNAPLEN", "BUFFER", "FILTER" }; #define CAPTURE_COL_TYPE_DESCRIPTION \ "Possible values: INTERFACE, LINK, PMODE, SNAPLEN, BUFFER, FILTER\n" #else /* Can neither set buffer size nor monitor mode. */ static gint num_capture_cols = 5; static const gchar *capture_cols[5] = { "INTERFACE", "LINK", "PMODE", "SNAPLEN", "FILTER" }; #define CAPTURE_COL_TYPE_DESCRIPTION \ "Possible values: INTERFACE, LINK, PMODE, SNAPLEN, FILTER\n" #endif static const enum_val_t gui_packet_list_elide_mode[] = { {"LEFT", "LEFT", ELIDE_LEFT}, {"RIGHT", "RIGHT", ELIDE_RIGHT}, {"MIDDLE", "MIDDLE", ELIDE_MIDDLE}, {"NONE", "NONE", ELIDE_NONE}, {NULL, NULL, -1} }; /** Struct to hold preference data */ struct preference { const char *name; /**< name of preference */ const char *title; /**< title to use in GUI */ const char *description; /**< human-readable description of preference */ int ordinal; /**< ordinal number of this preference */ int type; /**< type of that preference */ gui_type_t gui; /**< type of the GUI (QT, GTK or both) the preference is registered for */ union { /* The Qt preference code assumes that these will all be pointers (and unique) */ guint *uint; gboolean *boolp; gint *enump; char **string; range_t **range; struct epan_uat* uat; color_t *colorp; GList** list; } varp; /**< pointer to variable storing the value */ union { guint uint; gboolean boolval; gint enumval; char *string; range_t *range; color_t color; GList* list; } stashed_val; /**< original value, when editing from the GUI */ union { guint uint; gboolean boolval; gint enumval; char *string; range_t *range; color_t color; GList* list; } default_val; /**< the default value of the preference */ union { guint base; /**< input/output base, for PREF_UINT */ guint32 max_value; /**< maximum value of a range */ struct { const enum_val_t *enumvals; /**< list of name & values */ gboolean radio_buttons; /**< TRUE if it should be shown as radio buttons rather than as an option menu or combo box in the preferences tab */ } enum_info; /**< for PREF_ENUM */ } info; /**< display/text file information */ struct pref_custom_cbs custom_cbs; /**< for PREF_CUSTOM */ void *control; /**< handle for GUI control for this preference. GTK+ only? */ }; const char* prefs_get_description(pref_t *pref) { return pref->description; } const char* prefs_get_title(pref_t *pref) { return pref->title; } int prefs_get_type(pref_t *pref) { return pref->type; } gui_type_t prefs_get_gui_type(pref_t *pref) { return pref->gui; } const char* prefs_get_name(pref_t *pref) { return pref->name; } guint32 prefs_get_max_value(pref_t *pref) { return pref->info.max_value; } void* prefs_get_control(pref_t *pref) { return pref->control; } void prefs_set_control(pref_t *pref, void* control) { pref->control = control; } int prefs_get_ordinal(pref_t *pref) { return pref->ordinal; } /* * List of all modules with preference settings. */ static wmem_tree_t *prefs_modules = NULL; /* * List of all modules that should show up at the top level of the * tree in the preference dialog box. */ static wmem_tree_t *prefs_top_level_modules = NULL; /** Sets up memory used by proto routines. Called at program startup */ void prefs_init(void) { memset(&prefs, 0, sizeof(prefs)); prefs_modules = wmem_tree_new(wmem_epan_scope()); prefs_top_level_modules = wmem_tree_new(wmem_epan_scope()); } /* * Free the strings for a string-like preference. */ static void free_string_like_preference(pref_t *pref) { g_free(*pref->varp.string); *pref->varp.string = NULL; g_free(pref->default_val.string); pref->default_val.string = NULL; } static void free_pref(gpointer data, gpointer user_data _U_) { pref_t *pref = (pref_t *)data; int type = pref->type; /* we reset the PREF_OBSOLETE bit in order to allow the original preference to be freed */ RESET_PREF_OBSOLETE(type); switch (type) { case PREF_BOOL: case PREF_ENUM: case PREF_UINT: case PREF_DECODE_AS_UINT: case PREF_STATIC_TEXT: case PREF_UAT: case PREF_COLOR: break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: g_free(*pref->varp.string); *pref->varp.string = NULL; g_free(pref->default_val.string); pref->default_val.string = NULL; break; case PREF_RANGE: case PREF_DECODE_AS_RANGE: wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = NULL; wmem_free(wmem_epan_scope(), pref->default_val.range); pref->default_val.range = NULL; break; case PREF_CUSTOM: if (strcmp(pref->name, "columns") == 0) pref->stashed_val.boolval = TRUE; pref->custom_cbs.free_cb(pref); break; } g_free(pref); } static guint free_module_prefs(module_t *module, gpointer data _U_) { if (module->prefs) { g_list_foreach(module->prefs, free_pref, NULL); g_list_free(module->prefs); } module->prefs = NULL; module->numprefs = 0; if (module->submodules) { prefs_module_list_foreach(module->submodules, free_module_prefs, NULL, FALSE); } /* We don't free the actual module: its submodules pointer points to a wmem_tree and the module itself is stored in a wmem_tree */ return 0; } /** Frees memory used by proto routines. Called at program shutdown */ void prefs_cleanup(void) { /* This isn't strictly necessary since we're exiting anyway, but let's * do what clean up we can. */ prefs_module_list_foreach(prefs_modules, free_module_prefs, NULL, FALSE); /* Clean the uats */ uat_cleanup(); g_free(prefs.saved_at_version); g_free(gpf_path); gpf_path = NULL; } void prefs_set_gui_theme_is_dark(gboolean is_dark) { gui_theme_is_dark = is_dark; } /* * Register a module that will have preferences. * Specify the module under which to register it or NULL to register it * at the top level, the name used for the module in the preferences file, * the title used in the tab for it in a preferences dialog box, and a * routine to call back when we apply the preferences. */ static module_t * prefs_register_module(module_t *parent, const char *name, const char *title, const char *description, void (*apply_cb)(void), const gboolean use_gui) { return prefs_register_module_or_subtree(parent, name, title, description, FALSE, apply_cb, use_gui); } static void prefs_deregister_module(module_t *parent, const char *name, const char *title) { /* Remove this module from the list of all modules */ module_t *module = (module_t *)wmem_tree_remove_string(prefs_modules, name, WMEM_TREE_STRING_NOCASE); if (!module) return; if (parent == NULL) { /* Remove from top */ wmem_tree_remove_string(prefs_top_level_modules, title, WMEM_TREE_STRING_NOCASE); } else if (parent->submodules) { /* Remove from parent */ wmem_tree_remove_string(parent->submodules, title, WMEM_TREE_STRING_NOCASE); } free_module_prefs(module, NULL); wmem_free(wmem_epan_scope(), module); } /* * Register a subtree that will have modules under it. * Specify the module under which to register it or NULL to register it * at the top level and the title used in the tab for it in a preferences * dialog box. */ static module_t * prefs_register_subtree(module_t *parent, const char *title, const char *description, void (*apply_cb)(void)) { return prefs_register_module_or_subtree(parent, NULL, title, description, TRUE, apply_cb, parent ? parent->use_gui : FALSE); } static module_t * prefs_register_module_or_subtree(module_t *parent, const char *name, const char *title, const char *description, gboolean is_subtree, void (*apply_cb)(void), gboolean use_gui) { module_t *module; const char *p; guchar c; /* this module may have been created as a subtree item previously */ if ((module = find_subtree(parent, title))) { /* the module is currently a subtree */ module->name = name; module->apply_cb = apply_cb; module->description = description; if (prefs_find_module(name) == NULL) { wmem_tree_insert_string(prefs_modules, name, module, WMEM_TREE_STRING_NOCASE); } return module; } module = wmem_new(wmem_epan_scope(), module_t); module->name = name; module->title = title; module->description = description; module->apply_cb = apply_cb; module->prefs = NULL; /* no preferences, to start */ module->parent = parent; module->submodules = NULL; /* no submodules, to start */ module->numprefs = 0; module->prefs_changed = FALSE; module->obsolete = FALSE; module->use_gui = use_gui; /* * Do we have a module name? */ if (name != NULL) { /* * Yes. * Make sure that only lower-case ASCII letters, numbers, * underscores, hyphens, and dots appear in the name. * * Crash if there is, as that's an error in the code; * you can make the title a nice string with capitalization, * white space, punctuation, etc., but the name can be used * on the command line, and shouldn't require quoting, * shifting, etc. */ for (p = name; (c = *p) != '\0'; p++) { if (!(g_ascii_islower(c) || g_ascii_isdigit(c) || c == '_' || c == '-' || c == '.')) g_error("Preference module \"%s\" contains invalid characters", name); } /* * Make sure there's not already a module with that * name. Crash if there is, as that's an error in the * code, and the code has to be fixed not to register * more than one module with the same name. * * We search the list of all modules; the subtree stuff * doesn't require preferences in subtrees to have names * that reflect the subtree they're in (that would require * protocol preferences to have a bogus "protocol.", or * something such as that, to be added to all their names). */ g_assert(prefs_find_module(name) == NULL); /* * Insert this module in the list of all modules. */ wmem_tree_insert_string(prefs_modules, name, module, WMEM_TREE_STRING_NOCASE); } else { /* * This has no name, just a title; check to make sure it's a * subtree, and crash if it's not. */ g_assert(is_subtree); } /* * Insert this module into the appropriate place in the display * tree. */ if (parent == NULL) { /* * It goes at the top. */ wmem_tree_insert_string(prefs_top_level_modules, title, module, WMEM_TREE_STRING_NOCASE); } else { /* * It goes into the list for this module. */ if (parent->submodules == NULL) parent->submodules = wmem_tree_new(wmem_epan_scope()); wmem_tree_insert_string(parent->submodules, title, module, WMEM_TREE_STRING_NOCASE); } return module; } /* * Register that a protocol has preferences. */ module_t *protocols_module = NULL; module_t * prefs_register_protocol(int id, void (*apply_cb)(void)) { protocol_t *protocol; /* * Have we yet created the "Protocols" subtree? */ if (protocols_module == NULL) { /* * No. Register Protocols subtree as well as any preferences * for non-dissector modules. */ pre_init_prefs(); prefs_register_modules(); } protocol = find_protocol_by_id(id); if (protocol == NULL) g_error("Protocol preferences being registered with an invalid protocol ID"); return prefs_register_module(protocols_module, proto_get_protocol_filter_name(id), proto_get_protocol_short_name(protocol), proto_get_protocol_name(id), apply_cb, TRUE); } void prefs_deregister_protocol (int id) { protocol_t *protocol = find_protocol_by_id(id); if (protocol == NULL) g_error("Protocol preferences being de-registered with an invalid protocol ID"); prefs_deregister_module (protocols_module, proto_get_protocol_filter_name(id), proto_get_protocol_short_name(protocol)); } module_t * prefs_register_protocol_subtree(const char *subtree, int id, void (*apply_cb)(void)) { protocol_t *protocol; module_t *subtree_module; module_t *new_module; char *sep = NULL, *ptr = NULL, *orig = NULL; /* * Have we yet created the "Protocols" subtree? * XXX - can we just do this by registering Protocols/{subtree}? * If not, why not? */ if (protocols_module == NULL) { /* * No. Register Protocols subtree as well as any preferences * for non-dissector modules. */ pre_init_prefs(); prefs_register_modules(); } subtree_module = protocols_module; if (subtree) { /* take a copy of the buffer, orig keeps a base pointer while ptr * walks through the string */ orig = ptr = g_strdup(subtree); while (ptr && *ptr) { if ((sep = strchr(ptr, '/'))) *sep++ = '\0'; if (!(new_module = find_subtree(subtree_module, ptr))) { /* * There's no such module; create it, with the description * being the name (if it's later registered explicitly * with a description, that will override it). */ ptr = wmem_strdup(wmem_epan_scope(), ptr); new_module = prefs_register_subtree(subtree_module, ptr, ptr, NULL); } subtree_module = new_module; ptr = sep; } g_free(orig); } protocol = find_protocol_by_id(id); if (protocol == NULL) g_error("Protocol subtree being registered with an invalid protocol ID"); return prefs_register_module(subtree_module, proto_get_protocol_filter_name(id), proto_get_protocol_short_name(protocol), proto_get_protocol_name(id), apply_cb, TRUE); } /* * Register that a protocol used to have preferences but no longer does, * by creating an "obsolete" module for it. */ module_t * prefs_register_protocol_obsolete(int id) { module_t *module; protocol_t *protocol; /* * Have we yet created the "Protocols" subtree? */ if (protocols_module == NULL) { /* * No. Register Protocols subtree as well as any preferences * for non-dissector modules. */ pre_init_prefs(); prefs_register_modules(); } protocol = find_protocol_by_id(id); if (protocol == NULL) g_error("Protocol being registered with an invalid protocol ID"); module = prefs_register_module(protocols_module, proto_get_protocol_filter_name(id), proto_get_protocol_short_name(protocol), proto_get_protocol_name(id), NULL, TRUE); module->obsolete = TRUE; return module; } /* * Register that a statistical tap has preferences. * * "name" is a name for the tap to use on the command line with "-o" * and in preference files. * * "title" is a short human-readable name for the tap. * * "description" is a longer human-readable description of the tap. */ module_t *stats_module = NULL; module_t * prefs_register_stat(const char *name, const char *title, const char *description, void (*apply_cb)(void)) { /* * Have we yet created the "Statistics" subtree? */ if (stats_module == NULL) { /* * No. Register Statistics subtree as well as any preferences * for non-dissector modules. */ pre_init_prefs(); prefs_register_modules(); } return prefs_register_module(stats_module, name, title, description, apply_cb, TRUE); } module_t * prefs_find_module(const char *name) { return (module_t *)wmem_tree_lookup_string(prefs_modules, name, WMEM_TREE_STRING_NOCASE); } static module_t * find_subtree(module_t *parent, const char *name) { return (module_t *)wmem_tree_lookup_string(parent ? parent->submodules : prefs_top_level_modules, name, WMEM_TREE_STRING_NOCASE); } /* * Call a callback function, with a specified argument, for each module * in a list of modules. If the list is NULL, searches the top-level * list in the display tree of modules. If any callback returns a * non-zero value, we stop and return that value, otherwise we * return 0. * * Normally "obsolete" modules are ignored; their sole purpose is to allow old * preferences for dissectors that no longer have preferences to be * silently ignored in preference files. Does not ignore subtrees, * as this can be used when walking the display tree of modules. */ typedef struct { module_cb callback; gpointer user_data; guint ret; gboolean skip_obsolete; } call_foreach_t; static gboolean call_foreach_cb(const void *key _U_, void *value, void *data) { module_t *module = (module_t*)value; call_foreach_t *call_data = (call_foreach_t*)data; if (!call_data->skip_obsolete || !module->obsolete) call_data->ret = (*call_data->callback)(module, call_data->user_data); return (call_data->ret != 0); } static guint prefs_module_list_foreach(wmem_tree_t *module_list, module_cb callback, gpointer user_data, gboolean skip_obsolete) { call_foreach_t call_data; if (module_list == NULL) module_list = prefs_top_level_modules; call_data.callback = callback; call_data.user_data = user_data; call_data.ret = 0; call_data.skip_obsolete = skip_obsolete; wmem_tree_foreach(module_list, call_foreach_cb, &call_data); return call_data.ret; } /* * Returns TRUE if module has any submodules */ gboolean prefs_module_has_submodules(module_t *module) { if (module->submodules == NULL) { return FALSE; } if (wmem_tree_is_empty(module->submodules)) { return FALSE; } return TRUE; } /* * Call a callback function, with a specified argument, for each module * in the list of all modules. (This list does not include subtrees.) * * Ignores "obsolete" modules; their sole purpose is to allow old * preferences for dissectors that no longer have preferences to be * silently ignored in preference files. */ guint prefs_modules_foreach(module_cb callback, gpointer user_data) { return prefs_module_list_foreach(prefs_modules, callback, user_data, TRUE); } /* * Call a callback function, with a specified argument, for each submodule * of specified modules. If the module is NULL, goes through the top-level * list in the display tree of modules. * * Ignores "obsolete" modules; their sole purpose is to allow old * preferences for dissectors that no longer have preferences to be * silently ignored in preference files. Does not ignore subtrees, * as this can be used when walking the display tree of modules. */ guint prefs_modules_foreach_submodules(module_t *module, module_cb callback, gpointer user_data) { return prefs_module_list_foreach((module)?module->submodules:prefs_top_level_modules, callback, user_data, TRUE); } static gboolean call_apply_cb(const void *key _U_, void *value, void *data _U_) { module_t *module = (module_t *)value; if (module->obsolete) return FALSE; if (module->prefs_changed) { if (module->apply_cb != NULL) (*module->apply_cb)(); module->prefs_changed = FALSE; } if (module->submodules) wmem_tree_foreach(module->submodules, call_apply_cb, NULL); return FALSE; } /* * Call the "apply" callback function for each module if any of its * preferences have changed, and then clear the flag saying its * preferences have changed, as the module has been notified of that * fact. */ void prefs_apply_all(void) { wmem_tree_foreach(prefs_modules, call_apply_cb, NULL); } /* * Call the "apply" callback function for a specific module if any of * its preferences have changed, and then clear the flag saying its * preferences have changed, as the module has been notified of that * fact. */ void prefs_apply(module_t *module) { if (module && module->prefs_changed) call_apply_cb(NULL, module, NULL); } /* * Register a preference in a module's list of preferences. * If it has a title, give it an ordinal number; otherwise, it's a * preference that won't show up in the UI, so it shouldn't get an * ordinal number (the ordinal should be the ordinal in the set of * *visible* preferences). */ static pref_t * register_preference(module_t *module, const char *name, const char *title, const char *description, int type) { pref_t *preference; const gchar *p; const char *name_prefix = (module->name != NULL) ? module->name : module->parent->name; preference = g_new(pref_t,1); preference->name = name; preference->title = title; preference->description = description; preference->type = type; preference->gui = GUI_ALL; /* default */ if (title != NULL) preference->ordinal = module->numprefs; else preference->ordinal = -1; /* no ordinal for you */ /* * Make sure that only lower-case ASCII letters, numbers, * underscores, and dots appear in the preference name. * * Crash if there is, as that's an error in the code; * you can make the title and description nice strings * with capitalization, white space, punctuation, etc., * but the name can be used on the command line, * and shouldn't require quoting, shifting, etc. */ for (p = name; *p != '\0'; p++) if (!(g_ascii_islower(*p) || g_ascii_isdigit(*p) || *p == '_' || *p == '.')) g_error("Preference \"%s.%s\" contains invalid characters", module->name, name); /* * Make sure there's not already a preference with that * name. Crash if there is, as that's an error in the * code, and the code has to be fixed not to register * more than one preference with the same name. */ if (prefs_find_preference(module, name) != NULL) g_error("Preference %s has already been registered", name); if ((!IS_PREF_OBSOLETE(type)) && /* Don't compare if it's a subtree */ (module->name != NULL)) { /* * Make sure the preference name doesn't begin with the * module name, as that's redundant and Just Silly. */ if (!((strncmp(name, module->name, strlen(module->name)) != 0) || (((name[strlen(module->name)]) != '.') && ((name[strlen(module->name)]) != '_')))) g_error("Preference %s begins with the module name", name); } /* The title shows up in the preferences dialog. Make sure it's UI-friendly. */ if (preference->title) { const char *cur_char; if (preference->type != PREF_STATIC_TEXT && g_utf8_strlen(preference->title, -1) > 80) { // Arbitrary. g_error("Title for preference %s.%s is too long: %s", name_prefix, preference->name, preference->title); } if (!g_utf8_validate(preference->title, -1, NULL)) { g_error("Title for preference %s.%s isn't valid UTF-8.", name_prefix, preference->name); } for (cur_char = preference->title; *cur_char; cur_char = g_utf8_next_char(cur_char)) { if (!g_unichar_isprint(g_utf8_get_char(cur_char))) { g_error("Title for preference %s.%s isn't printable UTF-8.", name_prefix, preference->name); } } } if (preference->description) { if (!g_utf8_validate(preference->description, -1, NULL)) { g_error("Description for preference %s.%s isn't valid UTF-8.", name_prefix, preference->name); } } /* * We passed all of our checks. Add the preference. */ module->prefs = g_list_append(module->prefs, preference); if (title != NULL) module->numprefs++; return preference; } /* * Find a preference in a module's list of preferences, given the module * and the preference's name. */ typedef struct { GList *list_entry; const char *name; module_t *submodule; } find_pref_arg_t; static gint preference_match(gconstpointer a, gconstpointer b) { const pref_t *pref = (const pref_t *)a; const char *name = (const char *)b; return strcmp(name, pref->name); } static gboolean module_find_pref_cb(const void *key _U_, void *value, void *data) { find_pref_arg_t* arg = (find_pref_arg_t*)data; GList *list_entry; module_t *module = (module_t *)value; if (module == NULL) return FALSE; list_entry = g_list_find_custom(module->prefs, arg->name, preference_match); if (list_entry == NULL) return FALSE; arg->list_entry = list_entry; arg->submodule = module; return TRUE; } /* Tries to find a preference, setting containing_module to the (sub)module * holding this preference. */ static struct preference * prefs_find_preference_with_submodule(module_t *module, const char *name, module_t **containing_module) { find_pref_arg_t arg; GList *list_entry; if (module == NULL) return NULL; /* invalid parameters */ list_entry = g_list_find_custom(module->prefs, name, preference_match); arg.submodule = NULL; if (list_entry == NULL) { arg.list_entry = NULL; if (module->submodules != NULL) { arg.name = name; wmem_tree_foreach(module->submodules, module_find_pref_cb, &arg); } list_entry = arg.list_entry; } if (list_entry == NULL) return NULL; /* no such preference */ if (containing_module) *containing_module = arg.submodule ? arg.submodule : module; return (struct preference *) list_entry->data; } struct preference * prefs_find_preference(module_t *module, const char *name) { return prefs_find_preference_with_submodule(module, name, NULL); } /* * Returns TRUE if the given protocol has registered preferences */ gboolean prefs_is_registered_protocol(const char *name) { module_t *m = prefs_find_module(name); return (m != NULL && !m->obsolete); } /* * Returns the module title of a registered protocol */ const char * prefs_get_title_by_name(const char *name) { module_t *m = prefs_find_module(name); return (m != NULL && !m->obsolete) ? m->title : NULL; } /* * Register a preference with an unsigned integral value. */ void prefs_register_uint_preference(module_t *module, const char *name, const char *title, const char *description, guint base, guint *var) { pref_t *preference; preference = register_preference(module, name, title, description, PREF_UINT); preference->varp.uint = var; preference->default_val.uint = *var; g_assert(base > 0 && base != 1 && base < 37); preference->info.base = base; } /* * XXX Add a prefs_register_{uint16|port}_preference which sets max_value? */ /* * Register a "custom" preference with a unsigned integral value. * XXX - This should be temporary until we can find a better way * to do "custom" preferences */ static void prefs_register_uint_custom_preference(module_t *module, const char *name, const char *title, const char *description, struct pref_custom_cbs* custom_cbs, guint *var) { pref_t *preference; preference = register_preference(module, name, title, description, PREF_CUSTOM); preference->custom_cbs = *custom_cbs; preference->varp.uint = var; preference->default_val.uint = *var; } /* * Register a preference with an Boolean value. */ void prefs_register_bool_preference(module_t *module, const char *name, const char *title, const char *description, gboolean *var) { pref_t *preference; preference = register_preference(module, name, title, description, PREF_BOOL); preference->varp.boolp = var; preference->default_val.boolval = *var; } gboolean prefs_set_bool_value(pref_t *pref, gboolean value, pref_source_t source) { gboolean changed = FALSE; switch (source) { case pref_default: if (pref->default_val.boolval != value) { pref->default_val.boolval = value; changed = TRUE; } break; case pref_stashed: if (pref->stashed_val.boolval != value) { pref->stashed_val.boolval = value; changed = TRUE; } break; case pref_current: if (*pref->varp.boolp != value) { *pref->varp.boolp = value; changed = TRUE; } break; default: g_assert_not_reached(); break; } return changed; } void prefs_invert_bool_value(pref_t *pref, pref_source_t source) { switch (source) { case pref_default: pref->default_val.boolval = !pref->default_val.boolval; break; case pref_stashed: pref->stashed_val.boolval = !pref->stashed_val.boolval; break; case pref_current: *pref->varp.boolp = !(*pref->varp.boolp); break; default: g_assert_not_reached(); break; } } gboolean prefs_get_bool_value(pref_t *pref, pref_source_t source) { switch (source) { case pref_default: return pref->default_val.boolval; break; case pref_stashed: return pref->stashed_val.boolval; break; case pref_current: return *pref->varp.boolp; break; default: g_assert_not_reached(); break; } return FALSE; } /* * Register a preference with an enumerated value. */ /* * XXX Should we get rid of the radio_buttons parameter and make that * behavior automatic depending on the number of items? */ void prefs_register_enum_preference(module_t *module, const char *name, const char *title, const char *description, gint *var, const enum_val_t *enumvals, gboolean radio_buttons) { pref_t *preference; preference = register_preference(module, name, title, description, PREF_ENUM); preference->varp.enump = var; preference->default_val.enumval = *var; preference->info.enum_info.enumvals = enumvals; preference->info.enum_info.radio_buttons = radio_buttons; } gboolean prefs_set_enum_value(pref_t *pref, gint value, pref_source_t source) { gboolean changed = FALSE; switch (source) { case pref_default: if (pref->default_val.enumval != value) { pref->default_val.enumval = value; changed = TRUE; } break; case pref_stashed: if (pref->stashed_val.enumval != value) { pref->stashed_val.enumval = value; changed = TRUE; } break; case pref_current: if (*pref->varp.enump != value) { *pref->varp.enump = value; changed = TRUE; } break; default: g_assert_not_reached(); break; } return changed; } gint prefs_get_enum_value(pref_t *pref, pref_source_t source) { switch (source) { case pref_default: return pref->default_val.enumval; break; case pref_stashed: return pref->stashed_val.enumval; break; case pref_current: return *pref->varp.enump; break; default: g_assert_not_reached(); break; } return 0; } const enum_val_t* prefs_get_enumvals(pref_t *pref) { return pref->info.enum_info.enumvals; } gboolean prefs_get_enum_radiobuttons(pref_t *pref) { return pref->info.enum_info.radio_buttons; } static void register_string_like_preference(module_t *module, const char *name, const char *title, const char *description, char **var, int type, struct pref_custom_cbs* custom_cbs, gboolean free_tmp) { pref_t *pref; gchar *tmp; pref = register_preference(module, name, title, description, type); /* * String preference values should be non-null (as you can't * keep them null after using the preferences GUI, you can at best * have them be null strings) and freeable (as we free them * if we change them). * * If the value is a null pointer, make it a copy of a null * string, otherwise make it a copy of the value. */ tmp = *var; if (*var == NULL) { *var = g_strdup(""); } else { *var = g_strdup(*var); } if (free_tmp) { g_free(tmp); } pref->varp.string = var; pref->default_val.string = g_strdup(*var); pref->stashed_val.string = NULL; if (type == PREF_CUSTOM) { g_assert(custom_cbs); pref->custom_cbs = *custom_cbs; } } /* * For use by UI code that sets preferences. */ gboolean prefs_set_string_value(pref_t *pref, const char* value, pref_source_t source) { gboolean changed = FALSE; switch (source) { case pref_default: if (*pref->default_val.string) { if (strcmp(pref->default_val.string, value) != 0) { changed = TRUE; g_free(pref->default_val.string); pref->default_val.string = g_strdup(value); } } else if (value) { pref->default_val.string = g_strdup(value); } break; case pref_stashed: if (pref->stashed_val.string) { if (strcmp(pref->stashed_val.string, value) != 0) { changed = TRUE; g_free(pref->stashed_val.string); pref->stashed_val.string = g_strdup(value); } } else if (value) { pref->stashed_val.string = g_strdup(value); } break; case pref_current: if (*pref->varp.string) { if (strcmp(*pref->varp.string, value) != 0) { changed = TRUE; g_free(*pref->varp.string); *pref->varp.string = g_strdup(value); } } else if (value) { *pref->varp.string = g_strdup(value); } break; default: g_assert_not_reached(); break; } return changed; } char* prefs_get_string_value(pref_t *pref, pref_source_t source) { switch (source) { case pref_default: return pref->default_val.string; case pref_stashed: return pref->stashed_val.string; case pref_current: return *pref->varp.string; default: g_assert_not_reached(); break; } return NULL; } /* * Reset the value of a string-like preference. */ static void reset_string_like_preference(pref_t *pref) { g_free(*pref->varp.string); *pref->varp.string = g_strdup(pref->default_val.string); } /* * Register a preference with a character-string value. */ void prefs_register_string_preference(module_t *module, const char *name, const char *title, const char *description, const char **var) { DIAG_OFF(cast-qual) register_string_like_preference(module, name, title, description, (char **)var, PREF_STRING, NULL, FALSE); DIAG_ON(cast-qual) } /* * Register a preference with a file name (string) value. */ void prefs_register_filename_preference(module_t *module, const char *name, const char *title, const char *description, const char **var, gboolean for_writing) { DIAG_OFF(cast-qual) register_string_like_preference(module, name, title, description, (char **)var, for_writing ? PREF_SAVE_FILENAME : PREF_OPEN_FILENAME, NULL, FALSE); DIAG_ON(cast-qual) } /* * Register a preference with a directory name (string) value. */ void prefs_register_directory_preference(module_t *module, const char *name, const char *title, const char *description, const char **var) { DIAG_OFF(cast-qual) register_string_like_preference(module, name, title, description, (char **)var, PREF_DIRNAME, NULL, FALSE); DIAG_ON(cast-qual) } /* Refactoring to handle both PREF_RANGE and PREF_DECODE_AS_RANGE */ static void prefs_register_range_preference_common(module_t *module, const char *name, const char *title, const char *description, range_t **var, guint32 max_value, int type) { pref_t *preference; preference = register_preference(module, name, title, description, type); preference->info.max_value = max_value; /* * Range preference values should be non-null (as you can't * keep them null after using the preferences GUI, you can at best * have them be empty ranges) and freeable (as we free them * if we change them). * * If the value is a null pointer, make it an empty range. */ if (*var == NULL) *var = range_empty(wmem_epan_scope()); preference->varp.range = var; preference->default_val.range = range_copy(wmem_epan_scope(), *var); preference->stashed_val.range = NULL; } /* * Register a preference with a ranged value. */ void prefs_register_range_preference(module_t *module, const char *name, const char *title, const char *description, range_t **var, guint32 max_value) { prefs_register_range_preference_common(module, name, title, description, var, max_value, PREF_RANGE); } gboolean prefs_set_range_value_work(pref_t *pref, const gchar *value, gboolean return_range_errors, gboolean *changed) { range_t *newrange; if (range_convert_str_work(wmem_epan_scope(), &newrange, value, pref->info.max_value, return_range_errors) != CVT_NO_ERROR) { return FALSE; /* number was bad */ } if (!ranges_are_equal(*pref->varp.range, newrange)) { *changed = TRUE; wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = newrange; } else { wmem_free(wmem_epan_scope(), newrange); } return TRUE; } /* * For use by UI code that sets preferences. */ gboolean prefs_set_stashed_range_value(pref_t *pref, const gchar *value) { range_t *newrange; if (range_convert_str_work(wmem_epan_scope(), &newrange, value, pref->info.max_value, TRUE) != CVT_NO_ERROR) { return FALSE; /* number was bad */ } if (!ranges_are_equal(pref->stashed_val.range, newrange)) { wmem_free(wmem_epan_scope(), pref->stashed_val.range); pref->stashed_val.range = newrange; } else { wmem_free(wmem_epan_scope(), newrange); } return TRUE; } gboolean prefs_set_range_value(pref_t *pref, range_t *value, pref_source_t source) { gboolean changed = FALSE; switch (source) { case pref_default: if (!ranges_are_equal(pref->default_val.range, value)) { wmem_free(wmem_epan_scope(), pref->default_val.range); pref->default_val.range = range_copy(wmem_epan_scope(), value); changed = TRUE; } break; case pref_stashed: if (!ranges_are_equal(pref->stashed_val.range, value)) { wmem_free(wmem_epan_scope(), pref->stashed_val.range); pref->stashed_val.range = range_copy(wmem_epan_scope(), value); changed = TRUE; } break; case pref_current: if (!ranges_are_equal(*pref->varp.range, value)) { wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = range_copy(wmem_epan_scope(), value); changed = TRUE; } break; default: g_assert_not_reached(); break; } return changed; } range_t* prefs_get_range_value_real(pref_t *pref, pref_source_t source) { switch (source) { case pref_default: return pref->default_val.range; case pref_stashed: return pref->stashed_val.range; break; case pref_current: return *pref->varp.range; break; default: g_assert_not_reached(); break; } return NULL; } range_t* prefs_get_range_value(const char *module_name, const char* pref_name) { return prefs_get_range_value_real(prefs_find_preference(prefs_find_module(module_name), pref_name), pref_current); } void prefs_range_add_value(pref_t *pref, guint32 val) { range_add_value(wmem_epan_scope(), pref->varp.range, val); } void prefs_range_remove_value(pref_t *pref, guint32 val) { range_remove_value(wmem_epan_scope(), pref->varp.range, val); } /* * Register a static text 'preference'. It can be used to add explanatory * text inline with other preferences in the GUI. * Note: Static preferences are not saved to the preferences file. */ void prefs_register_static_text_preference(module_t *module, const char *name, const char *title, const char *description) { register_preference(module, name, title, description, PREF_STATIC_TEXT); } /* * Register a uat 'preference'. It adds a button that opens the uat's window in the * preferences tab of the module. */ extern void prefs_register_uat_preference(module_t *module, const char *name, const char *title, const char *description, uat_t* uat) { pref_t* preference = register_preference(module, name, title, description, PREF_UAT); preference->varp.uat = uat; } /* * Register a uat 'preference' for QT only. It adds a button that opens the uat's window in the * preferences tab of the module. */ extern void prefs_register_uat_preference_qt(module_t *module, const char *name, const char *title, const char *description, uat_t* uat) { pref_t* preference = register_preference(module, name, title, description, PREF_UAT); preference->varp.uat = uat; preference->gui = GUI_QT; } struct epan_uat* prefs_get_uat_value(pref_t *pref) { return pref->varp.uat; } /* * Register a color preference. */ void prefs_register_color_preference(module_t *module, const char *name, const char *title, const char *description, color_t *color) { pref_t* preference = register_preference(module, name, title, description, PREF_COLOR); preference->varp.colorp = color; preference->default_val.color = *color; } gboolean prefs_set_color_value(pref_t *pref, color_t value, pref_source_t source) { gboolean changed = FALSE; switch (source) { case pref_default: if ((pref->default_val.color.red != value.red) && (pref->default_val.color.green != value.green) && (pref->default_val.color.blue != value.blue)) { changed = TRUE; pref->default_val.color = value; } break; case pref_stashed: if ((pref->stashed_val.color.red != value.red) && (pref->stashed_val.color.green != value.green) && (pref->stashed_val.color.blue != value.blue)) { changed = TRUE; pref->stashed_val.color = value; } break; case pref_current: if ((pref->varp.colorp->red != value.red) && (pref->varp.colorp->green != value.green) && (pref->varp.colorp->blue != value.blue)) { changed = TRUE; *pref->varp.colorp = value; } break; default: g_assert_not_reached(); break; } return changed; } color_t* prefs_get_color_value(pref_t *pref, pref_source_t source) { switch (source) { case pref_default: return &pref->default_val.color; case pref_stashed: return &pref->stashed_val.color; break; case pref_current: return pref->varp.colorp; break; default: g_assert_not_reached(); break; } return NULL; } /* * Register a "custom" preference with a list. * XXX - This should be temporary until we can find a better way * to do "custom" preferences */ typedef void (*pref_custom_list_init_cb) (pref_t* pref, GList** value); static void prefs_register_list_custom_preference(module_t *module, const char *name, const char *title, const char *description, struct pref_custom_cbs* custom_cbs, pref_custom_list_init_cb init_cb, GList** list) { pref_t* preference = register_preference(module, name, title, description, PREF_CUSTOM); preference->custom_cbs = *custom_cbs; init_cb(preference, list); } /* * Register a custom preference. */ void prefs_register_custom_preference(module_t *module, const char *name, const char *title, const char *description, struct pref_custom_cbs* custom_cbs, void **custom_data _U_) { pref_t* preference = register_preference(module, name, title, description, PREF_CUSTOM); preference->custom_cbs = *custom_cbs; /* XXX - wait until we can handle void** pointers preference->custom_cbs.init_cb(preference, custom_data); */ } /* * Register a (internal) "Decode As" preference with a ranged value. */ void prefs_register_decode_as_range_preference(module_t *module, const char *name, const char *title, const char *description, range_t **var, guint32 max_value) { prefs_register_range_preference_common(module, name, title, description, var, max_value, PREF_DECODE_AS_RANGE); } /* * Register a (internal) "Decode As" preference with an unsigned integral value * for a dissector table. */ void prefs_register_decode_as_preference(module_t *module, const char *name, const char *title, const char *description, guint *var) { pref_t *preference; preference = register_preference(module, name, title, description, PREF_DECODE_AS_UINT); preference->varp.uint = var; preference->default_val.uint = *var; /* XXX - Presume base 10 for now */ preference->info.base = 10; } gboolean prefs_add_decode_as_value(pref_t *pref, guint value, gboolean replace) { switch(pref->type) { case PREF_DECODE_AS_UINT: /* This doesn't support multiple values for a dissector in Decode As because the preference only supports a single value. This leads to a "last port for dissector in Decode As wins" */ *pref->varp.uint = value; break; case PREF_DECODE_AS_RANGE: if (replace) { /* If range has single value, replace it */ if (((*pref->varp.range)->nranges == 1) && ((*pref->varp.range)->ranges[0].low == (*pref->varp.range)->ranges[0].high)) { wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = range_empty(wmem_epan_scope()); } } prefs_range_add_value(pref, value); break; default: /* XXX - Worth asserting over? */ break; } return TRUE; } gboolean prefs_remove_decode_as_value(pref_t *pref, guint value, gboolean set_default) { switch(pref->type) { case PREF_DECODE_AS_UINT: if (set_default) { *pref->varp.uint = pref->default_val.uint; } else { *pref->varp.uint = 0; } break; case PREF_DECODE_AS_RANGE: prefs_range_remove_value(pref, value); break; default: break; } return TRUE; } /* * Register a preference that used to be supported but no longer is. */ void prefs_register_obsolete_preference(module_t *module, const char *name) { register_preference(module, name, NULL, NULL, PREF_OBSOLETE); } /* * Check to see if a preference is obsolete. */ extern gboolean prefs_get_preference_obsolete(pref_t *pref) { if (pref) return (IS_PREF_OBSOLETE(pref->type) ? TRUE : FALSE); return TRUE; } /* * Make a preference obsolete. */ extern prefs_set_pref_e prefs_set_preference_obsolete(pref_t *pref) { if (pref) { SET_PREF_OBSOLETE(pref->type); return PREFS_SET_OK; } return PREFS_SET_NO_SUCH_PREF; } guint pref_stash(pref_t *pref, gpointer unused _U_) { switch (pref->type) { case PREF_DECODE_AS_UINT: pref->stashed_val.uint = *pref->varp.uint; break; case PREF_UINT: pref->stashed_val.uint = *pref->varp.uint; break; case PREF_BOOL: pref->stashed_val.boolval = *pref->varp.boolp; break; case PREF_ENUM: pref->stashed_val.enumval = *pref->varp.enump; break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: g_free(pref->stashed_val.string); pref->stashed_val.string = g_strdup(*pref->varp.string); break; case PREF_DECODE_AS_RANGE: case PREF_RANGE: wmem_free(wmem_epan_scope(), pref->stashed_val.range); pref->stashed_val.range = range_copy(wmem_epan_scope(), *pref->varp.range); break; case PREF_COLOR: pref->stashed_val.color = *pref->varp.colorp; break; case PREF_STATIC_TEXT: case PREF_UAT: case PREF_CUSTOM: break; case PREF_OBSOLETE: g_assert_not_reached(); break; } return 0; } guint pref_unstash(pref_t *pref, gpointer unstash_data_p) { pref_unstash_data_t *unstash_data = (pref_unstash_data_t *)unstash_data_p; dissector_table_t sub_dissectors = NULL; dissector_handle_t handle = NULL; /* Revert the preference to its saved value. */ switch (pref->type) { case PREF_DECODE_AS_UINT: if (*pref->varp.uint != pref->stashed_val.uint) { unstash_data->module->prefs_changed = TRUE; if (unstash_data->handle_decode_as) { if (*pref->varp.uint != pref->default_val.uint) { dissector_reset_uint(pref->name, *pref->varp.uint); } } *pref->varp.uint = pref->stashed_val.uint; if (unstash_data->handle_decode_as) { sub_dissectors = find_dissector_table(pref->name); if (sub_dissectors != NULL) { handle = dissector_table_get_dissector_handle(sub_dissectors, (gchar*)unstash_data->module->title); if (handle != NULL) { dissector_change_uint(pref->name, *pref->varp.uint, handle); } } } } break; case PREF_UINT: if (*pref->varp.uint != pref->stashed_val.uint) { unstash_data->module->prefs_changed = TRUE; *pref->varp.uint = pref->stashed_val.uint; } break; case PREF_BOOL: if (*pref->varp.boolp != pref->stashed_val.boolval) { unstash_data->module->prefs_changed = TRUE; *pref->varp.boolp = pref->stashed_val.boolval; } break; case PREF_ENUM: if (*pref->varp.enump != pref->stashed_val.enumval) { unstash_data->module->prefs_changed = TRUE; *pref->varp.enump = pref->stashed_val.enumval; } break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: if (strcmp(*pref->varp.string, pref->stashed_val.string) != 0) { unstash_data->module->prefs_changed = TRUE; g_free(*pref->varp.string); *pref->varp.string = g_strdup(pref->stashed_val.string); } break; case PREF_DECODE_AS_RANGE: if (!ranges_are_equal(*pref->varp.range, pref->stashed_val.range)) { guint32 i, j; unstash_data->module->prefs_changed = TRUE; if (unstash_data->handle_decode_as) { sub_dissectors = find_dissector_table(pref->name); if (sub_dissectors != NULL) { handle = dissector_table_get_dissector_handle(sub_dissectors, (gchar*)unstash_data->module->title); if (handle != NULL) { /* Delete all of the old values from the dissector table */ for (i = 0; i < (*pref->varp.range)->nranges; i++) { for (j = (*pref->varp.range)->ranges[i].low; j < (*pref->varp.range)->ranges[i].high; j++) { dissector_delete_uint(pref->name, j, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(j), NULL, NULL); } dissector_delete_uint(pref->name, (*pref->varp.range)->ranges[i].high, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER((*pref->varp.range)->ranges[i].high), NULL, NULL); } } } } wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = range_copy(wmem_epan_scope(), pref->stashed_val.range); if (unstash_data->handle_decode_as) { if ((sub_dissectors != NULL) && (handle != NULL)) { /* Add new values to the dissector table */ for (i = 0; i < (*pref->varp.range)->nranges; i++) { for (j = (*pref->varp.range)->ranges[i].low; j < (*pref->varp.range)->ranges[i].high; j++) { dissector_change_uint(pref->name, j, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(j), NULL, NULL); } dissector_change_uint(pref->name, (*pref->varp.range)->ranges[i].high, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER((*pref->varp.range)->ranges[i].high), NULL, NULL); } } } } break; case PREF_RANGE: if (!ranges_are_equal(*pref->varp.range, pref->stashed_val.range)) { unstash_data->module->prefs_changed = TRUE; wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = range_copy(wmem_epan_scope(), pref->stashed_val.range); } break; case PREF_COLOR: *pref->varp.colorp = pref->stashed_val.color; break; case PREF_STATIC_TEXT: case PREF_UAT: case PREF_CUSTOM: break; case PREF_OBSOLETE: g_assert_not_reached(); break; } return 0; } void reset_stashed_pref(pref_t *pref) { switch (pref->type) { case PREF_DECODE_AS_UINT: pref->stashed_val.uint = pref->default_val.uint; break; case PREF_UINT: pref->stashed_val.uint = pref->default_val.uint; break; case PREF_BOOL: pref->stashed_val.boolval = pref->default_val.boolval; break; case PREF_ENUM: pref->stashed_val.enumval = pref->default_val.enumval; break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: g_free(pref->stashed_val.string); pref->stashed_val.string = g_strdup(pref->default_val.string); break; case PREF_DECODE_AS_RANGE: case PREF_RANGE: wmem_free(wmem_epan_scope(), pref->stashed_val.range); pref->stashed_val.range = range_copy(wmem_epan_scope(), pref->default_val.range); break; case PREF_COLOR: memcpy(&pref->stashed_val.color, &pref->default_val.color, sizeof(color_t)); break; case PREF_STATIC_TEXT: case PREF_UAT: case PREF_CUSTOM: break; case PREF_OBSOLETE: g_assert_not_reached(); break; } } guint pref_clean_stash(pref_t *pref, gpointer unused _U_) { switch (pref->type) { case PREF_UINT: case PREF_DECODE_AS_UINT: break; case PREF_BOOL: break; case PREF_ENUM: break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: if (pref->stashed_val.string != NULL) { g_free(pref->stashed_val.string); pref->stashed_val.string = NULL; } break; case PREF_DECODE_AS_RANGE: case PREF_RANGE: if (pref->stashed_val.range != NULL) { wmem_free(wmem_epan_scope(), pref->stashed_val.range); pref->stashed_val.range = NULL; } break; case PREF_STATIC_TEXT: case PREF_UAT: case PREF_COLOR: case PREF_CUSTOM: break; case PREF_OBSOLETE: g_assert_not_reached(); break; } return 0; } #if 0 /* Return the value assigned to the given uint preference. */ guint prefs_get_uint_preference(pref_t *pref) { if (pref && pref->type == PREF_UINT) return *pref->varp.uint; return 0; } #endif /* * Call a callback function, with a specified argument, for each preference * in a given module. * * If any of the callbacks return a non-zero value, stop and return that * value, otherwise return 0. */ guint prefs_pref_foreach(module_t *module, pref_cb callback, gpointer user_data) { GList *elem; pref_t *pref; guint ret; for (elem = g_list_first(module->prefs); elem != NULL; elem = g_list_next(elem)) { pref = (pref_t *)elem->data; if (IS_PREF_OBSOLETE(pref->type)) { /* * This preference is no longer supported; it's * not a real preference, so we don't call the * callback for it (i.e., we treat it as if it * weren't found in the list of preferences, * and we weren't called in the first place). */ continue; } ret = (*callback)(pref, user_data); if (ret != 0) return ret; } return 0; } static const enum_val_t print_format_vals[] = { { "text", "Plain Text", PR_FMT_TEXT }, { "postscript", "Postscript", PR_FMT_PS }, { NULL, NULL, 0 } }; static const enum_val_t print_dest_vals[] = { #ifdef _WIN32 /* "PR_DEST_CMD" means "to printer" on Windows */ { "command", "Printer", PR_DEST_CMD }, #else { "command", "Command", PR_DEST_CMD }, #endif { "file", "File", PR_DEST_FILE }, { NULL, NULL, 0 } }; static const enum_val_t st_sort_col_vals[] = { { "name", "Node name (topic/item)", ST_SORT_COL_NAME }, { "count", "Item count", ST_SORT_COL_COUNT }, { "average", "Average value of the node", ST_SORT_COL_AVG }, { "min", "Minimum value of the node", ST_SORT_COL_MIN }, { "max", "Maximum value of the node", ST_SORT_COL_MAX }, { "burst", "Burst rate of the node", ST_SORT_COL_BURSTRATE }, { NULL, NULL, 0 } }; static void stats_callback(void) { /* Test for a sane tap update interval */ if (prefs.tap_update_interval < 100 || prefs.tap_update_interval > 10000) prefs.tap_update_interval = TAP_UPDATE_DEFAULT_INTERVAL; #ifdef HAVE_LIBPORTAUDIO /* Test for a sane max channels entry */ if (prefs.rtp_player_max_visible < 1 || prefs.rtp_player_max_visible > 10) prefs.rtp_player_max_visible = RTP_PLAYER_DEFAULT_VISIBLE; #endif /* burst resolution can't be less than 1 (ms) */ if (prefs.st_burst_resolution < 1) { prefs.st_burst_resolution = 1; } else if (prefs.st_burst_resolution > ST_MAX_BURSTRES) { prefs.st_burst_resolution = ST_MAX_BURSTRES; } /* make sure burst window value makes sense */ if (prefs.st_burst_windowlen < prefs.st_burst_resolution) { prefs.st_burst_windowlen = prefs.st_burst_resolution; } /* round burst window down to multiple of resolution */ prefs.st_burst_windowlen -= prefs.st_burst_windowlen%prefs.st_burst_resolution; if ((prefs.st_burst_windowlen/prefs.st_burst_resolution) > ST_MAX_BURSTBUCKETS) { prefs.st_burst_windowlen = prefs.st_burst_resolution*ST_MAX_BURSTBUCKETS; } } static void gui_callback(void) { /* Ensure there is at least one file count */ if (prefs.gui_recent_files_count_max == 0) prefs.gui_recent_files_count_max = 10; /* Ensure there is at least one display filter entry */ if (prefs.gui_recent_df_entries_max == 0) prefs.gui_recent_df_entries_max = 10; } static void gui_layout_callback(void) { if (prefs.gui_layout_type == layout_unused || prefs.gui_layout_type >= layout_type_max) { /* XXX - report an error? It's not a syntax error - we'd need to add a way of reporting a *semantic* error. */ prefs.gui_layout_type = layout_type_5; } } /****************************************************** * All custom preference function callbacks ******************************************************/ static void custom_pref_no_cb(pref_t* pref _U_) {} /* * Console log level custom preference functions */ static void console_log_level_reset_cb(pref_t* pref) { *pref->varp.uint = pref->default_val.uint; } static prefs_set_pref_e console_log_level_set_cb(pref_t* pref, const gchar* value, gboolean* changed) { guint uval; uval = (guint)strtoul(value, NULL, 10); if (*pref->varp.uint != uval) { *changed = TRUE; *pref->varp.uint = uval; } if (*pref->varp.uint & (G_LOG_LEVEL_INFO|G_LOG_LEVEL_DEBUG)) { /* * GLib >= 2.32 drops INFO and DEBUG messages by default. Tell * it not to do that. */ g_setenv("G_MESSAGES_DEBUG", "all", TRUE); } return PREFS_SET_OK; } static const char * console_log_level_type_name_cb(void) { return "Log level"; } static char * console_log_level_type_description_cb(void) { return g_strdup_printf( "Console log level (for debugging)\n" "A bitmask of log levels:\n" "ERROR = 4\n" "CRITICAL = 8\n" "WARNING = 16\n" "MESSAGE = 32\n" "INFO = 64\n" "DEBUG = 128"); } static gboolean console_log_level_is_default_cb(pref_t* pref) { return *pref->varp.uint == pref->default_val.uint; } static char * console_log_level_to_str_cb(pref_t* pref, gboolean default_val) { return g_strdup_printf("%u", default_val ? pref->default_val.uint : *pref->varp.uint); } /* * Column preference functions */ #define PRS_COL_HIDDEN "column.hidden" #define PRS_COL_FMT "column.format" #define PRS_COL_NUM "column.number" static module_t *gui_column_module = NULL; static prefs_set_pref_e column_hidden_set_cb(pref_t* pref, const gchar* value, gboolean* changed) { GList *clp; fmt_data *cfmt; pref_t *format_pref; (*changed) |= prefs_set_string_value(pref, value, pref_current); /* * Set the "visible" flag for the existing columns; we need to * do this if we set PRS_COL_HIDDEN but don't set PRS_COL_FMT * after setting it (which might be the case if, for example, we * set PRS_COL_HIDDEN on the command line). */ format_pref = prefs_find_preference(gui_column_module, PRS_COL_FMT); for (clp = *format_pref->varp.list; clp != NULL; clp = clp->next) { cfmt = (fmt_data *)clp->data; cfmt->visible = prefs_is_column_visible(*pref->varp.string, cfmt); } return PREFS_SET_OK; } static const char * column_hidden_type_name_cb(void) { return "Packet list hidden columns"; } static char * column_hidden_type_description_cb(void) { return g_strdup("List all columns to hide in the packet list."); } static char * column_hidden_to_str_cb(pref_t* pref, gboolean default_val) { GString *cols_hidden = g_string_new (""); GList *clp; fmt_data *cfmt; pref_t *format_pref; if (default_val) return g_strdup(pref->default_val.string); format_pref = prefs_find_preference(gui_column_module, PRS_COL_FMT); clp = (format_pref) ? *format_pref->varp.list : NULL; while (clp) { gchar *prefs_fmt; cfmt = (fmt_data *) clp->data; if ((cfmt->fmt == COL_CUSTOM) && (cfmt->custom_fields)) { prefs_fmt = g_strdup_printf("%s:%s:%d:%c", col_format_to_string(cfmt->fmt), cfmt->custom_fields, cfmt->custom_occurrence, cfmt->resolved ? 'R' : 'U'); } else { prefs_fmt = g_strdup(col_format_to_string(cfmt->fmt)); } if (!cfmt->visible) { if (cols_hidden->len) g_string_append (cols_hidden, ","); g_string_append (cols_hidden, prefs_fmt); } g_free(prefs_fmt); clp = clp->next; } return g_string_free (cols_hidden, FALSE); } static gboolean column_hidden_is_default_cb(pref_t* pref) { char *cur_hidden_str = column_hidden_to_str_cb(pref, FALSE); gboolean is_default = g_strcmp0(cur_hidden_str, pref->default_val.string) == 0; g_free(cur_hidden_str); return is_default; } /* Number of columns "preference". This is only used internally and is not written to the * preference file */ static void column_num_reset_cb(pref_t* pref) { *pref->varp.uint = pref->default_val.uint; } static prefs_set_pref_e column_num_set_cb(pref_t* pref _U_, const gchar* value _U_, gboolean* changed _U_) { /* Don't write this to the preferences file */ return PREFS_SET_OK; } static const char * column_num_type_name_cb(void) { return NULL; } static char * column_num_type_description_cb(void) { return g_strdup(""); } static gboolean column_num_is_default_cb(pref_t* pref _U_) { return TRUE; } static char * column_num_to_str_cb(pref_t* pref _U_, gboolean default_val _U_) { return g_strdup(""); } /* * Column format custom preference functions */ static void column_format_init_cb(pref_t* pref, GList** value) { fmt_data *src_cfmt, *dest_cfmt; GList *entry; pref->varp.list = value; pref->default_val.list = NULL; for (entry = *pref->varp.list; entry != NULL; entry = g_list_next(entry)) { src_cfmt = (fmt_data *)entry->data; dest_cfmt = g_new(fmt_data,1); dest_cfmt->title = g_strdup(src_cfmt->title); dest_cfmt->fmt = src_cfmt->fmt; if (src_cfmt->custom_fields) { dest_cfmt->custom_fields = g_strdup(src_cfmt->custom_fields); dest_cfmt->custom_occurrence = src_cfmt->custom_occurrence; } else { dest_cfmt->custom_fields = NULL; dest_cfmt->custom_occurrence = 0; } dest_cfmt->visible = src_cfmt->visible; dest_cfmt->resolved = src_cfmt->resolved; pref->default_val.list = g_list_append(pref->default_val.list, dest_cfmt); } } static void column_format_free_cb(pref_t* pref) { free_col_info(*pref->varp.list); free_col_info(pref->default_val.list); } static void column_format_reset_cb(pref_t* pref) { fmt_data *src_cfmt, *dest_cfmt; GList *entry; pref_t *col_num_pref; free_col_info(*pref->varp.list); *pref->varp.list = NULL; for (entry = pref->default_val.list; entry != NULL; entry = g_list_next(entry)) { src_cfmt = (fmt_data *)entry->data; dest_cfmt = g_new(fmt_data,1); dest_cfmt->title = g_strdup(src_cfmt->title); dest_cfmt->fmt = src_cfmt->fmt; if (src_cfmt->custom_fields) { dest_cfmt->custom_fields = g_strdup(src_cfmt->custom_fields); dest_cfmt->custom_occurrence = src_cfmt->custom_occurrence; } else { dest_cfmt->custom_fields = NULL; dest_cfmt->custom_occurrence = 0; } dest_cfmt->visible = src_cfmt->visible; dest_cfmt->resolved = src_cfmt->resolved; *pref->varp.list = g_list_append(*pref->varp.list, dest_cfmt); } col_num_pref = prefs_find_preference(gui_column_module, PRS_COL_NUM); g_assert(col_num_pref != NULL); /* Should never happen */ column_num_reset_cb(col_num_pref); } static prefs_set_pref_e column_format_set_cb(pref_t* pref, const gchar* value, gboolean* changed _U_) { GList *col_l, *col_l_elt; fmt_data *cfmt; gint llen; pref_t *hidden_pref, *col_num_pref; col_l = prefs_get_string_list(value); if (col_l == NULL) return PREFS_SET_SYNTAX_ERR; if ((g_list_length(col_l) % 2) != 0) { /* A title didn't have a matching format. */ prefs_clear_string_list(col_l); return PREFS_SET_SYNTAX_ERR; } /* Check to make sure all column formats are valid. */ col_l_elt = g_list_first(col_l); while (col_l_elt) { fmt_data cfmt_check; /* Go past the title. */ col_l_elt = col_l_elt->next; /* Parse the format to see if it's valid. */ if (!parse_column_format(&cfmt_check, (char *)col_l_elt->data)) { /* It's not a valid column format. */ prefs_clear_string_list(col_l); return PREFS_SET_SYNTAX_ERR; } if (cfmt_check.fmt != COL_CUSTOM) { /* Some predefined columns have been migrated to use custom columns. * We'll convert these silently here */ try_convert_to_custom_column(&col_l_elt->data); } else { /* We don't need the custom column field on this pass. */ g_free(cfmt_check.custom_fields); } /* Go past the format. */ col_l_elt = col_l_elt->next; } /* They're all valid; process them. */ free_col_info(*pref->varp.list); *pref->varp.list = NULL; hidden_pref = prefs_find_preference(gui_column_module, PRS_COL_HIDDEN); g_assert(hidden_pref != NULL); /* Should never happen */ col_num_pref = prefs_find_preference(gui_column_module, PRS_COL_NUM); g_assert(col_num_pref != NULL); /* Should never happen */ llen = g_list_length(col_l); *col_num_pref->varp.uint = llen / 2; col_l_elt = g_list_first(col_l); while (col_l_elt) { cfmt = g_new(fmt_data,1); cfmt->title = g_strdup((gchar *)col_l_elt->data); col_l_elt = col_l_elt->next; parse_column_format(cfmt, (char *)col_l_elt->data); cfmt->visible = prefs_is_column_visible(*hidden_pref->varp.string, cfmt); col_l_elt = col_l_elt->next; *pref->varp.list = g_list_append(*pref->varp.list, cfmt); } prefs_clear_string_list(col_l); free_string_like_preference(hidden_pref); return PREFS_SET_OK; } static const char * column_format_type_name_cb(void) { return "Packet list column format"; } static char * column_format_type_description_cb(void) { return g_strdup("Each pair of strings consists of a column title and its format"); } static gboolean column_format_is_default_cb(pref_t* pref) { GList *clp = *pref->varp.list, *pref_col = g_list_first(clp), *def_col = g_list_first(pref->default_val.list); fmt_data *cfmt, *def_cfmt; gboolean is_default = TRUE; pref_t *col_num_pref; /* See if the column data has changed from the default */ col_num_pref = prefs_find_preference(gui_column_module, PRS_COL_NUM); if (col_num_pref && *col_num_pref->varp.uint != col_num_pref->default_val.uint) { is_default = FALSE; } else { while (pref_col && def_col) { cfmt = (fmt_data *) pref_col->data; def_cfmt = (fmt_data *) def_col->data; if ((g_strcmp0(cfmt->title, def_cfmt->title) != 0) || (cfmt->fmt != def_cfmt->fmt) || (((cfmt->fmt == COL_CUSTOM) && (cfmt->custom_fields)) && ((g_strcmp0(cfmt->custom_fields, def_cfmt->custom_fields) != 0) || (cfmt->resolved != def_cfmt->resolved)))) { is_default = FALSE; break; } pref_col = pref_col->next; def_col = def_col->next; } } return is_default; } static char * column_format_to_str_cb(pref_t* pref, gboolean default_val) { GList *pref_l = default_val ? pref->default_val.list : *pref->varp.list; GList *clp = g_list_first(pref_l); GList *col_l; fmt_data *cfmt; gchar *prefs_fmt; char *column_format_str; col_l = NULL; while (clp) { cfmt = (fmt_data *) clp->data; col_l = g_list_append(col_l, g_strdup(cfmt->title)); if ((cfmt->fmt == COL_CUSTOM) && (cfmt->custom_fields)) { prefs_fmt = g_strdup_printf("%s:%s:%d:%c", col_format_to_string(cfmt->fmt), cfmt->custom_fields, cfmt->custom_occurrence, cfmt->resolved ? 'R' : 'U'); } else { prefs_fmt = g_strdup(col_format_to_string(cfmt->fmt)); } col_l = g_list_append(col_l, prefs_fmt); clp = clp->next; } column_format_str = join_string_list(col_l); prefs_clear_string_list(col_l); return column_format_str; } /****** Capture column custom preference functions ******/ /* This routine is only called when Wireshark is started, NOT when another profile is selected. Copy the pref->capture_columns list (just loaded with the capture_cols[] struct values) to prefs->default_val.list. */ static void capture_column_init_cb(pref_t* pref, GList** capture_cols_values) { GList *ccv_list = *capture_cols_values, *dlist = NULL; /* */ while (ccv_list) { dlist = g_list_append(dlist, g_strdup((gchar *)ccv_list->data)); ccv_list = ccv_list->next; } pref->default_val.list = dlist; pref->varp.list = &prefs.capture_columns; pref->stashed_val.boolval = FALSE; } /* Free the prefs->capture_columns list strings and remove the list entries. Note that since pref->varp.list points to &prefs.capture_columns, it is also freed. */ static void capture_column_free_cb(pref_t* pref) { prefs_clear_string_list(prefs.capture_columns); prefs.capture_columns = NULL; if (pref->stashed_val.boolval == TRUE) { prefs_clear_string_list(pref->default_val.list); pref->default_val.list = NULL; } } /* Copy pref->default_val.list to *pref->varp.list. */ static void capture_column_reset_cb(pref_t* pref) { GList *vlist = NULL, *dlist; /* Free the column name strings and remove the links from *pref->varp.list */ prefs_clear_string_list(*pref->varp.list); for (dlist = pref->default_val.list; dlist != NULL; dlist = g_list_next(dlist)) { vlist = g_list_append(vlist, g_strdup((gchar *)dlist->data)); } *pref->varp.list = vlist; } static prefs_set_pref_e capture_column_set_cb(pref_t* pref, const gchar* value, gboolean* changed _U_) { GList *col_l = prefs_get_string_list(value); GList *col_l_elt; gchar *col_name; int i; if (col_l == NULL) return PREFS_SET_SYNTAX_ERR; capture_column_free_cb(pref); /* If value (the list of capture.columns read from preferences) is empty, set capture.columns to the full list of valid capture column names. */ col_l_elt = g_list_first(col_l); if (!(*(gchar *)col_l_elt->data)) { for (i = 0; i < num_capture_cols; i++) { col_name = g_strdup(capture_cols[i]); prefs.capture_columns = g_list_append(prefs.capture_columns, col_name); } } /* Verify that all the column names are valid. If not, use the entire list of valid columns. */ while (col_l_elt) { gboolean found_match = FALSE; col_name = (gchar *)col_l_elt->data; for (i = 0; i < num_capture_cols; i++) { if (strcmp(col_name, capture_cols[i])==0) { found_match = TRUE; break; } } if (!found_match) { /* One or more cols are invalid so use the entire list of valid cols. */ for (i = 0; i < num_capture_cols; i++) { col_name = g_strdup(capture_cols[i]); prefs.capture_columns = g_list_append(prefs.capture_columns, col_name); } pref->varp.list = &prefs.capture_columns; prefs_clear_string_list(col_l); return PREFS_SET_SYNTAX_ERR; } col_l_elt = col_l_elt->next; } col_l_elt = g_list_first(col_l); while (col_l_elt) { col_name = (gchar *)col_l_elt->data; prefs.capture_columns = g_list_append(prefs.capture_columns, col_name); col_l_elt = col_l_elt->next; } pref->varp.list = &prefs.capture_columns; g_list_free(col_l); return PREFS_SET_OK; } static const char * capture_column_type_name_cb(void) { return "Column list"; } static char * capture_column_type_description_cb(void) { return g_strdup( "List of columns to be displayed in the capture options dialog.\n" CAPTURE_COL_TYPE_DESCRIPTION); } static gboolean capture_column_is_default_cb(pref_t* pref) { GList *pref_col = g_list_first(prefs.capture_columns), *def_col = g_list_first(pref->default_val.list); gboolean is_default = TRUE; /* See if the column data has changed from the default */ while (pref_col && def_col) { if (strcmp((gchar *)pref_col->data, (gchar *)def_col->data) != 0) { is_default = FALSE; break; } pref_col = pref_col->next; def_col = def_col->next; } /* Ensure the same column count */ if (((pref_col == NULL) && (def_col != NULL)) || ((pref_col != NULL) && (def_col == NULL))) is_default = FALSE; return is_default; } static char * capture_column_to_str_cb(pref_t* pref, gboolean default_val) { GList *pref_l = default_val ? pref->default_val.list : prefs.capture_columns; GList *clp = g_list_first(pref_l); GList *col_l = NULL; gchar *col; char *capture_column_str; while (clp) { col = (gchar *) clp->data; col_l = g_list_append(col_l, g_strdup(col)); clp = clp->next; } capture_column_str = join_string_list(col_l); prefs_clear_string_list(col_l); return capture_column_str; } static prefs_set_pref_e colorized_frame_set_cb(pref_t* pref, const gchar* value, gboolean* changed) { (*changed) |= prefs_set_string_value(pref, value, pref_current); return PREFS_SET_OK; } static const char * colorized_frame_type_name_cb(void) { /* Don't write the colors of the 10 easy-access-colorfilters to the preferences * file until the colors can be changed in the GUI. Currently this is not really * possible since the STOCK-icons for these colors are hardcoded. * * XXX Find a way to change the colors of the STOCK-icons on the fly and then * add these 10 colors to the list of colors that can be changed through * the preferences. * */ return NULL; } static char * colorized_frame_type_description_cb(void) { return g_strdup(""); } static gboolean colorized_frame_is_default_cb(pref_t* pref _U_) { return TRUE; } static char * colorized_frame_to_str_cb(pref_t* pref _U_, gboolean default_val _U_) { return g_strdup(""); } /* * Register all non-dissector modules' preferences. */ static module_t *gui_module = NULL; static module_t *gui_color_module = NULL; static module_t *nameres_module = NULL; static void prefs_register_modules(void) { module_t *printing, *capture_module, *console_module, *gui_layout_module, *gui_font_module; #ifdef HAVE_EXTCAP module_t *extcap_module; #endif struct pref_custom_cbs custom_cbs; if (protocols_module != NULL) { /* Already setup preferences */ return; } #ifdef HAVE_EXTCAP /* GUI * These are "simple" GUI preferences that can be read/written using the * preference module API. These preferences still use their own * configuration screens for access, but this cuts down on the * preference "string compare list" in set_pref() */ extcap_module = prefs_register_module(NULL, "extcap", "Extcap Utilities", "Extcap Utilities", NULL, FALSE); /* Setting default value to true */ prefs.extcap_save_on_start = TRUE; prefs_register_bool_preference(extcap_module, "gui_save_on_start", "Save arguments on start of capture", "Save arguments on start of capture", &prefs.extcap_save_on_start); #endif /* GUI * These are "simple" GUI preferences that can be read/written using the * preference module API. These preferences still use their own * configuration screens for access, but this cuts down on the * preference "string compare list" in set_pref() */ gui_module = prefs_register_module(NULL, "gui", "User Interface", "User Interface", &gui_callback, FALSE); /* gui.console_open is placed first in the list so that any problems encountered * in the following prefs can be displayed in the console window. */ prefs_register_enum_preference(gui_module, "console_open", "Open a console window", "Open a console window (Windows only)", (gint*)(void*)(&prefs.gui_console_open), gui_console_open_type, FALSE); prefs_register_obsolete_preference(gui_module, "scrollbar_on_right"); prefs_register_obsolete_preference(gui_module, "packet_list_sel_browse"); prefs_register_obsolete_preference(gui_module, "protocol_tree_sel_browse"); prefs_register_bool_preference(gui_module, "tree_view_altern_colors", "Alternating colors in TreeViews", "Alternating colors in TreeViews?", &prefs.gui_altern_colors); prefs_register_bool_preference(gui_module, "expert_composite_eyecandy", "Display Icons on Expert Composite Dialog Tabs", "Display Icons on Expert Composite Dialog Tabs?", &prefs.gui_expert_composite_eyecandy); prefs_register_bool_preference(gui_module, "filter_toolbar_show_in_statusbar", "Place filter toolbar inside the statusbar", "Place filter toolbar inside the statusbar?", &prefs.filter_toolbar_show_in_statusbar); prefs_register_bool_preference(gui_module, "restore_filter_after_following_stream", "Restore current display filter after following a stream", "Restore current display filter after following a stream?", &prefs.restore_filter_after_following_stream); prefs_register_enum_preference(gui_module, "protocol_tree_line_style", "Protocol-tree line style", "Protocol-tree line style", &prefs.gui_ptree_line_style, gui_ptree_line_style, FALSE); prefs_register_enum_preference(gui_module, "protocol_tree_expander_style", "Protocol-tree expander style", "Protocol-tree expander style", &prefs.gui_ptree_expander_style, gui_ptree_expander_style, FALSE); prefs_register_enum_preference(gui_module, "hex_dump_highlight_style", "Hex dump highlight style", "Hex dump highlight style", &prefs.gui_hex_dump_highlight_style, gui_hex_dump_highlight_style, FALSE); gui_column_module = prefs_register_subtree(gui_module, "Columns", "Columns", NULL); custom_cbs.free_cb = free_string_like_preference; custom_cbs.reset_cb = reset_string_like_preference; custom_cbs.set_cb = column_hidden_set_cb; custom_cbs.type_name_cb = column_hidden_type_name_cb; custom_cbs.type_description_cb = column_hidden_type_description_cb; custom_cbs.is_default_cb = column_hidden_is_default_cb; custom_cbs.to_str_cb = column_hidden_to_str_cb; register_string_like_preference(gui_column_module, PRS_COL_HIDDEN, "Packet list hidden columns", "List all columns to hide in the packet list", &cols_hidden_list, PREF_CUSTOM, &custom_cbs, FALSE); custom_cbs.free_cb = column_format_free_cb; custom_cbs.reset_cb = column_format_reset_cb; custom_cbs.set_cb = column_format_set_cb; custom_cbs.type_name_cb = column_format_type_name_cb; custom_cbs.type_description_cb = column_format_type_description_cb; custom_cbs.is_default_cb = column_format_is_default_cb; custom_cbs.to_str_cb = column_format_to_str_cb; prefs_register_list_custom_preference(gui_column_module, PRS_COL_FMT, "Packet list column format", "Each pair of strings consists of a column title and its format", &custom_cbs, column_format_init_cb, &prefs.col_list); /* Number of columns. This is only used internally and is not written to the * preference file */ custom_cbs.free_cb = custom_pref_no_cb; custom_cbs.reset_cb = column_num_reset_cb; custom_cbs.set_cb = column_num_set_cb; custom_cbs.type_name_cb = column_num_type_name_cb; custom_cbs.type_description_cb = column_num_type_description_cb; custom_cbs.is_default_cb = column_num_is_default_cb; custom_cbs.to_str_cb = column_num_to_str_cb; prefs_register_uint_custom_preference(gui_column_module, PRS_COL_NUM, "Number of columns", "Number of columns in col_list", &custom_cbs, &prefs.num_cols); /* User Interface : Font */ gui_font_module = prefs_register_subtree(gui_module, "Font", "Font", NULL); prefs_register_obsolete_preference(gui_font_module, "font_name"); register_string_like_preference(gui_font_module, "gtk2.font_name", "Font name", "Font name for packet list, protocol tree, and hex dump panes. (GTK+)", &prefs.gui_gtk2_font_name, PREF_STRING, NULL, TRUE); register_string_like_preference(gui_font_module, "qt.font_name", "Font name", "Font name for packet list, protocol tree, and hex dump panes. (Qt)", &prefs.gui_qt_font_name, PREF_STRING, NULL, TRUE); /* User Interface : Colors */ gui_color_module = prefs_register_subtree(gui_module, "Colors", "Colors", NULL); prefs_register_color_preference(gui_color_module, "marked_frame.fg", "Color preferences for a marked frame", "Color preferences for a marked frame", &prefs.gui_marked_fg); prefs_register_color_preference(gui_color_module, "marked_frame.bg", "Color preferences for a marked frame", "Color preferences for a marked frame", &prefs.gui_marked_bg); prefs_register_color_preference(gui_color_module, "ignored_frame.fg", "Color preferences for a ignored frame", "Color preferences for a ignored frame", &prefs.gui_ignored_fg); prefs_register_color_preference(gui_color_module, "ignored_frame.bg", "Color preferences for a ignored frame", "Color preferences for a ignored frame", &prefs.gui_ignored_bg); prefs_register_color_preference(gui_color_module, "stream.client.fg", "TCP stream window color preference", "TCP stream window color preference", &prefs.st_client_fg); prefs_register_color_preference(gui_color_module, "stream.client.bg", "TCP stream window color preference", "TCP stream window color preference", &prefs.st_client_bg); prefs_register_color_preference(gui_color_module, "stream.server.fg", "TCP stream window color preference", "TCP stream window color preference", &prefs.st_server_fg); prefs_register_color_preference(gui_color_module, "stream.server.bg", "TCP stream window color preference", "TCP stream window color preference", &prefs.st_server_bg); custom_cbs.free_cb = free_string_like_preference; custom_cbs.reset_cb = reset_string_like_preference; custom_cbs.set_cb = colorized_frame_set_cb; custom_cbs.type_name_cb = colorized_frame_type_name_cb; custom_cbs.type_description_cb = colorized_frame_type_description_cb; custom_cbs.is_default_cb = colorized_frame_is_default_cb; custom_cbs.to_str_cb = colorized_frame_to_str_cb; register_string_like_preference(gui_column_module, "colorized_frame.fg", "Colorized Foreground", "Filter Colorized Foreground", &prefs.gui_colorized_fg, PREF_CUSTOM, &custom_cbs, TRUE); custom_cbs.free_cb = free_string_like_preference; custom_cbs.reset_cb = reset_string_like_preference; custom_cbs.set_cb = colorized_frame_set_cb; custom_cbs.type_name_cb = colorized_frame_type_name_cb; custom_cbs.type_description_cb = colorized_frame_type_description_cb; custom_cbs.is_default_cb = colorized_frame_is_default_cb; custom_cbs.to_str_cb = colorized_frame_to_str_cb; register_string_like_preference(gui_column_module, "colorized_frame.bg", "Colorized Background", "Filter Colorized Background", &prefs.gui_colorized_bg, PREF_CUSTOM, &custom_cbs, TRUE); prefs_register_color_preference(gui_color_module, "color_filter_bg.valid", "Valid color filter background", "Valid color filter background", &prefs.gui_text_valid); prefs_register_color_preference(gui_color_module, "color_filter_bg.invalid", "Invalid color filter background", "Invalid color filter background", &prefs.gui_text_invalid); prefs_register_color_preference(gui_color_module, "color_filter_bg.deprecated", "Deprecated color filter background", "Deprecated color filter background", &prefs.gui_text_deprecated); prefs_register_enum_preference(gui_module, "fileopen.style", "Where to start the File Open dialog box", "Where to start the File Open dialog box", &prefs.gui_fileopen_style, gui_fileopen_style, FALSE); prefs_register_uint_preference(gui_module, "recent_files_count.max", "The max. number of items in the open recent files list", "The max. number of items in the open recent files list", 10, &prefs.gui_recent_files_count_max); prefs_register_uint_preference(gui_module, "recent_display_filter_entries.max", "The max. number of entries in the display filter list", "The max. number of entries in the display filter list", 10, &prefs.gui_recent_df_entries_max); register_string_like_preference(gui_module, "fileopen.dir", "Start Directory", "Directory to start in when opening File Open dialog.", &prefs.gui_fileopen_dir, PREF_DIRNAME, NULL, TRUE); prefs_register_obsolete_preference(gui_module, "fileopen.remembered_dir"); prefs_register_uint_preference(gui_module, "fileopen.preview", "The preview timeout in the File Open dialog", "The preview timeout in the File Open dialog", 10, &prefs.gui_fileopen_preview); prefs_register_bool_preference(gui_module, "ask_unsaved", "Ask to save unsaved capture files", "Ask to save unsaved capture files?", &prefs.gui_ask_unsaved); prefs_register_bool_preference(gui_module, "find_wrap", "Wrap to beginning/end of file during search", "Wrap to beginning/end of file during search?", &prefs.gui_find_wrap); prefs_register_bool_preference(gui_module, "use_pref_save", "Settings dialogs use a save button", "Settings dialogs use a save button?", &prefs.gui_use_pref_save); prefs_register_bool_preference(gui_module, "geometry.save.position", "Save window position at exit", "Save window position at exit?", &prefs.gui_geometry_save_position); prefs_register_bool_preference(gui_module, "geometry.save.size", "Save window size at exit", "Save window size at exit?", &prefs.gui_geometry_save_size); prefs_register_bool_preference(gui_module, "geometry.save.maximized", "Save window maximized state at exit", "Save window maximized state at exit?", &prefs.gui_geometry_save_maximized); /* GTK+ only */ prefs_register_bool_preference(gui_module, "macosx_style", "Use macOS style", "Use macOS style (macOS with native GTK only)?", &prefs.gui_macosx_style); prefs_register_obsolete_preference(gui_module, "geometry.main.x"); prefs_register_obsolete_preference(gui_module, "geometry.main.y"); prefs_register_obsolete_preference(gui_module, "geometry.main.width"); prefs_register_obsolete_preference(gui_module, "geometry.main.height"); prefs_register_obsolete_preference(gui_module, "toolbar_main_show"); prefs_register_enum_preference(gui_module, "toolbar_main_style", "Main Toolbar style", "Main Toolbar style", &prefs.gui_toolbar_main_style, gui_toolbar_style, FALSE); prefs_register_enum_preference(gui_module, "toolbar_filter_style", "Filter Toolbar style", "Filter Toolbar style", &prefs.gui_toolbar_filter_style, gui_toolbar_style, FALSE); register_string_like_preference(gui_module, "webbrowser", "The path to the webbrowser", "The path to the webbrowser (Ex: mozilla)", &prefs.gui_webbrowser, PREF_STRING, NULL, TRUE); prefs_register_bool_preference(gui_module, "update.enabled", "Check for updates", "Check for updates (Windows only)", &prefs.gui_update_enabled); prefs_register_enum_preference(gui_module, "update.channel", "Update channel", "The type of update to fetch. You should probably leave this set to UPDATE_CHANNEL_STABLE.", (gint*)(void*)(&prefs.gui_update_channel), gui_update_channel, FALSE); prefs_register_uint_preference(gui_module, "update.interval", "How often to check for software updates", "How often to check for software updates in seconds", 10, &prefs.gui_update_interval); register_string_like_preference(gui_module, "window_title", "Custom window title", "Custom window title to be appended to the existing title\n%P = profile name\n%V = version info", &prefs.gui_window_title, PREF_STRING, NULL, TRUE); register_string_like_preference(gui_module, "prepend_window_title", "Custom window title prefix", "Custom window title to be prepended to the existing title\n%P = profile name\n%V = version info", &prefs.gui_prepend_window_title, PREF_STRING, NULL, TRUE); register_string_like_preference(gui_module, "start_title", "Custom start page title", "Custom start page title", &prefs.gui_start_title, PREF_STRING, NULL, TRUE); prefs_register_enum_preference(gui_module, "version_placement", "Show version in the start page and/or main screen's title bar", "Show version in the start page and/or main screen's title bar", (gint*)(void*)(&prefs.gui_version_placement), gui_version_placement_type, FALSE); prefs_register_bool_preference(gui_module, "auto_scroll_on_expand", "Automatically scroll packet details", "When selecting a new packet, automatically scroll" "to the packet detail item that matches the most" "recently selected item", &prefs.gui_auto_scroll_on_expand); prefs_register_uint_preference(gui_module, "auto_scroll_percentage", "Packet detail scroll percentage", "The percentage down the view the recently expanded detail item should be scrolled", 10, &prefs.gui_auto_scroll_percentage); /* User Interface : Layout */ gui_layout_module = prefs_register_subtree(gui_module, "Layout", "Layout", gui_layout_callback); prefs_register_uint_preference(gui_layout_module, "layout_type", "Layout type", "Layout type (1-6)", 10, (guint*)(void*)(&prefs.gui_layout_type)); prefs_register_enum_preference(gui_layout_module, "layout_content_1", "Layout content of the pane 1", "Layout content of the pane 1", (gint*)(void*)(&prefs.gui_layout_content_1), gui_layout_content, FALSE); prefs_register_enum_preference(gui_layout_module, "layout_content_2", "Layout content of the pane 2", "Layout content of the pane 2", (gint*)(void*)(&prefs.gui_layout_content_2), gui_layout_content, FALSE); prefs_register_enum_preference(gui_layout_module, "layout_content_3", "Layout content of the pane 3", "Layout content of the pane 3", (gint*)(void*)(&prefs.gui_layout_content_3), gui_layout_content, FALSE); prefs_register_bool_preference(gui_layout_module, "packet_list_separator.enabled", "Enable Packet List Separator", "Enable Packet List Separator", &prefs.gui_qt_packet_list_separator); prefs_register_bool_preference(gui_layout_module, "show_selected_packet.enabled", "Show selected packet in the Status Bar", "Show selected packet in the Status Bar", &prefs.gui_qt_show_selected_packet); prefs_register_bool_preference(gui_layout_module, "show_file_load_time.enabled", "Show file load time in the Status Bar", "Show file load time in the Status Bar", &prefs.gui_qt_show_file_load_time); prefs_register_bool_preference(gui_module, "packet_editor.enabled", "Enable Packet Editor", "Enable Packet Editor (Experimental)", &prefs.gui_packet_editor); prefs_register_enum_preference(gui_module, "packet_list_elide_mode", "Elide mode", "The position of \"...\" in packet list text.", (gint*)(void*)(&prefs.gui_packet_list_elide_mode), gui_packet_list_elide_mode, FALSE); prefs_register_bool_preference(gui_layout_module, "packet_list_show_related", "Show Related Packets", "Show related packet indicators in the first column", &prefs.gui_packet_list_show_related); prefs_register_bool_preference(gui_layout_module, "packet_list_show_minimap", "Enable Intelligent Scroll Bar", "Show the intelligent scroll bar (a minimap of packet list colors in the scrollbar)", &prefs.gui_packet_list_show_minimap); prefs_register_bool_preference(gui_module, "interfaces_show_hidden", "Show hidden interfaces", "Show all interfaces, including interfaces marked as hidden", &prefs.gui_interfaces_show_hidden); #ifdef HAVE_PCAP_REMOTE prefs_register_bool_preference(gui_module, "interfaces_remote_display", "Show Remote interfaces", "Show remote interfaces in the interface selection", &prefs.gui_interfaces_remote_display); #endif register_string_like_preference(gui_module, "interfaces_hidden_types", "Hide interface types in list", "Hide the given interface types in the startup list", &prefs.gui_interfaces_hide_types, PREF_STRING, NULL, TRUE); /* Console * These are preferences that can be read/written using the * preference module API. These preferences still use their own * configuration screens for access, but this cuts down on the * preference "string compare list" in set_pref() */ console_module = prefs_register_module(NULL, "console", "Console", "Console logging and debugging output", NULL, FALSE); custom_cbs.free_cb = custom_pref_no_cb; custom_cbs.reset_cb = console_log_level_reset_cb; custom_cbs.set_cb = console_log_level_set_cb; custom_cbs.type_name_cb = console_log_level_type_name_cb; custom_cbs.type_description_cb = console_log_level_type_description_cb; custom_cbs.is_default_cb = console_log_level_is_default_cb; custom_cbs.to_str_cb = console_log_level_to_str_cb; prefs_register_uint_custom_preference(console_module, "log.level", "logging level", "A bitmask of GLib log levels", &custom_cbs, &prefs.console_log_level); prefs_register_bool_preference(console_module, "incomplete_dissectors_check_debug", "Print debug line for incomplete dissectors", "Look for dissectors that left some bytes undecoded (debug)", &prefs.incomplete_dissectors_check_debug); /* Display filter Expressions * This used to be an array of individual fields that has now been * converted to a UAT. Just make it part of the GUI category even * though the name of the preference will never be seen in preference * file */ filter_expression_register_uat(gui_module); /* Capture * These are preferences that can be read/written using the * preference module API. These preferences still use their own * configuration screens for access, but this cuts down on the * preference "string compare list" in set_pref() */ capture_module = prefs_register_module(NULL, "capture", "Capture", "Capture preferences", NULL, FALSE); register_string_like_preference(capture_module, "device", "Default capture device", "Default capture device", &prefs.capture_device, PREF_STRING, NULL, FALSE); register_string_like_preference(capture_module, "devices_linktypes", "Interface link-layer header type", "Interface link-layer header types (Ex: en0(1),en1(143),...)", &prefs.capture_devices_linktypes, PREF_STRING, NULL, FALSE); register_string_like_preference(capture_module, "devices_descr", "Interface descriptions", "Interface descriptions (Ex: eth0(eth0 descr),eth1(eth1 descr),...)", &prefs.capture_devices_descr, PREF_STRING, NULL, FALSE); register_string_like_preference(capture_module, "devices_hide", "Hide interface", "Hide interface? (Ex: eth0,eth3,...)", &prefs.capture_devices_hide, PREF_STRING, NULL, FALSE); register_string_like_preference(capture_module, "devices_monitor_mode", "Capture in monitor mode", "By default, capture in monitor mode on interface? (Ex: eth0,eth3,...)", &prefs.capture_devices_monitor_mode, PREF_STRING, NULL, FALSE); #ifdef CAN_SET_CAPTURE_BUFFER_SIZE register_string_like_preference(capture_module, "devices_buffersize", "Interface buffer size", "Interface buffer size (Ex: en0(1),en1(143),...)", &prefs.capture_devices_buffersize, PREF_STRING, NULL, FALSE); #endif register_string_like_preference(capture_module, "devices_snaplen", "Interface snap length", "Interface snap length (Ex: en0(65535),en1(1430),...)", &prefs.capture_devices_snaplen, PREF_STRING, NULL, FALSE); register_string_like_preference(capture_module, "devices_pmode", "Interface promiscuous mode", "Interface promiscuous mode (Ex: en0(0),en1(1),...)", &prefs.capture_devices_pmode, PREF_STRING, NULL, FALSE); prefs_register_bool_preference(capture_module, "prom_mode", "Capture in promiscuous mode", "Capture in promiscuous mode?", &prefs.capture_prom_mode); register_string_like_preference(capture_module, "devices_filter", "Interface capture filter", "Interface capture filter (Ex: en0(tcp),en1(udp),...)", &prefs.capture_devices_filter, PREF_STRING, NULL, FALSE); prefs_register_bool_preference(capture_module, "pcap_ng", "Capture in Pcap-NG format", "Capture in Pcap-NG format?", &prefs.capture_pcap_ng); prefs_register_bool_preference(capture_module, "real_time_update", "Update packet list in real time during capture", "Update packet list in real time during capture?", &prefs.capture_real_time); /* We might want to make this a "recent" setting. */ prefs_register_bool_preference(capture_module, "auto_scroll", "Scroll packet list during capture", "Scroll packet list during capture?", &prefs.capture_auto_scroll); /* GTK+ only */ prefs_register_bool_preference(capture_module, "show_info", "Show capture info dialog while capturing", "Show capture info dialog while capturing?", &prefs.capture_show_info); prefs_register_obsolete_preference(capture_module, "syntax_check_filter"); custom_cbs.free_cb = capture_column_free_cb; custom_cbs.reset_cb = capture_column_reset_cb; custom_cbs.set_cb = capture_column_set_cb; custom_cbs.type_name_cb = capture_column_type_name_cb; custom_cbs.type_description_cb = capture_column_type_description_cb; custom_cbs.is_default_cb = capture_column_is_default_cb; custom_cbs.to_str_cb = capture_column_to_str_cb; prefs_register_list_custom_preference(capture_module, "columns", "Capture options dialog column list", "List of columns to be displayed", &custom_cbs, capture_column_init_cb, &prefs.capture_columns); /* Name Resolution */ nameres_module = prefs_register_module(NULL, "nameres", "Name Resolution", "Name Resolution", NULL, TRUE); addr_resolve_pref_init(nameres_module); oid_pref_init(nameres_module); #ifdef HAVE_GEOIP geoip_db_pref_init(nameres_module); #endif /* Printing */ printing = prefs_register_module(NULL, "print", "Printing", "Printing", NULL, TRUE); prefs_register_enum_preference(printing, "format", "Format", "Can be one of \"text\" or \"postscript\"", &prefs.pr_format, print_format_vals, TRUE); prefs_register_enum_preference(printing, "destination", "Print to", "Can be one of \"command\" or \"file\"", &prefs.pr_dest, print_dest_vals, TRUE); #ifndef _WIN32 register_string_like_preference(printing, "command", "Command", "Output gets piped to this command when the destination is set to \"command\"", &prefs.pr_cmd, PREF_STRING, NULL, TRUE); #endif register_string_like_preference(printing, "file", "File", "This is the file that gets written to when the destination is set to \"file\"", &prefs.pr_file, PREF_SAVE_FILENAME, NULL, TRUE); /* Statistics */ stats_module = prefs_register_module(NULL, "statistics", "Statistics", "Statistics", &stats_callback, TRUE); prefs_register_uint_preference(stats_module, "update_interval", "Tap update interval in ms", "Determines time between tap updates", 10, &prefs.tap_update_interval); #ifdef HAVE_LIBPORTAUDIO prefs_register_uint_preference(stats_module, "rtp_player_max_visible", "Max visible channels in RTP Player", "Determines maximum height of RTP Player window", 10, &prefs.rtp_player_max_visible); #endif prefs_register_bool_preference(stats_module, "st_enable_burstinfo", "Enable the calculation of burst information", "If enabled burst rates will be calcuted for statistics that use the stats_tree system. " "Burst rates are calculated over a much shorter time interval than the rate column.", &prefs.st_enable_burstinfo); prefs_register_bool_preference(stats_module, "st_burst_showcount", "Show burst count for item rather than rate", "If selected the stats_tree statistics nodes will show the count of events " "within the burst window instead of a burst rate. Burst rate is calculated " "as number of events within burst window divided by the burst windown length.", &prefs.st_burst_showcount); prefs_register_uint_preference(stats_module, "st_burst_resolution", "Burst rate resolution (ms)", "Sets the duration of the time interval into which events are grouped when calculating " "the burst rate. Higher resolution (smaller number) increases processing overhead.", 10,&prefs.st_burst_resolution); prefs_register_uint_preference(stats_module, "st_burst_windowlen", "Burst rate window size (ms)", "Sets the duration of the sliding window during which the burst rate is " "measured. Longer window relative to burst rate resolution increases " "processing overhead. Will be truncated to a multiple of burst resolution.", 10,&prefs.st_burst_windowlen); prefs_register_enum_preference(stats_module, "st_sort_defcolflag", "Default sort column for stats_tree stats", "Sets the default column by which stats based on the stats_tree " "system is sorted.", &prefs.st_sort_defcolflag, st_sort_col_vals, FALSE); prefs_register_bool_preference(stats_module, "st_sort_defdescending", "Default stats_tree sort order is descending", "When selected, statistics based on the stats_tree system will by default " "be sorted in descending order.", &prefs.st_sort_defdescending); prefs_register_bool_preference(stats_module, "st_sort_casesensitve", "Case sensitive sort of stats_tree item names", "When selected, the item/node names of statistics based on the stats_tree " "system will be sorted taking case into account. Else the case of the name " "will be ignored.", &prefs.st_sort_casesensitve); prefs_register_bool_preference(stats_module, "st_sort_rng_nameonly", "Always sort 'range' nodes by name", "When selected, the stats_tree nodes representing a range of values " "(0-49, 50-100, etc.) will always be sorted by name (the range of the " "node). Else range nodes are sorted by the same column as the rest of " " the tree.", &prefs.st_sort_rng_nameonly); prefs_register_bool_preference(stats_module, "st_sort_rng_fixorder", "Always sort 'range' nodes in ascending order", "When selected, the stats_tree nodes representing a range of values " "(0-49, 50-100, etc.) will always be sorted ascending; else it follows " "the sort direction of the tree. Only effective if \"Always sort " "'range' nodes by name\" is also selected.", &prefs.st_sort_rng_fixorder); prefs_register_bool_preference(stats_module, "st_sort_showfullname", "Display the full stats_tree plug-in name", "When selected, the full name (including menu path) of the stats_tree " "plug-in is show in windows. If cleared the plug-in name is shown " "without menu path (only the part of the name after last '/' character.)", &prefs.st_sort_showfullname); /* Protocols */ protocols_module = prefs_register_module(NULL, "protocols", "Protocols", "Protocols", NULL, TRUE); prefs_register_bool_preference(protocols_module, "display_hidden_proto_items", "Display hidden protocol items", "Display all hidden protocol items in the packet list.", &prefs.display_hidden_proto_items); prefs_register_bool_preference(protocols_module, "display_byte_fields_with_spaces", "Display byte fields with a space character between bytes", "Display all byte fields with a space character between each byte in the packet list.", &prefs.display_byte_fields_with_spaces); prefs_register_bool_preference(protocols_module, "enable_incomplete_dissectors_check", "Look for incomplete dissectors", "Look for dissectors that left some bytes undecoded.", &prefs.enable_incomplete_dissectors_check); prefs_register_bool_preference(protocols_module, "strict_conversation_tracking_heuristics", "Enable stricter conversation tracking heuristics", "Protocols may use things like VLAN ID or interface ID to narrow the potential for duplicate conversations." "Currently only ICMP and ICMPv6 use this preference to add VLAN ID to conversation tracking", &prefs.strict_conversation_tracking_heuristics); /* Obsolete preferences * These "modules" were reorganized/renamed to correspond to their GUI * configuration screen within the preferences dialog */ /* taps is now part of the stats module */ prefs_register_module(NULL, "taps", "TAPS", "TAPS", NULL, FALSE); /* packet_list is now part of the protocol (parent) module */ prefs_register_module(NULL, "packet_list", "PACKET_LIST", "PACKET_LIST", NULL, FALSE); /* stream is now part of the gui module */ prefs_register_module(NULL, "stream", "STREAM", "STREAM", NULL, FALSE); } /* Parse through a list of comma-separated, possibly quoted strings. Return a list of the string data. */ GList * prefs_get_string_list(const gchar *str) { enum { PRE_STRING, IN_QUOT, NOT_IN_QUOT }; gint state = PRE_STRING, i = 0, j = 0; gboolean backslash = FALSE; guchar cur_c; gchar *slstr = NULL; GList *sl = NULL; /* Allocate a buffer for the first string. */ slstr = (gchar *) g_malloc(sizeof(gchar) * COL_MAX_LEN); j = 0; for (;;) { cur_c = str[i]; if (cur_c == '\0') { /* It's the end of the input, so it's the end of the string we were working on, and there's no more input. */ if (state == IN_QUOT || backslash) { /* We were in the middle of a quoted string or backslash escape, and ran out of characters; that's an error. */ g_free(slstr); prefs_clear_string_list(sl); return NULL; } slstr[j] = '\0'; if (j > 0) sl = g_list_append(sl, slstr); else g_free(slstr); break; } if (cur_c == '"' && ! backslash) { switch (state) { case PRE_STRING: /* We hadn't yet started processing a string; this starts the string, and we're now quoting. */ state = IN_QUOT; break; case IN_QUOT: /* We're in the middle of a quoted string, and we saw a quotation mark; we're no longer quoting. */ state = NOT_IN_QUOT; break; case NOT_IN_QUOT: /* We're working on a string, but haven't seen a quote; we're now quoting. */ state = IN_QUOT; break; default: break; } } else if (cur_c == '\\' && ! backslash) { /* We saw a backslash, and the previous character wasn't a backslash; escape the next character. This also means we've started a new string. */ backslash = TRUE; if (state == PRE_STRING) state = NOT_IN_QUOT; } else if (cur_c == ',' && state != IN_QUOT && ! backslash) { /* We saw a comma, and we're not in the middle of a quoted string and it wasn't preceded by a backslash; it's the end of the string we were working on... */ slstr[j] = '\0'; if (j > 0) { sl = g_list_append(sl, slstr); slstr = (gchar *) g_malloc(sizeof(gchar) * COL_MAX_LEN); } /* ...and the beginning of a new string. */ state = PRE_STRING; j = 0; } else if (!g_ascii_isspace(cur_c) || state != PRE_STRING) { /* Either this isn't a white-space character, or we've started a string (i.e., already seen a non-white-space character for that string and put it into the string). The character is to be put into the string; do so if there's room. */ if (j < COL_MAX_LEN) { slstr[j] = cur_c; j++; } /* If it was backslash-escaped, we're done with the backslash escape. */ backslash = FALSE; } i++; } return(sl); } char *join_string_list(GList *sl) { GString *joined_str = g_string_new(""); GList *cur, *first; gchar *str; guint item_count = 0; cur = first = g_list_first(sl); while (cur) { item_count++; str = (gchar *)cur->data; if (cur != first) g_string_append_c(joined_str, ','); if (item_count % 2) { /* Wrap the line. */ g_string_append(joined_str, "\n\t"); } else g_string_append_c(joined_str, ' '); g_string_append_c(joined_str, '"'); while (*str) { gunichar uc = g_utf8_get_char (str); if (uc == '"' || uc == '\\') g_string_append_c(joined_str, '\\'); if (g_unichar_isprint(uc)) g_string_append_unichar (joined_str, uc); str = g_utf8_next_char (str); } g_string_append_c(joined_str, '"'); cur = cur->next; } return g_string_free(joined_str, FALSE); } void prefs_clear_string_list(GList *sl) { /* g_list_free_full() only exists since 2.28. */ g_list_foreach(sl, (GFunc)g_free, NULL); g_list_free(sl); } /* * Takes a string, a pointer to an array of "enum_val_t"s, and a default gint * value. * The array must be terminated by an entry with a null "name" string. * * If the string matches a "name" string in an entry, the value from that * entry is returned. * * Otherwise, if a string matches a "description" string in an entry, the * value from that entry is returned; we do that for backwards compatibility, * as we used to have only a "name" string that was used both for command-line * and configuration-file values and in the GUI (which meant either that * the GUI had what might be somewhat cryptic values to select from or that * the "-o" flag took long strings, often with spaces in them). * * Otherwise, the default value that was passed as the third argument is * returned. */ static gint find_val_for_string(const char *needle, const enum_val_t *haystack, gint default_value) { int i; for (i = 0; haystack[i].name != NULL; i++) { if (g_ascii_strcasecmp(needle, haystack[i].name) == 0) { return haystack[i].value; } } for (i = 0; haystack[i].name != NULL; i++) { if (g_ascii_strcasecmp(needle, haystack[i].description) == 0) { return haystack[i].value; } } return default_value; } /* Array of columns that have been migrated to custom columns */ struct deprecated_columns { const gchar *col_fmt; const gchar *col_expr; }; static struct deprecated_columns migrated_columns[] = { { /* COL_COS_VALUE */ "%U", "vlan.priority" }, { /* COL_CIRCUIT_ID */ "%c", "iax2.call" }, { /* COL_BSSGP_TLLI */ "%l", "bssgp.tlli" }, { /* COL_HPUX_SUBSYS */ "%H", "nettl.subsys" }, { /* COL_HPUX_DEVID */ "%P", "nettl.devid" }, { /* COL_FR_DLCI */ "%C", "fr.dlci" }, { /* COL_REL_CONV_TIME */ "%rct", "tcp.time_relative" }, { /* COL_DELTA_CONV_TIME */ "%dct", "tcp.time_delta" }, { /* COL_OXID */ "%XO", "fc.ox_id" }, { /* COL_RXID */ "%XR", "fc.rx_id" }, { /* COL_SRCIDX */ "%Xd", "mdshdr.srcidx" }, { /* COL_DSTIDX */ "%Xs", "mdshdr.dstidx" }, { /* COL_DCE_CTX */ "%z", "dcerpc.cn_ctx_id" } }; static gboolean is_deprecated_column_format(const gchar* fmt) { guint haystack_idx; for (haystack_idx = 0; haystack_idx < G_N_ELEMENTS(migrated_columns); ++haystack_idx) { if (strcmp(migrated_columns[haystack_idx].col_fmt, fmt) == 0) { return TRUE; } } return FALSE; } /* Preferences file format: * - Configuration directives start at the beginning of the line, and * are terminated with a colon. * - Directives can be continued on the next line by preceding them with * whitespace. * * Example: # This is a comment line print.command: lpr print.file: /a/very/long/path/ to/wireshark-out.ps * */ #define DEF_NUM_COLS 7 /* * Parse a column format, filling in the relevant fields of a fmt_data. */ static gboolean parse_column_format(fmt_data *cfmt, const char *fmt) { const gchar *cust_format = col_format_to_string(COL_CUSTOM); size_t cust_format_len = strlen(cust_format); gchar **cust_format_info; char *p; int col_fmt; gchar *col_custom_fields = NULL; long col_custom_occurrence = 0; gboolean col_resolved = TRUE; /* * Is this a custom column? */ if ((strlen(fmt) > cust_format_len) && (fmt[cust_format_len] == ':') && strncmp(fmt, cust_format, cust_format_len) == 0) { /* Yes. */ col_fmt = COL_CUSTOM; cust_format_info = g_strsplit(&fmt[cust_format_len+1],":",3); /* add 1 for ':' */ col_custom_fields = g_strdup(cust_format_info[0]); if (col_custom_fields && cust_format_info[1]) { col_custom_occurrence = strtol(cust_format_info[1], &p, 10); if (p == cust_format_info[1] || *p != '\0') { /* Not a valid number. */ g_free(col_custom_fields); g_strfreev(cust_format_info); return FALSE; } } if (col_custom_fields && cust_format_info[1] && cust_format_info[2]) { col_resolved = (cust_format_info[2][0] == 'U') ? FALSE : TRUE; } g_strfreev(cust_format_info); } else { col_fmt = get_column_format_from_str(fmt); if ((col_fmt == -1) && (!is_deprecated_column_format(fmt))) return FALSE; } cfmt->fmt = col_fmt; cfmt->custom_fields = col_custom_fields; cfmt->custom_occurrence = (int)col_custom_occurrence; cfmt->resolved = col_resolved; return TRUE; } /* Initialize non-dissector preferences to wired-in default values Called * at program startup and any time the profile changes. (The dissector * preferences are assumed to be set to those values by the dissectors.) * They may be overridden by the global preferences file or the user's * preferences file. */ static void init_prefs(void) { if (prefs_initialized) return; uat_load_all(); /* * Ensure the "global" preferences have been initialized so the * preference API has the proper default values to work from */ pre_init_prefs(); prefs_register_modules(); prefs_initialized = TRUE; } /* * Initialize non-dissector preferences used by the "register preference" API * to default values so the default values can be used when registered. * * String, filename, and directory preferences will be g_freed so they must * be g_mallocated. */ static void pre_init_prefs(void) { int i; gchar *col_name; fmt_data *cfmt; static const gchar *col_fmt[DEF_NUM_COLS*2] = { "No.", "%m", "Time", "%t", "Source", "%s", "Destination", "%d", "Protocol", "%p", "Length", "%L", "Info", "%i"}; prefs.pr_format = PR_FMT_TEXT; prefs.pr_dest = PR_DEST_CMD; g_free(prefs.pr_file); prefs.pr_file = g_strdup("wireshark.out"); g_free(prefs.pr_cmd); prefs.pr_cmd = g_strdup("lpr"); prefs.gui_altern_colors = FALSE; prefs.gui_expert_composite_eyecandy = FALSE; prefs.gui_ptree_line_style = 0; prefs.gui_ptree_expander_style = 1; prefs.gui_hex_dump_highlight_style = 1; prefs.filter_toolbar_show_in_statusbar = FALSE; prefs.restore_filter_after_following_stream = FALSE; prefs.gui_toolbar_main_style = TB_STYLE_ICONS; prefs.gui_toolbar_filter_style = TB_STYLE_TEXT; /* These will be g_freed, so they must be g_mallocated. */ g_free(prefs.gui_gtk2_font_name); #ifdef _WIN32 prefs.gui_gtk2_font_name = g_strdup("Lucida Console 10"); #else prefs.gui_gtk2_font_name = g_strdup("Monospace 10"); #endif /* We try to find the best font in the Qt code */ g_free(prefs.gui_qt_font_name); prefs.gui_qt_font_name = g_strdup(""); prefs.gui_marked_fg.red = 65535; prefs.gui_marked_fg.green = 65535; prefs.gui_marked_fg.blue = 65535; prefs.gui_marked_bg.red = 0; prefs.gui_marked_bg.green = 8224; prefs.gui_marked_bg.blue = 10794; prefs.gui_ignored_fg.red = 32767; prefs.gui_ignored_fg.green = 32767; prefs.gui_ignored_fg.blue = 32767; prefs.gui_ignored_bg.red = 65535; prefs.gui_ignored_bg.green = 65535; prefs.gui_ignored_bg.blue = 65535; g_free(prefs.gui_colorized_fg); prefs.gui_colorized_fg = g_strdup("000000,000000,000000,000000,000000,000000,000000,000000,000000,000000"); g_free(prefs.gui_colorized_bg); prefs.gui_colorized_bg = g_strdup("ffc0c0,ffc0ff,e0c0e0,c0c0ff,c0e0e0,c0ffff,c0ffc0,ffffc0,e0e0c0,e0e0e0"); prefs.st_client_fg.red = 32767; prefs.st_client_fg.green = 0; prefs.st_client_fg.blue = 0; prefs.st_client_bg.red = 64507; prefs.st_client_bg.green = 60909; prefs.st_client_bg.blue = 60909; prefs.st_server_fg.red = 0; prefs.st_server_fg.green = 0; prefs.st_server_fg.blue = 32767; prefs.st_server_bg.red = 60909; prefs.st_server_bg.green = 60909; prefs.st_server_bg.blue = 64507; if (gui_theme_is_dark) { // Green, red and yellow with HSV V = 84 prefs.gui_text_valid.red = 0x0000; /* dark green */ prefs.gui_text_valid.green = 0x66ff; prefs.gui_text_valid.blue = 0x0000; prefs.gui_text_invalid.red = 0x66FF; /* dark red */ prefs.gui_text_invalid.green = 0x0000; prefs.gui_text_invalid.blue = 0x0000; prefs.gui_text_deprecated.red = 0x66FF; /* dark yellow / olive */ prefs.gui_text_deprecated.green = 0x66FF; prefs.gui_text_deprecated.blue = 0x0000; } else { // Green, red and yellow with HSV V = 20 prefs.gui_text_valid.red = 0xAFFF; /* light green */ prefs.gui_text_valid.green = 0xFFFF; prefs.gui_text_valid.blue = 0xAFFF; prefs.gui_text_invalid.red = 0xFFFF; /* light red */ prefs.gui_text_invalid.green = 0xAFFF; prefs.gui_text_invalid.blue = 0xAFFF; prefs.gui_text_deprecated.red = 0xFFFF; /* light yellow */ prefs.gui_text_deprecated.green = 0xFFFF; prefs.gui_text_deprecated.blue = 0xAFFF; } prefs.gui_geometry_save_position = TRUE; prefs.gui_geometry_save_size = TRUE; prefs.gui_geometry_save_maximized= TRUE; prefs.gui_macosx_style = TRUE; prefs.gui_console_open = console_open_never; prefs.gui_fileopen_style = FO_STYLE_LAST_OPENED; prefs.gui_recent_df_entries_max = 10; prefs.gui_recent_files_count_max = 10; g_free(prefs.gui_fileopen_dir); prefs.gui_fileopen_dir = g_strdup(get_persdatafile_dir()); prefs.gui_fileopen_preview = 3; prefs.gui_ask_unsaved = TRUE; prefs.gui_find_wrap = TRUE; prefs.gui_use_pref_save = FALSE; prefs.gui_update_enabled = TRUE; prefs.gui_update_channel = UPDATE_CHANNEL_STABLE; prefs.gui_update_interval = 60*60*24; /* Seconds */ g_free(prefs.gui_webbrowser); prefs.gui_webbrowser = g_strdup(""); g_free(prefs.gui_window_title); prefs.gui_window_title = g_strdup(""); g_free(prefs.gui_prepend_window_title); prefs.gui_prepend_window_title = g_strdup(""); g_free(prefs.gui_start_title); prefs.gui_start_title = g_strdup("The World's Most Popular Network Protocol Analyzer"); prefs.gui_version_placement = version_both; prefs.gui_auto_scroll_on_expand = FALSE; prefs.gui_auto_scroll_percentage = 0; prefs.gui_layout_type = layout_type_5; prefs.gui_layout_content_1 = layout_pane_content_plist; prefs.gui_layout_content_2 = layout_pane_content_pdetails; prefs.gui_layout_content_3 = layout_pane_content_pbytes; prefs.gui_packet_editor = FALSE; prefs.gui_packet_list_elide_mode = ELIDE_RIGHT; prefs.gui_packet_list_show_related = TRUE; prefs.gui_packet_list_show_minimap = TRUE; g_free (prefs.gui_interfaces_hide_types); prefs.gui_interfaces_hide_types = g_strdup(""); prefs.gui_interfaces_show_hidden = FALSE; #ifdef HAVE_PCAP_REMOTE prefs.gui_interfaces_remote_display = TRUE; #endif prefs.gui_qt_packet_list_separator = FALSE; prefs.gui_qt_show_selected_packet = FALSE; prefs.gui_qt_show_file_load_time = FALSE; if (prefs.col_list) { free_col_info(prefs.col_list); prefs.col_list = NULL; } for (i = 0; i < DEF_NUM_COLS; i++) { cfmt = g_new(fmt_data,1); cfmt->title = g_strdup(col_fmt[i * 2]); parse_column_format(cfmt, col_fmt[(i * 2) + 1]); cfmt->visible = TRUE; cfmt->resolved = TRUE; cfmt->custom_fields = NULL; cfmt->custom_occurrence = 0; prefs.col_list = g_list_append(prefs.col_list, cfmt); } prefs.num_cols = DEF_NUM_COLS; /* set the default values for the capture dialog box */ prefs.capture_prom_mode = TRUE; #ifdef PCAP_NG_DEFAULT prefs.capture_pcap_ng = TRUE; #else prefs.capture_pcap_ng = FALSE; #endif prefs.capture_real_time = TRUE; prefs.capture_auto_scroll = TRUE; prefs.capture_show_info = FALSE; if (!prefs.capture_columns) { /* First time through */ for (i = 0; i < num_capture_cols; i++) { col_name = g_strdup(capture_cols[i]); prefs.capture_columns = g_list_append(prefs.capture_columns, col_name); } } prefs.console_log_level = G_LOG_LEVEL_WARNING | G_LOG_LEVEL_CRITICAL | G_LOG_LEVEL_ERROR; /* set the default values for the tap/statistics dialog box */ prefs.tap_update_interval = TAP_UPDATE_DEFAULT_INTERVAL; prefs.rtp_player_max_visible = RTP_PLAYER_DEFAULT_VISIBLE; prefs.st_enable_burstinfo = TRUE; prefs.st_burst_showcount = FALSE; prefs.st_burst_resolution = ST_DEF_BURSTRES; prefs.st_burst_windowlen = ST_DEF_BURSTLEN; prefs.st_sort_casesensitve = TRUE; prefs.st_sort_rng_fixorder = TRUE; prefs.st_sort_rng_nameonly = TRUE; prefs.st_sort_defcolflag = ST_SORT_COL_COUNT; prefs.st_sort_defdescending = TRUE; prefs.st_sort_showfullname = FALSE; prefs.display_hidden_proto_items = FALSE; prefs.display_byte_fields_with_spaces = FALSE; } /* * Reset a single dissector preference. */ void reset_pref(pref_t *pref) { int type; if (!pref) return; type = pref->type; /* * This preference is no longer supported; it's not a * real preference, so we don't reset it (i.e., we * treat it as if it weren't found in the list of * preferences, and we weren't called in the first place). */ if (IS_PREF_OBSOLETE(type)) return; else RESET_PREF_OBSOLETE(type); switch (type) { case PREF_UINT: case PREF_DECODE_AS_UINT: *pref->varp.uint = pref->default_val.uint; break; case PREF_BOOL: *pref->varp.boolp = pref->default_val.boolval; break; case PREF_ENUM: /* * For now, we save the "description" value, so that if we * save the preferences older versions of Wireshark can at * least read preferences that they supported; we support * either the short name or the description when reading * the preferences file or a "-o" option. */ *pref->varp.enump = pref->default_val.enumval; break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: reset_string_like_preference(pref); break; case PREF_RANGE: case PREF_DECODE_AS_RANGE: wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = range_copy(wmem_epan_scope(), pref->default_val.range); break; case PREF_STATIC_TEXT: case PREF_UAT: /* Nothing to do */ break; case PREF_COLOR: *pref->varp.colorp = pref->default_val.color; break; case PREF_CUSTOM: pref->custom_cbs.reset_cb(pref); break; } } static void reset_pref_cb(gpointer data, gpointer user_data _U_) { pref_t *pref = (pref_t *) data; reset_pref(pref); } typedef struct { module_t *module; } reset_pref_arg_t; /* * Reset all preferences for a module. */ static gboolean reset_module_prefs(const void *key _U_, void *value, void *data _U_) { reset_pref_arg_t arg; arg.module = (module_t *)value; g_list_foreach(arg.module->prefs, reset_pref_cb, &arg); return FALSE; } /* Reset preferences */ void prefs_reset(void) { prefs_initialized = FALSE; g_free(prefs.saved_at_version); prefs.saved_at_version = NULL; /* * Unload all UAT preferences. */ uat_unload_all(); /* * Unload any loaded MIBs. */ oids_cleanup(); /* * Reset the non-dissector preferences. */ init_prefs(); /* * Reset the non-UAT dissector preferences. */ wmem_tree_foreach(prefs_modules, reset_module_prefs, NULL); } /* Read the preferences file, fill in "prefs", and return a pointer to it. If we got an error (other than "it doesn't exist") we report it through the UI. */ e_prefs * read_prefs(void) { int err; char *pf_path; FILE *pf; /* clean up libsmi structures before reading prefs */ oids_cleanup(); init_prefs(); /* * If we don't already have the pathname of the global preferences * file, construct it. Then, in either case, try to open the file. */ if (gpf_path == NULL) { /* * We don't have the path; try the new path first, and, if that * file doesn't exist, try the old path. */ gpf_path = get_datafile_path(PF_NAME); if ((pf = ws_fopen(gpf_path, "r")) == NULL && errno == ENOENT) { /* * It doesn't exist by the new name; try the old name. */ g_free(gpf_path); gpf_path = get_datafile_path(OLD_GPF_NAME); pf = ws_fopen(gpf_path, "r"); } } else { /* * We have the path; try it. */ pf = ws_fopen(gpf_path, "r"); } /* * If we were able to open the file, read it. * XXX - if it failed for a reason other than "it doesn't exist", * report the error. */ if (pf != NULL) { /* * Start out the counters of "mgcp.{tcp,udp}.port" entries we've * seen. */ mgcp_tcp_port_count = 0; mgcp_udp_port_count = 0; /* We succeeded in opening it; read it. */ err = read_prefs_file(gpf_path, pf, set_pref, NULL); if (err != 0) { /* We had an error reading the file; report it. */ report_warning("Error reading global preferences file \"%s\": %s.", gpf_path, g_strerror(err)); } fclose(pf); } else { /* We failed to open it. If we failed for some reason other than "it doesn't exist", report the error. */ if (errno != ENOENT) { if (errno != 0) { report_warning("Can't open global preferences file \"%s\": %s.", gpf_path, g_strerror(errno)); } } } /* Construct the pathname of the user's preferences file. */ pf_path = get_persconffile_path(PF_NAME, TRUE); /* Read the user's preferences file, if it exists. */ if ((pf = ws_fopen(pf_path, "r")) != NULL) { /* * Start out the counters of "mgcp.{tcp,udp}.port" entries we've * seen. */ mgcp_tcp_port_count = 0; mgcp_udp_port_count = 0; /* We succeeded in opening it; read it. */ err = read_prefs_file(pf_path, pf, set_pref, NULL); if (err != 0) { /* We had an error reading the file; report it. */ report_warning("Error reading your preferences file \"%s\": %s.", pf_path, g_strerror(err)); } else g_free(pf_path); fclose(pf); } else { /* We failed to open it. If we failed for some reason other than "it doesn't exist", return the errno and the pathname, so our caller can report the error. */ if (errno != ENOENT) { report_warning("Can't open your preferences file \"%s\": %s.", pf_path, g_strerror(errno)); } else g_free(pf_path); } /* load SMI modules if needed */ oids_init(); return &prefs; } /* read the preferences file (or similar) and call the callback * function to set each key/value pair found */ int read_prefs_file(const char *pf_path, FILE *pf, pref_set_pair_cb pref_set_pair_fct, void *private_data) { enum { START, /* beginning of a line */ IN_VAR, /* processing key name */ PRE_VAL, /* finished processing key name, skipping white space befor evalue */ IN_VAL, /* processing value */ IN_SKIP /* skipping to the end of the line */ } state = START; int got_c; GString *cur_val; GString *cur_var; gboolean got_val = FALSE; gint fline = 1, pline = 1; gchar hint[] = "(save preferences to remove this warning)"; gchar ver[128]; cur_val = g_string_new(""); cur_var = g_string_new(""); /* Try to read in the profile name in the first line of the preferences file. */ if (fscanf(pf, "# Configuration file for %127[^\r\n]", ver) == 1) { /* Assume trailing period and remove it */ g_free(prefs.saved_at_version); prefs.saved_at_version = g_strndup(ver, strlen(ver) - 1); } rewind(pf); while ((got_c = ws_getc_unlocked(pf)) != EOF) { if (got_c == '\r') { /* Treat CR-LF at the end of a line like LF, so that if we're reading * a Windows-format file on UN*X, we handle it the same way we'd handle * a UN*X-format file. */ got_c = ws_getc_unlocked(pf); if (got_c == EOF) break; if (got_c != '\n') { /* Put back the character after the CR, and process the CR normally. */ ungetc(got_c, pf); got_c = '\r'; } } if (got_c == '\n') { state = START; fline++; continue; } switch (state) { case START: if (g_ascii_isalnum(got_c)) { if (cur_var->len > 0) { if (got_val) { if (cur_val->len > 0) { if (cur_val->str[cur_val->len-1] == ',') { /* * If the pref has a trailing comma, eliminate it. */ cur_val->str[cur_val->len-1] = '\0'; ws_g_warning ("%s line %d: trailing comma in \"%s\" %s", pf_path, pline, cur_var->str, hint); } } /* Call the routine to set the preference; it will parse the value as appropriate. Since we're reading a file, rather than processing explicit user input, for range preferences, silently lower values in excess of the range's maximum, rather than reporting errors and failing. */ switch (pref_set_pair_fct(cur_var->str, cur_val->str, private_data, FALSE)) { case PREFS_SET_OK: break; case PREFS_SET_SYNTAX_ERR: ws_g_warning ("Syntax error in preference \"%s\" at line %d of\n%s %s", cur_var->str, pline, pf_path, hint); break; case PREFS_SET_NO_SUCH_PREF: /* * If "print.command" silently ignore it because it's valid * on non-Win32 platforms. */ if (strcmp(cur_var->str, "print.command") != 0) ws_g_warning ("No such preference \"%s\" at line %d of\n%s %s", cur_var->str, pline, pf_path, hint); prefs.unknown_prefs = TRUE; break; case PREFS_SET_OBSOLETE: if (strcmp(cur_var->str, "print.command") != 0) /* If an attempt is made to save the preferences, a popup warning will be displayed stating that obsolete prefs have been detected and the user will be given the opportunity to save these prefs under a different profile name. The prefs in question need to be listed in the console window so that the user can make an informed choice. */ ws_g_warning ("Obsolete preference \"%s\" at line %d of\n%s %s", cur_var->str, pline, pf_path, hint); prefs.unknown_prefs = TRUE; break; } } else { ws_g_warning ("Incomplete preference at line %d: of\n%s %s", pline, pf_path, hint); } } state = IN_VAR; got_val = FALSE; g_string_truncate(cur_var, 0); g_string_append_c(cur_var, (gchar) got_c); pline = fline; } else if (g_ascii_isspace(got_c) && cur_var->len > 0 && got_val) { state = PRE_VAL; } else if (got_c == '#') { state = IN_SKIP; } else { ws_g_warning ("Malformed preference at line %d of\n%s %s", fline, pf_path, hint); } break; case IN_VAR: if (got_c != ':') { g_string_append_c(cur_var, (gchar) got_c); } else { /* This is a colon (':') */ state = PRE_VAL; g_string_truncate(cur_val, 0); /* * Set got_val to TRUE to accommodate prefs such as * "gui.fileopen.dir" that do not require a value. */ got_val = TRUE; } break; case PRE_VAL: if (!g_ascii_isspace(got_c)) { state = IN_VAL; g_string_append_c(cur_val, (gchar) got_c); } break; case IN_VAL: g_string_append_c(cur_val, (gchar) got_c); break; case IN_SKIP: break; } } if (cur_var->len > 0) { if (got_val) { /* Call the routine to set the preference; it will parse the value as appropriate. Since we're reading a file, rather than processing explicit user input, for range preferences, silently lower values in excess of the range's maximum, rather than reporting errors and failing. */ switch (pref_set_pair_fct(cur_var->str, cur_val->str, private_data, FALSE)) { case PREFS_SET_OK: break; case PREFS_SET_SYNTAX_ERR: ws_g_warning ("Syntax error in preference %s at line %d of\n%s %s", cur_var->str, pline, pf_path, hint); break; case PREFS_SET_NO_SUCH_PREF: ws_g_warning ("No such preference \"%s\" at line %d of\n%s %s", cur_var->str, pline, pf_path, hint); prefs.unknown_prefs = TRUE; break; case PREFS_SET_OBSOLETE: prefs.unknown_prefs = TRUE; break; } } else { ws_g_warning("Incomplete preference at line %d of\n%s %s", pline, pf_path, hint); } } g_string_free(cur_val, TRUE); g_string_free(cur_var, TRUE); if (ferror(pf)) return errno; else return 0; } /* * If we were handed a preference starting with "uat:", try to turn it into * a valid uat entry. */ static gboolean prefs_set_uat_pref(char *uat_entry, char **errmsg) { gchar *p, *colonp; uat_t *uat; gboolean ret; colonp = strchr(uat_entry, ':'); if (colonp == NULL) return FALSE; p = colonp; *p++ = '\0'; /* * Skip over any white space (there probably won't be any, but * as we allow it in the preferences file, we might as well * allow it here). */ while (g_ascii_isspace(*p)) p++; if (*p == '\0') { /* * Put the colon back, so if our caller uses, in an * error message, the string they passed us, the message * looks correct. */ *colonp = ':'; return FALSE; } uat = uat_find(uat_entry); *colonp = ':'; if (uat == NULL) { *errmsg = g_strdup("Unknown preference"); return FALSE; } ret = uat_load_str(uat, p, errmsg); return ret; } /* * Given a string of the form ":", as might appear * as an argument to a "-o" option, parse it and set the preference in * question. Return an indication of whether it succeeded or failed * in some fashion. */ prefs_set_pref_e prefs_set_pref(char *prefarg, char **errmsg) { gchar *p, *colonp; prefs_set_pref_e ret; /* * Set the counters of "mgcp.{tcp,udp}.port" entries we've * seen to values that keep us from trying to interpret them * as "mgcp.{tcp,udp}.gateway_port" or "mgcp.{tcp,udp}.callagent_port", * as, from the command line, we have no way of guessing which * the user had in mind. */ mgcp_tcp_port_count = -1; mgcp_udp_port_count = -1; *errmsg = NULL; colonp = strchr(prefarg, ':'); if (colonp == NULL) return PREFS_SET_SYNTAX_ERR; p = colonp; *p++ = '\0'; /* * Skip over any white space (there probably won't be any, but * as we allow it in the preferences file, we might as well * allow it here). */ while (g_ascii_isspace(*p)) p++; if (*p == '\0') { /* * Put the colon back, so if our caller uses, in an * error message, the string they passed us, the message * looks correct. */ *colonp = ':'; return PREFS_SET_SYNTAX_ERR; } if (strcmp(prefarg, "uat")) { ret = set_pref(prefarg, p, NULL, TRUE); } else { ret = prefs_set_uat_pref(p, errmsg) ? PREFS_SET_OK : PREFS_SET_SYNTAX_ERR; } *colonp = ':'; /* put the colon back */ return ret; } guint prefs_get_uint_value_real(pref_t *pref, pref_source_t source) { switch (source) { case pref_default: return pref->default_val.uint; break; case pref_stashed: return pref->stashed_val.uint; break; case pref_current: return *pref->varp.uint; break; default: g_assert_not_reached(); break; } return 0; } guint prefs_get_uint_value(const char *module_name, const char* pref_name) { return prefs_get_uint_value_real(prefs_find_preference(prefs_find_module(module_name), pref_name), pref_current); } gboolean prefs_set_uint_value(pref_t *pref, guint value, pref_source_t source) { gboolean changed = FALSE; switch (source) { case pref_default: if (pref->default_val.uint != value) { pref->default_val.uint = value; changed = TRUE; } break; case pref_stashed: if (pref->stashed_val.uint != value) { pref->stashed_val.uint = value; changed = TRUE; } break; case pref_current: if (*pref->varp.uint != value) { *pref->varp.uint = value; changed = TRUE; } break; default: g_assert_not_reached(); break; } return changed; } guint prefs_get_uint_base(pref_t *pref) { return pref->info.base; } /* * Returns TRUE if the given device is hidden */ gboolean prefs_is_capture_device_hidden(const char *name) { gchar *tok, *devices; size_t len; if (prefs.capture_devices_hide && name) { devices = g_strdup (prefs.capture_devices_hide); len = strlen (name); for (tok = strtok (devices, ","); tok; tok = strtok(NULL, ",")) { if (strlen (tok) == len && strcmp (name, tok) == 0) { g_free (devices); return TRUE; } } g_free (devices); } return FALSE; } /* * Returns TRUE if the given column is visible (not hidden) */ static gboolean prefs_is_column_visible(const gchar *cols_hidden, fmt_data *cfmt) { gchar *tok, *cols; fmt_data cfmt_hidden; /* * Do we have a list of hidden columns? */ if (cols_hidden) { /* * Yes - check the column against each of the ones in the * list. */ cols = g_strdup(cols_hidden); for (tok = strtok(cols, ","); tok; tok = strtok(NULL, ",")) { tok = g_strstrip(tok); /* * Parse this column format. */ if (!parse_column_format(&cfmt_hidden, tok)) { /* * It's not valid; ignore it. */ continue; } /* * Does it match the column? */ if (cfmt->fmt != cfmt_hidden.fmt) { /* No. */ g_free(cfmt_hidden.custom_fields); cfmt_hidden.custom_fields = NULL; continue; } if (cfmt->fmt == COL_CUSTOM) { /* * A custom column has to have the * same custom field and occurrence. */ if (cfmt_hidden.custom_fields && cfmt->custom_fields) { if (strcmp(cfmt->custom_fields, cfmt_hidden.custom_fields) != 0) { /* Different fields. */ g_free(cfmt_hidden.custom_fields); cfmt_hidden.custom_fields = NULL; continue; } if (cfmt->custom_occurrence != cfmt_hidden.custom_occurrence) { /* Different occurrences. */ g_free(cfmt_hidden.custom_fields); cfmt_hidden.custom_fields = NULL; continue; } } } /* * OK, they match, so it's one of the hidden fields, * hence not visible. */ g_free(cfmt_hidden.custom_fields); g_free(cols); return FALSE; } g_free(cols); } /* * No - either there are no hidden columns or this isn't one * of them - so it is visible. */ return TRUE; } /* * Returns TRUE if the given device should capture in monitor mode by default */ gboolean prefs_capture_device_monitor_mode(const char *name) { gchar *tok, *devices; size_t len; if (prefs.capture_devices_monitor_mode && name) { devices = g_strdup (prefs.capture_devices_monitor_mode); len = strlen (name); for (tok = strtok (devices, ","); tok; tok = strtok(NULL, ",")) { if (strlen (tok) == len && strcmp (name, tok) == 0) { g_free (devices); return TRUE; } } g_free (devices); } return FALSE; } /* * Returns TRUE if the user has marked this column as visible */ gboolean prefs_capture_options_dialog_column_is_visible(const gchar *column) { GList *curr; gchar *col; for (curr = g_list_first(prefs.capture_columns); curr; curr = g_list_next(curr)) { col = (gchar *)curr->data; if (col && (g_ascii_strcasecmp(col, column) == 0)) { return TRUE; } } return FALSE; } gboolean prefs_has_layout_pane_content (layout_pane_content_e layout_pane_content) { return ((prefs.gui_layout_content_1 == layout_pane_content) || (prefs.gui_layout_content_2 == layout_pane_content) || (prefs.gui_layout_content_3 == layout_pane_content)); } #define PRS_GUI_FILTER_LABEL "gui.filter_expressions.label" #define PRS_GUI_FILTER_EXPR "gui.filter_expressions.expr" #define PRS_GUI_FILTER_ENABLED "gui.filter_expressions.enabled" /* * Extract the red, green, and blue components of a 24-bit RGB value * and convert them from [0,255] to [0,65535]. */ #define RED_COMPONENT(x) (guint16) (((((x) >> 16) & 0xff) * 65535 / 255)) #define GREEN_COMPONENT(x) (guint16) (((((x) >> 8) & 0xff) * 65535 / 255)) #define BLUE_COMPONENT(x) (guint16) ( (((x) & 0xff) * 65535 / 255)) char string_to_name_resolve(const char *string, e_addr_resolve *name_resolve) { char c; memset(name_resolve, 0, sizeof(e_addr_resolve)); while ((c = *string++) != '\0') { switch (c) { case 'm': name_resolve->mac_name = TRUE; break; case 'n': name_resolve->network_name = TRUE; break; case 'N': name_resolve->use_external_net_name_resolver = TRUE; break; case 't': name_resolve->transport_name = TRUE; break; case 'C': /* DEPRECATED */ /* name_resolve->concurrent_dns */ break; case 'd': name_resolve->dns_pkt_addr_resolution = TRUE; break; case 'v': name_resolve->vlan_name = TRUE; break; default: /* * Unrecognized letter. */ return c; } } return '\0'; } static void try_convert_to_custom_column(gpointer *el_data) { guint haystack_idx; gchar **fmt = (gchar **) el_data; for (haystack_idx = 0; haystack_idx < G_N_ELEMENTS(migrated_columns); ++haystack_idx) { if (strcmp(migrated_columns[haystack_idx].col_fmt, *fmt) == 0) { gchar *cust_col = g_strdup_printf("%%Cus:%s:0", migrated_columns[haystack_idx].col_expr); g_free(*fmt); *fmt = cust_col; } } } static gboolean deprecated_heur_dissector_pref(gchar *pref_name, const gchar *value) { struct heur_pref_name { const char* pref_name; const char* short_name; gboolean more_dissectors; /* For multiple dissectors controlled by the same preference */ }; struct heur_pref_name heur_prefs[] = { {"acn.heuristic_acn", "acn_udp", 0}, {"bfcp.enable", "bfcp_tcp", 1}, {"bfcp.enable", "bfcp_udp", 0}, {"bt-dht.enable", "bittorrent_dht_udp", 0}, {"bt-utp.enable", "bt_utp_udp", 0}, {"cattp.enable", "cattp_udp", 0}, {"cfp.enable", "fp_eth", 0}, {"dicom.heuristic", "dicom_tcp", 0}, {"dnp3.heuristics", "dnp3_tcp", 1}, {"dnp3.heuristics", "dnp3_udp", 0}, {"dvb-s2_modeadapt.enable", "dvb_s2_udp", 0}, {"esl.enable", "esl_eth", 0}, {"fp.udp_heur", "fp_udp", 0}, {"gvsp.enable_heuristic", "gvsp_udp", 0}, {"hdcp2.enable", "hdcp2_tcp", 0}, {"hislip.enable_heuristic", "hislip_tcp", 0}, {"infiniband.dissect_eoib", "mellanox_eoib", 1}, {"infiniband.identify_payload", "eth_over_ib", 0}, {"jxta.udp.heuristic", "jxta_udp", 0}, {"jxta.tcp.heuristic", "jxta_tcp", 0}, {"jxta.sctp.heuristic", "jxta_sctp", 0}, {"mac-lte.heuristic_mac_lte_over_udp", "mac_lte_udp", 0}, {"mbim.bulk_heuristic", "mbim_usb_bulk", 0}, {"norm.heuristic_norm", "rmt_norm_udp", 0}, {"openflow.heuristic", "openflow_tcp", 0}, {"pdcp-lte.heuristic_pdcp_lte_over_udp", "pdcp_lte_udp", 0}, {"rlc.heuristic_rlc_over_udp", "rlc_udp", 0}, {"rlc-lte.heuristic_rlc_lte_over_udp", "rlc_lte_udp", 0}, {"rtcp.heuristic_rtcp", "rtcp_udp", 1}, {"rtcp.heuristic_rtcp", "rtcp_stun", 0}, {"rtp.heuristic_rtp", "rtp_udp", 1}, {"rtp.heuristic_rtp", "rtp_stun", 0}, {"teredo.heuristic_teredo", "teredo_udp", 0}, {"vssmonitoring.use_heuristics", "vssmonitoring_eth", 0}, {"xml.heuristic", "xml_http", 1}, {"xml.heuristic", "xml_sip", 1}, {"xml.heuristic", "xml_media", 0}, {"xml.heuristic_tcp", "xml_tcp", 0}, {"xml.heuristic_udp", "xml_udp", 0}, }; unsigned int i; heur_dtbl_entry_t* heuristic; for (i = 0; i < sizeof(heur_prefs)/sizeof(struct heur_pref_name); i++) { if (strcmp(pref_name, heur_prefs[i].pref_name) == 0) { heuristic = find_heur_dissector_by_unique_short_name(heur_prefs[i].short_name); if (heuristic != NULL) { heuristic->enabled = ((g_ascii_strcasecmp(value, "true") == 0) ? TRUE : FALSE); } if (!heur_prefs[i].more_dissectors) return TRUE; } } return FALSE; } static gboolean deprecated_enable_dissector_pref(gchar *pref_name, const gchar *value) { struct dissector_pref_name { const char* pref_name; const char* short_name; }; struct dissector_pref_name dissector_prefs[] = { {"transum.tsumenabled", "TRANSUM"}, {"snort.enable_snort_dissector", "Snort"}, {"prp.enable", "PRP"}, }; unsigned int i; int proto_id; for (i = 0; i < sizeof(dissector_prefs)/sizeof(struct dissector_pref_name); i++) { if (strcmp(pref_name, dissector_prefs[i].pref_name) == 0) { proto_id = proto_get_id_by_short_name(dissector_prefs[i].short_name); if (proto_id >= 0) proto_set_decoding(proto_id, ((g_ascii_strcasecmp(value, "true") == 0) ? TRUE : FALSE)); return TRUE; } } return FALSE; } static gboolean deprecated_port_pref(gchar *pref_name, const gchar *value) { struct port_pref_name { const char* pref_name; const char* module_name; const char* table_name; guint base; }; struct obsolete_pref_name { const char* pref_name; }; /* For now this is only supporting TCP/UDP port dissector preferences which are assumed to be decimal */ struct port_pref_name port_prefs[] = { /* TCP */ {"cmp.tcp_alternate_port", "CMP", "tcp.port", 10}, {"h248.tcp_port", "H248", "tcp.port", 10}, {"cops.tcp.cops_port", "COPS", "tcp.port", 10}, {"dhcpfo.tcp_port", "DHCPFO", "tcp.port", 10}, {"enttec.tcp_port", "ENTTEC", "tcp.port", 10}, {"forces.tcp_alternate_port", "ForCES", "tcp.port", 10}, {"ged125.tcp_port", "GED125", "tcp.port", 10}, {"hpfeeds.dissector_port", "HPFEEDS", "tcp.port", 10}, {"lsc.port", "LSC", "tcp.port", 10}, {"megaco.tcp.txt_port", "MEGACO", "tcp.port", 10}, {"netsync.tcp_port", "Netsync", "tcp.port", 10}, {"osi.tpkt_port", "OSI", "tcp.port", 10}, {"rsync.tcp_port", "RSYNC", "tcp.port", 10}, {"sametime.tcp_port", "SAMETIME", "tcp.port", 10}, {"sigcomp.tcp.port2", "SIGCOMP", "tcp.port", 10}, {"synphasor.tcp_port", "SYNCHROPHASOR", "tcp.port", 10}, {"tipc.alternate_port", "TIPC", "tcp.port", 10}, {"vnc.alternate_port", "VNC", "tcp.port", 10}, {"scop.port", "SCoP", "tcp.port", 10}, {"scop.port_secure", "SCoP", "tcp.port", 10}, /* UDP */ {"h248.udp_port", "H248", "udp.port", 10}, {"actrace.udp_port", "ACtrace", "udp.port", 10}, {"brp.port", "BRP", "udp.port", 10}, {"bvlc.additional_udp_port", "BVLC", "udp.port", 10}, {"capwap.udp.port.control", "CAPWAP-CONTROL", "udp.port", 10}, {"capwap.udp.port.data", "CAPWAP-CONTROL", "udp.port", 10}, {"coap.udp_port", "CoAP", "udp.port", 10}, {"enttec.udp_port", "ENTTEC", "udp.port", 10}, {"forces.udp_alternate_port", "ForCES", "udp.port", 10}, {"ldss.udp_port", "LDSS", "udp.port", 10}, {"lmp.udp_port", "LMP", "udp.port", 10}, {"ltp.port", "LTP", "udp.port", 10}, {"lwres.udp.lwres_port", "LWRES", "udp.port", 10}, {"megaco.udp.txt_port", "MEGACO", "udp.port", 10}, {"pgm.udp.encap_ucast_port", "PGM", "udp.port", 10}, {"pgm.udp.encap_mcast_port", "PGM", "udp.port", 10}, {"quic.udp.quic.port", "QUIC", "udp.port", 10}, {"quic.udp.quics.port", "QUIC", "udp.port", 10}, {"radius.alternate_port", "RADIUS", "udp.port", 10}, {"rdt.default_udp_port", "RDT", "udp.port", 10}, {"alc.default.udp_port", "ALC", "udp.port", 10}, {"sigcomp.udp.port2", "SIGCOMP", "udp.port", 10}, {"synphasor.udp_port", "SYNCHROPHASOR", "udp.port", 10}, {"tdmop.udpport", "TDMoP", "udp.port", 10}, {"uaudp.port1", "UAUDP", "udp.port", 10}, {"uaudp.port2", "UAUDP", "udp.port", 10}, {"uaudp.port3", "UAUDP", "udp.port", 10}, {"uaudp.port4", "UAUDP", "udp.port", 10}, {"uhd.dissector_port", "UHD", "udp.port", 10}, {"vrt.dissector_port", "VITA 49", "udp.port", 10}, {"vuze-dht.udp_port", "Vuze-DHT", "udp.port", 10}, {"wimaxasncp.udp.wimax_port", "WiMAX ASN CP", "udp.port", 10}, }; struct port_pref_name port_range_prefs[] = { /* TCP */ {"couchbase.tcp.ports", "Couchbase", "tcp.port", 10}, {"gsm_ipa.tcp_ports", "GSM over IP", "tcp.port", 10}, {"kafka.tcp.ports", "Kafka", "tcp.port", 10}, {"kt.tcp.ports", "Kyoto Tycoon", "tcp.port", 10}, {"memcache.tcp.ports", "MEMCACHE", "tcp.port", 10}, {"mrcpv2.tcp.port_range", "MRCPv2", "tcp.port", 10}, {"rtsp.tcp.port_range", "RTSP", "tcp.port", 10}, {"sip.tcp.ports", "SIP", "tcp.port", 10}, {"tds.tcp_ports", "TDS", "tcp.port", 10}, {"uma.tcp.ports", "UMA", "tcp.port", 10}, /* UDP */ {"aruba_erm.udp.ports", "ARUBA_ERM", "udp.port", 10}, {"diameter.udp.ports", "DIAMETER", "udp.port", 10}, {"dmp.udp_ports", "DMP", "udp.port", 10}, {"dns.udp.ports", "DNS", "udp.port", 10}, {"gsm_ipa.udp_ports", "GSM over IP", "udp.port", 10}, {"hcrt.dissector_udp_port", "HCrt", "udp.port", 10}, {"memcache.udp.ports", "MEMCACHE", "udp.port", 10}, {"nb_rtpmux.udp_ports", "NB_RTPMUX", "udp.port", 10}, {"gprs-ns.udp.ports", "GPRS-NS", "udp.port", 10}, {"p_mul.udp_ports", "P_MUL", "udp.port", 10}, {"radius.ports", "RADIUS", "udp.port", 10}, {"sflow.ports", "sFlow", "udp.port", 10}, {"sscop.udp.ports", "SSCOP", "udp.port", 10}, {"tftp.udp_ports", "TFTP", "udp.port", 10}, {"tipc.udp.ports", "TIPC", "udp.port", 10}, }; /* These are subdissectors of TPKT/OSITP that used to have a TCP port preference even though they were never directly on TCP. Convert them to use Decode As with the TPKT dissector handle */ struct port_pref_name tpkt_subdissector_port_prefs[] = { {"dap.tcp.port", "DAP", "tcp.port", 10}, {"disp.tcp.port", "DISP", "tcp.port", 10}, {"dop.tcp.port", "DOP", "tcp.port", 10}, {"dsp.tcp.port", "DSP", "tcp.port", 10}, {"p1.tcp.port", "P1", "tcp.port", 10}, {"p7.tcp.port", "P7", "tcp.port", 10}, {"rdp.tcp.port", "RDP", "tcp.port", 10}, }; /* These are obsolete preferences from the dissectors' view, (typically because of a switch from a single value to a range value) but the name of the preference conflicts with the generated preference name from the dissector table. Don't allow the obsolete preference through to be handled */ struct obsolete_pref_name obsolete_prefs[] = { {"diameter.tcp.port"}, {"kafka.tcp.port"}, {"mrcpv2.tcp.port"}, {"rtsp.tcp.port"}, {"sip.tcp.port"}, {"t38.tcp.port"}, }; unsigned int i; char *p; guint uval; dissector_table_t sub_dissectors; dissector_handle_t handle, tpkt_handle; module_t *module; pref_t *pref; for (i = 0; i < sizeof(port_prefs)/sizeof(struct port_pref_name); i++) { if (strcmp(pref_name, port_prefs[i].pref_name) == 0) { /* XXX - give an error if it doesn't fit in a guint? */ uval = (guint)strtoul(value, &p, port_prefs[i].base); if (p == value || *p != '\0') return FALSE; /* number was bad */ module = prefs_find_module((gchar*)port_prefs[i].module_name); pref = prefs_find_preference(module, port_prefs[i].table_name); if (pref != NULL) { module->prefs_changed = TRUE; *pref->varp.uint = uval; } /* If the value is zero, it wouldn't add to the Decode As tables */ if (uval != 0) { sub_dissectors = find_dissector_table(port_prefs[i].table_name); if (sub_dissectors != NULL) { handle = dissector_table_get_dissector_handle(sub_dissectors, (gchar*)port_prefs[i].module_name); if (handle != NULL) { dissector_change_uint(port_prefs[i].table_name, uval, handle); decode_build_reset_list(port_prefs[i].table_name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(uval), NULL, NULL); } } } return TRUE; } } for (i = 0; i < sizeof(port_range_prefs)/sizeof(struct port_pref_name); i++) { if (strcmp(pref_name, port_range_prefs[i].pref_name) == 0) { guint32 range_i, range_j; sub_dissectors = find_dissector_table(port_range_prefs[i].table_name); if (sub_dissectors != NULL) { switch (dissector_table_get_type(sub_dissectors)) { case FT_UINT8: case FT_UINT16: case FT_UINT24: case FT_UINT32: break; default: g_error("The dissector table %s (%s) is not an integer type - are you using a buggy plugin?", port_range_prefs[i].table_name, get_dissector_table_ui_name(port_range_prefs[i].table_name)); g_assert_not_reached(); } module = prefs_find_module((gchar*)port_range_prefs[i].module_name); pref = prefs_find_preference(module, port_range_prefs[i].table_name); if (pref != NULL) { if (!prefs_set_range_value_work(pref, value, TRUE, &module->prefs_changed)) { return FALSE; /* number was bad */ } handle = dissector_table_get_dissector_handle(sub_dissectors, (gchar*)port_range_prefs[i].module_name); if (handle != NULL) { for (range_i = 0; range_i < (*pref->varp.range)->nranges; range_i++) { for (range_j = (*pref->varp.range)->ranges[range_i].low; range_j < (*pref->varp.range)->ranges[range_i].high; range_j++) { dissector_change_uint(port_range_prefs[i].table_name, range_j, handle); decode_build_reset_list(port_range_prefs[i].table_name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(range_j), NULL, NULL); } dissector_change_uint(port_range_prefs[i].table_name, (*pref->varp.range)->ranges[range_i].high, handle); decode_build_reset_list(port_range_prefs[i].table_name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER((*pref->varp.range)->ranges[range_i].high), NULL, NULL); } } } } return TRUE; } } for (i = 0; i < sizeof(tpkt_subdissector_port_prefs)/sizeof(struct port_pref_name); i++) { if (strcmp(pref_name, tpkt_subdissector_port_prefs[i].pref_name) == 0) { /* XXX - give an error if it doesn't fit in a guint? */ uval = (guint)strtoul(value, &p, tpkt_subdissector_port_prefs[i].base); if (p == value || *p != '\0') return FALSE; /* number was bad */ /* If the value is 0 or 102 (default TPKT port), don't add to the Decode As tables */ if ((uval != 0) && (uval != 102)) { tpkt_handle = find_dissector("tpkt"); if (tpkt_handle != NULL) { dissector_change_uint(tpkt_subdissector_port_prefs[i].table_name, uval, tpkt_handle); } } return TRUE; } } for (i = 0; i < sizeof(obsolete_prefs)/sizeof(struct obsolete_pref_name); i++) { if (strcmp(pref_name, obsolete_prefs[i].pref_name) == 0) { /* Just ignore the preference */ return TRUE; } } return FALSE; } static prefs_set_pref_e set_pref(gchar *pref_name, const gchar *value, void *private_data _U_, gboolean return_range_errors) { unsigned long int cval; guint uval; gboolean bval; gint enum_val; char *p; gchar *dotp, *last_dotp; static gchar *filter_label = NULL; static gboolean filter_enabled = FALSE; gchar *filter_expr = NULL; module_t *module, *containing_module; pref_t *pref; int type; //The PRS_GUI field names are here for backwards compatibility //display filters have been converted to a UAT. if (strcmp(pref_name, PRS_GUI_FILTER_LABEL) == 0) { filter_label = g_strdup(value); } else if (strcmp(pref_name, PRS_GUI_FILTER_ENABLED) == 0) { filter_enabled = (strcmp(value, "TRUE") == 0) ? TRUE : FALSE; } else if (strcmp(pref_name, PRS_GUI_FILTER_EXPR) == 0) { filter_expr = g_strdup(value); /* Comments not supported for "old" preference style */ filter_expression_new(filter_label, filter_expr, "", filter_enabled); g_free(filter_label); g_free(filter_expr); } else if (strcmp(pref_name, "gui.version_in_start_page") == 0) { /* Convert deprecated value to closest current equivalent */ if (g_ascii_strcasecmp(value, "true") == 0) { prefs.gui_version_placement = version_both; } else { prefs.gui_version_placement = version_neither; } } else if (strcmp(pref_name, "name_resolve") == 0 || strcmp(pref_name, "capture.name_resolve") == 0) { /* * Handle the deprecated name resolution options. * * "TRUE" and "FALSE", for backwards compatibility, are synonyms for * RESOLV_ALL and RESOLV_NONE. * * Otherwise, we treat it as a list of name types we want to resolve. */ if (g_ascii_strcasecmp(value, "true") == 0) { gbl_resolv_flags.mac_name = TRUE; gbl_resolv_flags.network_name = TRUE; gbl_resolv_flags.transport_name = TRUE; } else if (g_ascii_strcasecmp(value, "false") == 0) { disable_name_resolution(); } else { /* start out with none set */ disable_name_resolution(); if (string_to_name_resolve(value, &gbl_resolv_flags) != '\0') return PREFS_SET_SYNTAX_ERR; } } else if (deprecated_heur_dissector_pref(pref_name, value)) { /* Handled within deprecated_heur_dissector_pref() if found */ } else if (deprecated_enable_dissector_pref(pref_name, value)) { /* Handled within deprecated_enable_dissector_pref() if found */ } else if (deprecated_port_pref(pref_name, value)) { /* Handled within deprecated_port_pref() if found */ } else { /* Handle deprecated "global" options that don't have a module * associated with them */ if ((strcmp(pref_name, "name_resolve_concurrency") == 0) || (strcmp(pref_name, "name_resolve_load_smi_modules") == 0) || (strcmp(pref_name, "name_resolve_suppress_smi_errors") == 0)) { module = nameres_module; dotp = pref_name; } else { /* To which module does this preference belong? */ module = NULL; last_dotp = pref_name; while (!module) { dotp = strchr(last_dotp, '.'); if (dotp == NULL) { /* Either there's no such module, or no module was specified. In either case, that means there's no such preference. */ return PREFS_SET_NO_SUCH_PREF; } *dotp = '\0'; /* separate module and preference name */ module = prefs_find_module(pref_name); /* * XXX - "Diameter" rather than "diameter" was used in earlier * versions of Wireshark; if we didn't find the module, and its name * was "Diameter", look for "diameter" instead. * * In addition, the BEEP protocol used to be the BXXP protocol, * so if we didn't find the module, and its name was "bxxp", * look for "beep" instead. * * Also, the preferences for GTP v0 and v1 were combined under * a single "gtp" heading, and the preferences for SMPP were * moved to "smpp-gsm-sms" and then moved to "gsm-sms-ud". * However, SMPP now has its own preferences, so we just map * "smpp-gsm-sms" to "gsm-sms-ud", and then handle SMPP below. * * We also renamed "dcp" to "dccp", "x.25" to "x25", "x411" to "p1" * and "nsip" to "gprs_ns". * * The SynOptics Network Management Protocol (SONMP) is now known by * its modern name, the Nortel Discovery Protocol (NDP). */ if (module == NULL) { if (strcmp(pref_name, "column") == 0) module = gui_column_module; else if (strcmp(pref_name, "Diameter") == 0) module = prefs_find_module("diameter"); else if (strcmp(pref_name, "bxxp") == 0) module = prefs_find_module("beep"); else if (strcmp(pref_name, "gtpv0") == 0 || strcmp(pref_name, "gtpv1") == 0) module = prefs_find_module("gtp"); else if (strcmp(pref_name, "smpp-gsm-sms") == 0) module = prefs_find_module("gsm-sms-ud"); else if (strcmp(pref_name, "dcp") == 0) module = prefs_find_module("dccp"); else if (strcmp(pref_name, "x.25") == 0) module = prefs_find_module("x25"); else if (strcmp(pref_name, "x411") == 0) module = prefs_find_module("p1"); else if (strcmp(pref_name, "nsip") == 0) module = prefs_find_module("gprs-ns"); else if (strcmp(pref_name, "sonmp") == 0) module = prefs_find_module("ndp"); else if (strcmp(pref_name, "etheric") == 0 || strcmp(pref_name, "isup_thin") == 0) { /* This protocol was removed 7. July 2009 */ return PREFS_SET_OBSOLETE; } if (module) { ws_g_warning ("Preference \"%s.%s\" has been converted to \"%s.%s.%s\"\n" "Save your preferences to make this change permanent.", pref_name, dotp+1, module->parent->name, pref_name, dotp+1); prefs.unknown_prefs = TRUE; } } *dotp = '.'; /* put the preference string back */ dotp++; /* skip past separator to preference name */ last_dotp = dotp; } } /* The pref is located in the module or a submodule. * Assume module, then search for a submodule holding the pref. */ containing_module = module; pref = prefs_find_preference_with_submodule(module, dotp, &containing_module); if (pref == NULL) { prefs.unknown_prefs = TRUE; /* "gui" prefix was added to column preferences for better organization * within the preferences file */ if (module == gui_column_module) { /* While this has a subtree, there is no apply callback, so no * need to use prefs_find_preference_with_submodule to update * containing_module. It would not be useful. */ pref = prefs_find_preference(module, pref_name); } else if (strcmp(module->name, "mgcp") == 0) { /* * XXX - "mgcp.display raw text toggle" and "mgcp.display dissect tree" * rather than "mgcp.display_raw_text" and "mgcp.display_dissect_tree" * were used in earlier versions of Wireshark; if we didn't find the * preference, it was an MGCP preference, and its name was * "display raw text toggle" or "display dissect tree", look for * "display_raw_text" or "display_dissect_tree" instead. * * "mgcp.tcp.port" and "mgcp.udp.port" are harder to handle, as both * the gateway and callagent ports were given those names; we interpret * the first as "mgcp.{tcp,udp}.gateway_port" and the second as * "mgcp.{tcp,udp}.callagent_port", as that's the order in which * they were registered by the MCCP dissector and thus that's the * order in which they were written to the preferences file. (If * we're not reading the preferences file, but are handling stuff * from a "-o" command-line option, we have no clue which the user * had in mind - they should have used "mgcp.{tcp,udp}.gateway_port" * or "mgcp.{tcp,udp}.callagent_port" instead.) */ if (strcmp(dotp, "display raw text toggle") == 0) pref = prefs_find_preference(module, "display_raw_text"); else if (strcmp(dotp, "display dissect tree") == 0) pref = prefs_find_preference(module, "display_dissect_tree"); else if (strcmp(dotp, "tcp.port") == 0) { mgcp_tcp_port_count++; if (mgcp_tcp_port_count == 1) { /* It's the first one */ pref = prefs_find_preference(module, "tcp.gateway_port"); } else if (mgcp_tcp_port_count == 2) { /* It's the second one */ pref = prefs_find_preference(module, "tcp.callagent_port"); } /* Otherwise it's from the command line, and we don't bother mapping it. */ } else if (strcmp(dotp, "udp.port") == 0) { mgcp_udp_port_count++; if (mgcp_udp_port_count == 1) { /* It's the first one */ pref = prefs_find_preference(module, "udp.gateway_port"); } else if (mgcp_udp_port_count == 2) { /* It's the second one */ pref = prefs_find_preference(module, "udp.callagent_port"); } /* Otherwise it's from the command line, and we don't bother mapping it. */ } } else if (strcmp(module->name, "smb") == 0) { /* Handle old names for SMB preferences. */ if (strcmp(dotp, "smb.trans.reassembly") == 0) pref = prefs_find_preference(module, "trans_reassembly"); else if (strcmp(dotp, "smb.dcerpc.reassembly") == 0) pref = prefs_find_preference(module, "dcerpc_reassembly"); } else if (strcmp(module->name, "ndmp") == 0) { /* Handle old names for NDMP preferences. */ if (strcmp(dotp, "ndmp.desegment") == 0) pref = prefs_find_preference(module, "desegment"); } else if (strcmp(module->name, "diameter") == 0) { /* Handle old names for Diameter preferences. */ if (strcmp(dotp, "diameter.desegment") == 0) pref = prefs_find_preference(module, "desegment"); } else if (strcmp(module->name, "pcli") == 0) { /* Handle old names for PCLI preferences. */ if (strcmp(dotp, "pcli.udp_port") == 0) pref = prefs_find_preference(module, "udp_port"); } else if (strcmp(module->name, "artnet") == 0) { /* Handle old names for ARTNET preferences. */ if (strcmp(dotp, "artnet.udp_port") == 0) pref = prefs_find_preference(module, "udp_port"); } else if (strcmp(module->name, "mapi") == 0) { /* Handle old names for MAPI preferences. */ if (strcmp(dotp, "mapi_decrypt") == 0) pref = prefs_find_preference(module, "decrypt"); } else if (strcmp(module->name, "fc") == 0) { /* Handle old names for Fibre Channel preferences. */ if (strcmp(dotp, "reassemble_fc") == 0) pref = prefs_find_preference(module, "reassemble"); else if (strcmp(dotp, "fc_max_frame_size") == 0) pref = prefs_find_preference(module, "max_frame_size"); } else if (strcmp(module->name, "fcip") == 0) { /* Handle old names for Fibre Channel-over-IP preferences. */ if (strcmp(dotp, "desegment_fcip_messages") == 0) pref = prefs_find_preference(module, "desegment"); else if (strcmp(dotp, "fcip_port") == 0) pref = prefs_find_preference(module, "target_port"); } else if (strcmp(module->name, "gtp") == 0) { /* Handle old names for GTP preferences. */ if (strcmp(dotp, "gtpv0_port") == 0) pref = prefs_find_preference(module, "v0_port"); else if (strcmp(dotp, "gtpv1c_port") == 0) pref = prefs_find_preference(module, "v1c_port"); else if (strcmp(dotp, "gtpv1u_port") == 0) pref = prefs_find_preference(module, "v1u_port"); else if (strcmp(dotp, "gtp_dissect_tpdu") == 0) pref = prefs_find_preference(module, "dissect_tpdu"); else if (strcmp(dotp, "gtpv0_dissect_cdr_as") == 0) pref = prefs_find_preference(module, "v0_dissect_cdr_as"); else if (strcmp(dotp, "gtpv0_check_etsi") == 0) pref = prefs_find_preference(module, "v0_check_etsi"); else if (strcmp(dotp, "gtpv1_check_etsi") == 0) pref = prefs_find_preference(module, "v1_check_etsi"); } else if (strcmp(module->name, "ip") == 0) { /* Handle old names for IP preferences. */ if (strcmp(dotp, "ip_summary_in_tree") == 0) pref = prefs_find_preference(module, "summary_in_tree"); } else if (strcmp(module->name, "iscsi") == 0) { /* Handle old names for iSCSI preferences. */ if (strcmp(dotp, "iscsi_port") == 0) pref = prefs_find_preference(module, "target_port"); } else if (strcmp(module->name, "lmp") == 0) { /* Handle old names for LMP preferences. */ if (strcmp(dotp, "lmp_version") == 0) pref = prefs_find_preference(module, "version"); } else if (strcmp(module->name, "mtp3") == 0) { /* Handle old names for MTP3 preferences. */ if (strcmp(dotp, "mtp3_standard") == 0) pref = prefs_find_preference(module, "standard"); else if (strcmp(dotp, "net_addr_format") == 0) pref = prefs_find_preference(module, "addr_format"); } else if (strcmp(module->name, "nlm") == 0) { /* Handle old names for NLM preferences. */ if (strcmp(dotp, "nlm_msg_res_matching") == 0) pref = prefs_find_preference(module, "msg_res_matching"); } else if (strcmp(module->name, "ppp") == 0) { /* Handle old names for PPP preferences. */ if (strcmp(dotp, "ppp_fcs") == 0) pref = prefs_find_preference(module, "fcs_type"); else if (strcmp(dotp, "ppp_vj") == 0) pref = prefs_find_preference(module, "decompress_vj"); } else if (strcmp(module->name, "rsvp") == 0) { /* Handle old names for RSVP preferences. */ if (strcmp(dotp, "rsvp_process_bundle") == 0) pref = prefs_find_preference(module, "process_bundle"); } else if (strcmp(module->name, "tcp") == 0) { /* Handle old names for TCP preferences. */ if (strcmp(dotp, "tcp_summary_in_tree") == 0) pref = prefs_find_preference(module, "summary_in_tree"); else if (strcmp(dotp, "tcp_analyze_sequence_numbers") == 0) pref = prefs_find_preference(module, "analyze_sequence_numbers"); else if (strcmp(dotp, "tcp_relative_sequence_numbers") == 0) pref = prefs_find_preference(module, "relative_sequence_numbers"); } else if (strcmp(module->name, "udp") == 0) { /* Handle old names for UDP preferences. */ if (strcmp(dotp, "udp_summary_in_tree") == 0) pref = prefs_find_preference(module, "summary_in_tree"); } else if (strcmp(module->name, "ndps") == 0) { /* Handle old names for NDPS preferences. */ if (strcmp(dotp, "desegment_ndps") == 0) pref = prefs_find_preference(module, "desegment_tcp"); } else if (strcmp(module->name, "http") == 0) { /* Handle old names for HTTP preferences. */ if (strcmp(dotp, "desegment_http_headers") == 0) pref = prefs_find_preference(module, "desegment_headers"); else if (strcmp(dotp, "desegment_http_body") == 0) pref = prefs_find_preference(module, "desegment_body"); } else if (strcmp(module->name, "smpp") == 0) { /* Handle preferences that moved from SMPP. */ module_t *new_module = prefs_find_module("gsm-sms-ud"); if (new_module) { if (strcmp(dotp, "port_number_udh_means_wsp") == 0) { pref = prefs_find_preference(new_module, "port_number_udh_means_wsp"); containing_module = new_module; } else if (strcmp(dotp, "try_dissect_1st_fragment") == 0) { pref = prefs_find_preference(new_module, "try_dissect_1st_fragment"); containing_module = new_module; } } } else if (strcmp(module->name, "asn1") == 0) { /* Handle old generic ASN.1 preferences (it's not really a rename, as the new preferences support multiple ports, but we might as well copy them over). */ if (strcmp(dotp, "tcp_port") == 0) pref = prefs_find_preference(module, "tcp_ports"); else if (strcmp(dotp, "udp_port") == 0) pref = prefs_find_preference(module, "udp_ports"); else if (strcmp(dotp, "sctp_port") == 0) pref = prefs_find_preference(module, "sctp_ports"); } else if (strcmp(module->name, "llcgprs") == 0) { if (strcmp(dotp, "ignore_cipher_bit") == 0) pref = prefs_find_preference(module, "autodetect_cipher_bit"); } else if (strcmp(module->name, "erf") == 0) { if (strcmp(dotp, "erfeth") == 0) { /* Handle the old "erfeth" preference; map it to the new "ethfcs" preference, and map the values to those for the new preference. */ pref = prefs_find_preference(module, "ethfcs"); if (strcmp(value, "ethfcs") == 0 || strcmp(value, "Ethernet with FCS") == 0) value = "TRUE"; else if (strcmp(value, "eth") == 0 || strcmp(value, "Ethernet") == 0) value = "FALSE"; else if (strcmp(value, "raw") == 0 || strcmp(value, "Raw data") == 0) value = "TRUE"; } else if (strcmp(dotp, "erfatm") == 0) { /* Handle the old "erfatm" preference; map it to the new "aal5_type" preference, and map the values to those for the new preference. */ pref = prefs_find_preference(module, "aal5_type"); if (strcmp(value, "atm") == 0 || strcmp(value, "ATM") == 0) value = "guess"; else if (strcmp(value, "llc") == 0 || strcmp(value, "LLC") == 0) value = "llc"; else if (strcmp(value, "raw") == 0 || strcmp(value, "Raw data") == 0) value = "guess"; } else if (strcmp(dotp, "erfhdlc") == 0) { /* Handle the old "erfhdlc" preference; map it to the new "hdlc_type" preference, and map the values to those for the new preference. */ pref = prefs_find_preference(module, "hdlc_type"); if (strcmp(value, "chdlc") == 0 || strcmp(value, "Cisco HDLC") == 0) value = "chdlc"; else if (strcmp(value, "ppp") == 0 || strcmp(value, "PPP serial") == 0) value = "ppp"; else if (strcmp(value, "fr") == 0 || strcmp(value, "Frame Relay") == 0) value = "frelay"; else if (strcmp(value, "mtp2") == 0 || strcmp(value, "SS7 MTP2") == 0) value = "mtp2"; else if (strcmp(value, "raw") == 0 || strcmp(value, "Raw data") == 0) value = "guess"; } } else if (strcmp(module->name, "eth") == 0) { /* "eth.qinq_ethertype" has been changed(restored) to "vlan.qinq.ethertype" */ if (strcmp(dotp, "qinq_ethertype") == 0) { module_t *new_module = prefs_find_module("vlan"); if (new_module) { pref = prefs_find_preference(new_module, "qinq_ethertype"); containing_module = new_module; } } } else if (strcmp(module->name, "taps") == 0) { /* taps preferences moved to "statistics" module */ if (strcmp(dotp, "update_interval") == 0 || strcmp(dotp, "rtp_player_max_visible") == 0) pref = prefs_find_preference(stats_module, dotp); } else if (strcmp(module->name, "packet_list") == 0) { /* packet_list preferences moved to protocol module */ if (strcmp(dotp, "display_hidden_proto_items") == 0) pref = prefs_find_preference(protocols_module, dotp); } else if (strcmp(module->name, "stream") == 0) { /* stream preferences moved to gui color module */ if ((strcmp(dotp, "client.fg") == 0) || (strcmp(dotp, "client.bg") == 0) || (strcmp(dotp, "server.fg") == 0) || (strcmp(dotp, "server.bg") == 0)) pref = prefs_find_preference(gui_color_module, pref_name); } else if (strcmp(module->name, "nameres") == 0) { if (strcmp(pref_name, "name_resolve_concurrency") == 0) { pref = prefs_find_preference(nameres_module, pref_name); } else if (strcmp(pref_name, "name_resolve_load_smi_modules") == 0) { pref = prefs_find_preference(nameres_module, "load_smi_modules"); } else if (strcmp(pref_name, "name_resolve_suppress_smi_errors") == 0) { pref = prefs_find_preference(nameres_module, "suppress_smi_errors"); } } } if (pref == NULL) return PREFS_SET_NO_SUCH_PREF; /* no such preference */ type = pref->type; if (IS_PREF_OBSOLETE(type)) { return PREFS_SET_OBSOLETE; /* no such preference any more */ } else { RESET_PREF_OBSOLETE(type); } switch (type) { case PREF_UINT: /* XXX - give an error if it doesn't fit in a guint? */ uval = (guint)strtoul(value, &p, pref->info.base); if (p == value || *p != '\0') return PREFS_SET_SYNTAX_ERR; /* number was bad */ if (*pref->varp.uint != uval) { containing_module->prefs_changed = TRUE; *pref->varp.uint = uval; } break; case PREF_DECODE_AS_UINT: { /* This is for backwards compatibility in case any of the preferences that shared the "Decode As" preference name and used to be PREF_UINT are now applied directly to the Decode As funtionality */ dissector_table_t sub_dissectors; dissector_handle_t handle; /* XXX - give an error if it doesn't fit in a guint? */ uval = (guint)strtoul(value, &p, pref->info.base); if (p == value || *p != '\0') return PREFS_SET_SYNTAX_ERR; /* number was bad */ if (*pref->varp.uint != uval) { containing_module->prefs_changed = TRUE; *pref->varp.uint = uval; /* Name of preference is the dissector table */ sub_dissectors = find_dissector_table(pref->name); if (sub_dissectors != NULL) { handle = dissector_table_get_dissector_handle(sub_dissectors, (gchar*)module->title); if (handle != NULL) { if (uval != 0) { dissector_change_uint(pref->name, uval, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(uval), NULL, NULL); } else { dissector_delete_uint(pref->name, *pref->varp.uint, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), pref->varp.uint, NULL, NULL); } /* XXX - Do we save the decode_as_entries file here? */ } } } break; } case PREF_BOOL: /* XXX - give an error if it's neither "true" nor "false"? */ if (g_ascii_strcasecmp(value, "true") == 0) bval = TRUE; else bval = FALSE; if (*pref->varp.boolp != bval) { containing_module->prefs_changed = TRUE; *pref->varp.boolp = bval; } break; case PREF_ENUM: /* XXX - give an error if it doesn't match? */ enum_val = find_val_for_string(value, pref->info.enum_info.enumvals, *pref->varp.enump); if (*pref->varp.enump != enum_val) { containing_module->prefs_changed = TRUE; *pref->varp.enump = enum_val; } break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: containing_module->prefs_changed |= prefs_set_string_value(pref, value, pref_current); break; case PREF_RANGE: { if (!prefs_set_range_value_work(pref, value, return_range_errors, &containing_module->prefs_changed)) return PREFS_SET_SYNTAX_ERR; /* number was bad */ break; } case PREF_DECODE_AS_RANGE: { /* This is for backwards compatibility in case any of the preferences that shared the "Decode As" preference name and used to be PREF_RANGE are now applied directly to the Decode As funtionality */ range_t *newrange; dissector_table_t sub_dissectors; dissector_handle_t handle; guint32 i, j; if (range_convert_str_work(wmem_epan_scope(), &newrange, value, pref->info.max_value, return_range_errors) != CVT_NO_ERROR) { return PREFS_SET_SYNTAX_ERR; /* number was bad */ } if (!ranges_are_equal(*pref->varp.range, newrange)) { wmem_free(wmem_epan_scope(), *pref->varp.range); *pref->varp.range = newrange; containing_module->prefs_changed = TRUE; /* Name of preference is the dissector table */ sub_dissectors = find_dissector_table(pref->name); if (sub_dissectors != NULL) { handle = dissector_table_get_dissector_handle(sub_dissectors, (gchar*)module->title); if (handle != NULL) { /* Delete all of the old values from the dissector table */ for (i = 0; i < (*pref->varp.range)->nranges; i++) { for (j = (*pref->varp.range)->ranges[i].low; j < (*pref->varp.range)->ranges[i].high; j++) { dissector_delete_uint(pref->name, j, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(j), NULL, NULL); } dissector_delete_uint(pref->name, (*pref->varp.range)->ranges[i].high, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER((*pref->varp.range)->ranges[i].high), NULL, NULL); } /* Add new values to the dissector table */ for (i = 0; i < newrange->nranges; i++) { for (j = newrange->ranges[i].low; j < newrange->ranges[i].high; j++) { dissector_change_uint(pref->name, j, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(j), NULL, NULL); } dissector_change_uint(pref->name, newrange->ranges[i].high, handle); decode_build_reset_list(pref->name, dissector_table_get_type(sub_dissectors), GUINT_TO_POINTER(newrange->ranges[i].high), NULL, NULL); } /* XXX - Do we save the decode_as_entries file here? */ } } } else { wmem_free(wmem_epan_scope(), newrange); } break; } case PREF_COLOR: { cval = strtoul(value, NULL, 16); if ((pref->varp.colorp->red != RED_COMPONENT(cval)) || (pref->varp.colorp->green != GREEN_COMPONENT(cval)) || (pref->varp.colorp->blue != BLUE_COMPONENT(cval))) { containing_module->prefs_changed = TRUE; pref->varp.colorp->red = RED_COMPONENT(cval); pref->varp.colorp->green = GREEN_COMPONENT(cval); pref->varp.colorp->blue = BLUE_COMPONENT(cval); } break; } case PREF_CUSTOM: return pref->custom_cbs.set_cb(pref, value, &containing_module->prefs_changed); case PREF_STATIC_TEXT: case PREF_UAT: { break; } } } return PREFS_SET_OK; } typedef struct { FILE *pf; gboolean is_gui_module; } write_gui_pref_arg_t; const char * prefs_pref_type_name(pref_t *pref) { const char *type_name = "[Unknown]"; int type; if (!pref) { return type_name; /* ...or maybe assert? */ } type = pref->type; if (IS_PREF_OBSOLETE(type)) { type_name = "Obsolete"; } else { RESET_PREF_OBSOLETE(type); } switch (type) { case PREF_UINT: switch (pref->info.base) { case 10: type_name = "Decimal"; break; case 8: type_name = "Octal"; break; case 16: type_name = "Hexadecimal"; break; } break; case PREF_BOOL: type_name = "Boolean"; break; case PREF_ENUM: type_name = "Choice"; break; case PREF_STRING: type_name = "String"; break; case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: type_name = "Filename"; break; case PREF_DIRNAME: type_name = "Directory"; break; case PREF_RANGE: type_name = "Range"; break; case PREF_COLOR: type_name = "Color"; break; case PREF_CUSTOM: if (pref->custom_cbs.type_name_cb) return pref->custom_cbs.type_name_cb(); type_name = "Custom"; break; case PREF_DECODE_AS_UINT: type_name = "Decode As value"; break; case PREF_DECODE_AS_RANGE: type_name = "Range (for Decode As)"; break; case PREF_STATIC_TEXT: type_name = "Static text"; break; case PREF_UAT: type_name = "UAT"; break; } return type_name; } char * prefs_pref_type_description(pref_t *pref) { const char *type_desc = "An unknown preference type"; int type; if (!pref) { return g_strdup_printf("%s.", type_desc); /* ...or maybe assert? */ } type = pref->type; if (IS_PREF_OBSOLETE(type)) { type_desc = "An obsolete preference"; } else { RESET_PREF_OBSOLETE(type); } switch (type) { case PREF_UINT: switch (pref->info.base) { case 10: type_desc = "A decimal number"; break; case 8: type_desc = "An octal number"; break; case 16: type_desc = "A hexadecimal number"; break; } break; case PREF_BOOL: type_desc = "TRUE or FALSE (case-insensitive)"; break; case PREF_ENUM: { const enum_val_t *enum_valp = pref->info.enum_info.enumvals; GString *enum_str = g_string_new("One of: "); while (enum_valp->name != NULL) { g_string_append(enum_str, enum_valp->description); enum_valp++; if (enum_valp->name != NULL) g_string_append(enum_str, ", "); } g_string_append(enum_str, "\n(case-insensitive)."); return g_string_free(enum_str, FALSE); break; } case PREF_STRING: type_desc = "A string"; break; case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: type_desc = "A path to a file"; break; case PREF_DIRNAME: type_desc = "A path to a directory"; break; case PREF_RANGE: { type_desc = "A string denoting an positive integer range (e.g., \"1-20,30-40\")"; break; } case PREF_COLOR: { type_desc = "A six-digit hexadecimal RGB color triplet (e.g. fce94f)"; break; } case PREF_CUSTOM: if (pref->custom_cbs.type_description_cb) return pref->custom_cbs.type_description_cb(); type_desc = "A custom value"; break; case PREF_DECODE_AS_UINT: type_desc = "An integer value used in Decode As"; break; case PREF_DECODE_AS_RANGE: type_desc = "A string denoting an positive integer range for Decode As"; break; case PREF_STATIC_TEXT: type_desc = "[Static text]"; break; case PREF_UAT: type_desc = "Configuration data stored in its own file"; break; default: break; } return g_strdup(type_desc); } gboolean prefs_pref_is_default(pref_t *pref) { int type; if (!pref) return FALSE; type = pref->type; if (IS_PREF_OBSOLETE(type)) { return FALSE; } else { RESET_PREF_OBSOLETE(type); } switch (type) { case PREF_DECODE_AS_UINT: if (pref->default_val.uint == *pref->varp.uint) return TRUE; break; case PREF_UINT: if (pref->default_val.uint == *pref->varp.uint) return TRUE; break; case PREF_BOOL: if (pref->default_val.boolval == *pref->varp.boolp) return TRUE; break; case PREF_ENUM: if (pref->default_val.enumval == *pref->varp.enump) return TRUE; break; case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: if (!(g_strcmp0(pref->default_val.string, *pref->varp.string))) return TRUE; break; case PREF_DECODE_AS_RANGE: case PREF_RANGE: { if ((ranges_are_equal(pref->default_val.range, *pref->varp.range))) return TRUE; break; } case PREF_COLOR: { if ((pref->default_val.color.red == pref->varp.colorp->red) && (pref->default_val.color.green == pref->varp.colorp->green) && (pref->default_val.color.blue == pref->varp.colorp->blue)) return TRUE; break; } case PREF_CUSTOM: return pref->custom_cbs.is_default_cb(pref); case PREF_STATIC_TEXT: case PREF_UAT: return FALSE; /* g_assert_not_reached(); */ break; } return FALSE; } char * prefs_pref_to_str(pref_t *pref, pref_source_t source) { const char *pref_text = "[Unknown]"; void *valp; /* pointer to preference value */ color_t *pref_color; gchar *tmp_value, *ret_value; int type; if (!pref) { return g_strdup(pref_text); } switch (source) { case pref_default: valp = &pref->default_val; /* valp = &boolval, &enumval, etc. are implied by union property */ pref_color = &pref->default_val.color; break; case pref_stashed: valp = &pref->stashed_val; /* valp = &boolval, &enumval, etc. are implied by union property */ pref_color = &pref->stashed_val.color; break; case pref_current: valp = pref->varp.uint; /* valp = boolval, enumval, etc. are implied by union property */ pref_color = pref->varp.colorp; break; default: return g_strdup(pref_text); } type = pref->type; if (IS_PREF_OBSOLETE(type)) { pref_text = "[Obsolete]"; } else { RESET_PREF_OBSOLETE(type); } switch (type) { case PREF_DECODE_AS_UINT: case PREF_UINT: { guint pref_uint = *(guint *) valp; switch (pref->info.base) { case 10: return g_strdup_printf("%u", pref_uint); case 8: return g_strdup_printf("%#o", pref_uint); case 16: return g_strdup_printf("%#x", pref_uint); } break; } case PREF_BOOL: return g_strdup((*(gboolean *) valp) ? "TRUE" : "FALSE"); case PREF_ENUM: { gint pref_enumval = *(gint *) valp; /* * For now, we return the "description" value, so that if we * save the preferences older versions of Wireshark can at * least read preferences that they supported; we support * either the short name or the description when reading * the preferences file or a "-o" option. */ const enum_val_t *enum_valp = pref->info.enum_info.enumvals; while (enum_valp->name != NULL) { if (enum_valp->value == pref_enumval) return g_strdup(enum_valp->description); enum_valp++; } break; } case PREF_STRING: case PREF_SAVE_FILENAME: case PREF_OPEN_FILENAME: case PREF_DIRNAME: return g_strdup(*(const char **) valp); case PREF_DECODE_AS_RANGE: case PREF_RANGE: /* Convert wmem to g_alloc memory */ tmp_value = range_convert_range(NULL, *(range_t **) valp); ret_value = g_strdup(tmp_value); wmem_free(NULL, tmp_value); return ret_value; case PREF_COLOR: return g_strdup_printf("%02x%02x%02x", (pref_color->red * 255 / 65535), (pref_color->green * 255 / 65535), (pref_color->blue * 255 / 65535)); case PREF_CUSTOM: if (pref->custom_cbs.to_str_cb) return pref->custom_cbs.to_str_cb(pref, source == pref_default ? TRUE : FALSE); pref_text = "[Custom]"; break; case PREF_STATIC_TEXT: pref_text = "[Static text]"; break; case PREF_UAT: { uat_t *uat = pref->varp.uat; if (uat && uat->filename) return g_strdup_printf("[Managed in the file \"%s\"]", uat->filename); else pref_text = "[Managed in an unknown file]"; break; } default: break; } return g_strdup(pref_text); } /* * Write out a single dissector preference. */ static void write_pref(gpointer data, gpointer user_data) { pref_t *pref = (pref_t *)data; write_pref_arg_t *arg = (write_pref_arg_t *)user_data; gchar **desc_lines; int i; int type; type = pref->type; if (IS_PREF_OBSOLETE(type)) { /* * This preference is no longer supported; it's not a * real preference, so we don't write it out (i.e., we * treat it as if it weren't found in the list of * preferences, and we weren't called in the first place). */ return; } else { RESET_PREF_OBSOLETE(type); } switch (type) { case PREF_STATIC_TEXT: case PREF_UAT: /* Nothing to do; don't bother printing the description */ return; case PREF_DECODE_AS_UINT: case PREF_DECODE_AS_RANGE: /* Data is saved through Decode As mechanism and not part of preferences file */ return; default: break; } if (pref->type != PREF_CUSTOM || pref->custom_cbs.type_name_cb() != NULL) { /* * The prefix will either be the module name or the parent * name if it's a subtree */ const char *name_prefix = (arg->module->name != NULL) ? arg->module->name : arg->module->parent->name; char *type_desc, *pref_text; const char * def_prefix = prefs_pref_is_default(pref) ? "#" : ""; if (pref->type == PREF_CUSTOM) fprintf(arg->pf, "\n# %s", pref->custom_cbs.type_name_cb()); fprintf(arg->pf, "\n"); if (pref->description && (g_ascii_strncasecmp(pref->description,"", 2) != 0)) { if (pref->type != PREF_CUSTOM) { /* We get duplicate lines otherwise. */ desc_lines = g_strsplit(pref->description,"\n",0); for (i = 0; desc_lines[i] != NULL; ++i) { fprintf(arg->pf, "# %s\n", desc_lines[i]); } g_strfreev(desc_lines); } } else { fprintf(arg->pf, "# No description\n"); } type_desc = prefs_pref_type_description(pref); desc_lines = g_strsplit(type_desc,"\n",0); for (i = 0; desc_lines[i] != NULL; ++i) { fprintf(arg->pf, "# %s\n", desc_lines[i]); } g_strfreev(desc_lines); g_free(type_desc); pref_text = prefs_pref_to_str(pref, pref_current); fprintf(arg->pf, "%s%s.%s: ", def_prefix, name_prefix, pref->name); desc_lines = g_strsplit(pref_text,"\n",0); for (i = 0; desc_lines[i] != NULL; ++i) { fprintf(arg->pf, "%s%s\n", i == 0 ? "" : def_prefix, desc_lines[i]); } if (i == 0) fprintf(arg->pf, "\n"); g_strfreev(desc_lines); g_free(pref_text); } } static void count_non_uat_pref(gpointer data, gpointer user_data) { pref_t *pref = (pref_t *)data; int *arg = (int *)user_data; switch (pref->type) { case PREF_UAT: case PREF_OBSOLETE: case PREF_DECODE_AS_UINT: case PREF_DECODE_AS_RANGE: //These types are not written in preference file break; default: (*arg)++; break; } } static int num_non_uat_prefs(module_t *module) { int num = 0; g_list_foreach(module->prefs, count_non_uat_pref, &num); return num; } /* * Write out all preferences for a module. */ static guint write_module_prefs(module_t *module, gpointer user_data) { write_gui_pref_arg_t *gui_pref_arg = (write_gui_pref_arg_t*)user_data; write_pref_arg_t arg; /* The GUI module needs to be explicitly called out so it can be written out of order */ if ((module == gui_module) && (gui_pref_arg->is_gui_module != TRUE)) return 0; /* Write a header for the main modules and GUI sub-modules */ if (((module->parent == NULL) || (module->parent == gui_module)) && ((prefs_module_has_submodules(module)) || (num_non_uat_prefs(module) > 0) || (module->name == NULL))) { if ((module->name == NULL) && (module->parent != NULL)) { fprintf(gui_pref_arg->pf, "\n####### %s: %s ########\n", module->parent->title, module->title); } else { fprintf(gui_pref_arg->pf, "\n####### %s ########\n", module->title); } } arg.module = module; arg.pf = gui_pref_arg->pf; g_list_foreach(arg.module->prefs, write_pref, &arg); if (prefs_module_has_submodules(module)) return prefs_modules_foreach_submodules(module, write_module_prefs, user_data); return 0; } /* Write out "prefs" to the user's preferences file, and return 0. If the preferences file path is NULL, write to stdout. If we got an error, stuff a pointer to the path of the preferences file into "*pf_path_return", and return the errno. */ int write_prefs(char **pf_path_return) { char *pf_path; FILE *pf; write_gui_pref_arg_t write_gui_pref_info; /* Needed for "-G defaultprefs" */ init_prefs(); /* To do: * - Split output lines longer than MAX_VAL_LEN * - Create a function for the preference directory check/creation * so that duplication can be avoided with filter.c */ if (pf_path_return != NULL) { pf_path = get_persconffile_path(PF_NAME, TRUE); if ((pf = ws_fopen(pf_path, "w")) == NULL) { *pf_path_return = pf_path; return errno; } g_free(pf_path); } else { pf = stdout; } fputs("# Configuration file for Wireshark " VERSION ".\n" "#\n" "# This file is regenerated each time preferences are saved within\n" "# Wireshark. Making manual changes should be safe, however.\n" "# Preferences that have been commented out have not been\n" "# changed from their default value.\n", pf); /* * For "backwards compatibility" the GUI module is written first as it's * at the top of the file. This is followed by all modules that can't * fit into the preferences read/write API. Finally the remaining modules * are written in alphabetical order (including of course the protocol preferences) */ write_gui_pref_info.pf = pf; write_gui_pref_info.is_gui_module = TRUE; write_module_prefs(gui_module, &write_gui_pref_info); write_gui_pref_info.is_gui_module = FALSE; prefs_modules_foreach_submodules(NULL, write_module_prefs, &write_gui_pref_info); fclose(pf); /* XXX - catch I/O errors (e.g. "ran out of disk space") and return an error indication, or maybe write to a new preferences file and rename that file on top of the old one only if there are not I/O errors. */ return 0; } /** The col_list is only partly managed by the custom preference API * because its data is shared between multiple preferences, so * it's freed here */ static void free_col_info(GList *list) { fmt_data *cfmt; GList *list_head = list; while (list != NULL) { cfmt = (fmt_data *)list->data; g_free(cfmt->title); g_free(cfmt->custom_fields); g_free(cfmt); list = g_list_next(list); } g_list_free(list_head); } /* * Editor modelines * * Local Variables: * c-basic-offset: 4 * tab-width: 8 * indent-tabs-mode: nil * End: * * ex: set shiftwidth=4 tabstop=8 expandtab: * :indentSize=4:tabSize=8:noTabs=true: */