2 * Routines for color filters
4 * Wireshark - Network traffic analyzer
5 * By Gerald Combs <gerald@wireshark.org>
6 * Copyright 1998 Gerald Combs
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2
11 * of the License, or (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23 * Updated 1 Dec 10 jjm
34 #include <wsutil/filesystem.h>
35 #include <wsutil/file_util.h>
36 #include <wsutil/ws_printf.h> /* ws_g_warning */
38 #include <epan/packet.h>
39 #include "color_filters.h"
41 #include <epan/dfilter/dfilter.h>
42 #include <epan/prefs.h>
43 #include <epan/epan_dissect.h>
46 #define RED_COMPONENT(x) (guint16) (((((x) >> 16) & 0xff) * 65535 / 255))
47 #define GREEN_COMPONENT(x) (guint16) (((((x) >> 8) & 0xff) * 65535 / 255))
48 #define BLUE_COMPONENT(x) (guint16) ( (((x) & 0xff) * 65535 / 255))
50 static gboolean read_users_filters(GSList **cfl, gchar** err_msg, color_filter_add_cb_func add_cb);
52 /* the currently active filters */
53 static GSList *color_filter_list = NULL;
55 /* keep "old" deleted filters in this list until
56 * the dissection no longer needs them (e.g. file is closed) */
57 static GSList *color_filter_deleted_list = NULL;
58 static GSList *color_filter_valid_list = NULL;
60 /* Color Filters can en-/disabled. */
61 static gboolean filters_enabled = TRUE;
63 /* Remember if there are temporary coloring filters set to
64 * add sensitivity to the "Reset Coloring 1-10" menu item
66 static gboolean tmp_colors_set = FALSE;
68 /* Create a new filter */
70 color_filter_new(const gchar *name, /* The name of the filter to create */
71 const gchar *filter_string, /* The string representing the filter */
72 color_t *bg_color, /* The background color */
73 color_t *fg_color, /* The foreground color */
74 gboolean disabled) /* Is the filter disabled? */
76 color_filter_t *colorf;
78 colorf = (color_filter_t *)g_malloc0(sizeof (color_filter_t));
79 colorf->filter_name = g_strdup(name);
80 colorf->filter_text = g_strdup(filter_string);
81 colorf->bg_color = *bg_color;
82 colorf->fg_color = *fg_color;
83 colorf->disabled = disabled;
87 /* Add ten empty (temporary) colorfilters for easy coloring */
89 color_filters_add_tmp(GSList **cfl)
96 color_t bg_color, fg_color;
97 color_filter_t *colorf;
99 g_assert(strlen(prefs.gui_colorized_fg)==69);
100 g_assert(strlen(prefs.gui_colorized_bg)==69);
101 fg_colors = g_strsplit(prefs.gui_colorized_fg, ",", -1);
102 bg_colors = g_strsplit(prefs.gui_colorized_bg, ",", -1);
104 for ( i=1 ; i<=10 ; i++ ) {
105 name = g_strdup_printf("%s%02d",CONVERSATION_COLOR_PREFIX,i);
107 /* retrieve background and foreground colors */
108 cval = strtoul(fg_colors[i-1], NULL, 16);
109 fg_color.red = RED_COMPONENT(cval);
110 fg_color.green = GREEN_COMPONENT(cval);
111 fg_color.blue = BLUE_COMPONENT(cval);
112 cval = strtoul(bg_colors[i-1], NULL, 16);
113 bg_color.red = RED_COMPONENT(cval);
114 bg_color.green = GREEN_COMPONENT(cval);
115 bg_color.blue = BLUE_COMPONENT(cval);
116 colorf = color_filter_new(name, NULL, &bg_color, &fg_color, TRUE);
117 colorf->filter_text = g_strdup("frame");
118 *cfl = g_slist_append(*cfl, colorf);
123 g_strfreev(fg_colors);
124 g_strfreev(bg_colors);
130 color_filters_find_by_name_cb(gconstpointer arg1, gconstpointer arg2)
132 const color_filter_t *colorf = (const color_filter_t *)arg1;
133 const gchar *name = (const gchar *)arg2;
135 return strcmp(colorf->filter_name, name);
139 /* Set the filter off a temporary colorfilters and enable it */
141 color_filters_set_tmp(guint8 filt_nr, const gchar *filter, gboolean disabled, gchar **err_msg)
144 const gchar *tmpfilter = NULL;
146 color_filter_t *colorf;
147 dfilter_t *compiled_filter;
149 gchar *local_err_msg = NULL;
150 /* Go through the temporary filters and look for the same filter string.
151 * If found, clear it so that a filter can be "moved" up and down the list
153 for ( i=1 ; i<=10 ; i++ ) {
154 /* If we need to reset the temporary filter (filter==NULL), don't look
155 * for other rules with the same filter string
157 if( i!=filt_nr && filter==NULL )
160 name = g_strdup_printf("%s%02d",CONVERSATION_COLOR_PREFIX,i);
161 cfl = g_slist_find_custom(color_filter_list, name, color_filters_find_by_name_cb);
162 colorf = (color_filter_t *)cfl->data;
164 /* Only change the filter rule if this is the rule to change or if
165 * a matching filter string has been found
167 if(colorf && ( (i==filt_nr) || (!strcmp(filter, colorf->filter_text)) ) ) {
168 /* set filter string to "frame" if we are resetting the rules
169 * or if we found a matching filter string which need to be cleared
171 tmpfilter = ( (filter==NULL) || (i!=filt_nr) ) ? "frame" : filter;
172 if (!dfilter_compile(tmpfilter, &compiled_filter, &local_err_msg)) {
173 *err_msg = g_strdup_printf( "Could not compile color filter name: \"%s\" text: \"%s\".\n%s", name, filter, local_err_msg);
174 g_free(local_err_msg);
177 if (colorf->filter_text != NULL)
178 g_free(colorf->filter_text);
179 if (colorf->c_colorfilter != NULL)
180 dfilter_free(colorf->c_colorfilter);
181 colorf->filter_text = g_strdup(tmpfilter);
182 colorf->c_colorfilter = compiled_filter;
183 colorf->disabled = ((i!=filt_nr) ? TRUE : disabled);
184 /* Remember that there are now temporary coloring filters set */
186 tmp_colors_set = TRUE;
194 const color_filter_t *
195 color_filters_tmp_color(guint8 filter_num) {
197 color_filter_t *colorf = NULL;
200 name = g_strdup_printf("%s%02d", CONVERSATION_COLOR_PREFIX, filter_num);
201 cfl = g_slist_find_custom(color_filter_list, name, color_filters_find_by_name_cb);
203 colorf = (color_filter_t *)cfl->data;
210 /* Reset the temporary colorfilters */
212 color_filters_reset_tmp(gchar **err_msg)
216 for ( i=1 ; i<=10 ; i++ ) {
217 if (!color_filters_set_tmp(i, NULL, TRUE, err_msg))
220 /* Remember that there are now *no* temporary coloring filters set */
221 tmp_colors_set = FALSE;
225 /* delete the specified filter */
227 color_filter_delete(color_filter_t *colorf)
229 if (colorf->filter_name != NULL)
230 g_free(colorf->filter_name);
231 if (colorf->filter_text != NULL)
232 g_free(colorf->filter_text);
233 if (colorf->c_colorfilter != NULL)
234 dfilter_free(colorf->c_colorfilter);
238 /* delete the specified filter (called from g_slist_foreach) */
240 color_filter_delete_cb(gpointer filter_arg, gpointer unused _U_)
242 color_filter_t *colorf = (color_filter_t *)filter_arg;
244 color_filter_delete(colorf);
247 /* delete the specified list */
249 color_filter_list_delete(GSList **cfl)
251 g_slist_foreach(*cfl, color_filter_delete_cb, NULL);
256 /* clone a single list entries from normal to edit list */
257 static color_filter_t *
258 color_filter_clone(color_filter_t *colorf)
260 color_filter_t *new_colorf;
262 new_colorf = (color_filter_t *)g_malloc(sizeof (color_filter_t));
263 new_colorf->filter_name = g_strdup(colorf->filter_name);
264 new_colorf->filter_text = g_strdup(colorf->filter_text);
265 new_colorf->bg_color = colorf->bg_color;
266 new_colorf->fg_color = colorf->fg_color;
267 new_colorf->disabled = colorf->disabled;
268 new_colorf->c_colorfilter = NULL;
269 new_colorf->color_edit_dlg_info = NULL;
270 new_colorf->selected = FALSE;
276 color_filter_list_clone_cb(gpointer filter_arg, gpointer cfl_arg)
278 GSList **cfl = (GSList **)cfl_arg;
279 color_filter_t *new_colorf;
281 new_colorf = color_filter_clone((color_filter_t *)filter_arg);
282 *cfl = g_slist_append(*cfl, new_colorf);
285 /* clone the specified list */
287 color_filter_list_clone(GSList *cfl)
289 GSList *new_list = NULL;
291 g_slist_foreach(cfl, color_filter_list_clone_cb, &new_list);
296 /* Initialize the filter structures (reading from file) for general running, including app startup */
298 color_filters_init(gchar** err_msg, color_filter_add_cb_func add_cb)
300 /* delete all currently existing filters */
301 color_filter_list_delete(&color_filter_list);
303 /* start the list with the temporary colorizing rules */
304 color_filters_add_tmp(&color_filter_list);
306 /* try to read the users filters */
307 if (!read_users_filters(&color_filter_list, err_msg, add_cb)) {
308 gchar* local_err_msg = NULL;
310 /* if that failed, try to read the global filters */
311 if (!color_filters_read_globals(&color_filter_list, &local_err_msg, add_cb)) {
312 /* Show the first error */
313 g_free(local_err_msg);
316 return (*err_msg == NULL);
323 color_filters_reload(gchar** err_msg, color_filter_add_cb_func add_cb)
325 /* "move" old entries to the deleted list
326 * we must keep them until the dissection no longer needs them */
327 color_filter_deleted_list = g_slist_concat(color_filter_deleted_list, color_filter_list);
328 color_filter_list = NULL;
330 /* start the list with the temporary colorizing rules */
331 color_filters_add_tmp(&color_filter_list);
333 /* try to read the users filters */
334 if (!read_users_filters(&color_filter_list, err_msg, add_cb)) {
335 gchar* local_err_msg = NULL;
337 /* if that failed, try to read the global filters */
338 if (!color_filters_read_globals(&color_filter_list, &local_err_msg, add_cb)) {
339 /* Show the first error */
340 g_free(local_err_msg);
343 return (*err_msg == NULL);
349 color_filters_cleanup(void)
351 /* delete the previously deleted filters */
352 color_filter_list_delete(&color_filter_deleted_list);
355 typedef struct _color_clone
358 color_filter_add_cb_func add_cb;
362 color_filters_clone_cb(gpointer filter_arg, gpointer user_data)
364 color_clone_t* clone_data = (color_clone_t*)user_data;
365 color_filter_t * new_colorf = color_filter_clone((color_filter_t *)filter_arg);
367 clone_data->add_cb (new_colorf, clone_data->user_data);
371 color_filters_clone(gpointer user_data, color_filter_add_cb_func add_cb)
373 color_clone_t clone_data;
375 clone_data.user_data = user_data;
376 clone_data.add_cb = add_cb;
377 g_slist_foreach(color_filter_list, color_filters_clone_cb, &clone_data);
382 color_filter_compile_cb(gpointer filter_arg, gpointer err)
384 color_filter_t *colorf = (color_filter_t *)filter_arg;
385 gchar **err_msg = (gchar**)err;
386 gchar *local_err_msg = NULL;
388 g_assert(colorf->c_colorfilter == NULL);
390 /* If the filter is disabled it doesn't matter if it compiles or not. */
391 if (colorf->disabled) return;
393 if (!dfilter_compile(colorf->filter_text, &colorf->c_colorfilter, &local_err_msg)) {
394 *err_msg = g_strdup_printf("Could not compile color filter name: \"%s\" text: \"%s\".\n%s",
395 colorf->filter_name, colorf->filter_text, local_err_msg);
396 g_free(local_err_msg);
397 /* this filter was compilable before, so this should never happen */
398 /* except if the OK button of the parent window has been clicked */
399 /* so don't use g_assert_not_reached() but check the filters again */
404 color_filter_validate_cb(gpointer filter_arg, gpointer err)
406 color_filter_t *colorf = (color_filter_t *)filter_arg;
407 gchar **err_msg = (gchar**)err;
408 gchar *local_err_msg;
410 g_assert(colorf->c_colorfilter == NULL);
412 /* If the filter is disabled it doesn't matter if it compiles or not. */
413 if (colorf->disabled) return;
415 if (!dfilter_compile(colorf->filter_text, &colorf->c_colorfilter, &local_err_msg)) {
416 *err_msg = g_strdup_printf("Removing color filter name: \"%s\" text: \"%s\".\n%s",
417 colorf->filter_name, colorf->filter_text, local_err_msg);
418 g_free(local_err_msg);
419 /* Delete the color filter from the list of color filters. */
420 color_filter_valid_list = g_slist_remove(color_filter_valid_list, colorf);
421 color_filter_delete(colorf);
425 /* apply changes from the edit list */
427 color_filters_apply(GSList *tmp_cfl, GSList *edit_cfl, gchar** err_msg)
433 /* "move" old entries to the deleted list
434 * we must keep them until the dissection no longer needs them */
435 color_filter_deleted_list = g_slist_concat(color_filter_deleted_list, color_filter_list);
436 color_filter_list = NULL;
438 /* clone all list entries from tmp/edit to normal list */
439 color_filter_valid_list = NULL;
440 color_filter_valid_list = color_filter_list_clone(tmp_cfl);
441 color_filter_valid_list = g_slist_concat(color_filter_valid_list,
442 color_filter_list_clone(edit_cfl) );
444 /* compile all filter */
445 g_slist_foreach(color_filter_valid_list, color_filter_validate_cb, err_msg);
446 if (*err_msg != NULL) {
450 /* clone all list entries from tmp/edit to normal list */
451 color_filter_list = color_filter_list_clone(color_filter_valid_list);
453 /* compile all filter */
454 g_slist_foreach(color_filter_list, color_filter_compile_cb, err_msg);
455 if (*err_msg != NULL) {
463 color_filters_used(void)
465 return color_filter_list != NULL && filters_enabled;
469 tmp_color_filters_used(void)
471 return tmp_colors_set;
474 /* prepare the epan_dissect_t for the filter */
476 prime_edt(gpointer data, gpointer user_data)
478 color_filter_t *colorf = (color_filter_t *)data;
479 epan_dissect_t *edt = (epan_dissect_t *)user_data;
481 if (colorf->c_colorfilter != NULL)
482 epan_dissect_prime_dfilter(edt, colorf->c_colorfilter);
485 /* Prime the epan_dissect_t with all the compiler
486 * color filters in 'color_filter_list'. */
488 color_filters_prime_edt(epan_dissect_t *edt)
490 if (color_filters_used())
491 g_slist_foreach(color_filter_list, prime_edt, edt);
494 /* * Return the color_t for later use */
495 const color_filter_t *
496 color_filters_colorize_packet(epan_dissect_t *edt)
499 color_filter_t *colorf;
501 /* If we have color filters, "search" for the matching one. */
502 if ((edt->tree != NULL) && (color_filters_used())) {
503 curr = color_filter_list;
505 while(curr != NULL) {
506 colorf = (color_filter_t *)curr->data;
507 if ( (!colorf->disabled) &&
508 (colorf->c_colorfilter != NULL) &&
509 dfilter_apply_edt(colorf->c_colorfilter, edt)) {
512 curr = g_slist_next(curr);
519 /* read filters from the given file */
520 /* XXX - Would it make more sense to use GStrings here instead of reallocing
523 read_filters_file(const gchar *path, FILE *f, gpointer user_data, color_filter_add_cb_func add_cb)
525 #define INIT_BUF_SIZE 128
527 gchar *filter_exp = NULL;
528 guint32 name_len = INIT_BUF_SIZE;
529 guint32 filter_exp_len = INIT_BUF_SIZE;
532 guint16 fg_r, fg_g, fg_b, bg_r, bg_g, bg_b;
533 gboolean disabled = FALSE;
534 gboolean skip_end_of_line = FALSE;
537 name = (gchar *)g_malloc(name_len + 1);
538 filter_exp = (gchar *)g_malloc(filter_exp_len + 1);
542 if (skip_end_of_line) {
544 c = ws_getc_unlocked(f);
545 } while (c != EOF && c != '\n');
549 skip_end_of_line = FALSE;
552 while ((c = ws_getc_unlocked(f)) != EOF && g_ascii_isspace(c)) {
566 /* skip # comments and invalid lines */
568 skip_end_of_line = TRUE;
572 /* we get the @ delimiter.
574 * @name@filter expression@[background r,g,b][foreground r,g,b]
580 c = ws_getc_unlocked(f);
581 if (c == EOF || c == '@')
584 /* buffer isn't long enough; double its length.*/
586 name = (gchar *)g_realloc(name, name_len + 1);
595 skip_end_of_line = TRUE;
599 /* retrieve filter expression */
602 c = ws_getc_unlocked(f);
603 if (c == EOF || c == '@')
605 if (i >= filter_exp_len) {
606 /* buffer isn't long enough; double its length.*/
608 filter_exp = (gchar *)g_realloc(filter_exp, filter_exp_len + 1);
612 filter_exp[i] = '\0';
617 skip_end_of_line = TRUE;
621 /* retrieve background and foreground colors */
622 if (fscanf(f,"[%hu,%hu,%hu][%hu,%hu,%hu]",
623 &bg_r, &bg_g, &bg_b, &fg_r, &fg_g, &fg_b) == 6) {
625 /* we got a complete color filter */
627 color_t bg_color, fg_color;
628 color_filter_t *colorf;
629 dfilter_t *temp_dfilter = NULL;
630 gchar *local_err_msg = NULL;
632 if (!disabled && !dfilter_compile(filter_exp, &temp_dfilter, &local_err_msg)) {
633 ws_g_warning("Could not compile \"%s\" in colorfilters file \"%s\".\n%s",
634 name, path, local_err_msg);
635 g_free(local_err_msg);
636 prefs.unknown_colorfilters = TRUE;
638 /* skip_end_of_line = TRUE; */
643 fg_color.green = fg_g;
644 fg_color.blue = fg_b;
647 bg_color.green = bg_g;
648 bg_color.blue = bg_b;
650 colorf = color_filter_new(name, filter_exp, &bg_color,
651 &fg_color, disabled);
652 if(user_data == &color_filter_list) {
653 GSList **cfl = (GSList **)user_data;
656 colorf->c_colorfilter = temp_dfilter;
657 *cfl = g_slist_append(*cfl, colorf);
660 /* just editing, don't need the compiled filter */
661 dfilter_free(temp_dfilter);
662 add_cb(colorf, user_data);
666 skip_end_of_line = TRUE;
677 /* read filters from the user's filter file */
679 read_users_filters(GSList **cfl, gchar** err_msg, color_filter_add_cb_func add_cb)
685 /* decide what file to open (from dfilter code) */
686 path = get_persconffile_path("colorfilters", TRUE);
687 if ((f = ws_fopen(path, "r")) == NULL) {
688 if (errno != ENOENT) {
689 *err_msg = g_strdup_printf("Could not open filter file\n\"%s\": %s.", path,
696 ret = read_filters_file(path, f, cfl, add_cb);
698 *err_msg = g_strdup_printf("Error reading filter file\n\"%s\": %s.",
699 path, g_strerror(errno));
710 /* read filters from the filter file */
712 color_filters_read_globals(gpointer user_data, gchar** err_msg, color_filter_add_cb_func add_cb)
718 /* decide what file to open (from dfilter code) */
719 path = get_datafile_path("colorfilters");
720 if ((f = ws_fopen(path, "r")) == NULL) {
721 if (errno != ENOENT) {
722 *err_msg = g_strdup_printf("Could not open global filter file\n\"%s\": %s.", path,
729 ret = read_filters_file(path, f, user_data, add_cb);
731 *err_msg = g_strdup_printf("Error reading global filter file\n\"%s\": %s.",
732 path, g_strerror(errno));
743 /* read filters from some other filter file (import) */
745 color_filters_import(const gchar *path, gpointer user_data, gchar **err_msg, color_filter_add_cb_func add_cb)
750 if ((f = ws_fopen(path, "r")) == NULL) {
751 *err_msg = g_strdup_printf("Could not open filter file\n%s\nfor reading: %s.",
752 path, g_strerror(errno));
756 ret = read_filters_file(path, f, user_data, add_cb);
758 *err_msg = g_strdup_printf("Error reading filter file\n\"%s\": %s.",
759 path, g_strerror(errno));
768 struct write_filter_data
771 gboolean only_selected;
774 /* save a single filter */
776 write_filter(gpointer filter_arg, gpointer data_arg)
778 struct write_filter_data *data = (struct write_filter_data *)data_arg;
779 color_filter_t *colorf = (color_filter_t *)filter_arg;
782 if ( (colorf->selected || !data->only_selected) &&
783 (strstr(colorf->filter_name,CONVERSATION_COLOR_PREFIX)==NULL) ) {
784 fprintf(f,"%s@%s@%s@[%u,%u,%u][%u,%u,%u]\n",
785 colorf->disabled ? "!" : "",
788 colorf->bg_color.red,
789 colorf->bg_color.green,
790 colorf->bg_color.blue,
791 colorf->fg_color.red,
792 colorf->fg_color.green,
793 colorf->fg_color.blue);
797 /* save filters in a filter file */
799 write_filters_file(GSList *cfl, FILE *f, gboolean only_selected)
801 struct write_filter_data data;
804 data.only_selected = only_selected;
806 fprintf(f,"# DO NOT EDIT THIS FILE! It was created by Wireshark\n");
807 g_slist_foreach(cfl, write_filter, &data);
811 /* save filters in users filter file */
813 color_filters_write(GSList *cfl, gchar** err_msg)
819 /* Create the directory that holds personal configuration files,
821 if (create_persconffile_dir(&pf_dir_path) == -1) {
822 *err_msg = g_strdup_printf("Can't create directory\n\"%s\"\nfor color files: %s.",
823 pf_dir_path, g_strerror(errno));
828 path = get_persconffile_path("colorfilters", TRUE);
829 if ((f = ws_fopen(path, "w+")) == NULL) {
830 *err_msg = g_strdup_printf("Could not open\n%s\nfor writing: %s.",
831 path, g_strerror(errno));
836 write_filters_file(cfl, f, FALSE);
841 /* save filters in some other filter file (export) */
843 color_filters_export(const gchar *path, GSList *cfl, gboolean only_marked, gchar** err_msg)
847 if ((f = ws_fopen(path, "w+")) == NULL) {
848 *err_msg = g_strdup_printf("Could not open\n%s\nfor writing: %s.",
849 path, g_strerror(errno));
852 write_filters_file(cfl, f, only_marked);
858 * Editor modelines - http://www.wireshark.org/tools/modelines.html
863 * indent-tabs-mode: nil
866 * vi: set shiftwidth=4 tabstop=8 expandtab:
867 * :indentSize=4:tabSize=8:noTabs=true: