2 * Utility routines for packet capture
6 * Wireshark - Network traffic analyzer
7 * By Gerald Combs <gerald@wireshark.org>
8 * Copyright 1998 Gerald Combs
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.
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.
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.
38 #ifdef HAVE_SYS_TYPES_H
39 # include <sys/types.h>
42 #ifdef HAVE_SYS_SOCKET_H
43 #include <sys/socket.h>
49 #include "capture_ifinfo.h"
50 #include "capture-pcap-util.h"
51 #include "capture-pcap-util-int.h"
54 #include <netinet/in.h>
59 * Get the data-link type for a libpcap device.
60 * This works around AIX 5.x's non-standard and incompatible-with-the-
61 * rest-of-the-universe libpcap.
64 get_pcap_linktype(pcap_t *pch, const char *devname
72 const char *ifacename;
75 linktype = pcap_datalink(pch);
79 * The libpcap that comes with AIX 5.x uses RFC 1573 ifType values
80 * rather than DLT_ values for link-layer types; the ifType values
81 * for LAN devices are:
88 * and the ifType value for a loopback device is 24.
90 * The AIX names for LAN devices begin with:
97 * and the AIX names for loopback devices begin with "lo".
99 * (The difference between "Ethernet" and "802.3" is presumably
100 * whether packets have an Ethernet header, with a packet type,
101 * or an 802.3 header, with a packet length, followed by an 802.2
102 * header and possibly a SNAP header.)
104 * If the device name matches "linktype" interpreted as an ifType
105 * value, rather than as a DLT_ value, we will assume this is AIX's
106 * non-standard, incompatible libpcap, rather than a standard libpcap,
107 * and will map the link-layer type to the standard DLT_ value for
108 * that link-layer type, as that's what the rest of Wireshark expects.
110 * (This means the capture files won't be readable by a tcpdump
111 * linked with AIX's non-standard libpcap, but so it goes. They
112 * *will* be readable by standard versions of tcpdump, Wireshark,
115 * XXX - if we conclude we're using AIX libpcap, should we also
116 * set a flag to cause us to assume the time stamps are in
117 * seconds-and-nanoseconds form, and to convert them to
118 * seconds-and-microseconds form before processing them and
123 * Find the last component of the device name, which is the
126 ifacename = strchr(devname, '/');
127 if (ifacename == NULL)
130 /* See if it matches any of the LAN device names. */
131 if (strncmp(ifacename, "en", 2) == 0) {
134 * That's the RFC 1573 value for Ethernet; map it
139 } else if (strncmp(ifacename, "et", 2) == 0) {
142 * That's the RFC 1573 value for 802.3; map it to
144 * (libpcap, tcpdump, Wireshark, etc. don't care if
145 * it's Ethernet or 802.3.)
149 } else if (strncmp(ifacename, "tr", 2) == 0) {
152 * That's the RFC 1573 value for 802.5 (Token Ring);
153 * map it to DLT_IEEE802, which is what's used for
158 } else if (strncmp(ifacename, "fi", 2) == 0) {
159 if (linktype == 15) {
161 * That's the RFC 1573 value for FDDI; map it to
166 } else if (strncmp(ifacename, "lo", 2) == 0) {
167 if (linktype == 24) {
169 * That's the RFC 1573 value for "software loopback"
170 * devices; map it to DLT_NULL, which is what's used
171 * for loopback devices on BSD.
182 if_info_new(char *name, char *description)
186 if_info = g_malloc(sizeof (if_info_t));
187 if_info->name = g_strdup(name);
188 if (description == NULL)
189 if_info->description = NULL;
191 if_info->description = g_strdup(description);
192 if_info->addrs = NULL;
193 if_info->loopback = FALSE;
198 if_info_add_address(if_info_t *if_info, struct sockaddr *addr)
201 struct sockaddr_in *ai;
203 struct sockaddr_in6 *ai6;
206 switch (addr->sa_family) {
209 ai = (struct sockaddr_in *)addr;
210 if_addr = g_malloc(sizeof(*if_addr));
211 if_addr->ifat_type = IF_AT_IPv4;
212 if_addr->addr.ip4_addr =
213 *((guint32 *)&(ai->sin_addr.s_addr));
214 if_info->addrs = g_slist_append(if_info->addrs, if_addr);
219 ai6 = (struct sockaddr_in6 *)addr;
220 if_addr = g_malloc(sizeof(*if_addr));
221 if_addr->ifat_type = IF_AT_IPv6;
222 memcpy((void *)&if_addr->addr.ip6_addr,
223 (void *)&ai6->sin6_addr.s6_addr,
224 sizeof if_addr->addr.ip6_addr);
225 if_info->addrs = g_slist_append(if_info->addrs, if_addr);
231 #ifdef HAVE_PCAP_FINDALLDEVS
233 * Get all IP address information, and the loopback flag, for the given
237 if_info_ip(if_info_t *if_info, pcap_if_t *d)
242 if_info->loopback = (d->flags & PCAP_IF_LOOPBACK) ? TRUE : FALSE;
245 for (a = d->addresses; a != NULL; a = a->next) {
247 if_info_add_address(if_info, a->addr);
251 #ifdef HAVE_PCAP_REMOTE
253 get_interface_list_findalldevs_ex(const char *source,
254 struct pcap_rmtauth *auth,
255 int *err, char **err_str)
258 pcap_if_t *alldevs, *dev;
260 char errbuf[PCAP_ERRBUF_SIZE];
262 if (pcap_findalldevs_ex((char *)source, auth, &alldevs, errbuf) == -1) {
263 *err = CANT_GET_INTERFACE_LIST;
265 *err_str = cant_get_if_list_error_message(errbuf);
269 if (alldevs == NULL) {
271 * No interfaces found.
273 *err = NO_INTERFACES_FOUND;
279 for (dev = alldevs; dev != NULL; dev = dev->next) {
280 if_info = if_info_new(dev->name, dev->description);
281 il = g_list_append(il, if_info);
282 if_info_ip(if_info, dev);
284 pcap_freealldevs(alldevs);
291 get_interface_list_findalldevs(int *err, char **err_str)
294 pcap_if_t *alldevs, *dev;
296 char errbuf[PCAP_ERRBUF_SIZE];
298 if (pcap_findalldevs(&alldevs, errbuf) == -1) {
299 *err = CANT_GET_INTERFACE_LIST;
301 *err_str = cant_get_if_list_error_message(errbuf);
305 if (alldevs == NULL) {
307 * No interfaces found.
309 *err = NO_INTERFACES_FOUND;
315 for (dev = alldevs; dev != NULL; dev = dev->next) {
316 if_info = if_info_new(dev->name, dev->description);
317 il = g_list_append(il, if_info);
318 if_info_ip(if_info, dev);
320 pcap_freealldevs(alldevs);
324 #endif /* HAVE_PCAP_FINDALLDEVS */
327 free_if_info_addr_cb(gpointer addr, gpointer user_data _U_)
333 free_if_cb(gpointer data, gpointer user_data _U_)
335 if_info_t *if_info = data;
337 g_free(if_info->name);
338 g_free(if_info->description);
340 g_slist_foreach(if_info->addrs, free_if_info_addr_cb, NULL);
341 g_slist_free(if_info->addrs);
346 free_interface_list(GList *if_list)
348 g_list_foreach(if_list, free_if_cb, NULL);
349 g_list_free(if_list);
352 #if !defined(HAVE_PCAP_DATALINK_NAME_TO_VAL) || !defined(HAVE_PCAP_DATALINK_VAL_TO_NAME) || !defined(HAVE_PCAP_DATALINK_VAL_TO_DESCRIPTION)
355 const char *description;
359 #define DLT_CHOICE(code, description) { #code, description, code }
360 #define DLT_CHOICE_SENTINEL { NULL, NULL, 0 }
362 static struct dlt_choice dlt_choices[] = {
363 DLT_CHOICE(DLT_NULL, "BSD loopback"),
364 DLT_CHOICE(DLT_EN10MB, "Ethernet"),
365 DLT_CHOICE(DLT_IEEE802, "Token ring"),
366 DLT_CHOICE(DLT_ARCNET, "ARCNET"),
367 DLT_CHOICE(DLT_SLIP, "SLIP"),
368 DLT_CHOICE(DLT_PPP, "PPP"),
369 DLT_CHOICE(DLT_FDDI, "FDDI"),
370 DLT_CHOICE(DLT_ATM_RFC1483, "RFC 1483 IP-over-ATM"),
371 DLT_CHOICE(DLT_RAW, "Raw IP"),
372 DLT_CHOICE(DLT_SLIP_BSDOS, "BSD/OS SLIP"),
373 DLT_CHOICE(DLT_PPP_BSDOS, "BSD/OS PPP"),
374 DLT_CHOICE(DLT_ATM_CLIP, "Linux Classical IP-over-ATM"),
375 DLT_CHOICE(DLT_PPP_SERIAL, "PPP over serial"),
376 DLT_CHOICE(DLT_PPP_ETHER, "PPPoE"),
377 DLT_CHOICE(DLT_C_HDLC, "Cisco HDLC"),
378 DLT_CHOICE(DLT_IEEE802_11, "802.11"),
379 DLT_CHOICE(DLT_FRELAY, "Frame Relay"),
380 DLT_CHOICE(DLT_LOOP, "OpenBSD loopback"),
381 DLT_CHOICE(DLT_ENC, "OpenBSD encapsulated IP"),
382 DLT_CHOICE(DLT_LINUX_SLL, "Linux cooked"),
383 DLT_CHOICE(DLT_LTALK, "Localtalk"),
384 DLT_CHOICE(DLT_PFLOG, "OpenBSD pflog file"),
385 DLT_CHOICE(DLT_PRISM_HEADER, "802.11 plus Prism header"),
386 DLT_CHOICE(DLT_IP_OVER_FC, "RFC 2625 IP-over-Fibre Channel"),
387 DLT_CHOICE(DLT_SUNATM, "Sun raw ATM"),
388 DLT_CHOICE(DLT_IEEE802_11_RADIO, "802.11 plus BSD radio information header"),
389 DLT_CHOICE(DLT_APPLE_IP_OVER_IEEE1394, "Apple IP-over-IEEE 1394"),
390 DLT_CHOICE(DLT_ARCNET_LINUX, "Linux ARCNET"),
391 DLT_CHOICE(DLT_LINUX_IRDA, "Linux IrDA"),
392 DLT_CHOICE(DLT_IEEE802_11_RADIO_AVS, "802.11 plus AVS radio information header"),
396 #if !defined(HAVE_PCAP_DATALINK_NAME_TO_VAL)
398 pcap_datalink_name_to_val(const char *name)
402 for (i = 0; dlt_choices[i].name != NULL; i++) {
403 if (g_ascii_strcasecmp(dlt_choices[i].name + sizeof("DLT_") - 1,
405 return (dlt_choices[i].dlt);
409 #endif /* defined(HAVE_PCAP_DATALINK_NAME_TO_VAL) */
411 #if !defined(HAVE_PCAP_DATALINK_VAL_TO_NAME)
413 pcap_datalink_val_to_name(int dlt)
417 for (i = 0; dlt_choices[i].name != NULL; i++) {
418 if (dlt_choices[i].dlt == dlt)
419 return (dlt_choices[i].name + sizeof("DLT_") - 1);
423 #endif /* defined(HAVE_PCAP_DATALINK_VAL_TO_NAME) */
425 #if !defined(HAVE_PCAP_DATALINK_VAL_TO_DESCRIPTION)
427 pcap_datalink_val_to_description(int dlt)
431 for (i = 0; dlt_choices[i].name != NULL; i++) {
432 if (dlt_choices[i].dlt == dlt)
433 return (dlt_choices[i].description);
437 #endif /* defined(HAVE_PCAP_DATALINK_VAL_TO_DESCRIPTION) */
439 #endif /* !defined(HAVE_PCAP_DATALINK_VAL_TO_NAME) || !defined(HAVE_PCAP_DATALINK_VAL_TO_DESCRIPTION) */
442 * Get the data-link types available for a libpcap device.
444 static data_link_info_t *
445 create_data_link_info(int dlt)
447 data_link_info_t *data_link_info;
450 data_link_info = g_malloc(sizeof (data_link_info_t));
451 data_link_info->dlt = dlt;
452 text = pcap_datalink_val_to_name(dlt);
454 data_link_info->name = g_strdup(text);
456 data_link_info->name = g_strdup_printf("DLT %d", dlt);
457 text = pcap_datalink_val_to_description(dlt);
459 data_link_info->description = g_strdup(text);
461 data_link_info->description = NULL;
462 return data_link_info;
466 get_pcap_linktype_list(const char *devname, char **err_str)
468 GList *linktype_list = NULL;
471 char errbuf[PCAP_ERRBUF_SIZE];
472 #ifdef HAVE_PCAP_LIST_DATALINKS
476 data_link_info_t *data_link_info;
478 #ifdef HAVE_PCAP_OPEN
479 pch = pcap_open(devname, MIN_PACKET_SIZE, 0, 0, NULL, errbuf);
481 pch = pcap_open_live(devname, MIN_PACKET_SIZE, 0, 0, errbuf);
485 *err_str = g_strdup(errbuf);
488 deflt = get_pcap_linktype(pch, devname);
489 #ifdef HAVE_PCAP_LIST_DATALINKS
490 nlt = pcap_list_datalinks(pch, &linktypes);
491 if (nlt == 0 || linktypes == NULL) {
494 *err_str = NULL; /* an empty list doesn't mean an error */
497 for (i = 0; i < nlt; i++) {
498 data_link_info = create_data_link_info(linktypes[i]);
501 * XXX - for 802.11, make the most detailed 802.11
502 * version the default, rather than the one the
503 * device has as the default?
505 if (linktypes[i] == deflt)
506 linktype_list = g_list_prepend(linktype_list,
509 linktype_list = g_list_append(linktype_list,
512 #ifdef HAVE_PCAP_FREE_DATALINKS
513 pcap_free_datalinks(linktypes);
516 * In Windows, there's no guarantee that if you have a library
517 * built with one version of the MSVC++ run-time library, and
518 * it returns a pointer to allocated data, you can free that
519 * data from a program linked with another version of the
520 * MSVC++ run-time library.
522 * This is not an issue on UN*X.
524 * See the mail threads starting at
526 * http://www.winpcap.org/pipermail/winpcap-users/2006-September/001421.html
530 * http://www.winpcap.org/pipermail/winpcap-users/2008-May/002498.html
533 #define xx_free free /* hack so checkAPIs doesn't complain */
536 #endif /* HAVE_PCAP_FREE_DATALINKS */
537 #else /* HAVE_PCAP_LIST_DATALINKS */
538 data_link_info = create_data_link_info(deflt);
539 linktype_list = g_list_append(linktype_list, data_link_info);
540 #endif /* HAVE_PCAP_LIST_DATALINKS */
543 return linktype_list;
547 free_linktype_cb(gpointer data, gpointer user_data _U_)
549 data_link_info_t *linktype_info = data;
551 g_free(linktype_info->name);
552 g_free(linktype_info->description);
556 free_pcap_linktype_list(GList *linktype_list)
558 g_list_foreach(linktype_list, free_linktype_cb, NULL);
559 g_list_free(linktype_list);
563 linktype_val_to_name(int dlt)
565 return pcap_datalink_val_to_name(dlt);
568 int linktype_name_to_val(const char *linktype)
570 return pcap_datalink_name_to_val(linktype);
573 #endif /* HAVE_LIBPCAP */