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.
62 #include <netpacket/packet.h>
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".
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.
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.
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".
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)
100 #ifdef HAVE_STRUCT_SOCKADDR_SA_LEN
101 #define SA_LEN(addr) ((addr)->sa_len)
102 #else /* HAVE_STRUCT_SOCKADDR_SA_LEN */
104 get_sa_len(struct sockaddr
*addr
)
106 switch (addr
->sa_family
) {
110 return (sizeof (struct sockaddr_in
));
115 return (sizeof (struct sockaddr_in6
));
118 #if defined(__linux__)
120 return (sizeof (struct sockaddr_ll
));
125 return (sizeof (struct sockaddr_dl
));
129 return (sizeof (struct sockaddr
));
132 #define SA_LEN(addr) (get_sa_len(addr))
133 #endif /* HAVE_STRUCT_SOCKADDR_SA_LEN */
137 * Get a list of all interfaces that are up and that we can open.
138 * Returns -1 on error, 0 otherwise.
139 * The list, as returned through "alldevsp", may be null if no interfaces
143 pcapint_findalldevs_interfaces(pcap_if_list_t
*devlistp
, char *errbuf
,
144 int (*check_usable
)(const char *), get_if_flags_func get_flags_func
)
146 struct ifaddrs
*ifap
, *ifa
;
147 struct sockaddr
*addr
, *netmask
, *broadaddr
, *dstaddr
;
148 size_t addr_size
, broadaddr_size
, dstaddr_size
;
153 * Get the list of interface addresses.
155 * Note: this won't return information about interfaces
156 * with no addresses, so, if a platform has interfaces
157 * with no interfaces on which traffic can be captured,
158 * we must check for those interfaces as well (see, for
159 * example, what's done on Linux).
161 * LAN interfaces will probably have link-layer
162 * addresses; I don't know whether all implementations
163 * of "getifaddrs()" now, or in the future, will return
166 if (getifaddrs(&ifap
) != 0) {
167 pcapint_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
168 errno
, "getifaddrs");
171 for (ifa
= ifap
; ifa
!= NULL
; ifa
= ifa
->ifa_next
) {
173 * If this entry has a colon followed by a number at
174 * the end, we assume it's a logical interface. Those
175 * are just the way you assign multiple IP addresses to
176 * a real interface on Linux, so an entry for a logical
177 * interface should be treated like the entry for the
178 * real interface; we do that by stripping off the ":"
181 * XXX - should we do this only on Linux?
183 p
= strchr(ifa
->ifa_name
, ':');
186 * We have a ":"; is it followed by a number?
189 while (PCAP_ISDIGIT(*q
))
193 * All digits after the ":" until the end.
194 * Strip off the ":" and everything after
202 * Can we capture on this device?
204 if (!(*check_usable
)(ifa
->ifa_name
)) {
212 * "ifa_addr" was apparently null on at least one
213 * interface on some system. Therefore, we supply
214 * the address and netmask only if "ifa_addr" is
215 * non-null (if there's no address, there's obviously
218 if (ifa
->ifa_addr
!= NULL
) {
219 addr
= ifa
->ifa_addr
;
220 addr_size
= SA_LEN(addr
);
221 netmask
= ifa
->ifa_netmask
;
229 * Note that, on some platforms, ifa_broadaddr and
230 * ifa_dstaddr could be the same field (true on at
231 * least some versions of *BSD and macOS), so we
232 * can't just check whether the broadcast address
233 * is null and add it if so and check whether the
234 * destination address is null and add it if so.
236 * Therefore, we must also check the IFF_BROADCAST
237 * flag, and only add a broadcast address if it's
238 * set, and check the IFF_POINTTOPOINT flag, and
239 * only add a destination address if it's set (as
240 * per man page recommendations on some of those
243 if (ifa
->ifa_flags
& IFF_BROADCAST
&&
244 ifa
->ifa_broadaddr
!= NULL
) {
245 broadaddr
= ifa
->ifa_broadaddr
;
246 broadaddr_size
= SA_LEN(broadaddr
);
251 if (ifa
->ifa_flags
& IFF_POINTOPOINT
&&
252 ifa
->ifa_dstaddr
!= NULL
) {
253 dstaddr
= ifa
->ifa_dstaddr
;
254 dstaddr_size
= SA_LEN(ifa
->ifa_dstaddr
);
261 * Add information for this address to the list.
263 if (pcapint_add_addr_to_if(devlistp
, ifa
->ifa_name
, ifa
->ifa_flags
,
265 addr
, addr_size
, netmask
, addr_size
,
266 broadaddr
, broadaddr_size
, dstaddr
, dstaddr_size
,