Coverage Report

Created: 2026-03-21 06:50

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/libpcap/fad-getad.c
Line
Count
Source
1
/* -*- Mode: c; tab-width: 8; indent-tabs-mode: 1; c-basic-offset: 8; -*- */
2
/*
3
 * Copyright (c) 1994, 1995, 1996, 1997, 1998
4
 *  The Regents of the University of California.  All rights reserved.
5
 *
6
 * Redistribution and use in source and binary forms, with or without
7
 * modification, are permitted provided that the following conditions
8
 * are met:
9
 * 1. Redistributions of source code must retain the above copyright
10
 *    notice, this list of conditions and the following disclaimer.
11
 * 2. Redistributions in binary form must reproduce the above copyright
12
 *    notice, this list of conditions and the following disclaimer in the
13
 *    documentation and/or other materials provided with the distribution.
14
 * 3. All advertising materials mentioning features or use of this software
15
 *    must display the following acknowledgement:
16
 *  This product includes software developed by the Computer Systems
17
 *  Engineering Group at Lawrence Berkeley Laboratory.
18
 * 4. Neither the name of the University nor of the Laboratory may be used
19
 *    to endorse or promote products derived from this software without
20
 *    specific prior written permission.
21
 *
22
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32
 * SUCH DAMAGE.
33
 */
34
35
#include <config.h>
36
37
#include <sys/types.h>
38
#include <sys/socket.h>
39
#include <netinet/in.h>
40
41
#include <net/if.h>
42
43
#include <errno.h>
44
#include <stdio.h>
45
#include <stdlib.h>
46
#include <string.h>
47
#include <ifaddrs.h>
48
49
#include "pcap-int.h"
50
51
#ifdef HAVE_OS_PROTO_H
52
#include "os-proto.h"
53
#endif
54
55
/*
56
 * We don't do this on Solaris 11 and later, as it appears there aren't
57
 * any AF_PACKET addresses on interfaces, so we don't need this, and
58
 * we end up including both the OS's <net/bpf.h> and our <pcap/bpf.h>,
59
 * and their definitions of some data structures collide.
60
 */
61
#ifdef __linux__
62
#include <netpacket/packet.h>
63
#endif
64
65
/*
66
 * This is fun.
67
 *
68
 * In older BSD systems, socket addresses were fixed-length, and
69
 * "sizeof (struct sockaddr)" gave the size of the structure.
70
 * All addresses fit within a "struct sockaddr".
71
 *
72
 * In newer BSD systems, the socket address is variable-length, and
73
 * there's an "sa_len" field giving the length of the structure;
74
 * this allows socket addresses to be longer than 2 bytes of family
75
 * and 14 bytes of data.
76
 *
77
 * Some commercial UNIXes use the old BSD scheme, some use the RFC 2553
78
 * variant of the old BSD scheme (with "struct sockaddr_storage" rather
79
 * than "struct sockaddr"), and some use the new BSD scheme.
80
 *
81
 * Some versions of GNU libc use neither scheme, but has an "SA_LEN()"
82
 * macro that determines the size based on the address family.  Other
83
 * versions don't have "SA_LEN()" (as it was in drafts of RFC 2553
84
 * but not in the final version).  On the latter systems, we explicitly
85
 * check the AF_ type to determine the length; we assume that on
86
 * all those systems we have "struct sockaddr_storage".
87
 *
88
 * OSes that use this file are:
89
 * - FreeBSD (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
90
 * - Haiku (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
91
 * - Hurd (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
92
 * - illumos (HAVE_STRUCT_SOCKADDR_SA_LEN is not defined)
93
 * - Linux (HAVE_STRUCT_SOCKADDR_SA_LEN is not defined)
94
 * - macOS (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
95
 * - NetBSD (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
96
 * - OpenBSD (SA_LEN() is defined)
97
 * - Solaris 11 (HAVE_STRUCT_SOCKADDR_SA_LEN is not defined)
98
 */
99
#ifndef SA_LEN
100
#ifdef HAVE_STRUCT_SOCKADDR_SA_LEN
101
#define SA_LEN(addr)  ((addr)->sa_len)
102
#else /* HAVE_STRUCT_SOCKADDR_SA_LEN */
103
static size_t
104
get_sa_len(struct sockaddr *addr)
105
0
{
106
0
  switch (addr->sa_family) {
107
108
0
  case AF_INET:
109
0
    return (sizeof (struct sockaddr_in));
110
111
0
  case AF_INET6:
112
0
    return (sizeof (struct sockaddr_in6));
113
114
0
#if defined(__linux__)
115
0
  case AF_PACKET:
116
0
    return (sizeof (struct sockaddr_ll));
117
0
#endif
118
119
#ifdef AF_LINK
120
  case AF_LINK:
121
    return (sizeof (struct sockaddr_dl));
122
#endif
123
124
0
  default:
125
0
    return (sizeof (struct sockaddr));
126
0
  }
127
0
}
128
0
#define SA_LEN(addr)  (get_sa_len(addr))
129
#endif /* HAVE_STRUCT_SOCKADDR_SA_LEN */
130
#endif /* SA_LEN */
131
132
/*
133
 * Get a list of all interfaces that are up and that we can open.
134
 * Returns -1 on error, 0 otherwise.
135
 * The list, as returned through "alldevsp", may be null if no interfaces
136
 * could be opened.
137
 */
138
int
139
pcapint_findalldevs_interfaces(pcap_if_list_t *devlistp, char *errbuf,
140
    int (*check_usable)(const char *), get_if_flags_func get_flags_func)
141
0
{
142
0
  struct ifaddrs *ifap, *ifa;
143
0
  struct sockaddr *addr, *netmask, *broadaddr, *dstaddr;
144
0
  size_t addr_size, netmask_size, broadaddr_size, dstaddr_size;
145
0
  int ret = 0;
146
0
  char *p, *q;
147
148
  /*
149
   * Get the list of interface addresses.
150
   *
151
   * Note: this won't return information about interfaces
152
   * with no addresses, so, if a platform has interfaces
153
   * with no interfaces on which traffic can be captured,
154
   * we must check for those interfaces as well (see, for
155
   * example, what's done on Linux).
156
   *
157
   * LAN interfaces will probably have link-layer
158
   * addresses; I don't know whether all implementations
159
   * of "getifaddrs()" now, or in the future, will return
160
   * those.
161
   */
162
0
  if (getifaddrs(&ifap) != 0) {
163
0
    pcapint_fmt_errmsg_for_errno(errbuf, PCAP_ERRBUF_SIZE,
164
0
        errno, "getifaddrs");
165
0
    return (-1);
166
0
  }
167
0
  for (ifa = ifap; ifa != NULL; ifa = ifa->ifa_next) {
168
    /*
169
     * If this entry has a colon followed by a number at
170
     * the end, we assume it's a logical interface.  Those
171
     * are just the way you assign multiple IP addresses to
172
     * a real interface on Linux, so an entry for a logical
173
     * interface should be treated like the entry for the
174
     * real interface; we do that by stripping off the ":"
175
     * and the number.
176
     *
177
     * XXX - should we do this only on Linux?
178
     */
179
0
    p = strchr(ifa->ifa_name, ':');
180
0
    if (p != NULL) {
181
      /*
182
       * We have a ":"; is it followed by a number?
183
       */
184
0
      q = p + 1;
185
0
      while (PCAP_ISDIGIT(*q))
186
0
        q++;
187
0
      if (*q == '\0') {
188
        /*
189
         * All digits after the ":" until the end.
190
         * Strip off the ":" and everything after
191
         * it.
192
         */
193
0
             *p = '\0';
194
0
      }
195
0
    }
196
197
    /*
198
     * Can we capture on this device?
199
     */
200
0
    if (!(*check_usable)(ifa->ifa_name)) {
201
      /*
202
       * No.
203
       */
204
0
      continue;
205
0
    }
206
207
    /*
208
     * "ifa_addr" was apparently null on at least one
209
     * interface on some system.  Therefore, we supply
210
     * the address and netmask only if "ifa_addr" is
211
     * non-null (if there's no address, there's obviously
212
     * no netmask).
213
     */
214
0
    if (ifa->ifa_addr != NULL) {
215
0
      addr = ifa->ifa_addr;
216
0
      addr_size = SA_LEN(addr);
217
0
      if (ifa->ifa_netmask != NULL) {
218
0
        netmask = ifa->ifa_netmask;
219
0
        netmask_size = SA_LEN(ifa->ifa_netmask);
220
0
      } else {
221
0
        netmask = NULL;
222
0
        netmask_size = 0;
223
0
      }
224
0
    } else {
225
0
      addr = NULL;
226
0
      addr_size = 0;
227
0
      netmask = NULL;
228
0
      netmask_size = 0;
229
0
    }
230
231
    /*
232
     * Note that, on some platforms, ifa_broadaddr and
233
     * ifa_dstaddr could be the same field (true on at
234
     * least some versions of *BSD and macOS), so we
235
     * can't just check whether the broadcast address
236
     * is null and add it if so and check whether the
237
     * destination address is null and add it if so.
238
     *
239
     * Therefore, we must also check the IFF_BROADCAST
240
     * flag, and only add a broadcast address if it's
241
     * set, and check the IFF_POINTTOPOINT flag, and
242
     * only add a destination address if it's set (as
243
     * per man page recommendations on some of those
244
     * platforms).
245
     */
246
0
    if (ifa->ifa_flags & IFF_BROADCAST &&
247
0
        ifa->ifa_broadaddr != NULL) {
248
0
      broadaddr = ifa->ifa_broadaddr;
249
0
      broadaddr_size = SA_LEN(broadaddr);
250
0
    } else {
251
0
      broadaddr = NULL;
252
0
      broadaddr_size = 0;
253
0
    }
254
0
    if (ifa->ifa_flags & IFF_POINTOPOINT &&
255
0
        ifa->ifa_dstaddr != NULL) {
256
0
      dstaddr = ifa->ifa_dstaddr;
257
0
      dstaddr_size = SA_LEN(ifa->ifa_dstaddr);
258
0
    } else {
259
0
      dstaddr = NULL;
260
0
      dstaddr_size = 0;
261
0
    }
262
263
    /*
264
     * Add information for this address to the list.
265
     */
266
0
    if (pcapint_add_addr_to_if(devlistp, ifa->ifa_name, ifa->ifa_flags,
267
0
        get_flags_func,
268
0
        addr, addr_size, netmask, netmask_size,
269
0
        broadaddr, broadaddr_size, dstaddr, dstaddr_size,
270
0
        errbuf) < 0) {
271
0
      ret = -1;
272
0
      break;
273
0
    }
274
0
  }
275
276
0
  freeifaddrs(ifap);
277
278
0
  return (ret);
279
0
}