Add a HACK patch for building a patched kerberos library
[metze/wireshark/wip.git] / capture_ui_utils.h
index e3b7bf7dc5dcaa4e645f1a448ca41bbca0be1dd1..7b9c3b2af79f18a305580a6476cb120d53833e3d 100644 (file)
@@ -3,8 +3,8 @@
  *
  * $Id$
  *
- * Ethereal - Network traffic analyzer
- * By Gerald Combs <gerald@ethereal.com>
+ * Wireshark - Network traffic analyzer
+ * By Gerald Combs <gerald@wireshark.org>
  * Copyright 1998 Gerald Combs
  *
  * This program is free software; you can redistribute it and/or
  *
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
 #ifndef __CAPTURE_UI_UTILS_H__
 #define __CAPTURE_UI_UTILS_H__
 
+#include "capture_opts.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
 /** @file
  *  GList of available capture interfaces.
  */
 
+/**
+ * Find user-specified capture device description that matches interface
+ * name, if any.
+ */
+char *capture_dev_user_descr_find(const gchar *if_name);
+
+/**
+ * Find user-specified link-layer header type that matches interface
+ * name, if any.
+ */
+gint capture_dev_user_linktype_find(const gchar *if_name);
+
+#if defined(_WIN32) || defined(HAVE_PCAP_CREATE)
+/**
+ * Find user-specified buffer size that matches interface
+ * name, if any.
+ */
+gint capture_dev_user_buffersize_find(const gchar *if_name);
+#endif
+
+/**
+ * Find user-specified snap length that matches interface
+ * name, if any.
+ */
+gint capture_dev_user_snaplen_find(const gchar *if_name);
+gboolean capture_dev_user_hassnap_find(const gchar *if_name);
+
+/**
+ * Find user-specified promiscuous mode that matches interface
+ * name, if any.
+ */
+gboolean capture_dev_user_pmode_find(const gchar *if_name);
+
 /** Return as descriptive a name for an interface as we can get.
  * If the user has specified a comment, use that.  Otherwise,
- * if get_interface_list() supplies a description, use that,
+ * if capture_interface_list() supplies a description, use that,
  * otherwise use the interface name.
  *
  * @param if_name The name of the interface.
@@ -42,7 +81,7 @@ char *get_interface_descriptive_name(const char *if_name);
 
 /** Build the GList of available capture interfaces.
  *
- * @param if_list An interface list from get_interface_list().
+ * @param if_list An interface list from capture_interface_list().
  * @param do_hide Hide the "hidden" interfaces.
  *
  * @return A list of if_info_t structs (use free_capture_combo_list() later).
@@ -65,14 +104,28 @@ void free_capture_combo_list(GList *combo_list);
  *
  * @return The raw interface name, without description (must NOT be g_free'd later)
  */
-char *get_if_name(char *if_text);
+const char *get_if_name(const char *if_text);
 
 /** Convert plain interface name to the displayed name in the combo box.
  *
+ * @param if_list The list of interfaces returned by build_capture_combo_list()
  * @param if_name The name of the interface.
  *
  * @return The descriptive name (must be g_free'd later)
  */
-char * build_capture_combo_name(GList *if_list, gchar *if_name);
+char *build_capture_combo_name(GList *if_list, gchar *if_name);
 
-#endif
+/** Return the interface description (after setting it if not already set)
+ *
+ * @param capture_opts The capture_options structure that contains the used interface
+ * @param i The index of the interface
+ *
+ * @return A pointer to interface_opts->descr
+ */
+const char *get_iface_description_for_interface(capture_options *capture_opts, guint i);
+
+#ifdef __cplusplus
+}
+#endif /* __cplusplus */
+
+#endif /* __CAPTURE_UI_UTILS_H__ */