ui/capture_ui_utils.h

   1 /** @file
   2  *
   3  * Declarations of utilities for capture user interfaces
   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 __CAPTURE_UI_UTILS_H__
  13 #define __CAPTURE_UI_UTILS_H__
  14
  15 #include "capture_opts.h"
  16
  17 #ifdef __cplusplus
  18 extern "C" {
  19 #endif /* __cplusplus */
  20
  21 /** @file
  22  *  GList of available capture interfaces.
  23  */
  24
  25 /**
  26  * Find user-specified capture device description that matches interface
  27  * name, if any.
  28  *
  29  * @param if_name The name of the interface.
  30  *
  31  * @return The device description (must be g_free'd later) or NULL
  32  * if not found.
  33  */
  34 char *capture_dev_user_descr_find(const char *if_name);
  35
  36 /**
  37  * Find user-specified link-layer header type that matches interface
  38  * name, if any.
  39  *
  40  * @param if_name The name of the interface.
  41  *
  42  * @return The link-layer header type (a DLT_) or -1 if not found.
  43  */
  44 int capture_dev_user_linktype_find(const char *if_name);
  45
  46 #ifdef CAN_SET_CAPTURE_BUFFER_SIZE
  47 /**
  48  * Find user-specified buffer size that matches interface
  49  * name, if any.
  50  *
  51  * @param if_name The name of the interface.
  52  *
  53  * @return The buffer size or -1 if not found.
  54  */
  55 int capture_dev_user_buffersize_find(const char *if_name);
  56 #endif
  57
  58 /**
  59  * Find user-specified snap length that matches interface
  60  * name, if any.
  61  *
  62  * @param if_name The name of the interface.
  63  * @param hassnap Pointer to a variable to be set to true if the
  64  * interface should be given a snap length or false if it shouldn't
  65  * be given a snap length.
  66  * @param snaplen Pointer to a variable to be set to the snap length
  67  * if the interface should be given a snap length or the maximum
  68  * snap length if it shouldn't be given a snap length.
  69  *
  70  * @return true if found or false if not found.
  71  */
  72 bool capture_dev_user_snaplen_find(const char *if_name, bool *hassnap, int *snaplen);
  73
  74 /**
  75  * Find user-specified promiscuous mode that matches interface
  76  * name, if any.
  77  *
  78  * @param if_name The name of the interface.
  79  * @param pmode Pointer to a variable to be set to true if promiscuous
  80  * mode should be used and false if it shouldn't be used.
  81  *
  82  * @return true if found or false if not found.
  83  */
  84 bool capture_dev_user_pmode_find(const char *if_name, bool *pmode);
  85
  86 /**
  87  * Find user-specified capture filter that matches interface
  88  * name, if any.
  89  *
  90  * This is deprecated and should not be used in new code.
  91  *
  92  * @param if_name The name of the interface.
  93  *
  94  * @return The capture filter (must be g_free'd later) or NULL if not found.
  95  */
  96 char* capture_dev_user_cfilter_find(const char *if_name);
  97
  98 /** Return as descriptive a name for an interface as we can get.
  99  * If the user has specified a comment, use that.  Otherwise,
 100  * if the get_iface_list() method of capture_opts supplies a
 101  * description, use that, otherwise use the interface name.
 102  *
 103  * @param capture_opts The capture options to use to find the interface
 104  * @param if_name The name of the interface.
 105  *
 106  * @return The descriptive name (must be g_free'd later)
 107  */
 108 char *get_interface_descriptive_name(const capture_options *capture_opts, const char *if_name);
 109
 110 /** Build the GList of available capture interfaces.
 111  *
 112  * @param if_list An interface list from capture_interface_list().
 113  * @param do_hide Hide the "hidden" interfaces.
 114  *
 115  * @return A list of if_info_t structs (use free_capture_combo_list() later).
 116  */
 117 GList *build_capture_combo_list(GList *if_list, bool do_hide);
 118
 119 /** Free the GList from build_capture_combo_list().
 120  *
 121  * @param combo_list the interface list from build_capture_combo_list()
 122  */
 123 void free_capture_combo_list(GList *combo_list);
 124
 125
 126 /** Given text that contains an interface name possibly prefixed by an
 127  * interface description, extract the interface name.
 128  *
 129  * @param if_text A string containing the interface description + name.
 130  * This is usually the data from one of the list elements returned by
 131  * build_capture_combo_list().
 132  *
 133  * @return The raw interface name, without description (must NOT be g_free'd later)
 134  */
 135 const char *get_if_name(const char *if_text);
 136
 137 /** Set the active DLT for a device appropriately.
 138  *
 139  * @param device the device on which to set the active DLT
 140  * @param global_default_dlt the global default DLT
 141  */
 142 extern void set_active_dlt(interface_t *device, int global_default_dlt);
 143
 144 /** Get a descriptive string for a list of interfaces.
 145  *
 146  * @param capture_opts The capture_options structure that contains the interfaces
 147  * @param style flags to indicate the style of string to use:
 148  *
 149  *  IFLIST_QUOTE_IF_DESCRIPTION: put the interface descriptive string in
 150  *  single quotes
 151  *
 152  *  IFLIST_SHOW_FILTER: include the capture filters in the string
 153  *
 154  * @return A GString set to the descriptive string
 155  */
 156 #define IFLIST_QUOTE_IF_DESCRIPTION 0x00000001
 157 #define IFLIST_SHOW_FILTER          0x00000002
 158
 159 extern GString *get_iface_list_string(capture_options *capture_opts, uint32_t style);
 160
 161 #ifdef __cplusplus
 162 }
 163 #endif /* __cplusplus */
 164
 165 #endif /* __CAPTURE_UI_UTILS_H__ */