epan/disabled_protos.h

   1 /* disabled_protos.h
   2  * Declarations of routines for reading and writing protocols file that determine
   3  * enabling and disabling of protocols.
   4  *
   5  * Wireshark - Network traffic analyzer
   6  * By Gerald Combs <gerald@wireshark.org>
   7  * Copyright 1998 Gerald Combs
   8  *
   9  * SPDX-License-Identifier: GPL-2.0-or-later
  10  */
  11
  12 #ifndef DISABLED_PROTOS_H
  13 #define DISABLED_PROTOS_H
  14
  15 #ifdef __cplusplus
  16 extern "C" {
  17 #endif /* __cplusplus */
  18
  19 /*
  20  * Disable a particular protocol by name
  21  */
  22 WS_DLL_PUBLIC void
  23 proto_disable_proto_by_name(const char *name);
  24
  25 /*
  26  * Enable a particular protocol by name.  This will only enable
  27  * protocols that are disabled by default.  All others will be ignored.
  28  */
  29 WS_DLL_PUBLIC void
  30 proto_enable_proto_by_name(const char *name);
  31
  32 /*
  33  * Enable/disable a particular heuristic dissector by name
  34  * On success (found the protocol), return TRUE.
  35  * On failure (didn't find the protocol), return FALSE.
  36  */
  37 WS_DLL_PUBLIC gboolean
  38 proto_enable_heuristic_by_name(const char *name, gboolean enable);
  39
  40 /*
  41  * Read the files that enable and disable protocols and heuristic
  42  * dissectors.  Report errors through the UI.
  43  *
  44  * This is called by epan_load_settings(); programs should call that
  45  * rather than individually calling the routines it calls.
  46  */
  47 extern void
  48 read_enabled_and_disabled_lists(void);
  49
  50 /*
  51  * Write out the lists of enabled and disabled protocols and heuristic
  52  * dissectors to the corresponding files.  Report errors through the UI.
  53  */
  54 WS_DLL_PUBLIC void
  55 save_enabled_and_disabled_lists(void);
  56
  57 /*
  58  * Free the internal structures
  59  */
  60 extern void
  61 cleanup_enabled_and_disabled_lists(void);
  62
  63 #ifdef __cplusplus
  64 }
  65 #endif /* __cplusplus */
  66
  67 #endif /* DISABLED_PROTOS_H */