capture-pcap-util.c

   1 /* capture-pcap-util.c
   2  * Utility routines for packet capture
   3  *
   4  * $Id$
   5  *
   6  * Wireshark - Network traffic analyzer
   7  * By Gerald Combs <gerald@wireshark.org>
   8  * 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 #ifdef HAVE_CONFIG_H
  26 # include "config.h"
  27 #endif
  28
  29 #ifdef HAVE_LIBPCAP
  30
  31 #include <glib.h>
  32
  33 #include <stdlib.h>
  34 #include <stdio.h>
  35 #include <limits.h>
  36 #include <string.h>
  37
  38 #include <pcap.h>
  39
  40 #ifdef HAVE_SYS_TYPES_H
  41 # include <sys/types.h>
  42 #endif
  43
  44 #ifdef HAVE_SYS_SOCKET_H
  45 #include <sys/socket.h>
  46 #endif
  47
  48 #include <wtap.h>
  49 #include <libpcap.h>
  50
  51 #include "capture-pcap-util.h"
  52 #include "capture-pcap-util-int.h"
  53
  54 #ifndef _WIN32
  55 #include <netinet/in.h>
  56 #endif
  57
  58
  59 /*
  60  * Get the data-link type for a libpcap device.
  61  * This works around AIX 5.x's non-standard and incompatible-with-the-
  62  * rest-of-the-universe libpcap.
  63  */
  64 int
  65 get_pcap_linktype(pcap_t *pch, const char *devname
  66 #ifndef _AIX
  67         _U_
  68 #endif
  69 )
  70 {
  71         int linktype;
  72 #ifdef _AIX
  73         const char *ifacename;
  74 #endif
  75
  76         linktype = pcap_datalink(pch);
  77 #ifdef _AIX
  78
  79         /*
  80          * The libpcap that comes with AIX 5.x uses RFC 1573 ifType values
  81          * rather than DLT_ values for link-layer types; the ifType values
  82          * for LAN devices are:
  83          *
  84          *      Ethernet        6
  85          *      802.3           7
  86          *      Token Ring      9
  87          *      FDDI            15
  88          *
  89          * and the ifType value for a loopback device is 24.
  90          *
  91          * The AIX names for LAN devices begin with:
  92          *
  93          *      Ethernet                en
  94          *      802.3                   et
  95          *      Token Ring              tr
  96          *      FDDI                    fi
  97          *
  98          * and the AIX names for loopback devices begin with "lo".
  99          *
 100          * (The difference between "Ethernet" and "802.3" is presumably
 101          * whether packets have an Ethernet header, with a packet type,
 102          * or an 802.3 header, with a packet length, followed by an 802.2
 103          * header and possibly a SNAP header.)
 104          *
 105          * If the device name matches "linktype" interpreted as an ifType
 106          * value, rather than as a DLT_ value, we will assume this is AIX's
 107          * non-standard, incompatible libpcap, rather than a standard libpcap,
 108          * and will map the link-layer type to the standard DLT_ value for
 109          * that link-layer type, as that's what the rest of Wireshark expects.
 110          *
 111          * (This means the capture files won't be readable by a tcpdump
 112          * linked with AIX's non-standard libpcap, but so it goes.  They
 113          * *will* be readable by standard versions of tcpdump, Wireshark,
 114          * and so on.)
 115          *
 116          * XXX - if we conclude we're using AIX libpcap, should we also
 117          * set a flag to cause us to assume the time stamps are in
 118          * seconds-and-nanoseconds form, and to convert them to
 119          * seconds-and-microseconds form before processing them and
 120          * writing them out?
 121          */
 122
 123         /*
 124          * Find the last component of the device name, which is the
 125          * interface name.
 126          */
 127         ifacename = strchr(devname, '/');
 128         if (ifacename == NULL)
 129                 ifacename = devname;
 130
 131         /* See if it matches any of the LAN device names. */
 132         if (strncmp(ifacename, "en", 2) == 0) {
 133                 if (linktype == 6) {
 134                         /*
 135                          * That's the RFC 1573 value for Ethernet; map it
 136                          * to DLT_EN10MB.
 137                          */
 138                         linktype = 1;
 139                 }
 140         } else if (strncmp(ifacename, "et", 2) == 0) {
 141                 if (linktype == 7) {
 142                         /*
 143                          * That's the RFC 1573 value for 802.3; map it to
 144                          * DLT_EN10MB.
 145                          * (libpcap, tcpdump, Wireshark, etc. don't care if
 146                          * it's Ethernet or 802.3.)
 147                          */
 148                         linktype = 1;
 149                 }
 150         } else if (strncmp(ifacename, "tr", 2) == 0) {
 151                 if (linktype == 9) {
 152                         /*
 153                          * That's the RFC 1573 value for 802.5 (Token Ring);
 154                          * map it to DLT_IEEE802, which is what's used for
 155                          * Token Ring.
 156                          */
 157                         linktype = 6;
 158                 }
 159         } else if (strncmp(ifacename, "fi", 2) == 0) {
 160                 if (linktype == 15) {
 161                         /*
 162                          * That's the RFC 1573 value for FDDI; map it to
 163                          * DLT_FDDI.
 164                          */
 165                         linktype = 10;
 166                 }
 167         } else if (strncmp(ifacename, "lo", 2) == 0) {
 168                 if (linktype == 24) {
 169                         /*
 170                          * That's the RFC 1573 value for "software loopback"
 171                          * devices; map it to DLT_NULL, which is what's used
 172                          * for loopback devices on BSD.
 173                          */
 174                         linktype = 0;
 175                 }
 176         }
 177 #endif
 178
 179         return linktype;
 180 }
 181
 182 if_info_t *
 183 if_info_new(char *name, char *description)
 184 {
 185         if_info_t *if_info;
 186
 187         if_info = g_malloc(sizeof (if_info_t));
 188         if_info->name = g_strdup(name);
 189         if (description == NULL)
 190                 if_info->description = NULL;
 191         else
 192                 if_info->description = g_strdup(description);
 193         if_info->ip_addr = NULL;
 194         if_info->loopback = FALSE;
 195         return if_info;
 196 }
 197
 198 void
 199 if_info_add_address(if_info_t *if_info, struct sockaddr *addr)
 200 {
 201         if_addr_t *ip_addr;
 202         struct sockaddr_in *ai;
 203 #ifdef INET6
 204         struct sockaddr_in6 *ai6;
 205 #endif
 206
 207         switch (addr->sa_family) {
 208
 209         case AF_INET:
 210                 ai = (struct sockaddr_in *)addr;
 211                 ip_addr = g_malloc(sizeof(*ip_addr));
 212                 ip_addr->type = AT_IPv4;
 213                 ip_addr->ip_addr.ip4_addr =
 214                     *((guint32 *)&(ai->sin_addr.s_addr));
 215                 if_info->ip_addr = g_slist_append(if_info->ip_addr, ip_addr);
 216                 break;
 217
 218 #ifdef INET6
 219         case AF_INET6:
 220                 ai6 = (struct sockaddr_in6 *)addr;
 221                 ip_addr = g_malloc(sizeof(*ip_addr));
 222                 ip_addr->type = AT_IPv6;
 223                 memcpy((void *)&ip_addr->ip_addr.ip6_addr,
 224                     (void *)&ai6->sin6_addr.s6_addr,
 225                     sizeof ip_addr->ip_addr.ip6_addr);
 226                 if_info->ip_addr = g_slist_append(if_info->ip_addr, ip_addr);
 227                 break;
 228 #endif
 229         }
 230 }
 231
 232 #ifdef HAVE_PCAP_FINDALLDEVS
 233 /*
 234  * Get all IP address information, and the loopback flag, for the given
 235  * interface.
 236  */
 237 static void
 238 if_info_ip(if_info_t *if_info, pcap_if_t *d)
 239 {
 240         pcap_addr_t *a;
 241
 242         /* Loopback flag */
 243         if_info->loopback = (d->flags & PCAP_IF_LOOPBACK) ? TRUE : FALSE;
 244
 245         /* All addresses */
 246         for (a = d->addresses; a != NULL; a = a->next) {
 247                 if (a->addr != NULL)
 248                         if_info_add_address(if_info, a->addr);
 249         }
 250 }
 251
 252 #ifdef HAVE_PCAP_REMOTE
 253 GList *
 254 get_interface_list_findalldevs_ex(const char *source,
 255                                   struct pcap_rmtauth *auth,
 256                                   int *err, char **err_str)
 257 #else
 258 GList *
 259 get_interface_list_findalldevs(int *err, char **err_str)
 260 #endif
 261 {
 262         GList  *il = NULL;
 263         pcap_if_t *alldevs, *dev;
 264         if_info_t *if_info;
 265         char errbuf[PCAP_ERRBUF_SIZE];
 266
 267 #ifdef HAVE_PCAP_REMOTE
 268     if (pcap_findalldevs_ex((char *)source, auth, &alldevs, errbuf) == -1) {
 269 #else
 270         if (pcap_findalldevs(&alldevs, errbuf) == -1) {
 271 #endif
 272                 *err = CANT_GET_INTERFACE_LIST;
 273                 if (err_str != NULL)
 274                         *err_str = cant_get_if_list_error_message(errbuf);
 275                 return NULL;
 276         }
 277
 278         if (alldevs == NULL) {
 279                 /*
 280                  * No interfaces found.
 281                  */
 282                 *err = NO_INTERFACES_FOUND;
 283                 if (err_str != NULL)
 284                         *err_str = NULL;
 285                 return NULL;
 286         }
 287
 288         for (dev = alldevs; dev != NULL; dev = dev->next) {
 289                 if_info = if_info_new(dev->name, dev->description);
 290                 il = g_list_append(il, if_info);
 291                 if_info_ip(if_info, dev);
 292         }
 293         pcap_freealldevs(alldevs);
 294
 295         return il;
 296 }
 297 #endif /* HAVE_PCAP_FINDALLDEVS */
 298
 299 static void
 300 free_if_info_addr_cb(gpointer addr, gpointer user_data _U_)
 301 {
 302         g_free(addr);
 303 }
 304
 305 static void
 306 free_if_cb(gpointer data, gpointer user_data _U_)
 307 {
 308         if_info_t *if_info = data;
 309
 310         g_free(if_info->name);
 311         if (if_info->description != NULL)
 312                 g_free(if_info->description);
 313
 314         g_slist_foreach(if_info->ip_addr, free_if_info_addr_cb, NULL);
 315         g_slist_free(if_info->ip_addr);
 316         g_free(if_info);
 317 }
 318
 319 void
 320 free_interface_list(GList *if_list)
 321 {
 322         g_list_foreach(if_list, free_if_cb, NULL);
 323         g_list_free(if_list);
 324 }
 325
 326 /*
 327  * Get the data-link types available for a libpcap device.
 328  */
 329 static data_link_info_t *
 330 create_data_link_info(int dlt)
 331 {
 332         data_link_info_t *data_link_info;
 333 #ifdef HAVE_PCAP_DATALINK_VAL_TO_NAME
 334         const char *typename;
 335 #endif
 336         int wtap_encap;
 337
 338         data_link_info = g_malloc(sizeof (data_link_info_t));
 339         data_link_info->dlt = dlt;
 340 #ifdef HAVE_PCAP_DATALINK_VAL_TO_NAME
 341         typename = pcap_datalink_val_to_name(dlt);
 342         if (typename != NULL)
 343                 data_link_info->name = g_strdup(typename);
 344         else
 345 #endif
 346                 data_link_info->name = g_strdup_printf("DLT %d", dlt);
 347         wtap_encap = wtap_pcap_encap_to_wtap_encap(dlt);
 348         if (wtap_encap == WTAP_ENCAP_UNKNOWN) {
 349                 /*
 350                  * We don't support this in Wiretap.
 351                  * However, we should, so you can capture on it.
 352                  * Put in an entry for it, with no description.
 353                  */
 354                 data_link_info->description = NULL;
 355         } else {
 356                 /*
 357                  * If this is null, that's a bug in
 358                  * "wtap_pcap_encap_to_wtap_encap()" - it should always
 359                  * return a valid encapsulation type - so we assume it's
 360                  * not null.
 361                  */
 362                 data_link_info->description =
 363                     g_strdup(wtap_encap_string(wtap_encap));
 364         }
 365         return data_link_info;
 366 }
 367
 368 GList *
 369 get_pcap_linktype_list(const char *devname, char **err_str)
 370 {
 371         GList *linktype_list = NULL;
 372         pcap_t *pch;
 373         int deflt;
 374         char errbuf[PCAP_ERRBUF_SIZE];
 375 #ifdef HAVE_PCAP_LIST_DATALINKS
 376         int *linktypes;
 377         int i, nlt;
 378 #endif
 379         data_link_info_t *data_link_info;
 380
 381 #ifdef HAVE_PCAP_OPEN
 382         pch = pcap_open(devname, MIN_PACKET_SIZE, 0, 0, NULL, errbuf);
 383 #else
 384         pch = pcap_open_live(devname, MIN_PACKET_SIZE, 0, 0, errbuf);
 385 #endif
 386         if (pch == NULL) {
 387                 if (err_str != NULL)
 388                         *err_str = g_strdup(errbuf);
 389                 return NULL;
 390         }
 391         deflt = get_pcap_linktype(pch, devname);
 392 #ifdef HAVE_PCAP_LIST_DATALINKS
 393         nlt = pcap_list_datalinks(pch, &linktypes);
 394         if (nlt == 0 || linktypes == NULL) {
 395                 pcap_close(pch);
 396                 if (err_str != NULL)
 397                         *err_str = NULL;        /* an empty list doesn't mean an error */
 398                 return NULL;
 399         }
 400         for (i = 0; i < nlt; i++) {
 401                 data_link_info = create_data_link_info(linktypes[i]);
 402
 403                 /*
 404                  * XXX - for 802.11, make the most detailed 802.11
 405                  * version the default, rather than the one the
 406                  * device has as the default?
 407                  */
 408                 if (linktypes[i] == deflt)
 409                         linktype_list = g_list_prepend(linktype_list,
 410                             data_link_info);
 411                 else
 412                         linktype_list = g_list_append(linktype_list,
 413                             data_link_info);
 414         }
 415 #ifdef HAVE_PCAP_FREE_DATALINKS
 416         pcap_free_datalinks(linktypes);
 417 #else
 418         /*
 419          * In Windows, there's no guarantee that if you have a library
 420          * built with one version of the MSVC++ run-time library, and
 421          * it returns a pointer to allocated data, you can free that
 422          * data from a program linked with another version of the
 423          * MSVC++ run-time library.
 424          *
 425          * This is not an issue on UN*X.
 426          *
 427          * See the mail threads starting at
 428          *
 429          *      http://www.winpcap.org/pipermail/winpcap-users/2006-September/001421.html
 430          *
 431          * and
 432          *
 433          *      http://www.winpcap.org/pipermail/winpcap-users/2008-May/002498.html
 434          */
 435 #ifndef _WIN32
 436         free(linktypes);
 437 #endif /* _WIN32 */
 438 #endif /* HAVE_PCAP_FREE_DATALINKS */
 439 #else /* HAVE_PCAP_LIST_DATALINKS */
 440         data_link_info = create_data_link_info(deflt);
 441         linktype_list = g_list_append(linktype_list, data_link_info);
 442 #endif /* HAVE_PCAP_LIST_DATALINKS */
 443
 444         pcap_close(pch);
 445         return linktype_list;
 446 }
 447
 448 static void
 449 free_linktype_cb(gpointer data, gpointer user_data _U_)
 450 {
 451         data_link_info_t *linktype_info = data;
 452
 453         g_free(linktype_info->name);
 454         if (linktype_info->description != NULL)
 455                 g_free(linktype_info->description);
 456 }
 457
 458 void
 459 free_pcap_linktype_list(GList *linktype_list)
 460 {
 461         g_list_foreach(linktype_list, free_linktype_cb, NULL);
 462         g_list_free(linktype_list);
 463 }
 464
 465 /* Set the data link type on a pcap. */
 466 const char *
 467 set_pcap_linktype(pcap_t *pch, char *devname
 468 #ifdef HAVE_PCAP_SET_DATALINK
 469         _U_
 470 #endif
 471         , int dlt)
 472 {
 473 #ifdef HAVE_PCAP_SET_DATALINK
 474         if (pcap_set_datalink(pch, dlt) == 0)
 475                 return NULL;    /* no error */
 476         return pcap_geterr(pch);
 477 #else
 478         /* Let them set it to the type it is; reject any other request. */
 479         if (get_pcap_linktype(pch, devname) == dlt)
 480                 return NULL;    /* no error */
 481         return "That DLT isn't one of the DLTs supported by this device";
 482 #endif
 483 }
 484
 485
 486 #ifdef HAVE_PCAP_DATALINK_VAL_TO_NAME
 487 const char *
 488 linktype_val_to_name(int dlt)
 489 {
 490     return pcap_datalink_val_to_name(dlt);
 491 }
 492 #endif
 493
 494 #ifdef HAVE_PCAP_DATALINK_NAME_TO_VAL
 495 int linktype_name_to_val(const char *linktype)
 496 {
 497     return pcap_datalink_name_to_val(linktype);
 498 }
 499 #endif
 500
 501 #endif /* HAVE_LIBPCAP */