Give the code that computes protocol statistics a progress dialog box,
[obnox/wireshark/wip.git] / prefs.c
1 /* prefs.c
2  * Routines for handling preferences
3  *
4  * $Id: prefs.c,v 1.47 2001/01/05 22:45:26 guy Exp $
5  *
6  * Ethereal - Network traffic analyzer
7  * By Gerald Combs <gerald@zing.org>
8  * Copyright 1998 Gerald Combs
9  *
10  * 
11  * This program is free software; you can redistribute it and/or
12  * modify it under the terms of the GNU General Public License
13  * as published by the Free Software Foundation; either version 2
14  * of the License, or (at your option) any later version.
15  * 
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  * 
21  * You should have received a copy of the GNU General Public License
22  * along with this program; if not, write to the Free Software
23  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
24  */
25
26 #ifdef HAVE_CONFIG_H
27 # include "config.h"
28 #endif
29
30 #ifdef HAVE_SYS_TYPES_H
31 #include <sys/types.h>
32 #endif
33
34 #ifdef HAVE_DIRECT_H
35 #include <direct.h>
36 #endif
37
38 #include <stdlib.h>
39 #include <string.h>
40 #include <ctype.h>
41 #include <errno.h>
42
43 #ifdef HAVE_UNISTD_H
44 #include <unistd.h>
45 #endif
46
47 #ifdef HAVE_SYS_STAT_H
48 #include <sys/stat.h>
49 #endif
50
51 #include <epan.h>
52 #include "globals.h"
53 #include "packet.h"
54 #include "file.h"
55 #include "prefs.h"
56 #include "proto.h"
57 #include "column.h"
58 #include "print.h"
59 #include "util.h"
60
61 #include "prefs-int.h"
62
63 /* Internal functions */
64 static int    set_pref(gchar*, gchar*);
65 static GList *get_string_list(gchar *);
66 static void   clear_string_list(GList *);
67 static void   free_col_info(e_prefs *);
68
69 #define PF_NAME "preferences"
70
71 #define GPF_PATH        DATAFILE_DIR "/ethereal.conf"
72
73 static gboolean init_prefs = TRUE;
74 static gchar *pf_path = NULL;
75
76 /*
77  * XXX - variables to allow us to attempt to interpret the first
78  * "mgcp.{tcp,udp}.port" in a preferences file as
79  * "mgcp.{tcp,udp}.gateway_port" and the second as
80  * "mgcp.{tcp,udp}.callagent_port".
81  */
82 static int mgcp_tcp_port_count;
83 static int mgcp_udp_port_count;
84
85 e_prefs prefs;
86
87 gchar   *gui_ptree_line_style_text[] =
88         { "NONE", "SOLID", "DOTTED", "TABBED", NULL };
89
90 gchar   *gui_ptree_expander_style_text[] =
91         { "NONE", "SQUARE", "TRIANGLE", "CIRCULAR", NULL };
92
93 gchar   *gui_hex_dump_highlight_style_text[] =
94         { "BOLD", "INVERSE", NULL };
95
96 /*
97  * List of modules with preference settings.
98  */
99 static GList *modules;
100
101 /*
102  * Register a module that will have preferences.
103  * Specify the name used for the module in the preferences file, the
104  * title used in the tab for it in a preferences dialog box, and a
105  * routine to call back when we apply the preferences.
106  */
107 module_t *
108 prefs_register_module(const char *name, const char *title,
109     void (*apply_cb)(void))
110 {
111         module_t *module;
112
113         module = g_malloc(sizeof (module_t));
114         module->name = name;
115         module->title = title;
116         module->apply_cb = apply_cb;
117         module->prefs = NULL;   /* no preferences, to start */
118         module->numprefs = 0;
119         module->prefs_changed = FALSE;
120
121         modules = g_list_append(modules, module);
122
123         return module;
124 }
125
126 /*
127  * Register that a protocol has preferences.
128  */
129 module_t *
130 prefs_register_protocol(int id, void (*apply_cb)(void))
131 {
132         return prefs_register_module(proto_get_protocol_filter_name(id),
133                                      proto_get_protocol_short_name(id),
134                                      apply_cb);
135 }
136
137 /*
138  * Find a module, given its name.
139  */
140 static gint
141 module_match(gconstpointer a, gconstpointer b)
142 {
143         const module_t *module = a;
144         const char *name = b;
145
146         return strcmp(name, module->name);
147 }
148
149 static module_t *
150 find_module(char *name)
151 {
152         GList *list_entry;
153
154         list_entry = g_list_find_custom(modules, name, module_match);
155         if (list_entry == NULL)
156                 return NULL;    /* no such module */
157         return (module_t *) list_entry->data;
158 }
159
160 typedef struct {
161         module_cb callback;
162         gpointer user_data;
163 } module_cb_arg_t;
164
165 static void
166 do_module_callback(gpointer data, gpointer user_data)
167 {
168         module_t *module = data;
169         module_cb_arg_t *arg = user_data;
170
171         (*arg->callback)(module, arg->user_data);
172 }
173
174 /*
175  * Call a callback function, with a specified argument, for each module.
176  */
177 void
178 prefs_module_foreach(module_cb callback, gpointer user_data)
179 {
180         module_cb_arg_t arg;
181
182         arg.callback = callback;
183         arg.user_data = user_data;
184         g_list_foreach(modules, do_module_callback, &arg);
185 }
186
187 static void
188 call_apply_cb(gpointer data, gpointer user_data)
189 {
190         module_t *module = data;
191
192         if (module->prefs_changed) {
193                 if (module->apply_cb != NULL)
194                         (*module->apply_cb)();
195                 module->prefs_changed = FALSE;
196         }
197 }
198
199 /*
200  * Call the "apply" callback function for each module if any of its
201  * preferences have changed, and then clear the flag saying its
202  * preferences have changed, as the module has been notified of that
203  * fact.
204  */
205 void
206 prefs_apply_all(void)
207 {
208         g_list_foreach(modules, call_apply_cb, NULL);
209 }
210
211 /*
212  * Register a preference in a module's list of preferences.
213  */
214 static pref_t *
215 register_preference(module_t *module, const char *name, const char *title,
216     const char *description)
217 {
218         pref_t *preference;
219
220         preference = g_malloc(sizeof (pref_t));
221         preference->name = name;
222         preference->title = title;
223         preference->description = description;
224         preference->ordinal = module->numprefs;
225
226         module->prefs = g_list_append(module->prefs, preference);
227         module->numprefs++;
228
229         return preference;
230 }
231
232 /*
233  * Find a preference in a module's list of preferences, given the module
234  * and the preference's name.
235  */
236 static gint
237 preference_match(gconstpointer a, gconstpointer b)
238 {
239         const pref_t *pref = a;
240         const char *name = b;
241
242         return strcmp(name, pref->name);
243 }
244
245 static struct preference *
246 find_preference(module_t *module, char *name)
247 {
248         GList *list_entry;
249
250         list_entry = g_list_find_custom(module->prefs, name, preference_match);
251         if (list_entry == NULL)
252                 return NULL;    /* no such preference */
253         return (struct preference *) list_entry->data;
254 }
255
256 /*
257  * Returns TRUE if the given protocol has registered preferences
258  */
259 gboolean
260 prefs_is_registered_protocol(char *name)
261 {
262         return (find_module(name) != NULL);
263 }
264
265 /*
266  * Returns the module title of a registered protocol
267  */
268 const char *
269 prefs_get_title_by_name(char *name)
270 {
271         module_t *m = find_module(name);
272         return  (m) ? m->title : NULL;
273 }
274
275 /*
276  * Register a preference with an unsigned integral value.
277  */
278 void
279 prefs_register_uint_preference(module_t *module, const char *name,
280     const char *title, const char *description, guint base, guint *var)
281 {
282         pref_t *preference;
283
284         preference = register_preference(module, name, title, description);
285         preference->type = PREF_UINT;
286         preference->varp.uint = var;
287         preference->info.base = base;
288 }
289
290 /*
291  * Register a preference with an Boolean value.
292  */
293 void
294 prefs_register_bool_preference(module_t *module, const char *name,
295     const char *title, const char *description, gboolean *var)
296 {
297         pref_t *preference;
298
299         preference = register_preference(module, name, title, description);
300         preference->type = PREF_BOOL;
301         preference->varp.bool = var;
302 }
303
304 /*
305  * Register a preference with an enumerated value.
306  */
307 void
308 prefs_register_enum_preference(module_t *module, const char *name,
309     const char *title, const char *description, gint *var,
310     const enum_val_t *enumvals, gboolean radio_buttons)
311 {
312         pref_t *preference;
313
314         preference = register_preference(module, name, title, description);
315         preference->type = PREF_ENUM;
316         preference->varp.enump = var;
317         preference->info.enum_info.enumvals = enumvals;
318         preference->info.enum_info.radio_buttons = radio_buttons;
319 }
320
321 /*
322  * Register a preference with a character-string value.
323  */
324 void
325 prefs_register_string_preference(module_t *module, const char *name,
326     const char *title, const char *description, char **var)
327 {
328         pref_t *preference;
329
330         preference = register_preference(module, name, title, description);
331         preference->type = PREF_STRING;
332         preference->varp.string = var;
333         preference->saved_val.string = NULL;
334 }
335
336 typedef struct {
337         pref_cb callback;
338         gpointer user_data;
339 } pref_cb_arg_t;
340
341 static void
342 do_pref_callback(gpointer data, gpointer user_data)
343 {
344         pref_t *pref = data;
345         pref_cb_arg_t *arg = user_data;
346
347         (*arg->callback)(pref, arg->user_data);
348 }
349
350 /*
351  * Call a callback function, with a specified argument, for each preference
352  * in a given module.
353  */
354 void
355 prefs_pref_foreach(module_t *module, pref_cb callback, gpointer user_data)
356 {
357         pref_cb_arg_t arg;
358
359         arg.callback = callback;
360         arg.user_data = user_data;
361         g_list_foreach(module->prefs, do_pref_callback, &arg);
362 }
363
364 /*
365  * Register all non-dissector modules' preferences.
366  */
367 void
368 prefs_register_modules(void)
369 {
370 }
371
372 /* Parse through a list of comma-separated, quoted strings.  Return a
373    list of the string data */
374 static GList *
375 get_string_list(gchar *str) {
376   enum { PRE_QUOT, IN_QUOT, POST_QUOT };
377
378   gint      state = PRE_QUOT, i = 0, j = 0;
379   gboolean  backslash = FALSE;
380   gchar     cur_c, *slstr = NULL;
381   GList    *sl = NULL;
382   
383   while ((cur_c = str[i]) != '\0') {
384     if (cur_c == '"' && ! backslash) {
385       switch (state) {
386         case PRE_QUOT:
387           state = IN_QUOT;
388           slstr = (gchar *) g_malloc(sizeof(gchar) * COL_MAX_LEN);
389           j = 0;
390           break;
391         case IN_QUOT:
392           state  = POST_QUOT;
393           slstr[j] = '\0';
394           sl = g_list_append(sl, slstr);
395           break;
396         case POST_QUOT:
397           clear_string_list(sl);
398           return NULL;
399           break;
400         default:
401           break;
402       }
403     } else if (cur_c == '\\' && ! backslash) {
404       backslash = TRUE;
405     } else if (cur_c == ',' && state == POST_QUOT) {
406       state = PRE_QUOT;
407     } else if (state == IN_QUOT && j < COL_MAX_LEN) {
408       slstr[j] = str[i];
409       j++;
410     }
411     i++;
412   }
413   if (state != POST_QUOT) {
414     clear_string_list(sl);
415   }
416   return(sl);
417 }
418
419 void
420 clear_string_list(GList *sl) {
421   GList *l = sl;
422   
423   while (l) {
424     g_free(l->data);
425     l = g_list_remove_link(l, l);
426   }
427 }
428
429 /*
430  * Takes a string, a pointer to an array of "enum_val_t"s, and a default gint
431  * value.
432  * The array must be terminated by an entry with a null "name" string.
433  * If the string matches a "name" strings in an entry, the value from that
434  * entry is returned. Otherwise, the default value that was passed as the
435  * third argument is returned.
436  */
437 gint
438 find_val_for_string(const char *needle, const enum_val_t *haystack,
439     gint default_value)
440 {
441         int i = 0;
442
443         while (haystack[i].name != NULL) {
444                 if (strcasecmp(needle, haystack[i].name) == 0) {
445                         return haystack[i].value;
446                 }
447                 i++;    
448         }
449         return default_value;
450 }
451
452 /* Takes an string and a pointer to an array of strings, and a default int value.
453  * The array must be terminated by a NULL string. If the string is found in the array
454  * of strings, the index of that string in the array is returned. Otherwise, the
455  * default value that was passed as the third argument is returned.
456  */
457 static int
458 find_index_from_string_array(char *needle, char **haystack, int default_value)
459 {
460         int i = 0;
461
462         while (haystack[i] != NULL) {
463                 if (strcmp(needle, haystack[i]) == 0) {
464                         return i;
465                 }
466                 i++;    
467         }
468         return default_value;
469 }
470
471 /* Preferences file format:
472  * - Configuration directives start at the beginning of the line, and 
473  *   are terminated with a colon.
474  * - Directives can be continued on the next line by preceding them with
475  *   whitespace.
476  *
477  * Example:
478
479 # This is a comment line
480 print.command: lpr
481 print.file: /a/very/long/path/
482         to/ethereal-out.ps
483  *
484  */
485
486 #define MAX_VAR_LEN    48
487 #define MAX_VAL_LEN  1024
488
489 #define DEF_NUM_COLS    6
490
491 static void read_prefs_file(const char *pf_path, FILE *pf);
492
493 /* Read the preferences file, fill in "prefs", and return a pointer to it.
494
495    If we got an error (other than "it doesn't exist") trying to read
496    the global preferences file, stuff the errno into "*gpf_errno_return"
497    and a pointer to the path of the file into "*gpf_path_return", and
498    return NULL.
499
500    If we got an error (other than "it doesn't exist") trying to read
501    the user's preferences file, stuff the errno into "*pf_errno_return"
502    and a pointer to the path of the file into "*pf_path_return", and
503    return NULL. */
504 e_prefs *
505 read_prefs(int *gpf_errno_return, char **gpf_path_return,
506            int *pf_errno_return, char **pf_path_return)
507 {
508   int       i;
509   FILE     *pf;
510   fmt_data *cfmt;
511   gchar    *col_fmt[] = {"No.",      "%m", "Time",        "%t",
512                          "Source",   "%s", "Destination", "%d",
513                          "Protocol", "%p", "Info",        "%i"};
514
515   
516   if (init_prefs) {
517     /* Initialize preferences to wired-in default values.
518        They may be overridded by the global preferences file or the
519        user's preferences file. */
520     init_prefs       = FALSE;
521     prefs.pr_format  = PR_FMT_TEXT;
522     prefs.pr_dest    = PR_DEST_CMD;
523     prefs.pr_file    = g_strdup("ethereal.out");
524     prefs.pr_cmd     = g_strdup("lpr");
525     prefs.col_list = NULL;
526     for (i = 0; i < DEF_NUM_COLS; i++) {
527       cfmt = (fmt_data *) g_malloc(sizeof(fmt_data));
528       cfmt->title = g_strdup(col_fmt[i * 2]);
529       cfmt->fmt   = g_strdup(col_fmt[(i * 2) + 1]);
530       prefs.col_list = g_list_append(prefs.col_list, cfmt);
531     }
532     prefs.num_cols  = DEF_NUM_COLS;
533     prefs.st_client_fg.pixel =     0;
534     prefs.st_client_fg.red   = 32767;
535     prefs.st_client_fg.green =     0;
536     prefs.st_client_fg.blue  =     0;
537     prefs.st_client_bg.pixel = 65535;
538     prefs.st_client_bg.red   = 65535;
539     prefs.st_client_bg.green = 65535;
540     prefs.st_client_bg.blue  = 65535;
541     prefs.st_server_fg.pixel =     0;
542     prefs.st_server_fg.red   =     0;
543     prefs.st_server_fg.green =     0;
544     prefs.st_server_fg.blue  = 32767;
545     prefs.st_server_bg.pixel = 65535;
546     prefs.st_server_bg.red   = 65535;
547     prefs.st_server_bg.green = 65535;
548     prefs.st_server_bg.blue  = 65535;
549     prefs.gui_scrollbar_on_right = TRUE;
550     prefs.gui_plist_sel_browse = FALSE;
551     prefs.gui_ptree_sel_browse = FALSE;
552     prefs.gui_ptree_line_style = 0;
553     prefs.gui_ptree_expander_style = 1;
554     prefs.gui_hex_dump_highlight_style = 1;
555 #ifdef WIN32
556     prefs.gui_font_name = g_strdup("-*-lucida console-medium-r-*-*-*-100-*-*-*-*-*-*");
557 #else
558     /*
559      * XXX - for now, we make the initial font name a pattern that matches
560      * only ISO 8859/1 fonts, so that we don't match 2-byte fonts such
561      * as ISO 10646 fonts.
562      *
563      * Users in locales using other one-byte fonts will have to choose
564      * a different font from the preferences dialog - or put the font
565      * selection in the global preferences file to make that font the
566      * default for all users who don't explicitly specify a different
567      * font.
568      *
569      * Making this a font set rather than a font has two problems:
570      *
571      *  1) as far as I know, you can't select font sets with the
572      *     font selection dialog;
573      *
574      *  2) if you use a font set, the text to be drawn must be a
575      *     multi-byte string in the appropriate locale, but
576      *     Ethereal does *NOT* guarantee that's the case - in
577      *     the hex-dump window, each character in the text portion
578      *     of the display must be a *single* byte, and in the
579      *     packet-list and protocol-tree windows, text extracted
580      *     from the packet is not necessarily in the right format.
581      *
582      * "Doing this right" may, for the packet-list and protocol-tree
583      * windows, require that dissectors know what the locale is
584      * *AND* know what locale and text representation is used in
585      * the packets they're dissecting, and may be impossible in
586      * the hex-dump window (except by punting and displaying only
587      * ASCII characters).
588      *
589      * GTK+ 2.0 may simplify part of the problem, as it will, as I
590      * understand it, use UTF-8-encoded Unicode as its internal
591      * character set; however, we'd still have to know whatever
592      * character set and encoding is used in the packet (which
593      * may differ for different protocols, e.g. SMB might use
594      * PC code pages for some strings and Unicode for others, whilst
595      * NFS might use some UNIX character set encoding, e.g. ISO 8859/x,
596      * or one of the EUC character sets for Asian languages, or one
597      * of the other multi-byte character sets, or UTF-8, or...).
598      *
599      * I.e., as far as I can tell, "internationalizing" the packet-list,
600      * protocol-tree, and hex-dump windows involves a lot more than, say,
601      * just using font sets rather than fonts.
602      */
603     prefs.gui_font_name = g_strdup("-*-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-1");
604 #endif
605     prefs.gui_marked_fg.pixel = 65535;
606     prefs.gui_marked_fg.red   = 65535;
607     prefs.gui_marked_fg.green = 65535;
608     prefs.gui_marked_fg.blue  = 65535;
609     prefs.gui_marked_bg.pixel =     0;
610     prefs.gui_marked_bg.red   =     0;
611     prefs.gui_marked_bg.green =     0;
612     prefs.gui_marked_bg.blue  =     0;
613
614   }
615
616   /* Read the global preferences file, if it exists. */
617   *gpf_path_return = NULL;
618   if ((pf = fopen(GPF_PATH, "r")) != NULL) {
619     /* We succeeded in opening it; read it. */
620     read_prefs_file(GPF_PATH, pf);
621     fclose(pf);
622   } else {
623     /* We failed to open it.  If we failed for some reason other than
624        "it doesn't exist", return the errno and the pathname, so our
625        caller can report the error. */
626     if (errno != ENOENT) {
627       *gpf_errno_return = errno;
628       *gpf_path_return = GPF_PATH;
629     }
630   }
631
632   /* Construct the pathname of the user's preferences file. */
633   if (! pf_path) {
634     pf_path = (gchar *) g_malloc(strlen(get_home_dir()) + strlen(PF_DIR) +
635       strlen(PF_NAME) + 4);
636     sprintf(pf_path, "%s/%s/%s", get_home_dir(), PF_DIR, PF_NAME);
637   }
638     
639   /* Read the user's preferences file, if it exists. */
640   *pf_path_return = NULL;
641   if ((pf = fopen(pf_path, "r")) != NULL) {
642     /* We succeeded in opening it; read it. */
643     read_prefs_file(pf_path, pf);
644     fclose(pf);
645   } else {
646     /* We failed to open it.  If we failed for some reason other than
647        "it doesn't exist", return the errno and the pathname, so our
648        caller can report the error. */
649     if (errno != ENOENT) {
650       *pf_errno_return = errno;
651       *pf_path_return = pf_path;
652     }
653   }
654   
655   return &prefs;
656 }
657
658 static void
659 read_prefs_file(const char *pf_path, FILE *pf)
660 {
661   enum { START, IN_VAR, PRE_VAL, IN_VAL, IN_SKIP };
662   gchar     cur_var[MAX_VAR_LEN], cur_val[MAX_VAL_LEN];
663   int       got_c, state = START;
664   gboolean  got_val = FALSE;
665   gint      var_len = 0, val_len = 0, fline = 1, pline = 1;
666
667   /*
668    * Start out the counters of "mgcp.{tcp,udp}.port" entries we've
669    * seen.
670    */
671   mgcp_tcp_port_count = 0;
672   mgcp_udp_port_count = 0;
673
674   while ((got_c = getc(pf)) != EOF) {
675     if (got_c == '\n') {
676       state = START;
677       fline++;
678       continue;
679     }
680     if (var_len >= MAX_VAR_LEN) {
681       g_warning ("%s line %d: Variable too long", pf_path, fline);
682       state = IN_SKIP;
683       var_len = 0;
684       continue;
685     }
686     if (val_len >= MAX_VAL_LEN) {
687       g_warning ("%s line %d: Value too long", pf_path, fline);
688       state = IN_SKIP;
689       var_len = 0;
690       continue;
691     }
692     
693     switch (state) {
694       case START:
695         if (isalnum(got_c)) {
696           if (var_len > 0) {
697             if (got_val) {
698               cur_var[var_len] = '\0';
699               cur_val[val_len] = '\0';
700               switch (set_pref(cur_var, cur_val)) {
701
702               case PREFS_SET_SYNTAX_ERR:
703                 g_warning ("%s line %d: Syntax error", pf_path, pline);
704                 break;
705
706               case PREFS_SET_NO_SUCH_PREF:
707                 g_warning ("%s line %d: No such preference \"%s\"", pf_path,
708                                 pline, cur_var);
709                 break;
710               }
711             } else {
712               g_warning ("%s line %d: Incomplete preference", pf_path, pline);
713             }
714           }
715           state      = IN_VAR;
716           got_val    = FALSE;
717           cur_var[0] = got_c;
718           var_len    = 1;
719           pline = fline;
720         } else if (isspace(got_c) && var_len > 0 && got_val) {
721           state = PRE_VAL;
722         } else if (got_c == '#') {
723           state = IN_SKIP;
724         } else {
725           g_warning ("%s line %d: Malformed line", pf_path, fline);
726         }
727         break;
728       case IN_VAR:
729         if (got_c != ':') {
730           cur_var[var_len] = got_c;
731           var_len++;
732         } else {
733           state   = PRE_VAL;
734           val_len = 0;
735           got_val = TRUE;
736         }
737         break;
738       case PRE_VAL:
739         if (!isspace(got_c)) {
740           state = IN_VAL;
741           cur_val[val_len] = got_c;
742           val_len++;
743         }
744         break;
745       case IN_VAL:
746         if (got_c != '#')  {
747           cur_val[val_len] = got_c;
748           val_len++;
749         } else {
750           while (isspace((guchar)cur_val[val_len]) && val_len > 0)
751             val_len--;
752           state = IN_SKIP;
753         }
754         break;
755     }
756   }
757   if (var_len > 0) {
758     if (got_val) {
759       cur_var[var_len] = '\0';
760       cur_val[val_len] = '\0';
761       switch (set_pref(cur_var, cur_val)) {
762
763       case PREFS_SET_SYNTAX_ERR:
764         g_warning ("%s line %d: Syntax error", pf_path, pline);
765         break;
766
767       case PREFS_SET_NO_SUCH_PREF:
768         g_warning ("%s line %d: No such preference \"%s\"", pf_path,
769                         pline, cur_var);
770         break;
771       }
772     } else {
773       g_warning ("%s line %d: Incomplete preference", pf_path, pline);
774     }
775   }
776 }
777
778 /*
779  * Given a string of the form "<pref name>:<pref value>", as might appear
780  * as an argument to a "-o" option, parse it and set the preference in
781  * question.  Return an indication of whether it succeeded or failed
782  * in some fashion.
783  */
784 int
785 prefs_set_pref(char *prefarg)
786 {
787         u_char *p, *colonp;
788         int ret;
789
790         /*
791          * Set the counters of "mgcp.{tcp,udp}.port" entries we've
792          * seen to values that keep us from trying to interpret tham
793          * as "mgcp.{tcp,udp}.gateway_port" or "mgcp.{tcp,udp}.callagent_port",
794          * as, from the command line, we have no way of guessing which
795          * the user had in mind.
796          */
797         mgcp_tcp_port_count = -1;
798         mgcp_udp_port_count = -1;
799
800         colonp = strchr(prefarg, ':');
801         if (colonp == NULL)
802                 return PREFS_SET_SYNTAX_ERR;
803
804         p = colonp;
805         *p++ = '\0';
806
807         /*
808          * Skip over any white space (there probably won't be any, but
809          * as we allow it in the preferences file, we might as well
810          * allow it here).
811          */
812         while (isspace(*p))
813                 p++;
814         if (*p == '\0') {
815                 /*
816                  * Put the colon back, so if our caller uses, in an
817                  * error message, the string they passed us, the message
818                  * looks correct.
819                  */
820                 *colonp = ':';
821                 return PREFS_SET_SYNTAX_ERR;
822         }
823
824         ret = set_pref(prefarg, p);
825         *colonp = ':';  /* put the colon back */
826         return ret;
827 }
828
829 #define PRS_PRINT_FMT    "print.format"
830 #define PRS_PRINT_DEST   "print.destination"
831 #define PRS_PRINT_FILE   "print.file"
832 #define PRS_PRINT_CMD    "print.command"
833 #define PRS_COL_FMT      "column.format"
834 #define PRS_STREAM_CL_FG "stream.client.fg"
835 #define PRS_STREAM_CL_BG "stream.client.bg"
836 #define PRS_STREAM_SR_FG "stream.server.fg"
837 #define PRS_STREAM_SR_BG "stream.server.bg"
838 #define PRS_GUI_SCROLLBAR_ON_RIGHT "gui.scrollbar_on_right"
839 #define PRS_GUI_PLIST_SEL_BROWSE "gui.packet_list_sel_browse"
840 #define PRS_GUI_PTREE_SEL_BROWSE "gui.protocol_tree_sel_browse"
841 #define PRS_GUI_PTREE_LINE_STYLE "gui.protocol_tree_line_style"
842 #define PRS_GUI_PTREE_EXPANDER_STYLE "gui.protocol_tree_expander_style"
843 #define PRS_GUI_HEX_DUMP_HIGHLIGHT_STYLE "gui.hex_dump_highlight_style"
844 #define PRS_GUI_FONT_NAME "gui.font_name"
845 #define PRS_GUI_MARKED_FG "gui.marked_frame.fg"
846 #define PRS_GUI_MARKED_BG "gui.marked_frame.bg"
847
848 #define RED_COMPONENT(x)   ((((x) >> 16) & 0xff) * 65535 / 255)
849 #define GREEN_COMPONENT(x) ((((x) >>  8) & 0xff) * 65535 / 255)
850 #define BLUE_COMPONENT(x)   (((x)        & 0xff) * 65535 / 255)
851
852 static gchar *pr_formats[] = { "text", "postscript" };
853 static gchar *pr_dests[]   = { "command", "file" };
854
855 static int
856 set_pref(gchar *pref_name, gchar *value)
857 {
858   GList    *col_l;
859   gint      llen;
860   fmt_data *cfmt;
861   unsigned long int cval;
862   guint    uval;
863   gboolean bval;
864   gint     enum_val;
865   char     *p;
866   gchar    *dotp;
867   module_t *module;
868   pref_t   *pref;
869
870   if (strcmp(pref_name, PRS_PRINT_FMT) == 0) {
871     if (strcmp(value, pr_formats[PR_FMT_TEXT]) == 0) {
872       prefs.pr_format = PR_FMT_TEXT;
873     } else if (strcmp(value, pr_formats[PR_FMT_PS]) == 0) {
874       prefs.pr_format = PR_FMT_PS;
875     } else {
876       return PREFS_SET_SYNTAX_ERR;
877     }
878   } else if (strcmp(pref_name, PRS_PRINT_DEST) == 0) {
879     if (strcmp(value, pr_dests[PR_DEST_CMD]) == 0) {
880       prefs.pr_dest = PR_DEST_CMD;
881     } else if (strcmp(value, pr_dests[PR_DEST_FILE]) == 0) {
882       prefs.pr_dest = PR_DEST_FILE;
883     } else {
884       return PREFS_SET_SYNTAX_ERR;
885     }
886   } else if (strcmp(pref_name, PRS_PRINT_FILE) == 0) {
887     if (prefs.pr_file) g_free(prefs.pr_file);
888     prefs.pr_file = g_strdup(value);
889   } else if (strcmp(pref_name, PRS_PRINT_CMD) == 0) {
890     if (prefs.pr_cmd) g_free(prefs.pr_cmd);
891     prefs.pr_cmd = g_strdup(value);
892   } else if (strcmp(pref_name, PRS_COL_FMT) == 0) {
893     if ((col_l = get_string_list(value)) && (g_list_length(col_l) % 2) == 0) {
894       free_col_info(&prefs);
895       prefs.col_list = NULL;
896       llen             = g_list_length(col_l);
897       prefs.num_cols   = llen / 2;
898       col_l = g_list_first(col_l);
899       while(col_l) {
900         cfmt = (fmt_data *) g_malloc(sizeof(fmt_data));
901         cfmt->title    = g_strdup(col_l->data);
902         col_l          = col_l->next;
903         cfmt->fmt      = g_strdup(col_l->data);
904         col_l          = col_l->next;
905         prefs.col_list = g_list_append(prefs.col_list, cfmt);
906       }
907       /* To do: else print some sort of error? */
908     }
909     clear_string_list(col_l);
910   } else if (strcmp(pref_name, PRS_STREAM_CL_FG) == 0) {
911     cval = strtoul(value, NULL, 16);
912     prefs.st_client_fg.pixel = 0;
913     prefs.st_client_fg.red   = RED_COMPONENT(cval);
914     prefs.st_client_fg.green = GREEN_COMPONENT(cval);
915     prefs.st_client_fg.blue  = BLUE_COMPONENT(cval);
916   } else if (strcmp(pref_name, PRS_STREAM_CL_BG) == 0) {
917     cval = strtoul(value, NULL, 16);
918     prefs.st_client_bg.pixel = 0;
919     prefs.st_client_bg.red   = RED_COMPONENT(cval);
920     prefs.st_client_bg.green = GREEN_COMPONENT(cval);
921     prefs.st_client_bg.blue  = BLUE_COMPONENT(cval);
922   } else if (strcmp(pref_name, PRS_STREAM_SR_FG) == 0) {
923     cval = strtoul(value, NULL, 16);
924     prefs.st_server_fg.pixel = 0;
925     prefs.st_server_fg.red   = RED_COMPONENT(cval);
926     prefs.st_server_fg.green = GREEN_COMPONENT(cval);
927     prefs.st_server_fg.blue  = BLUE_COMPONENT(cval);
928   } else if (strcmp(pref_name, PRS_STREAM_SR_BG) == 0) {
929     cval = strtoul(value, NULL, 16);
930     prefs.st_server_bg.pixel = 0;
931     prefs.st_server_bg.red   = RED_COMPONENT(cval);
932     prefs.st_server_bg.green = GREEN_COMPONENT(cval);
933     prefs.st_server_bg.blue  = BLUE_COMPONENT(cval);
934   } else if (strcmp(pref_name, PRS_GUI_SCROLLBAR_ON_RIGHT) == 0) {
935     if (strcmp(value, "TRUE") == 0) {
936             prefs.gui_scrollbar_on_right = TRUE;
937     }
938     else {
939             prefs.gui_scrollbar_on_right = FALSE;
940     }
941   } else if (strcmp(pref_name, PRS_GUI_PLIST_SEL_BROWSE) == 0) {
942     if (strcmp(value, "TRUE") == 0) {
943             prefs.gui_plist_sel_browse = TRUE;
944     }
945     else {
946             prefs.gui_plist_sel_browse = FALSE;
947     }
948   } else if (strcmp(pref_name, PRS_GUI_PTREE_SEL_BROWSE) == 0) {
949     if (strcmp(value, "TRUE") == 0) {
950             prefs.gui_ptree_sel_browse = TRUE;
951     }
952     else {
953             prefs.gui_ptree_sel_browse = FALSE;
954     }
955   } else if (strcmp(pref_name, PRS_GUI_PTREE_LINE_STYLE) == 0) {
956           prefs.gui_ptree_line_style =
957                   find_index_from_string_array(value, gui_ptree_line_style_text, 0);
958   } else if (strcmp(pref_name, PRS_GUI_PTREE_EXPANDER_STYLE) == 0) {
959           prefs.gui_ptree_expander_style =
960                   find_index_from_string_array(value, gui_ptree_expander_style_text, 1);
961   } else if (strcmp(pref_name, PRS_GUI_HEX_DUMP_HIGHLIGHT_STYLE) == 0) {
962           prefs.gui_hex_dump_highlight_style =
963                   find_index_from_string_array(value, gui_hex_dump_highlight_style_text, 1);
964   } else if (strcmp(pref_name, PRS_GUI_FONT_NAME) == 0) {
965           if (prefs.gui_font_name != NULL)
966                 g_free(prefs.gui_font_name);
967           prefs.gui_font_name = g_strdup(value);
968   } else if (strcmp(pref_name, PRS_GUI_MARKED_FG) == 0) {
969     cval = strtoul(value, NULL, 16);
970     prefs.gui_marked_fg.pixel = 0;
971     prefs.gui_marked_fg.red   = RED_COMPONENT(cval);
972     prefs.gui_marked_fg.green = GREEN_COMPONENT(cval);
973     prefs.gui_marked_fg.blue  = BLUE_COMPONENT(cval);
974   } else if (strcmp(pref_name, PRS_GUI_MARKED_BG) == 0) {
975     cval = strtoul(value, NULL, 16);
976     prefs.gui_marked_bg.pixel = 0;
977     prefs.gui_marked_bg.red   = RED_COMPONENT(cval);
978     prefs.gui_marked_bg.green = GREEN_COMPONENT(cval);
979     prefs.gui_marked_bg.blue  = BLUE_COMPONENT(cval);
980   } else {
981     /* To which module does this preference belong? */
982     dotp = strchr(pref_name, '.');
983     if (dotp == NULL)
984       return PREFS_SET_SYNTAX_ERR;      /* no ".", so no module/name separator */
985     *dotp = '\0';               /* separate module and preference name */
986     module = find_module(pref_name);
987
988     /*
989      * XXX - "Diameter" rather than "diameter" was used in earlier
990      * versions of Ethereal; if we didn't find the module, and its name
991      * was "Diameter", look for "diameter" instead.
992      */
993     if (module == NULL && strcmp(pref_name, "Diameter") == 0)
994       module = find_module("diameter");
995     *dotp = '.';                /* put the preference string back */
996     if (module == NULL)
997       return PREFS_SET_NO_SUCH_PREF;    /* no such module */
998     dotp++;                     /* skip past separator to preference name */
999     pref = find_preference(module, dotp);
1000
1001     /*
1002      * XXX - "mgcp.display raw text toggle" and "mgcp.display dissect tree"
1003      * rather than "mgcp.display_raw_text" and "mgcp.display_dissect_tree"
1004      * were used in earlier versions of Ethereal; if we didn't find the
1005      * preference, it was an MGCP preference, and its name was
1006      * "display raw text toggle" or "display dissect tree", look for
1007      * "display_raw_text" or "display_dissect_tree" instead.
1008      *
1009      * "mgcp.tcp.port" and "mgcp.udp.port" are harder to handle, as both
1010      * the gateway and callagent ports were given those names; we interpret
1011      * the first as "mgcp.{tcp,udp}.gateway_port" and the second as
1012      * "mgcp.{tcp,udp}.callagent_port", as that's the order in which
1013      * they were registered by the MCCP dissector and thus that's the
1014      * order in which they were written to the preferences file.  (If
1015      * we're not reading the preferences file, but are handling stuff
1016      * from a "-o" command-line option, we have no clue which the user
1017      * had in mind - they should have used "mgcp.{tcp,udp}.gateway_port"
1018      * or "mgcp.{tcp,udp}.callagent_port" instead.)
1019      */
1020     if (pref == NULL && strncmp(pref_name, "mgcp.", 5) == 0) {
1021       if (strcmp(dotp, "display raw text toggle") == 0)
1022         pref = find_preference(module, "display_raw_text");
1023       else if (strcmp(dotp, "display dissect tree") == 0)
1024         pref = find_preference(module, "display_dissect_tree");
1025       else if (strcmp(dotp, "tcp.port") == 0) {
1026         mgcp_tcp_port_count++;
1027         if (mgcp_tcp_port_count == 1) {
1028           /* It's the first one */
1029           pref = find_preference(module, "tcp.gateway_port");
1030         } else if (mgcp_tcp_port_count == 2) {
1031           /* It's the second one */
1032           pref = find_preference(module, "tcp.callagent_port");
1033         }
1034         /* Otherwise it's from the command line, and we don't bother
1035            mapping it. */
1036       } else if (strcmp(dotp, "udp.port") == 0) {
1037         mgcp_udp_port_count++;
1038         if (mgcp_udp_port_count == 1) {
1039           /* It's the first one */
1040           pref = find_preference(module, "udp.gateway_port");
1041         } else if (mgcp_udp_port_count == 2) {
1042           /* It's the second one */
1043           pref = find_preference(module, "udp.callagent_port");
1044         }
1045         /* Otherwise it's from the command line, and we don't bother
1046            mapping it. */
1047       }
1048     }
1049     if (pref == NULL)
1050       return PREFS_SET_NO_SUCH_PREF;    /* no such preference */
1051
1052     switch (pref->type) {
1053
1054     case PREF_UINT:
1055       uval = strtoul(value, &p, pref->info.base);
1056       if (p == value || *p != '\0')
1057         return PREFS_SET_SYNTAX_ERR;    /* number was bad */
1058       if (*pref->varp.uint != uval) {
1059         module->prefs_changed = TRUE;
1060         *pref->varp.uint = uval;
1061       }
1062       break;
1063
1064     case PREF_BOOL:
1065       /* XXX - give an error if it's neither "true" nor "false"? */
1066       if (strcasecmp(value, "true") == 0)
1067         bval = TRUE;
1068       else
1069         bval = FALSE;
1070       if (*pref->varp.bool != bval) {
1071         module->prefs_changed = TRUE;
1072         *pref->varp.bool = bval;
1073       }
1074       break;
1075
1076     case PREF_ENUM:
1077       /* XXX - give an error if it doesn't match? */
1078       enum_val = find_val_for_string(value,
1079                                         pref->info.enum_info.enumvals, 1);
1080       if (*pref->varp.enump != enum_val) {
1081         module->prefs_changed = TRUE;
1082         *pref->varp.enump = enum_val;
1083       }
1084       break;
1085
1086     case PREF_STRING:
1087       if (*pref->varp.string == NULL || strcmp(*pref->varp.string, value) != 0) {
1088         module->prefs_changed = TRUE;
1089         if (*pref->varp.string != NULL)
1090           g_free(*pref->varp.string);
1091         *pref->varp.string = g_strdup(value);
1092       }
1093       break;
1094     }
1095   }
1096   
1097   return PREFS_SET_OK;
1098 }
1099
1100 typedef struct {
1101         module_t *module;
1102         FILE    *pf;
1103 } write_pref_arg_t;
1104
1105 /*
1106  * Write out a single preference.
1107  */
1108 static void
1109 write_pref(gpointer data, gpointer user_data)
1110 {
1111         pref_t *pref = data;
1112         write_pref_arg_t *arg = user_data;
1113         const enum_val_t *enum_valp;
1114         const char *val_string;
1115
1116         fprintf(arg->pf, "\n# %s\n", pref->description);
1117
1118         switch (pref->type) {
1119
1120         case PREF_UINT:
1121                 switch (pref->info.base) {
1122
1123                 case 10:
1124                         fprintf(arg->pf, "# A decimal number.\n");
1125                         fprintf(arg->pf, "%s.%s: %u\n", arg->module->name,
1126                             pref->name, *pref->varp.uint);
1127                         break;
1128
1129                 case 8:
1130                         fprintf(arg->pf, "# An octal number.\n");
1131                         fprintf(arg->pf, "%s.%s: %#o\n", arg->module->name,
1132                             pref->name, *pref->varp.uint);
1133                         break;
1134
1135                 case 16:
1136                         fprintf(arg->pf, "# A hexadecimal number.\n");
1137                         fprintf(arg->pf, "%s.%s: %#x\n", arg->module->name,
1138                             pref->name, *pref->varp.uint);
1139                         break;
1140                 }
1141                 break;
1142
1143         case PREF_BOOL:
1144                 fprintf(arg->pf, "# TRUE or FALSE (case-insensitive).\n");
1145                 fprintf(arg->pf, "%s.%s: %s\n", arg->module->name, pref->name,
1146                     *pref->varp.bool ? "TRUE" : "FALSE");
1147                 break;
1148
1149         case PREF_ENUM:
1150                 fprintf(arg->pf, "# One of: ");
1151                 enum_valp = pref->info.enum_info.enumvals;
1152                 val_string = NULL;
1153                 while (enum_valp->name != NULL) {
1154                         if (enum_valp->value == *pref->varp.enump)
1155                                 val_string = enum_valp->name;
1156                         fprintf(arg->pf, "%s", enum_valp->name);
1157                         enum_valp++;
1158                         if (enum_valp->name == NULL)
1159                                 fprintf(arg->pf, "\n");
1160                         else
1161                                 fprintf(arg->pf, ", ");
1162                 }
1163                 fprintf(arg->pf, "# (case-insensitive).\n");
1164                 fprintf(arg->pf, "%s.%s: %s\n", arg->module->name, pref->name,
1165                     val_string);
1166                 break;
1167
1168         case PREF_STRING:
1169                 fprintf(arg->pf, "# A string.\n");
1170                 fprintf(arg->pf, "%s.%s: %s\n", arg->module->name, pref->name,
1171                     *pref->varp.string);
1172                 break;
1173         }
1174 }
1175
1176 static void
1177 write_module_prefs(gpointer data, gpointer user_data)
1178 {
1179         write_pref_arg_t arg;
1180
1181         arg.module = data;
1182         arg.pf = user_data;
1183         g_list_foreach(arg.module->prefs, write_pref, &arg);
1184 }
1185
1186 /* Write out "prefs" to the user's preferences file, and return 0.
1187
1188    If we got an error, stuff a pointer to the path of the preferences file
1189    into "*pf_path_return", and return the errno. */
1190 int
1191 write_prefs(char **pf_path_return)
1192 {
1193   FILE        *pf;
1194   struct stat  s_buf;
1195   
1196   /* To do:
1197    * - Split output lines longer than MAX_VAL_LEN
1198    * - Create a function for the preference directory check/creation
1199    *   so that duplication can be avoided with filter.c
1200    */
1201
1202   if (! pf_path) {
1203     pf_path = (gchar *) g_malloc(strlen(get_home_dir()) + strlen(PF_DIR) +
1204       strlen(PF_NAME) + 4);
1205   }
1206
1207   sprintf(pf_path, "%s/%s", get_home_dir(), PF_DIR);
1208   if (stat(pf_path, &s_buf) != 0)
1209 #ifdef WIN32
1210     mkdir(pf_path);
1211 #else
1212     mkdir(pf_path, 0755);
1213 #endif
1214
1215   sprintf(pf_path, "%s/%s/%s", get_home_dir(), PF_DIR, PF_NAME);
1216   if ((pf = fopen(pf_path, "w")) == NULL) {
1217     *pf_path_return = pf_path;
1218     return errno;
1219   }
1220     
1221   fputs("# Configuration file for Ethereal " VERSION ".\n"
1222     "#\n"
1223     "# This file is regenerated each time preferences are saved within\n"
1224     "# Ethereal.  Making manual changes should be safe, however.\n"
1225     "\n"
1226     "######## Printing ########\n"
1227     "\n", pf);
1228
1229   fprintf (pf, "# Can be one of \"text\" or \"postscript\".\n"
1230     "print.format: %s\n\n", pr_formats[prefs.pr_format]);
1231
1232   fprintf (pf, "# Can be one of \"command\" or \"file\".\n"
1233     "print.destination: %s\n\n", pr_dests[prefs.pr_dest]);
1234
1235   fprintf (pf, "# This is the file that gets written to when the "
1236     "destination is set to \"file\"\n"
1237     "%s: %s\n\n", PRS_PRINT_FILE, prefs.pr_file);
1238
1239   fprintf (pf, "# Output gets piped to this command when the destination "
1240     "is set to \"command\"\n"
1241     "%s: %s\n\n", PRS_PRINT_CMD, prefs.pr_cmd);
1242
1243   fprintf (pf, "# Packet list column format.  Each pair of strings consists "
1244     "of a column title \n# and its format.\n"
1245     "%s: %s\n\n", PRS_COL_FMT, col_format_to_pref_str());
1246
1247   fprintf (pf, "# TCP stream window color preferences.  Each value is a six "
1248     "digit hexadecimal value in the form rrggbb.\n");
1249   fprintf (pf, "%s: %02x%02x%02x\n", PRS_STREAM_CL_FG,
1250     (prefs.st_client_fg.red * 255 / 65535),
1251     (prefs.st_client_fg.green * 255 / 65535),
1252     (prefs.st_client_fg.blue * 255 / 65535));
1253   fprintf (pf, "%s: %02x%02x%02x\n", PRS_STREAM_CL_BG,
1254     (prefs.st_client_bg.red * 255 / 65535),
1255     (prefs.st_client_bg.green * 255 / 65535),
1256     (prefs.st_client_bg.blue * 255 / 65535));
1257   fprintf (pf, "%s: %02x%02x%02x\n", PRS_STREAM_SR_FG,
1258     (prefs.st_server_fg.red * 255 / 65535),
1259     (prefs.st_server_fg.green * 255 / 65535),
1260     (prefs.st_server_fg.blue * 255 / 65535));
1261   fprintf (pf, "%s: %02x%02x%02x\n", PRS_STREAM_SR_BG,
1262     (prefs.st_server_bg.red * 255 / 65535),
1263     (prefs.st_server_bg.green * 255 / 65535),
1264     (prefs.st_server_bg.blue * 255 / 65535));
1265
1266   fprintf(pf, "\n# Vertical scrollbars should be on right side? TRUE/FALSE\n");
1267   fprintf(pf, PRS_GUI_SCROLLBAR_ON_RIGHT ": %s\n",
1268                   prefs.gui_scrollbar_on_right == TRUE ? "TRUE" : "FALSE");
1269
1270   fprintf(pf, "\n# Packet-list selection bar can be used to browse w/o selecting? TRUE/FALSE\n");
1271   fprintf(pf, PRS_GUI_PLIST_SEL_BROWSE ": %s\n",
1272                   prefs.gui_plist_sel_browse == TRUE ? "TRUE" : "FALSE");
1273
1274   fprintf(pf, "\n# Protocol-tree selection bar can be used to browse w/o selecting? TRUE/FALSE\n");
1275   fprintf(pf, PRS_GUI_PTREE_SEL_BROWSE ": %s\n",
1276                   prefs.gui_ptree_sel_browse == TRUE ? "TRUE" : "FALSE");
1277
1278   fprintf(pf, "\n# Protocol-tree line style. One of: NONE, SOLID, DOTTED, TABBED\n");
1279   fprintf(pf, PRS_GUI_PTREE_LINE_STYLE ": %s\n",
1280                   gui_ptree_line_style_text[prefs.gui_ptree_line_style]);
1281
1282   fprintf(pf, "\n# Protocol-tree expander style. One of: NONE, SQUARE, TRIANGLE, CIRCULAR\n");
1283   fprintf(pf, PRS_GUI_PTREE_EXPANDER_STYLE ": %s\n",
1284                   gui_ptree_expander_style_text[prefs.gui_ptree_expander_style]);
1285
1286   fprintf(pf, "\n# Hex dump highlight style. One of: BOLD, INVERSE\n");
1287   fprintf(pf, PRS_GUI_HEX_DUMP_HIGHLIGHT_STYLE ": %s\n",
1288                   gui_hex_dump_highlight_style_text[prefs.gui_hex_dump_highlight_style]);
1289
1290   fprintf(pf, "\n# Font name for packet list, protocol tree, and hex dump panes.\n");
1291   fprintf(pf, PRS_GUI_FONT_NAME ": %s\n", prefs.gui_font_name);
1292
1293   fprintf (pf, "\n# Color preferences for a marked frame.  Each value is a six "
1294     "digit hexadecimal value in the form rrggbb.\n");
1295   fprintf (pf, "%s: %02x%02x%02x\n", PRS_GUI_MARKED_FG,
1296     (prefs.gui_marked_fg.red * 255 / 65535),
1297     (prefs.gui_marked_fg.green * 255 / 65535),
1298     (prefs.gui_marked_fg.blue * 255 / 65535));
1299   fprintf (pf, "%s: %02x%02x%02x\n", PRS_GUI_MARKED_BG,
1300     (prefs.gui_marked_bg.red * 255 / 65535),
1301     (prefs.gui_marked_bg.green * 255 / 65535),
1302     (prefs.gui_marked_bg.blue * 255 / 65535));
1303
1304   g_list_foreach(modules, write_module_prefs, pf);
1305
1306   fclose(pf);
1307
1308   /* XXX - catch I/O errors (e.g. "ran out of disk space") and return
1309      an error indication, or maybe write to a new preferences file and
1310      rename that file on top of the old one only if there are not I/O
1311      errors. */
1312   return 0;
1313 }
1314
1315 /* Copy a set of preferences. */
1316 void
1317 copy_prefs(e_prefs *dest, e_prefs *src)
1318 {
1319   fmt_data *src_cfmt, *dest_cfmt;
1320   GList *entry;
1321
1322   dest->pr_format = src->pr_format;
1323   dest->pr_dest = src->pr_dest;
1324   dest->pr_file = g_strdup(src->pr_file);
1325   dest->pr_cmd = g_strdup(src->pr_cmd);
1326   dest->col_list = NULL;
1327   for (entry = src->col_list; entry != NULL; entry = g_list_next(entry)) {
1328     src_cfmt = entry->data;
1329     dest_cfmt = (fmt_data *) g_malloc(sizeof(fmt_data));
1330     dest_cfmt->title = g_strdup(src_cfmt->title);
1331     dest_cfmt->fmt = g_strdup(src_cfmt->fmt);
1332     dest->col_list = g_list_append(dest->col_list, dest_cfmt);
1333   }
1334   dest->num_cols = src->num_cols;
1335   dest->st_client_fg = src->st_client_fg;
1336   dest->st_client_bg = src->st_client_bg;
1337   dest->st_server_fg = src->st_server_fg;
1338   dest->st_server_bg = src->st_server_bg;
1339   dest->gui_scrollbar_on_right = src->gui_scrollbar_on_right;
1340   dest->gui_plist_sel_browse = src->gui_plist_sel_browse;
1341   dest->gui_ptree_sel_browse = src->gui_ptree_sel_browse;
1342   dest->gui_ptree_line_style = src->gui_ptree_line_style;
1343   dest->gui_ptree_expander_style = src->gui_ptree_expander_style;
1344   dest->gui_hex_dump_highlight_style = src->gui_hex_dump_highlight_style;
1345   dest->gui_font_name = g_strdup(src->gui_font_name);
1346   dest->gui_marked_fg = src->gui_marked_fg;
1347   dest->gui_marked_bg = src->gui_marked_bg;
1348 }
1349
1350 /* Free a set of preferences. */
1351 void
1352 free_prefs(e_prefs *pr)
1353 {
1354   if (pr->pr_file != NULL) {
1355     g_free(pr->pr_file);
1356     pr->pr_file = NULL;
1357   }
1358   if (pr->pr_cmd != NULL) {
1359     g_free(pr->pr_cmd);
1360     pr->pr_cmd = NULL;
1361   }
1362   free_col_info(pr);
1363   if (pr->gui_font_name != NULL) {
1364     g_free(pr->gui_font_name);
1365     pr->gui_font_name = NULL;
1366   }
1367 }
1368
1369 static void
1370 free_col_info(e_prefs *pr)
1371 {
1372   fmt_data *cfmt;
1373
1374   while (pr->col_list != NULL) {
1375     cfmt = pr->col_list->data;
1376     g_free(cfmt->title);
1377     g_free(cfmt->fmt);
1378     g_free(cfmt);
1379     pr->col_list = g_list_remove_link(pr->col_list, pr->col_list);
1380   }
1381   g_list_free(pr->col_list);
1382   pr->col_list = NULL;
1383 }