The data contained in this repository can be downloaded to your computer using one of several clients.
Please see the documentation of your version control software client for more information.

Please select the desired protocol below to get the URL.

This URL has Read-Only access.

Statistics
| Branch: | Revision:

main_repo / capture_ui_utils.h @ d8087438

History | View | Annotate | Download (2.66 KB)

1 43869b46 Guy Harris
/* capture_ui_utils.c
2
 * Declarations of utilities for capture user interfaces
3 27ea7816 Guy Harris
 *
4 8a8b8834 Guy Harris
 * $Id$
5 27ea7816 Guy Harris
 *
6 89f022b1 Ronnie Sahlberg
 * Wireshark - Network traffic analyzer
7
 * By Gerald Combs <gerald@wireshark.org>
8 27ea7816 Guy Harris
 * Copyright 1998 Gerald Combs
9
 *
10
 * This program is free software; you can redistribute it and/or
11
 * modify it under the terms of the GNU General Public License
12
 * as published by the Free Software Foundation; either version 2
13
 * of the License, or (at your option) any later version.
14
 *
15
 * This program is distributed in the hope that it will be useful,
16
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18
 * GNU General Public License for more details.
19
 *
20
 * You should have received a copy of the GNU General Public License
21
 * along with this program; if not, write to the Free Software
22
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
23
 */
24
25 43869b46 Guy Harris
#ifndef __CAPTURE_UI_UTILS_H__
26
#define __CAPTURE_UI_UTILS_H__
27 27ea7816 Guy Harris
28 a8db4e10 Ulf Lamping
/** @file
29
 *  GList of available capture interfaces.
30
 */
31
32 709b556a Guy Harris
/** Return as descriptive a name for an interface as we can get.
33
 * If the user has specified a comment, use that.  Otherwise,
34
 * if get_interface_list() supplies a description, use that,
35
 * otherwise use the interface name.
36
 *
37 5115a265 Ulf Lamping
 * @param if_name The name of the interface.
38 709b556a Guy Harris
 *
39 5115a265 Ulf Lamping
 * @return The descriptive name (must be g_free'd later)
40 709b556a Guy Harris
 */
41
char *get_interface_descriptive_name(const char *if_name);
42
43 a8db4e10 Ulf Lamping
/** Build the GList of available capture interfaces.
44
 *
45 4e3b6fb3 Gerald Combs
 * @param if_list An interface list from get_interface_list().
46
 * @param do_hide Hide the "hidden" interfaces.
47
 *
48 5115a265 Ulf Lamping
 * @return A list of if_info_t structs (use free_capture_combo_list() later).
49 a8db4e10 Ulf Lamping
 */
50 27ea7816 Guy Harris
GList *build_capture_combo_list(GList *if_list, gboolean do_hide);
51 a8db4e10 Ulf Lamping
52
/** Free the GList from build_capture_combo_list().
53
 *
54
 * @param combo_list the interface list from build_capture_combo_list()
55
 */
56 27ea7816 Guy Harris
void free_capture_combo_list(GList *combo_list);
57
58 4e3b6fb3 Gerald Combs
59
/** Given text that contains an interface name possibly prefixed by an
60
 * interface description, extract the interface name.
61
 *
62
 * @param if_text A string containing the interface description + name.
63
 * This is usually the data from one of the list elements returned by
64
 * build_capture_combo_list().
65
 *
66 5115a265 Ulf Lamping
 * @return The raw interface name, without description (must NOT be g_free'd later)
67 4e3b6fb3 Gerald Combs
 */
68 eaee2b68 Guy Harris
const char *get_if_name(const char *if_text);
69 4e3b6fb3 Gerald Combs
70 5115a265 Ulf Lamping
/** Convert plain interface name to the displayed name in the combo box.
71
 *
72 924cc601 Ulf Lamping
 * @param if_list The list of interfaces returned by build_capture_combo_list()
73 5115a265 Ulf Lamping
 * @param if_name The name of the interface.
74
 *
75
 * @return The descriptive name (must be g_free'd later)
76
 */
77
char * build_capture_combo_name(GList *if_list, gchar *if_name);
78
79 27ea7816 Guy Harris
#endif