prefs.h

   1 /* prefs.h
   2  * Definitions for preference handling routines
   3  *
   4  * $Id: prefs.h,v 1.26 2000/11/21 23:54:08 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 #ifndef __PREFS_H__
  27 #define __PREFS_H__
  28
  29 #include <glib.h>
  30
  31 #include "color.h"
  32
  33 #define PR_DEST_CMD  0
  34 #define PR_DEST_FILE 1
  35
  36 typedef struct _e_prefs {
  37   gint     pr_format;
  38   gint     pr_dest;
  39   gchar   *pr_file;
  40   gchar   *pr_cmd;
  41   GList   *col_list;
  42   gint     num_cols;
  43   color_t  st_client_fg, st_client_bg, st_server_fg, st_server_bg;
  44   gboolean gui_scrollbar_on_right;
  45   gboolean gui_plist_sel_browse;
  46   gboolean gui_ptree_sel_browse;
  47   gint     gui_ptree_line_style;
  48   gint     gui_ptree_expander_style;
  49   gboolean gui_hex_dump_highlight_style;
  50   gchar   *gui_font_name;
  51   color_t  gui_marked_fg;
  52   color_t  gui_marked_bg;
  53 } e_prefs;
  54
  55 extern e_prefs prefs;
  56
  57 /*
  58  * Routines to let modules that have preference settings register
  59  * themselves by name, and to let them register preference settings
  60  * by name.
  61  */
  62 struct pref_module;
  63
  64 typedef struct pref_module module_t;
  65
  66 /*
  67  * Register a module that will have preferences.
  68  * Specify the name used for the module in the preferences file, the
  69  * title used in the tab for it in a preferences dialog box, and a
  70  * routine to call back when we apply the preferences.
  71  * Note:
  72  * In case of dissectors, the specified name should be the protocol
  73  * name specified at the proto_register_protocol() call in order to
  74  * make the "Protocol Properties..." menu item work.
  75  */
  76 module_t *prefs_register_module(const char *name, const char *title,
  77     void (*apply_cb)(void));
  78
  79 typedef void (*module_cb)(module_t *module, gpointer user_data);
  80
  81 /*
  82  * Call a callback function, with a specified argument, for each module.
  83  */
  84 void prefs_module_foreach(module_cb callback, gpointer user_data);
  85
  86 /*
  87  * Call the "apply" callback function for each module if any of its
  88  * preferences have changed, and then clear the flag saying its
  89  * preferences have changed, as the module has been notified of that
  90  * fact.
  91  */
  92 void prefs_apply_all(void);
  93
  94 struct preference;
  95
  96 typedef struct preference pref_t;
  97
  98 /*
  99  * Returns TRUE if the given protocol has registered preferences
 100  */
 101 gboolean prefs_is_registered_protocol(char *name);
 102
 103 /*
 104  * Returns the module title of a registered protocol (or NULL if unknown)
 105  */
 106 const char *prefs_get_title_by_name(char *name);
 107
 108 /*
 109  * Register a preference with an unsigned integral value.
 110  */
 111 void prefs_register_uint_preference(module_t *module, const char *name,
 112     const char *title, const char *description, guint base, guint *var);
 113
 114 /*
 115  * Register a preference with an Boolean value.
 116  */
 117 void prefs_register_bool_preference(module_t *module, const char *name,
 118     const char *title, const char *description, gboolean *var);
 119
 120 /*
 121  * Register a preference with an enumerated value.
 122  */
 123 typedef struct {
 124         char    *name;
 125         gint    value;
 126 } enum_val_t;
 127
 128 void prefs_register_enum_preference(module_t *module, const char *name,
 129     const char *title, const char *description, gint *var,
 130     const enum_val_t *enumvals, gboolean radio_buttons);
 131
 132 /*
 133  * Register a preference with a character-string value.
 134  */
 135 void prefs_register_string_preference(module_t *module, const char *name,
 136     const char *title, const char *description, char **var);
 137
 138 typedef void (*pref_cb)(pref_t *pref, gpointer user_data);
 139
 140 /*
 141  * Call a callback function, with a specified argument, for each preference
 142  * in a given module.
 143  */
 144 void prefs_pref_foreach(module_t *module, pref_cb callback, gpointer user_data);
 145
 146 /*
 147  * Register all non-dissector modules' preferences.
 148  */
 149 void prefs_register_modules(void);
 150
 151 /* Read the preferences file, fill in "prefs", and return a pointer to it.
 152
 153    If we got an error (other than "it doesn't exist") trying to read
 154    the global preferences file, stuff the errno into "*gpf_errno_return"
 155    and a pointer to the path of the file into "*gpf_path_return", and
 156    return NULL.
 157
 158    If we got an error (other than "it doesn't exist") trying to read
 159    the user's preferences file, stuff the errno into "*pf_errno_return"
 160    and a pointer to the path of the file into "*pf_path_return", and
 161    return NULL. */
 162 e_prefs *read_prefs(int *, char **, int *, char **);
 163
 164 /* Write out "prefs" to the user's preferences file, and return 0.
 165
 166    If we got an error, stuff a pointer to the path of the preferences file
 167    into "*pf_path_return", and return the errno. */
 168 int write_prefs(char **);
 169
 170 /* Copy a set of preferences. */
 171 void copy_prefs(e_prefs *dest, e_prefs *src);
 172
 173 /* Free a set of preferences. */
 174 void free_prefs(e_prefs *pr);
 175
 176 /*
 177  * Given a string of the form "<pref name>:<pref value>", as might appear
 178  * as an argument to a "-o" option, parse it and set the preference in
 179  * question.  Return an indication of whether it succeeded or failed
 180  * in some fashion.
 181  */
 182 #define PREFS_SET_OK            0       /* succeeded */
 183 #define PREFS_SET_SYNTAX_ERR    1       /* syntax error in string */
 184 #define PREFS_SET_NO_SUCH_PREF  2       /* no such preference */
 185
 186 int prefs_set_pref(char *prefarg);
 187
 188 #endif /* prefs.h */