1 /* -*- Mode: c; tab-width: 8; indent-tabs-mode: 1; c-basic-offset: 8; -*- */
3 * Copyright (c) 1994, 1995, 1996, 1997, 1998
4 * The Regents of the University of California. All rights reserved.
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
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.
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
37 #include <sys/types.h>
38 #include <sys/socket.h>
39 #include <netinet/in.h>
51 #ifdef HAVE_OS_PROTO_H
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.
61 #if defined(__linux__) && defined(AF_PACKET)
62 # ifdef HAVE_NETPACKET_PACKET_H
63 /* Linux distributions with newer glibc */
64 # include <netpacket/packet.h>
65 # else /* HAVE_NETPACKET_PACKET_H */
66 /* Linux distributions with older glibc */
67 # include <linux/types.h>
68 # include <linux/if_packet.h>
69 # endif /* HAVE_NETPACKET_PACKET_H */
70 #endif /* defined(__linux__) && defined(AF_PACKET) */
75 * In older BSD systems, socket addresses were fixed-length, and
76 * "sizeof (struct sockaddr)" gave the size of the structure.
77 * All addresses fit within a "struct sockaddr".
79 * In newer BSD systems, the socket address is variable-length, and
80 * there's an "sa_len" field giving the length of the structure;
81 * this allows socket addresses to be longer than 2 bytes of family
82 * and 14 bytes of data.
84 * Some commercial UNIXes use the old BSD scheme, some use the RFC 2553
85 * variant of the old BSD scheme (with "struct sockaddr_storage" rather
86 * than "struct sockaddr"), and some use the new BSD scheme.
88 * Some versions of GNU libc use neither scheme, but has an "SA_LEN()"
89 * macro that determines the size based on the address family. Other
90 * versions don't have "SA_LEN()" (as it was in drafts of RFC 2553
91 * but not in the final version). On the latter systems, we explicitly
92 * check the AF_ type to determine the length; we assume that on
93 * all those systems we have "struct sockaddr_storage".
95 * OSes that use this file are:
96 * - FreeBSD (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
97 * - Haiku (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
98 * - Hurd (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
99 * - illumos (HAVE_STRUCT_SOCKADDR_SA_LEN is not defined)
100 * - Linux (HAVE_STRUCT_SOCKADDR_SA_LEN is not defined)
101 * - macOS (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
102 * - NetBSD (HAVE_STRUCT_SOCKADDR_SA_LEN is defined)
103 * - OpenBSD (SA_LEN() is defined)
104 * - Solaris 11 (HAVE_STRUCT_SOCKADDR_SA_LEN is not defined)
107 #ifdef HAVE_STRUCT_SOCKADDR_SA_LEN
108 #define SA_LEN(addr) ((addr)->sa_len)
109 #else /* HAVE_STRUCT_SOCKADDR_SA_LEN */
111 get_sa_len(struct sockaddr
*addr
)
113 switch (addr
->sa_family
) {
117 return (sizeof (struct sockaddr_in
));
122 return (sizeof (struct sockaddr_in6
));
125 #if defined(__linux__) && defined(AF_PACKET)
127 return (sizeof (struct sockaddr_ll
));
132 return (sizeof (struct sockaddr_dl
));
136 return (sizeof (struct sockaddr
));
139 #define SA_LEN(addr) (get_sa_len(addr))
140 #endif /* HAVE_STRUCT_SOCKADDR_SA_LEN */
144 * Get a list of all interfaces that are up and that we can open.
145 * Returns -1 on error, 0 otherwise.
146 * The list, as returned through "alldevsp", may be null if no interfaces
150 pcapint_findalldevs_interfaces(pcap_if_list_t
*devlistp
, char *errbuf
,
151 int (*check_usable
)(const char *), get_if_flags_func get_flags_func
)
153 struct ifaddrs
*ifap
, *ifa
;
154 struct sockaddr
*addr
, *netmask
, *broadaddr
, *dstaddr
;
155 size_t addr_size
, broadaddr_size
, dstaddr_size
;
160 * Get the list of interface addresses.
162 * Note: this won't return information about interfaces
163 * with no addresses, so, if a platform has interfaces
164 * with no interfaces on which traffic can be captured,
165 * we must check for those interfaces as well (see, for
166 * example, what's done on Linux).
168 * LAN interfaces will probably have link-layer
169 * addresses; I don't know whether all implementations
170 * of "getifaddrs()" now, or in the future, will return
173 if (getifaddrs(&ifap
) != 0) {
174 pcapint_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
175 errno
, "getifaddrs");
178 for (ifa
= ifap
; ifa
!= NULL
; ifa
= ifa
->ifa_next
) {
180 * If this entry has a colon followed by a number at
181 * the end, we assume it's a logical interface. Those
182 * are just the way you assign multiple IP addresses to
183 * a real interface on Linux, so an entry for a logical
184 * interface should be treated like the entry for the
185 * real interface; we do that by stripping off the ":"
188 * XXX - should we do this only on Linux?
190 p
= strchr(ifa
->ifa_name
, ':');
193 * We have a ":"; is it followed by a number?
196 while (PCAP_ISDIGIT(*q
))
200 * All digits after the ":" until the end.
201 * Strip off the ":" and everything after
209 * Can we capture on this device?
211 if (!(*check_usable
)(ifa
->ifa_name
)) {
219 * "ifa_addr" was apparently null on at least one
220 * interface on some system. Therefore, we supply
221 * the address and netmask only if "ifa_addr" is
222 * non-null (if there's no address, there's obviously
225 if (ifa
->ifa_addr
!= NULL
) {
226 addr
= ifa
->ifa_addr
;
227 addr_size
= SA_LEN(addr
);
228 netmask
= ifa
->ifa_netmask
;
236 * Note that, on some platforms, ifa_broadaddr and
237 * ifa_dstaddr could be the same field (true on at
238 * least some versions of *BSD and macOS), so we
239 * can't just check whether the broadcast address
240 * is null and add it if so and check whether the
241 * destination address is null and add it if so.
243 * Therefore, we must also check the IFF_BROADCAST
244 * flag, and only add a broadcast address if it's
245 * set, and check the IFF_POINTTOPOINT flag, and
246 * only add a destination address if it's set (as
247 * per man page recommendations on some of those
250 if (ifa
->ifa_flags
& IFF_BROADCAST
&&
251 ifa
->ifa_broadaddr
!= NULL
) {
252 broadaddr
= ifa
->ifa_broadaddr
;
253 broadaddr_size
= SA_LEN(broadaddr
);
258 if (ifa
->ifa_flags
& IFF_POINTOPOINT
&&
259 ifa
->ifa_dstaddr
!= NULL
) {
260 dstaddr
= ifa
->ifa_dstaddr
;
261 dstaddr_size
= SA_LEN(ifa
->ifa_dstaddr
);
268 * Add information for this address to the list.
270 if (pcapint_add_addr_to_if(devlistp
, ifa
->ifa_name
, ifa
->ifa_flags
,
272 addr
, addr_size
, netmask
, addr_size
,
273 broadaddr
, broadaddr_size
, dstaddr
, dstaddr_size
,