2 * Copyright (c) 1993, 1994, 1995, 1996, 1998
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that: (1) source code distributions
7 * retain the above copyright notice and this paragraph in its entirety, (2)
8 * distributions including binary code include the above copyright notice and
9 * this paragraph in its entirety in the documentation or other materials
10 * provided with the distribution, and (3) all advertising materials mentioning
11 * features or use of this software display the following acknowledgement:
12 * ``This product includes software developed by the University of California,
13 * Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
14 * the University nor the names of its contributors may be used to endorse
15 * or promote products derived from this software without specific prior
17 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
18 * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
19 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
26 #include <sys/param.h> /* optionally get BSD define */
27 #include <sys/socket.h>
30 * <net/bpf.h> defines ioctls, but doesn't include <sys/ioccom.h>.
32 * We include <sys/ioctl.h> as it might be necessary to declare ioctl();
33 * at least on *BSD and macOS, it also defines various SIOC ioctls -
34 * we could include <sys/sockio.h>, but if we're already including
35 * <sys/ioctl.h>, which includes <sys/sockio.h> on those platforms,
36 * there's not much point in doing so.
38 * If we have <sys/ioccom.h>, we include it as well, to handle systems
39 * such as Solaris which don't arrange to include <sys/ioccom.h> if you
40 * include <sys/ioctl.h>
42 #include <sys/ioctl.h>
43 #ifdef HAVE_SYS_IOCCOM_H
44 #include <sys/ioccom.h>
46 #include <sys/utsname.h>
48 #if defined(__FreeBSD__) && defined(SIOCIFCREATE2)
50 * Add support for capturing on FreeBSD usbusN interfaces.
52 static const char usbus_prefix
[] = "usbus";
53 #define USBUS_PREFIX_LEN (sizeof(usbus_prefix) - 1)
62 * Make "pcap.h" not include "pcap/bpf.h"; we are going to include the
63 * native OS version, as we need "struct bpf_config" from it.
65 #define PCAP_DONT_INCLUDE_PCAP_BPF_H
67 #include <sys/types.h>
70 * Prevent bpf.h from redefining the DLT_ values to their
71 * IFT_ values, as we're going to return the standard libpcap
72 * values, not IBM's non-standard IFT_ values.
79 * If both BIOCROTZBUF and BPF_BUFMODE_ZBUF are defined, we have
82 #if defined(BIOCROTZBUF) && defined(BPF_BUFMODE_ZBUF)
83 #define HAVE_ZEROCOPY_BPF
85 #include <machine/atomic.h>
88 #include <net/if_types.h> /* for IFT_ values */
89 #include <sys/sysconfig.h>
90 #include <sys/device.h>
91 #include <sys/cfgodm.h>
95 #define domakedev makedev64
96 #define getmajor major64
97 #define bpf_hdr bpf_hdr32
99 #define domakedev makedev
100 #define getmajor major
101 #endif /* __64BIT__ */
103 #define BPF_NAME "bpf"
105 #define DRIVER_PATH "/usr/lib/drivers"
106 #define BPF_NODE "/dev/bpf"
107 static int bpfloadedflag
= 0;
108 static int odmlockid
= 0;
110 static int bpf_load(char *errbuf
);
128 # include <net/if_media.h>
131 #include "pcap-int.h"
133 #ifdef HAVE_OS_PROTO_H
134 #include "os-proto.h"
138 * Later versions of NetBSD stick padding in front of FDDI frames
139 * to align the IP header on a 4-byte boundary.
141 #if defined(__NetBSD__) && __NetBSD_Version__ > 106000000
142 #define PCAP_FDDIPAD 3
146 * Private data for capturing on BPF devices.
149 #ifdef HAVE_ZEROCOPY_BPF
151 * Zero-copy read buffer -- for zero-copy BPF. 'buffer' above will
152 * alternative between these two actual mmap'd buffers as required.
153 * As there is a header on the front size of the mmap'd buffer, only
154 * some of the buffer is exposed to libpcap as a whole via bufsize;
155 * zbufsize is the true size. zbuffer tracks the current zbuf
156 * assocated with buffer so that it can be used to decide which the
157 * next buffer to read will be.
159 u_char
*zbuf1
, *zbuf2
, *zbuffer
;
163 struct timespec firstsel
;
165 * If there's currently a buffer being actively processed, then it is
166 * referenced here; 'buffer' is also pointed at it, but offset by the
167 * size of the header.
169 struct bpf_zbuf_header
*bzh
;
170 int nonblock
; /* true if in nonblocking mode */
171 #endif /* HAVE_ZEROCOPY_BPF */
173 char *device
; /* device name */
174 int filtering_in_kernel
; /* using kernel filter */
175 int must_do_on_close
; /* stuff we must do when we close */
179 * Stuff to do when we close.
181 #define MUST_CLEAR_RFMON 0x00000001 /* clear rfmon (monitor) mode */
182 #define MUST_DESTROY_USBUS 0x00000002 /* destroy usbusN interface */
185 # if (defined(HAVE_NET_IF_MEDIA_H) && defined(IFM_IEEE80211)) && !defined(__APPLE__)
186 #define HAVE_BSD_IEEE80211
189 * The ifm_ulist member of a struct ifmediareq is an int * on most systems,
190 * but it's a uint64_t on newer versions of OpenBSD.
192 * We check this by checking whether IFM_GMASK is defined and > 2^32-1.
194 # if defined(IFM_GMASK) && IFM_GMASK > 0xFFFFFFFF
195 # define IFM_ULIST_TYPE uint64_t
197 # define IFM_ULIST_TYPE int
201 # if defined(__APPLE__) || defined(HAVE_BSD_IEEE80211)
202 static int find_802_11(struct bpf_dltlist
*);
204 # ifdef HAVE_BSD_IEEE80211
205 static int monitor_mode(pcap_t
*, int);
208 # if defined(__APPLE__)
209 static void remove_non_802_11(pcap_t
*);
210 static void remove_802_11(pcap_t
*);
213 # endif /* defined(__APPLE__) || defined(HAVE_BSD_IEEE80211) */
215 #endif /* BIOCGDLTLIST */
217 #if defined(sun) && defined(LIFNAMSIZ) && defined(lifr_zoneid)
222 * We include the OS's <net/bpf.h>, not our "pcap/bpf.h", so we probably
223 * don't get DLT_DOCSIS defined.
226 #define DLT_DOCSIS 143
230 * In some versions of macOS, we might not even get any of the
231 * 802.11-plus-radio-header DLT_'s defined, even though some
232 * of them are used by various Airport drivers in those versions.
234 #ifndef DLT_PRISM_HEADER
235 #define DLT_PRISM_HEADER 119
237 #ifndef DLT_AIRONET_HEADER
238 #define DLT_AIRONET_HEADER 120
240 #ifndef DLT_IEEE802_11_RADIO
241 #define DLT_IEEE802_11_RADIO 127
243 #ifndef DLT_IEEE802_11_RADIO_AVS
244 #define DLT_IEEE802_11_RADIO_AVS 163
247 static int pcap_can_set_rfmon_bpf(pcap_t
*p
);
248 static int pcap_activate_bpf(pcap_t
*p
);
249 static int pcap_setfilter_bpf(pcap_t
*p
, struct bpf_program
*fp
);
250 static int pcap_setdirection_bpf(pcap_t
*, pcap_direction_t
);
251 static int pcap_set_datalink_bpf(pcap_t
*p
, int dlt
);
254 * For zerocopy bpf, the setnonblock/getnonblock routines need to modify
255 * pb->nonblock so we don't call select(2) if the pcap handle is in non-
259 pcap_getnonblock_bpf(pcap_t
*p
)
261 #ifdef HAVE_ZEROCOPY_BPF
262 struct pcap_bpf
*pb
= p
->priv
;
265 return (pb
->nonblock
);
267 return (pcap_getnonblock_fd(p
));
271 pcap_setnonblock_bpf(pcap_t
*p
, int nonblock
)
273 #ifdef HAVE_ZEROCOPY_BPF
274 struct pcap_bpf
*pb
= p
->priv
;
277 pb
->nonblock
= nonblock
;
281 return (pcap_setnonblock_fd(p
, nonblock
));
284 #ifdef HAVE_ZEROCOPY_BPF
286 * Zero-copy BPF buffer routines to check for and acknowledge BPF data in
287 * shared memory buffers.
289 * pcap_next_zbuf_shm(): Check for a newly available shared memory buffer,
290 * and set up p->buffer and cc to reflect one if available. Notice that if
291 * there was no prior buffer, we select zbuf1 as this will be the first
292 * buffer filled for a fresh BPF session.
295 pcap_next_zbuf_shm(pcap_t
*p
, int *cc
)
297 struct pcap_bpf
*pb
= p
->priv
;
298 struct bpf_zbuf_header
*bzh
;
300 if (pb
->zbuffer
== pb
->zbuf2
|| pb
->zbuffer
== NULL
) {
301 bzh
= (struct bpf_zbuf_header
*)pb
->zbuf1
;
302 if (bzh
->bzh_user_gen
!=
303 atomic_load_acq_int(&bzh
->bzh_kernel_gen
)) {
305 pb
->zbuffer
= (u_char
*)pb
->zbuf1
;
306 p
->buffer
= pb
->zbuffer
+ sizeof(*bzh
);
307 *cc
= bzh
->bzh_kernel_len
;
310 } else if (pb
->zbuffer
== pb
->zbuf1
) {
311 bzh
= (struct bpf_zbuf_header
*)pb
->zbuf2
;
312 if (bzh
->bzh_user_gen
!=
313 atomic_load_acq_int(&bzh
->bzh_kernel_gen
)) {
315 pb
->zbuffer
= (u_char
*)pb
->zbuf2
;
316 p
->buffer
= pb
->zbuffer
+ sizeof(*bzh
);
317 *cc
= bzh
->bzh_kernel_len
;
326 * pcap_next_zbuf() -- Similar to pcap_next_zbuf_shm(), except wait using
327 * select() for data or a timeout, and possibly force rotation of the buffer
328 * in the event we time out or are in immediate mode. Invoke the shared
329 * memory check before doing system calls in order to avoid doing avoidable
333 pcap_next_zbuf(pcap_t
*p
, int *cc
)
335 struct pcap_bpf
*pb
= p
->priv
;
343 #define TSTOMILLI(ts) (((ts)->tv_sec * 1000) + ((ts)->tv_nsec / 1000000))
345 * Start out by seeing whether anything is waiting by checking the
346 * next shared memory buffer for data.
348 data
= pcap_next_zbuf_shm(p
, cc
);
352 * If a previous sleep was interrupted due to signal delivery, make
353 * sure that the timeout gets adjusted accordingly. This requires
354 * that we analyze when the timeout should be been expired, and
355 * subtract the current time from that. If after this operation,
356 * our timeout is less then or equal to zero, handle it like a
359 tmout
= p
->opt
.timeout
;
361 (void) clock_gettime(CLOCK_MONOTONIC
, &cur
);
362 if (pb
->interrupted
&& p
->opt
.timeout
) {
363 expire
= TSTOMILLI(&pb
->firstsel
) + p
->opt
.timeout
;
364 tmout
= expire
- TSTOMILLI(&cur
);
368 data
= pcap_next_zbuf_shm(p
, cc
);
371 if (ioctl(p
->fd
, BIOCROTZBUF
, &bz
) < 0) {
372 pcap_fmt_errmsg_for_errno(p
->errbuf
,
373 PCAP_ERRBUF_SIZE
, errno
, "BIOCROTZBUF");
376 return (pcap_next_zbuf_shm(p
, cc
));
380 * No data in the buffer, so must use select() to wait for data or
381 * the next timeout. Note that we only call select if the handle
382 * is in blocking mode.
386 FD_SET(p
->fd
, &r_set
);
388 tv
.tv_sec
= tmout
/ 1000;
389 tv
.tv_usec
= (tmout
* 1000) % 1000000;
391 r
= select(p
->fd
+ 1, &r_set
, NULL
, NULL
,
392 p
->opt
.timeout
!= 0 ? &tv
: NULL
);
393 if (r
< 0 && errno
== EINTR
) {
394 if (!pb
->interrupted
&& p
->opt
.timeout
) {
400 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
407 * Check again for data, which may exist now that we've either been
408 * woken up as a result of data or timed out. Try the "there's data"
409 * case first since it doesn't require a system call.
411 data
= pcap_next_zbuf_shm(p
, cc
);
415 * Try forcing a buffer rotation to dislodge timed out or immediate
418 if (ioctl(p
->fd
, BIOCROTZBUF
, &bz
) < 0) {
419 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
420 errno
, "BIOCROTZBUF");
423 return (pcap_next_zbuf_shm(p
, cc
));
427 * Notify kernel that we are done with the buffer. We don't reset zbuffer so
428 * that we know which buffer to use next time around.
431 pcap_ack_zbuf(pcap_t
*p
)
433 struct pcap_bpf
*pb
= p
->priv
;
435 atomic_store_rel_int(&pb
->bzh
->bzh_user_gen
,
436 pb
->bzh
->bzh_kernel_gen
);
441 #endif /* HAVE_ZEROCOPY_BPF */
444 pcap_create_interface(const char *device _U_
, char *ebuf
)
448 p
= pcap_create_common(ebuf
, sizeof (struct pcap_bpf
));
452 p
->activate_op
= pcap_activate_bpf
;
453 p
->can_set_rfmon_op
= pcap_can_set_rfmon_bpf
;
456 * We claim that we support microsecond and nanosecond time
459 p
->tstamp_precision_count
= 2;
460 p
->tstamp_precision_list
= malloc(2 * sizeof(u_int
));
461 if (p
->tstamp_precision_list
== NULL
) {
462 pcap_fmt_errmsg_for_errno(ebuf
, PCAP_ERRBUF_SIZE
, errno
,
467 p
->tstamp_precision_list
[0] = PCAP_TSTAMP_PRECISION_MICRO
;
468 p
->tstamp_precision_list
[1] = PCAP_TSTAMP_PRECISION_NANO
;
469 #endif /* BIOCSTSTAMP */
474 * On success, returns a file descriptor for a BPF device.
475 * On failure, returns a PCAP_ERROR_ value, and sets p->errbuf.
478 bpf_open(char *errbuf
)
481 static const char cloning_device
[] = "/dev/bpf";
483 char device
[sizeof "/dev/bpf0000000000"];
484 static int no_cloning_bpf
= 0;
488 * Load the bpf driver, if it isn't already loaded,
489 * and create the BPF device entries, if they don't
492 if (bpf_load(errbuf
) == PCAP_ERROR
)
497 * First, unless we've already tried opening /dev/bpf and
498 * gotten ENOENT, try opening /dev/bpf.
499 * If it fails with ENOENT, remember that, so we don't try
500 * again, and try /dev/bpfN.
502 if (!no_cloning_bpf
&&
503 (fd
= open(cloning_device
, O_RDWR
)) == -1 &&
504 ((errno
!= EACCES
&& errno
!= ENOENT
) ||
505 (fd
= open(cloning_device
, O_RDONLY
)) == -1)) {
506 if (errno
!= ENOENT
) {
508 fd
= PCAP_ERROR_PERM_DENIED
;
511 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
512 errno
, "(cannot open device) %s", cloning_device
);
518 if (no_cloning_bpf
) {
520 * We don't have /dev/bpf.
521 * Go through all the /dev/bpfN minors and find one
525 (void)snprintf(device
, sizeof(device
), "/dev/bpf%d", n
++);
527 * Initially try a read/write open (to allow the inject
528 * method to work). If that fails due to permission
529 * issues, fall back to read-only. This allows a
530 * non-root user to be granted specific access to pcap
531 * capabilities via file permissions.
533 * XXX - we should have an API that has a flag that
534 * controls whether to open read-only or read-write,
535 * so that denial of permission to send (or inability
536 * to send, if sending packets isn't supported on
537 * the device in question) can be indicated at open
540 fd
= open(device
, O_RDWR
);
541 if (fd
== -1 && errno
== EACCES
)
542 fd
= open(device
, O_RDONLY
);
543 } while (fd
< 0 && errno
== EBUSY
);
547 * XXX better message for all minors used
556 * /dev/bpf0 doesn't exist, which
557 * means we probably have no BPF
560 snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
561 "(there are no BPF devices)");
564 * We got EBUSY on at least one
565 * BPF device, so we have BPF
566 * devices, but all the ones
567 * that exist are busy.
569 snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
570 "(all BPF devices are busy)");
576 * Got EACCES on the last device we tried,
577 * and EBUSY on all devices before that,
580 fd
= PCAP_ERROR_PERM_DENIED
;
581 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
582 errno
, "(cannot open BPF device) %s", device
);
587 * Some other problem.
590 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
591 errno
, "(cannot open BPF device) %s", device
);
600 * Open and bind to a device; used if we're not actually going to use
601 * the device, but are just testing whether it can be opened, or opening
602 * it to get information about it.
604 * Returns an error code on failure (always negative), and an FD for
605 * the now-bound BPF device on success (always non-negative).
608 bpf_open_and_bind(const char *name
, char *errbuf
)
614 * First, open a BPF device.
616 fd
= bpf_open(errbuf
);
618 return (fd
); /* fd is the appropriate error code */
621 * Now bind to the device.
623 (void)strncpy(ifr
.ifr_name
, name
, sizeof(ifr
.ifr_name
));
624 if (ioctl(fd
, BIOCSETIF
, (caddr_t
)&ifr
) < 0) {
629 * There's no such device.
632 return (PCAP_ERROR_NO_SUCH_DEVICE
);
636 * Return a "network down" indication, so that
637 * the application can report that rather than
638 * saying we had a mysterious failure and
639 * suggest that they report a problem to the
640 * libpcap developers.
643 return (PCAP_ERROR_IFACE_NOT_UP
);
646 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
647 errno
, "BIOCSETIF: %s", name
);
661 get_dlt_list(int fd
, int v
, struct bpf_dltlist
*bdlp
, char *ebuf
)
663 memset(bdlp
, 0, sizeof(*bdlp
));
664 if (ioctl(fd
, BIOCGDLTLIST
, (caddr_t
)bdlp
) == 0) {
668 bdlp
->bfl_list
= (u_int
*) malloc(sizeof(u_int
) * (bdlp
->bfl_len
+ 1));
669 if (bdlp
->bfl_list
== NULL
) {
670 pcap_fmt_errmsg_for_errno(ebuf
, PCAP_ERRBUF_SIZE
,
675 if (ioctl(fd
, BIOCGDLTLIST
, (caddr_t
)bdlp
) < 0) {
676 pcap_fmt_errmsg_for_errno(ebuf
, PCAP_ERRBUF_SIZE
,
677 errno
, "BIOCGDLTLIST");
678 free(bdlp
->bfl_list
);
683 * OK, for real Ethernet devices, add DLT_DOCSIS to the
684 * list, so that an application can let you choose it,
685 * in case you're capturing DOCSIS traffic that a Cisco
686 * Cable Modem Termination System is putting out onto
687 * an Ethernet (it doesn't put an Ethernet header onto
688 * the wire, it puts raw DOCSIS frames out on the wire
689 * inside the low-level Ethernet framing).
691 * A "real Ethernet device" is defined here as a device
692 * that has a link-layer type of DLT_EN10MB and that has
693 * no alternate link-layer types; that's done to exclude
694 * 802.11 interfaces (which might or might not be the
695 * right thing to do, but I suspect it is - Ethernet <->
696 * 802.11 bridges would probably badly mishandle frames
697 * that don't have Ethernet headers).
699 * On Solaris with BPF, Ethernet devices also offer
700 * DLT_IPNET, so we, if DLT_IPNET is defined, we don't
701 * treat it as an indication that the device isn't an
704 if (v
== DLT_EN10MB
) {
706 for (i
= 0; i
< bdlp
->bfl_len
; i
++) {
707 if (bdlp
->bfl_list
[i
] != DLT_EN10MB
709 && bdlp
->bfl_list
[i
] != DLT_IPNET
718 * We reserved one more slot at the end of
721 bdlp
->bfl_list
[bdlp
->bfl_len
] = DLT_DOCSIS
;
727 * EINVAL just means "we don't support this ioctl on
728 * this device"; don't treat it as an error.
730 if (errno
!= EINVAL
) {
731 pcap_fmt_errmsg_for_errno(ebuf
, PCAP_ERRBUF_SIZE
,
732 errno
, "BIOCGDLTLIST");
740 #if defined(__APPLE__)
742 pcap_can_set_rfmon_bpf(pcap_t
*p
)
744 struct utsname osinfo
;
748 struct bpf_dltlist bdl
;
752 * The joys of monitor mode on Mac OS X/OS X/macOS.
754 * Prior to 10.4, it's not supported at all.
756 * In 10.4, if adapter enN supports monitor mode, there's a
757 * wltN adapter corresponding to it; you open it, instead of
758 * enN, to get monitor mode. You get whatever link-layer
759 * headers it supplies.
761 * In 10.5, and, we assume, later releases, if adapter enN
762 * supports monitor mode, it offers, among its selectable
763 * DLT_ values, values that let you get the 802.11 header;
764 * selecting one of those values puts the adapter into monitor
765 * mode (i.e., you can't get 802.11 headers except in monitor
766 * mode, and you can't get Ethernet headers in monitor mode).
768 if (uname(&osinfo
) == -1) {
770 * Can't get the OS version; just say "no".
775 * We assume osinfo.sysname is "Darwin", because
776 * __APPLE__ is defined. We just check the version.
778 if (osinfo
.release
[0] < '8' && osinfo
.release
[1] == '.') {
780 * 10.3 (Darwin 7.x) or earlier.
781 * Monitor mode not supported.
785 if (osinfo
.release
[0] == '8' && osinfo
.release
[1] == '.') {
787 * 10.4 (Darwin 8.x). s/en/wlt/, and check
788 * whether the device exists.
790 if (strncmp(p
->opt
.device
, "en", 2) != 0) {
792 * Not an enN device; no monitor mode.
796 fd
= socket(AF_INET
, SOCK_DGRAM
, 0);
798 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
802 pcap_strlcpy(ifr
.ifr_name
, "wlt", sizeof(ifr
.ifr_name
));
803 pcap_strlcat(ifr
.ifr_name
, p
->opt
.device
+ 2, sizeof(ifr
.ifr_name
));
804 if (ioctl(fd
, SIOCGIFFLAGS
, (char *)&ifr
) < 0) {
817 * Everything else is 10.5 or later; for those,
818 * we just open the enN device, and check whether
819 * we have any 802.11 devices.
821 * First, open a BPF device.
823 fd
= bpf_open(p
->errbuf
);
825 return (fd
); /* fd is the appropriate error code */
828 * Now bind to the device.
830 (void)strncpy(ifr
.ifr_name
, p
->opt
.device
, sizeof(ifr
.ifr_name
));
831 if (ioctl(fd
, BIOCSETIF
, (caddr_t
)&ifr
) < 0) {
836 * There's no such device.
839 return (PCAP_ERROR_NO_SUCH_DEVICE
);
843 * Return a "network down" indication, so that
844 * the application can report that rather than
845 * saying we had a mysterious failure and
846 * suggest that they report a problem to the
847 * libpcap developers.
850 return (PCAP_ERROR_IFACE_NOT_UP
);
853 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
854 errno
, "BIOCSETIF: %s", p
->opt
.device
);
861 * We know the default link type -- now determine all the DLTs
862 * this interface supports. If this fails with EINVAL, it's
863 * not fatal; we just don't get to use the feature later.
864 * (We don't care about DLT_DOCSIS, so we pass DLT_NULL
865 * as the default DLT for this adapter.)
867 if (get_dlt_list(fd
, DLT_NULL
, &bdl
, p
->errbuf
) == PCAP_ERROR
) {
871 if (find_802_11(&bdl
) != -1) {
873 * We have an 802.11 DLT, so we can set monitor mode.
881 #endif /* BIOCGDLTLIST */
884 #elif defined(HAVE_BSD_IEEE80211)
886 pcap_can_set_rfmon_bpf(pcap_t
*p
)
890 ret
= monitor_mode(p
, 0);
891 if (ret
== PCAP_ERROR_RFMON_NOTSUP
)
892 return (0); /* not an error, just a "can't do" */
894 return (1); /* success */
899 pcap_can_set_rfmon_bpf(pcap_t
*p _U_
)
906 pcap_stats_bpf(pcap_t
*p
, struct pcap_stat
*ps
)
911 * "ps_recv" counts packets handed to the filter, not packets
912 * that passed the filter. This includes packets later dropped
913 * because we ran out of buffer space.
915 * "ps_drop" counts packets dropped inside the BPF device
916 * because we ran out of buffer space. It doesn't count
917 * packets dropped by the interface driver. It counts
918 * only packets that passed the filter.
920 * Both statistics include packets not yet read from the kernel
921 * by libpcap, and thus not yet seen by the application.
923 if (ioctl(p
->fd
, BIOCGSTATS
, (caddr_t
)&s
) < 0) {
924 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
925 errno
, "BIOCGSTATS");
929 ps
->ps_recv
= s
.bs_recv
;
930 ps
->ps_drop
= s
.bs_drop
;
936 pcap_read_bpf(pcap_t
*p
, int cnt
, pcap_handler callback
, u_char
*user
)
938 struct pcap_bpf
*pb
= p
->priv
;
941 register u_char
*bp
, *ep
;
946 #ifdef HAVE_ZEROCOPY_BPF
952 * Has "pcap_breakloop()" been called?
956 * Yes - clear the flag that indicates that it
957 * has, and return PCAP_ERROR_BREAK to indicate
958 * that we were told to break out of the loop.
961 return (PCAP_ERROR_BREAK
);
966 * When reading without zero-copy from a file descriptor, we
967 * use a single buffer and return a length of data in the
968 * buffer. With zero-copy, we update the p->buffer pointer
969 * to point at whatever underlying buffer contains the next
970 * data and update cc to reflect the data found in the
973 #ifdef HAVE_ZEROCOPY_BPF
975 if (p
->buffer
!= NULL
)
977 i
= pcap_next_zbuf(p
, &cc
);
985 cc
= (int)read(p
->fd
, p
->buffer
, p
->bufsize
);
988 /* Don't choke when we get ptraced */
997 * Sigh. More AIX wonderfulness.
999 * For some unknown reason the uiomove()
1000 * operation in the bpf kernel extension
1001 * used to copy the buffer into user
1002 * space sometimes returns EFAULT. I have
1003 * no idea why this is the case given that
1004 * a kernel debugger shows the user buffer
1005 * is correct. This problem appears to
1006 * be mostly mitigated by the memset of
1007 * the buffer before it is first used.
1008 * Very strange.... Shaun Clowes
1010 * In any case this means that we shouldn't
1011 * treat EFAULT as a fatal error; as we
1012 * don't have an API for returning
1013 * a "some packets were dropped since
1014 * the last packet you saw" indication,
1015 * we just ignore EFAULT and keep reading.
1023 case ENXIO
: /* FreeBSD, DragonFly BSD, and Darwin */
1024 case EIO
: /* OpenBSD */
1025 /* NetBSD appears not to return an error in this case */
1027 * The device on which we're capturing
1030 * XXX - we should really return
1031 * an appropriate error for that,
1032 * but pcap_dispatch() etc. aren't
1033 * documented as having error returns
1034 * other than PCAP_ERROR or PCAP_ERROR_BREAK.
1036 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1037 "The interface disappeared");
1038 return (PCAP_ERROR
);
1040 #if defined(sun) && !defined(BSD) && !defined(__svr4__) && !defined(__SVR4)
1042 * Due to a SunOS bug, after 2^31 bytes, the kernel
1043 * file offset overflows and read fails with EINVAL.
1044 * The lseek() to 0 will fix things.
1047 if (lseek(p
->fd
, 0L, SEEK_CUR
) +
1049 (void)lseek(p
->fd
, 0L, SEEK_SET
);
1055 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1057 return (PCAP_ERROR
);
1059 bp
= (u_char
*)p
->buffer
;
1064 * Loop through each packet.
1067 #define bhp ((struct bpf_xhdr *)bp)
1069 #define bhp ((struct bpf_hdr *)bp)
1076 register u_int caplen
, hdrlen
;
1079 * Has "pcap_breakloop()" been called?
1080 * If so, return immediately - if we haven't read any
1081 * packets, clear the flag and return PCAP_ERROR_BREAK
1082 * to indicate that we were told to break out of the loop,
1083 * otherwise leave the flag set, so that the *next* call
1084 * will break out of the loop without having read any
1085 * packets, and return the number of packets we've
1088 if (p
->break_loop
) {
1090 p
->cc
= (int)(ep
- bp
);
1092 * ep is set based on the return value of read(),
1093 * but read() from a BPF device doesn't necessarily
1094 * return a value that's a multiple of the alignment
1095 * value for BPF_WORDALIGN(). However, whenever we
1096 * increment bp, we round up the increment value by
1097 * a value rounded up by BPF_WORDALIGN(), so we
1098 * could increment bp past ep after processing the
1099 * last packet in the buffer.
1101 * We treat ep < bp as an indication that this
1102 * happened, and just set p->cc to 0.
1108 return (PCAP_ERROR_BREAK
);
1113 caplen
= bhp
->bh_caplen
;
1114 hdrlen
= bhp
->bh_hdrlen
;
1115 datap
= bp
+ hdrlen
;
1117 * Short-circuit evaluation: if using BPF filter
1118 * in kernel, no need to do it now - we already know
1119 * the packet passed the filter.
1122 * Note: the filter code was generated assuming
1123 * that p->fddipad was the amount of padding
1124 * before the header, as that's what's required
1125 * in the kernel, so we run the filter before
1126 * skipping that padding.
1129 if (pb
->filtering_in_kernel
||
1130 pcap_filter(p
->fcode
.bf_insns
, datap
, bhp
->bh_datalen
, caplen
)) {
1131 struct pcap_pkthdr pkthdr
;
1135 bt
.sec
= bhp
->bh_tstamp
.bt_sec
;
1136 bt
.frac
= bhp
->bh_tstamp
.bt_frac
;
1137 if (p
->opt
.tstamp_precision
== PCAP_TSTAMP_PRECISION_NANO
) {
1140 bintime2timespec(&bt
, &ts
);
1141 pkthdr
.ts
.tv_sec
= ts
.tv_sec
;
1142 pkthdr
.ts
.tv_usec
= ts
.tv_nsec
;
1146 bintime2timeval(&bt
, &tv
);
1147 pkthdr
.ts
.tv_sec
= tv
.tv_sec
;
1148 pkthdr
.ts
.tv_usec
= tv
.tv_usec
;
1151 pkthdr
.ts
.tv_sec
= bhp
->bh_tstamp
.tv_sec
;
1154 * AIX's BPF returns seconds/nanoseconds time
1155 * stamps, not seconds/microseconds time stamps.
1157 pkthdr
.ts
.tv_usec
= bhp
->bh_tstamp
.tv_usec
/1000;
1159 pkthdr
.ts
.tv_usec
= bhp
->bh_tstamp
.tv_usec
;
1161 #endif /* BIOCSTSTAMP */
1164 pkthdr
.caplen
= caplen
- pad
;
1167 if (bhp
->bh_datalen
> pad
)
1168 pkthdr
.len
= bhp
->bh_datalen
- pad
;
1173 pkthdr
.caplen
= caplen
;
1174 pkthdr
.len
= bhp
->bh_datalen
;
1176 (*callback
)(user
, &pkthdr
, datap
);
1177 bp
+= BPF_WORDALIGN(caplen
+ hdrlen
);
1178 if (++n
>= cnt
&& !PACKET_COUNT_IS_UNLIMITED(cnt
)) {
1180 p
->cc
= (int)(ep
- bp
);
1182 * See comment above about p->cc < 0.
1192 bp
+= BPF_WORDALIGN(caplen
+ hdrlen
);
1201 pcap_inject_bpf(pcap_t
*p
, const void *buf
, int size
)
1205 ret
= (int)write(p
->fd
, buf
, size
);
1207 if (ret
== -1 && errno
== EAFNOSUPPORT
) {
1209 * In some versions of macOS, there's a bug wherein setting
1210 * the BIOCSHDRCMPLT flag causes writes to fail; see, for
1213 * http://cerberus.sourcefire.com/~jeff/archives/patches/macosx/BIOCSHDRCMPLT-10.3.3.patch
1215 * So, if, on macOS, we get EAFNOSUPPORT from the write, we
1216 * assume it's due to that bug, and turn off that flag
1217 * and try again. If we succeed, it either means that
1218 * somebody applied the fix from that URL, or other patches
1221 * http://cerberus.sourcefire.com/~jeff/archives/patches/macosx/
1223 * and are running a Darwin kernel with those fixes, or
1224 * that Apple fixed the problem in some macOS release.
1226 u_int spoof_eth_src
= 0;
1228 if (ioctl(p
->fd
, BIOCSHDRCMPLT
, &spoof_eth_src
) == -1) {
1229 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1230 errno
, "send: can't turn off BIOCSHDRCMPLT");
1231 return (PCAP_ERROR
);
1235 * Now try the write again.
1237 ret
= (int)write(p
->fd
, buf
, size
);
1239 #endif /* __APPLE__ */
1241 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1243 return (PCAP_ERROR
);
1250 bpf_odminit(char *errbuf
)
1254 if (odm_initialize() == -1) {
1255 if (odm_err_msg(odmerrno
, &errstr
) == -1)
1256 errstr
= "Unknown error";
1257 snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
1258 "bpf_load: odm_initialize failed: %s",
1260 return (PCAP_ERROR
);
1263 if ((odmlockid
= odm_lock("/etc/objrepos/config_lock", ODM_WAIT
)) == -1) {
1264 if (odm_err_msg(odmerrno
, &errstr
) == -1)
1265 errstr
= "Unknown error";
1266 snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
1267 "bpf_load: odm_lock of /etc/objrepos/config_lock failed: %s",
1269 (void)odm_terminate();
1270 return (PCAP_ERROR
);
1277 bpf_odmcleanup(char *errbuf
)
1281 if (odm_unlock(odmlockid
) == -1) {
1282 if (errbuf
!= NULL
) {
1283 if (odm_err_msg(odmerrno
, &errstr
) == -1)
1284 errstr
= "Unknown error";
1285 snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
1286 "bpf_load: odm_unlock failed: %s",
1289 return (PCAP_ERROR
);
1292 if (odm_terminate() == -1) {
1293 if (errbuf
!= NULL
) {
1294 if (odm_err_msg(odmerrno
, &errstr
) == -1)
1295 errstr
= "Unknown error";
1296 snprintf(errbuf
, PCAP_ERRBUF_SIZE
,
1297 "bpf_load: odm_terminate failed: %s",
1300 return (PCAP_ERROR
);
1307 bpf_load(char *errbuf
)
1311 int numminors
, i
, rc
;
1314 struct bpf_config cfg_bpf
;
1315 struct cfg_load cfg_ld
;
1316 struct cfg_kmod cfg_km
;
1319 * This is very very close to what happens in the real implementation
1320 * but I've fixed some (unlikely) bug situations.
1325 if (bpf_odminit(errbuf
) == PCAP_ERROR
)
1326 return (PCAP_ERROR
);
1328 major
= genmajor(BPF_NAME
);
1330 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
1331 errno
, "bpf_load: genmajor failed");
1332 (void)bpf_odmcleanup(NULL
);
1333 return (PCAP_ERROR
);
1336 minors
= getminor(major
, &numminors
, BPF_NAME
);
1338 minors
= genminor("bpf", major
, 0, BPF_MINORS
, 1, 1);
1340 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
1341 errno
, "bpf_load: genminor failed");
1342 (void)bpf_odmcleanup(NULL
);
1343 return (PCAP_ERROR
);
1347 if (bpf_odmcleanup(errbuf
) == PCAP_ERROR
)
1348 return (PCAP_ERROR
);
1350 rc
= stat(BPF_NODE
"0", &sbuf
);
1351 if (rc
== -1 && errno
!= ENOENT
) {
1352 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
1353 errno
, "bpf_load: can't stat %s", BPF_NODE
"0");
1354 return (PCAP_ERROR
);
1357 if (rc
== -1 || getmajor(sbuf
.st_rdev
) != major
) {
1358 for (i
= 0; i
< BPF_MINORS
; i
++) {
1359 snprintf(buf
, sizeof(buf
), "%s%d", BPF_NODE
, i
);
1361 if (mknod(buf
, S_IRUSR
| S_IFCHR
, domakedev(major
, i
)) == -1) {
1362 pcap_fmt_errmsg_for_errno(errbuf
,
1363 PCAP_ERRBUF_SIZE
, errno
,
1364 "bpf_load: can't mknod %s", buf
);
1365 return (PCAP_ERROR
);
1370 /* Check if the driver is loaded */
1371 memset(&cfg_ld
, 0x0, sizeof(cfg_ld
));
1372 snprintf(buf
, sizeof(buf
), "%s/%s", DRIVER_PATH
, BPF_NAME
);
1374 if ((sysconfig(SYS_QUERYLOAD
, (void *)&cfg_ld
, sizeof(cfg_ld
)) == -1) ||
1375 (cfg_ld
.kmid
== 0)) {
1376 /* Driver isn't loaded, load it now */
1377 if (sysconfig(SYS_SINGLELOAD
, (void *)&cfg_ld
, sizeof(cfg_ld
)) == -1) {
1378 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
1379 errno
, "bpf_load: could not load driver");
1380 return (PCAP_ERROR
);
1384 /* Configure the driver */
1385 cfg_km
.cmd
= CFG_INIT
;
1386 cfg_km
.kmid
= cfg_ld
.kmid
;
1387 cfg_km
.mdilen
= sizeof(cfg_bpf
);
1388 cfg_km
.mdiptr
= (void *)&cfg_bpf
;
1389 for (i
= 0; i
< BPF_MINORS
; i
++) {
1390 cfg_bpf
.devno
= domakedev(major
, i
);
1391 if (sysconfig(SYS_CFGKMOD
, (void *)&cfg_km
, sizeof(cfg_km
)) == -1) {
1392 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
1393 errno
, "bpf_load: could not configure driver");
1394 return (PCAP_ERROR
);
1405 * Undo any operations done when opening the device when necessary.
1408 pcap_cleanup_bpf(pcap_t
*p
)
1410 struct pcap_bpf
*pb
= p
->priv
;
1411 #ifdef HAVE_BSD_IEEE80211
1413 struct ifmediareq req
;
1417 if (pb
->must_do_on_close
!= 0) {
1419 * There's something we have to do when closing this
1422 #ifdef HAVE_BSD_IEEE80211
1423 if (pb
->must_do_on_close
& MUST_CLEAR_RFMON
) {
1425 * We put the interface into rfmon mode;
1426 * take it out of rfmon mode.
1428 * XXX - if somebody else wants it in rfmon
1429 * mode, this code cannot know that, so it'll take
1430 * it out of rfmon mode.
1432 sock
= socket(AF_INET
, SOCK_DGRAM
, 0);
1435 "Can't restore interface flags (socket() failed: %s).\n"
1436 "Please adjust manually.\n",
1439 memset(&req
, 0, sizeof(req
));
1440 strncpy(req
.ifm_name
, pb
->device
,
1441 sizeof(req
.ifm_name
));
1442 if (ioctl(sock
, SIOCGIFMEDIA
, &req
) < 0) {
1444 "Can't restore interface flags (SIOCGIFMEDIA failed: %s).\n"
1445 "Please adjust manually.\n",
1448 if (req
.ifm_current
& IFM_IEEE80211_MONITOR
) {
1450 * Rfmon mode is currently on;
1453 memset(&ifr
, 0, sizeof(ifr
));
1454 (void)strncpy(ifr
.ifr_name
,
1456 sizeof(ifr
.ifr_name
));
1458 req
.ifm_current
& ~IFM_IEEE80211_MONITOR
;
1459 if (ioctl(sock
, SIOCSIFMEDIA
,
1462 "Can't restore interface flags (SIOCSIFMEDIA failed: %s).\n"
1463 "Please adjust manually.\n",
1471 #endif /* HAVE_BSD_IEEE80211 */
1473 #if defined(__FreeBSD__) && defined(SIOCIFCREATE2)
1475 * Attempt to destroy the usbusN interface that we created.
1477 if (pb
->must_do_on_close
& MUST_DESTROY_USBUS
) {
1478 if (if_nametoindex(pb
->device
) > 0) {
1481 s
= socket(AF_LOCAL
, SOCK_DGRAM
, 0);
1483 pcap_strlcpy(ifr
.ifr_name
, pb
->device
,
1484 sizeof(ifr
.ifr_name
));
1485 ioctl(s
, SIOCIFDESTROY
, &ifr
);
1490 #endif /* defined(__FreeBSD__) && defined(SIOCIFCREATE2) */
1492 * Take this pcap out of the list of pcaps for which we
1493 * have to take the interface out of some mode.
1495 pcap_remove_from_pcaps_to_close(p
);
1496 pb
->must_do_on_close
= 0;
1499 #ifdef HAVE_ZEROCOPY_BPF
1502 * Delete the mappings. Note that p->buffer gets
1503 * initialized to one of the mmapped regions in
1504 * this case, so do not try and free it directly;
1505 * null it out so that pcap_cleanup_live_common()
1506 * doesn't try to free it.
1508 if (pb
->zbuf1
!= MAP_FAILED
&& pb
->zbuf1
!= NULL
)
1509 (void) munmap(pb
->zbuf1
, pb
->zbufsize
);
1510 if (pb
->zbuf2
!= MAP_FAILED
&& pb
->zbuf2
!= NULL
)
1511 (void) munmap(pb
->zbuf2
, pb
->zbufsize
);
1515 if (pb
->device
!= NULL
) {
1519 pcap_cleanup_live_common(p
);
1523 check_setif_failure(pcap_t
*p
, int error
)
1531 if (error
== ENXIO
) {
1533 * No such device exists.
1536 if (p
->opt
.rfmon
&& strncmp(p
->opt
.device
, "wlt", 3) == 0) {
1538 * Monitor mode was requested, and we're trying
1539 * to open a "wltN" device. Assume that this
1540 * is 10.4 and that we were asked to open an
1541 * "enN" device; if that device exists, return
1542 * "monitor mode not supported on the device".
1544 fd
= socket(AF_INET
, SOCK_DGRAM
, 0);
1546 pcap_strlcpy(ifr
.ifr_name
, "en",
1547 sizeof(ifr
.ifr_name
));
1548 pcap_strlcat(ifr
.ifr_name
, p
->opt
.device
+ 3,
1549 sizeof(ifr
.ifr_name
));
1550 if (ioctl(fd
, SIOCGIFFLAGS
, (char *)&ifr
) < 0) {
1552 * We assume this failed because
1553 * the underlying device doesn't
1556 err
= PCAP_ERROR_NO_SUCH_DEVICE
;
1557 pcap_fmt_errmsg_for_errno(p
->errbuf
,
1558 PCAP_ERRBUF_SIZE
, errno
,
1559 "SIOCGIFFLAGS on %s failed",
1563 * The underlying "enN" device
1564 * exists, but there's no
1565 * corresponding "wltN" device;
1566 * that means that the "enN"
1567 * device doesn't support
1568 * monitor mode, probably because
1569 * it's an Ethernet device rather
1570 * than a wireless device.
1572 err
= PCAP_ERROR_RFMON_NOTSUP
;
1577 * We can't find out whether there's
1578 * an underlying "enN" device, so
1579 * just report "no such device".
1581 err
= PCAP_ERROR_NO_SUCH_DEVICE
;
1582 pcap_fmt_errmsg_for_errno(p
->errbuf
,
1583 errno
, PCAP_ERRBUF_SIZE
,
1592 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1593 errno
, "BIOCSETIF failed");
1594 return (PCAP_ERROR_NO_SUCH_DEVICE
);
1595 } else if (errno
== ENETDOWN
) {
1597 * Return a "network down" indication, so that
1598 * the application can report that rather than
1599 * saying we had a mysterious failure and
1600 * suggest that they report a problem to the
1601 * libpcap developers.
1603 return (PCAP_ERROR_IFACE_NOT_UP
);
1606 * Some other error; fill in the error string, and
1607 * return PCAP_ERROR.
1609 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1610 errno
, "BIOCSETIF: %s", p
->opt
.device
);
1611 return (PCAP_ERROR
);
1616 * Default capture buffer size.
1617 * 32K isn't very much for modern machines with fast networks; we
1618 * pick .5M, as that's the maximum on at least some systems with BPF.
1620 * However, on AIX 3.5, the larger buffer sized caused unrecoverable
1621 * read failures under stress, so we leave it as 32K; yet another
1622 * place where AIX's BPF is broken.
1625 #define DEFAULT_BUFSIZE 32768
1627 #define DEFAULT_BUFSIZE 524288
1631 pcap_activate_bpf(pcap_t
*p
)
1633 struct pcap_bpf
*pb
= p
->priv
;
1635 #ifdef HAVE_BSD_IEEE80211
1642 char *ifrname
= ifr
.lifr_name
;
1643 const size_t ifnamsiz
= sizeof(ifr
.lifr_name
);
1646 char *ifrname
= ifr
.ifr_name
;
1647 const size_t ifnamsiz
= sizeof(ifr
.ifr_name
);
1649 struct bpf_version bv
;
1652 char *wltdev
= NULL
;
1655 struct bpf_dltlist bdl
;
1656 #if defined(__APPLE__) || defined(HAVE_BSD_IEEE80211)
1659 #endif /* BIOCGDLTLIST */
1660 #if defined(BIOCGHDRCMPLT) && defined(BIOCSHDRCMPLT)
1661 u_int spoof_eth_src
= 1;
1664 struct bpf_insn total_insn
;
1665 struct bpf_program total_prog
;
1666 struct utsname osinfo
;
1667 int have_osinfo
= 0;
1668 #ifdef HAVE_ZEROCOPY_BPF
1670 u_int bufmode
, zbufmax
;
1673 fd
= bpf_open(p
->errbuf
);
1681 if (ioctl(fd
, BIOCVERSION
, (caddr_t
)&bv
) < 0) {
1682 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1683 errno
, "BIOCVERSION");
1684 status
= PCAP_ERROR
;
1687 if (bv
.bv_major
!= BPF_MAJOR_VERSION
||
1688 bv
.bv_minor
< BPF_MINOR_VERSION
) {
1689 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1690 "kernel bpf filter out of date");
1691 status
= PCAP_ERROR
;
1696 * Turn a negative snapshot value (invalid), a snapshot value of
1697 * 0 (unspecified), or a value bigger than the normal maximum
1698 * value, into the maximum allowed value.
1700 * If some application really *needs* a bigger snapshot
1701 * length, we should just increase MAXIMUM_SNAPLEN.
1703 if (p
->snapshot
<= 0 || p
->snapshot
> MAXIMUM_SNAPLEN
)
1704 p
->snapshot
= MAXIMUM_SNAPLEN
;
1706 #if defined(LIFNAMSIZ) && defined(ZONENAME_MAX) && defined(lifr_zoneid)
1708 * Retrieve the zoneid of the zone we are currently executing in.
1710 if ((ifr
.lifr_zoneid
= getzoneid()) == -1) {
1711 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1712 errno
, "getzoneid()");
1713 status
= PCAP_ERROR
;
1717 * Check if the given source datalink name has a '/' separated
1718 * zonename prefix string. The zonename prefixed source datalink can
1719 * be used by pcap consumers in the Solaris global zone to capture
1720 * traffic on datalinks in non-global zones. Non-global zones
1721 * do not have access to datalinks outside of their own namespace.
1723 if ((zonesep
= strchr(p
->opt
.device
, '/')) != NULL
) {
1724 char path_zname
[ZONENAME_MAX
];
1728 if (ifr
.lifr_zoneid
!= GLOBAL_ZONEID
) {
1729 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1730 "zonename/linkname only valid in global zone.");
1731 status
= PCAP_ERROR
;
1734 znamelen
= zonesep
- p
->opt
.device
;
1735 (void) pcap_strlcpy(path_zname
, p
->opt
.device
, znamelen
+ 1);
1736 ifr
.lifr_zoneid
= getzoneidbyname(path_zname
);
1737 if (ifr
.lifr_zoneid
== -1) {
1738 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1739 errno
, "getzoneidbyname(%s)", path_zname
);
1740 status
= PCAP_ERROR
;
1743 lnamep
= strdup(zonesep
+ 1);
1744 if (lnamep
== NULL
) {
1745 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1747 status
= PCAP_ERROR
;
1750 free(p
->opt
.device
);
1751 p
->opt
.device
= lnamep
;
1755 pb
->device
= strdup(p
->opt
.device
);
1756 if (pb
->device
== NULL
) {
1757 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1759 status
= PCAP_ERROR
;
1764 * Attempt to find out the version of the OS on which we're running.
1766 if (uname(&osinfo
) == 0)
1771 * See comment in pcap_can_set_rfmon_bpf() for an explanation
1772 * of why we check the version number.
1777 * We assume osinfo.sysname is "Darwin", because
1778 * __APPLE__ is defined. We just check the version.
1780 if (osinfo
.release
[0] < '8' &&
1781 osinfo
.release
[1] == '.') {
1783 * 10.3 (Darwin 7.x) or earlier.
1785 status
= PCAP_ERROR_RFMON_NOTSUP
;
1788 if (osinfo
.release
[0] == '8' &&
1789 osinfo
.release
[1] == '.') {
1791 * 10.4 (Darwin 8.x). s/en/wlt/
1793 if (strncmp(p
->opt
.device
, "en", 2) != 0) {
1795 * Not an enN device; check
1796 * whether the device even exists.
1798 sockfd
= socket(AF_INET
, SOCK_DGRAM
, 0);
1800 pcap_strlcpy(ifrname
,
1801 p
->opt
.device
, ifnamsiz
);
1802 if (ioctl(sockfd
, SIOCGIFFLAGS
,
1803 (char *)&ifr
) < 0) {
1811 status
= PCAP_ERROR_NO_SUCH_DEVICE
;
1812 pcap_fmt_errmsg_for_errno(p
->errbuf
,
1815 "SIOCGIFFLAGS failed");
1817 status
= PCAP_ERROR_RFMON_NOTSUP
;
1821 * We can't find out whether
1822 * the device exists, so just
1823 * report "no such device".
1825 status
= PCAP_ERROR_NO_SUCH_DEVICE
;
1826 pcap_fmt_errmsg_for_errno(p
->errbuf
,
1827 PCAP_ERRBUF_SIZE
, errno
,
1832 wltdev
= malloc(strlen(p
->opt
.device
) + 2);
1833 if (wltdev
== NULL
) {
1834 pcap_fmt_errmsg_for_errno(p
->errbuf
,
1835 PCAP_ERRBUF_SIZE
, errno
,
1837 status
= PCAP_ERROR
;
1840 strcpy(wltdev
, "wlt");
1841 strcat(wltdev
, p
->opt
.device
+ 2);
1842 free(p
->opt
.device
);
1843 p
->opt
.device
= wltdev
;
1846 * Everything else is 10.5 or later; for those,
1847 * we just open the enN device, and set the DLT.
1851 #endif /* __APPLE__ */
1854 * If this is FreeBSD, and the device name begins with "usbus",
1855 * try to create the interface if it's not available.
1857 #if defined(__FreeBSD__) && defined(SIOCIFCREATE2)
1858 if (strncmp(p
->opt
.device
, usbus_prefix
, USBUS_PREFIX_LEN
) == 0) {
1860 * Do we already have an interface with that name?
1862 if (if_nametoindex(p
->opt
.device
) == 0) {
1864 * No. We need to create it, and, if we
1865 * succeed, remember that we should destroy
1866 * it when the pcap_t is closed.
1871 * Open a socket to use for ioctls to
1872 * create the interface.
1874 s
= socket(AF_LOCAL
, SOCK_DGRAM
, 0);
1876 pcap_fmt_errmsg_for_errno(p
->errbuf
,
1877 PCAP_ERRBUF_SIZE
, errno
,
1878 "Can't open socket");
1879 status
= PCAP_ERROR
;
1884 * If we haven't already done so, arrange to have
1885 * "pcap_close_all()" called when we exit.
1887 if (!pcap_do_addexit(p
)) {
1889 * "atexit()" failed; don't create the
1890 * interface, just give up.
1892 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1895 status
= PCAP_ERROR
;
1900 * Create the interface.
1902 pcap_strlcpy(ifr
.ifr_name
, p
->opt
.device
, sizeof(ifr
.ifr_name
));
1903 if (ioctl(s
, SIOCIFCREATE2
, &ifr
) < 0) {
1904 if (errno
== EINVAL
) {
1905 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1906 "Invalid USB bus interface %s",
1909 pcap_fmt_errmsg_for_errno(p
->errbuf
,
1910 PCAP_ERRBUF_SIZE
, errno
,
1911 "Can't create interface for %s",
1915 status
= PCAP_ERROR
;
1920 * Make sure we clean this up when we close.
1922 pb
->must_do_on_close
|= MUST_DESTROY_USBUS
;
1925 * Add this to the list of pcaps to close when we exit.
1927 pcap_add_to_pcaps_to_close(p
);
1930 #endif /* defined(__FreeBSD__) && defined(SIOCIFCREATE2) */
1932 #ifdef HAVE_ZEROCOPY_BPF
1934 * If the BPF extension to set buffer mode is present, try setting
1935 * the mode to zero-copy. If that fails, use regular buffering. If
1936 * it succeeds but other setup fails, return an error to the user.
1938 bufmode
= BPF_BUFMODE_ZBUF
;
1939 if (ioctl(fd
, BIOCSETBUFMODE
, (caddr_t
)&bufmode
) == 0) {
1941 * We have zerocopy BPF; use it.
1946 * How to pick a buffer size: first, query the maximum buffer
1947 * size supported by zero-copy. This also lets us quickly
1948 * determine whether the kernel generally supports zero-copy.
1949 * Then, if a buffer size was specified, use that, otherwise
1950 * query the default buffer size, which reflects kernel
1951 * policy for a desired default. Round to the nearest page
1954 if (ioctl(fd
, BIOCGETZMAX
, (caddr_t
)&zbufmax
) < 0) {
1955 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1956 errno
, "BIOCGETZMAX");
1957 status
= PCAP_ERROR
;
1961 if (p
->opt
.buffer_size
!= 0) {
1963 * A buffer size was explicitly specified; use it.
1965 v
= p
->opt
.buffer_size
;
1967 if ((ioctl(fd
, BIOCGBLEN
, (caddr_t
)&v
) < 0) ||
1968 v
< DEFAULT_BUFSIZE
)
1969 v
= DEFAULT_BUFSIZE
;
1972 #define roundup(x, y) ((((x)+((y)-1))/(y))*(y)) /* to any y */
1974 pb
->zbufsize
= roundup(v
, getpagesize());
1975 if (pb
->zbufsize
> zbufmax
)
1976 pb
->zbufsize
= zbufmax
;
1977 pb
->zbuf1
= mmap(NULL
, pb
->zbufsize
, PROT_READ
| PROT_WRITE
,
1979 pb
->zbuf2
= mmap(NULL
, pb
->zbufsize
, PROT_READ
| PROT_WRITE
,
1981 if (pb
->zbuf1
== MAP_FAILED
|| pb
->zbuf2
== MAP_FAILED
) {
1982 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1984 status
= PCAP_ERROR
;
1987 memset(&bz
, 0, sizeof(bz
)); /* bzero() deprecated, replaced with memset() */
1988 bz
.bz_bufa
= pb
->zbuf1
;
1989 bz
.bz_bufb
= pb
->zbuf2
;
1990 bz
.bz_buflen
= pb
->zbufsize
;
1991 if (ioctl(fd
, BIOCSETZBUF
, (caddr_t
)&bz
) < 0) {
1992 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
1993 errno
, "BIOCSETZBUF");
1994 status
= PCAP_ERROR
;
1997 (void)strncpy(ifrname
, p
->opt
.device
, ifnamsiz
);
1998 if (ioctl(fd
, BIOCSETIF
, (caddr_t
)&ifr
) < 0) {
1999 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2000 errno
, "BIOCSETIF: %s", p
->opt
.device
);
2001 status
= PCAP_ERROR
;
2004 v
= pb
->zbufsize
- sizeof(struct bpf_zbuf_header
);
2009 * We don't have zerocopy BPF.
2010 * Set the buffer size.
2012 if (p
->opt
.buffer_size
!= 0) {
2014 * A buffer size was explicitly specified; use it.
2016 if (ioctl(fd
, BIOCSBLEN
,
2017 (caddr_t
)&p
->opt
.buffer_size
) < 0) {
2018 pcap_fmt_errmsg_for_errno(p
->errbuf
,
2019 PCAP_ERRBUF_SIZE
, errno
,
2020 "BIOCSBLEN: %s", p
->opt
.device
);
2021 status
= PCAP_ERROR
;
2026 * Now bind to the device.
2028 (void)strncpy(ifrname
, p
->opt
.device
, ifnamsiz
);
2030 if (ioctl(fd
, BIOCSETLIF
, (caddr_t
)&ifr
) < 0)
2032 if (ioctl(fd
, BIOCSETIF
, (caddr_t
)&ifr
) < 0)
2035 status
= check_setif_failure(p
, errno
);
2040 * No buffer size was explicitly specified.
2042 * Try finding a good size for the buffer;
2043 * DEFAULT_BUFSIZE may be too big, so keep
2044 * cutting it in half until we find a size
2045 * that works, or run out of sizes to try.
2046 * If the default is larger, don't make it smaller.
2048 if ((ioctl(fd
, BIOCGBLEN
, (caddr_t
)&v
) < 0) ||
2049 v
< DEFAULT_BUFSIZE
)
2050 v
= DEFAULT_BUFSIZE
;
2051 for ( ; v
!= 0; v
>>= 1) {
2053 * Ignore the return value - this is because the
2054 * call fails on BPF systems that don't have
2055 * kernel malloc. And if the call fails, it's
2056 * no big deal, we just continue to use the
2057 * standard buffer size.
2059 (void) ioctl(fd
, BIOCSBLEN
, (caddr_t
)&v
);
2061 (void)strncpy(ifrname
, p
->opt
.device
, ifnamsiz
);
2063 if (ioctl(fd
, BIOCSETLIF
, (caddr_t
)&ifr
) >= 0)
2065 if (ioctl(fd
, BIOCSETIF
, (caddr_t
)&ifr
) >= 0)
2067 break; /* that size worked; we're done */
2069 if (errno
!= ENOBUFS
) {
2070 status
= check_setif_failure(p
, errno
);
2076 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2077 "BIOCSBLEN: %s: No buffer size worked",
2079 status
= PCAP_ERROR
;
2085 /* Get the data link layer type. */
2086 if (ioctl(fd
, BIOCGDLT
, (caddr_t
)&v
) < 0) {
2087 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2089 status
= PCAP_ERROR
;
2095 * AIX's BPF returns IFF_ types, not DLT_ types, in BIOCGDLT.
2118 * We don't know what to map this to yet.
2120 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
, "unknown interface type %u",
2122 status
= PCAP_ERROR
;
2126 #if _BSDI_VERSION - 0 >= 199510
2127 /* The SLIP and PPP link layer header changed in BSD/OS 2.1 */
2142 case 12: /*DLT_C_HDLC*/
2150 * We know the default link type -- now determine all the DLTs
2151 * this interface supports. If this fails with EINVAL, it's
2152 * not fatal; we just don't get to use the feature later.
2154 if (get_dlt_list(fd
, v
, &bdl
, p
->errbuf
) == -1) {
2155 status
= PCAP_ERROR
;
2158 p
->dlt_count
= bdl
.bfl_len
;
2159 p
->dlt_list
= bdl
.bfl_list
;
2163 * Monitor mode fun, continued.
2165 * For 10.5 and, we're assuming, later releases, as noted above,
2166 * 802.1 adapters that support monitor mode offer both DLT_EN10MB,
2167 * DLT_IEEE802_11, and possibly some 802.11-plus-radio-information
2168 * DLT_ value. Choosing one of the 802.11 DLT_ values will turn
2171 * Therefore, if the user asked for monitor mode, we filter out
2172 * the DLT_EN10MB value, as you can't get that in monitor mode,
2173 * and, if the user didn't ask for monitor mode, we filter out
2174 * the 802.11 DLT_ values, because selecting those will turn
2175 * monitor mode on. Then, for monitor mode, if an 802.11-plus-
2176 * radio DLT_ value is offered, we try to select that, otherwise
2177 * we try to select DLT_IEEE802_11.
2180 if (isdigit((unsigned)osinfo
.release
[0]) &&
2181 (osinfo
.release
[0] == '9' ||
2182 isdigit((unsigned)osinfo
.release
[1]))) {
2184 * 10.5 (Darwin 9.x), or later.
2186 new_dlt
= find_802_11(&bdl
);
2187 if (new_dlt
!= -1) {
2189 * We have at least one 802.11 DLT_ value,
2190 * so this is an 802.11 interface.
2191 * new_dlt is the best of the 802.11
2192 * DLT_ values in the list.
2196 * Our caller wants monitor mode.
2197 * Purge DLT_EN10MB from the list
2198 * of link-layer types, as selecting
2199 * it will keep monitor mode off.
2201 remove_non_802_11(p
);
2204 * If the new mode we want isn't
2205 * the default mode, attempt to
2206 * select the new mode.
2208 if ((u_int
)new_dlt
!= v
) {
2209 if (ioctl(p
->fd
, BIOCSDLT
,
2221 * Our caller doesn't want
2222 * monitor mode. Unless this
2223 * is being done by pcap_open_live(),
2224 * purge the 802.11 link-layer types
2225 * from the list, as selecting
2226 * one of them will turn monitor
2235 * The caller requested monitor
2236 * mode, but we have no 802.11
2237 * link-layer types, so they
2240 status
= PCAP_ERROR_RFMON_NOTSUP
;
2246 #elif defined(HAVE_BSD_IEEE80211)
2248 * *BSD with the new 802.11 ioctls.
2249 * Do we want monitor mode?
2253 * Try to put the interface into monitor mode.
2255 retv
= monitor_mode(p
, 1);
2265 * We're in monitor mode.
2266 * Try to find the best 802.11 DLT_ value and, if we
2267 * succeed, try to switch to that mode if we're not
2268 * already in that mode.
2270 new_dlt
= find_802_11(&bdl
);
2271 if (new_dlt
!= -1) {
2273 * We have at least one 802.11 DLT_ value.
2274 * new_dlt is the best of the 802.11
2275 * DLT_ values in the list.
2277 * If the new mode we want isn't the default mode,
2278 * attempt to select the new mode.
2280 if ((u_int
)new_dlt
!= v
) {
2281 if (ioctl(p
->fd
, BIOCSDLT
, &new_dlt
) != -1) {
2283 * We succeeded; make this the
2291 #endif /* various platforms */
2292 #endif /* BIOCGDLTLIST */
2295 * If this is an Ethernet device, and we don't have a DLT_ list,
2296 * give it a list with DLT_EN10MB and DLT_DOCSIS. (That'd give
2297 * 802.11 interfaces DLT_DOCSIS, which isn't the right thing to
2298 * do, but there's not much we can do about that without finding
2299 * some other way of determining whether it's an Ethernet or 802.11
2302 if (v
== DLT_EN10MB
&& p
->dlt_count
== 0) {
2303 p
->dlt_list
= (u_int
*) malloc(sizeof(u_int
) * 2);
2305 * If that fails, just leave the list empty.
2307 if (p
->dlt_list
!= NULL
) {
2308 p
->dlt_list
[0] = DLT_EN10MB
;
2309 p
->dlt_list
[1] = DLT_DOCSIS
;
2315 p
->fddipad
= PCAP_FDDIPAD
;
2321 #if defined(BIOCGHDRCMPLT) && defined(BIOCSHDRCMPLT)
2323 * Do a BIOCSHDRCMPLT, if defined, to turn that flag on, so
2324 * the link-layer source address isn't forcibly overwritten.
2325 * (Should we ignore errors? Should we do this only if
2326 * we're open for writing?)
2328 * XXX - I seem to remember some packet-sending bug in some
2329 * BSDs - check CVS log for "bpf.c"?
2331 if (ioctl(fd
, BIOCSHDRCMPLT
, &spoof_eth_src
) == -1) {
2332 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2333 errno
, "BIOCSHDRCMPLT");
2334 status
= PCAP_ERROR
;
2339 #ifdef HAVE_ZEROCOPY_BPF
2341 * In zero-copy mode, we just use the timeout in select().
2342 * XXX - what if we're in non-blocking mode and the *application*
2343 * is using select() or poll() or kqueues or....?
2345 if (p
->opt
.timeout
&& !pb
->zerocopy
) {
2347 if (p
->opt
.timeout
) {
2350 * XXX - is this seconds/nanoseconds in AIX?
2351 * (Treating it as such doesn't fix the timeout
2352 * problem described below.)
2354 * XXX - Mac OS X 10.6 mishandles BIOCSRTIMEOUT in
2355 * 64-bit userland - it takes, as an argument, a
2356 * "struct BPF_TIMEVAL", which has 32-bit tv_sec
2357 * and tv_usec, rather than a "struct timeval".
2359 * If this platform defines "struct BPF_TIMEVAL",
2360 * we check whether the structure size in BIOCSRTIMEOUT
2361 * is that of a "struct timeval" and, if not, we use
2362 * a "struct BPF_TIMEVAL" rather than a "struct timeval".
2363 * (That way, if the bug is fixed in a future release,
2364 * we will still do the right thing.)
2367 #ifdef HAVE_STRUCT_BPF_TIMEVAL
2368 struct BPF_TIMEVAL bpf_to
;
2370 if (IOCPARM_LEN(BIOCSRTIMEOUT
) != sizeof(struct timeval
)) {
2371 bpf_to
.tv_sec
= p
->opt
.timeout
/ 1000;
2372 bpf_to
.tv_usec
= (p
->opt
.timeout
* 1000) % 1000000;
2373 if (ioctl(p
->fd
, BIOCSRTIMEOUT
, (caddr_t
)&bpf_to
) < 0) {
2374 pcap_fmt_errmsg_for_errno(p
->errbuf
,
2375 errno
, PCAP_ERRBUF_SIZE
, "BIOCSRTIMEOUT");
2376 status
= PCAP_ERROR
;
2381 to
.tv_sec
= p
->opt
.timeout
/ 1000;
2382 to
.tv_usec
= (p
->opt
.timeout
* 1000) % 1000000;
2383 if (ioctl(p
->fd
, BIOCSRTIMEOUT
, (caddr_t
)&to
) < 0) {
2384 pcap_fmt_errmsg_for_errno(p
->errbuf
,
2385 errno
, PCAP_ERRBUF_SIZE
, "BIOCSRTIMEOUT");
2386 status
= PCAP_ERROR
;
2389 #ifdef HAVE_STRUCT_BPF_TIMEVAL
2394 #ifdef BIOCIMMEDIATE
2396 * Darren Reed notes that
2398 * On AIX (4.2 at least), if BIOCIMMEDIATE is not set, the
2399 * timeout appears to be ignored and it waits until the buffer
2400 * is filled before returning. The result of not having it
2401 * set is almost worse than useless if your BPF filter
2402 * is reducing things to only a few packets (i.e. one every
2405 * so we always turn BIOCIMMEDIATE mode on if this is AIX.
2407 * For other platforms, we don't turn immediate mode on by default,
2408 * as that would mean we get woken up for every packet, which
2409 * probably isn't what you want for a packet sniffer.
2411 * We set immediate mode if the caller requested it by calling
2412 * pcap_set_immediate() before calling pcap_activate().
2415 if (p
->opt
.immediate
) {
2418 if (ioctl(p
->fd
, BIOCIMMEDIATE
, &v
) < 0) {
2419 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2420 errno
, "BIOCIMMEDIATE");
2421 status
= PCAP_ERROR
;
2427 #else /* BIOCIMMEDIATE */
2428 if (p
->opt
.immediate
) {
2430 * We don't support immediate mode. Fail.
2432 snprintf(p
->errbuf
, PCAP_ERRBUF_SIZE
, "Immediate mode not supported");
2433 status
= PCAP_ERROR
;
2436 #endif /* BIOCIMMEDIATE */
2438 if (p
->opt
.promisc
) {
2439 /* set promiscuous mode, just warn if it fails */
2440 if (ioctl(p
->fd
, BIOCPROMISC
, NULL
) < 0) {
2441 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2442 errno
, "BIOCPROMISC");
2443 status
= PCAP_WARNING_PROMISC_NOTSUP
;
2449 if (ioctl(p
->fd
, BIOCSTSTAMP
, &v
) < 0) {
2450 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2451 errno
, "BIOCSTSTAMP");
2452 status
= PCAP_ERROR
;
2455 #endif /* BIOCSTSTAMP */
2457 if (ioctl(fd
, BIOCGBLEN
, (caddr_t
)&v
) < 0) {
2458 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2459 errno
, "BIOCGBLEN");
2460 status
= PCAP_ERROR
;
2464 #ifdef HAVE_ZEROCOPY_BPF
2465 if (!pb
->zerocopy
) {
2467 p
->buffer
= malloc(p
->bufsize
);
2468 if (p
->buffer
== NULL
) {
2469 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2471 status
= PCAP_ERROR
;
2475 /* For some strange reason this seems to prevent the EFAULT
2476 * problems we have experienced from AIX BPF. */
2477 memset(p
->buffer
, 0x0, p
->bufsize
);
2479 #ifdef HAVE_ZEROCOPY_BPF
2484 * If there's no filter program installed, there's
2485 * no indication to the kernel of what the snapshot
2486 * length should be, so no snapshotting is done.
2488 * Therefore, when we open the device, we install
2489 * an "accept everything" filter with the specified
2492 total_insn
.code
= (u_short
)(BPF_RET
| BPF_K
);
2495 total_insn
.k
= p
->snapshot
;
2497 total_prog
.bf_len
= 1;
2498 total_prog
.bf_insns
= &total_insn
;
2499 if (ioctl(p
->fd
, BIOCSETF
, (caddr_t
)&total_prog
) < 0) {
2500 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2502 status
= PCAP_ERROR
;
2507 * On most BPF platforms, either you can do a "select()" or
2508 * "poll()" on a BPF file descriptor and it works correctly,
2509 * or you can do it and it will return "readable" if the
2510 * hold buffer is full but not if the timeout expires *and*
2511 * a non-blocking read will, if the hold buffer is empty
2512 * but the store buffer isn't empty, rotate the buffers
2513 * and return what packets are available.
2515 * In the latter case, the fact that a non-blocking read
2516 * will give you the available packets means you can work
2517 * around the failure of "select()" and "poll()" to wake up
2518 * and return "readable" when the timeout expires by using
2519 * the timeout as the "select()" or "poll()" timeout, putting
2520 * the BPF descriptor into non-blocking mode, and read from
2521 * it regardless of whether "select()" reports it as readable
2524 * However, in FreeBSD 4.3 and 4.4, "select()" and "poll()"
2525 * won't wake up and return "readable" if the timer expires
2526 * and non-blocking reads return EWOULDBLOCK if the hold
2527 * buffer is empty, even if the store buffer is non-empty.
2529 * This means the workaround in question won't work.
2531 * Therefore, on FreeBSD 4.3 and 4.4, we set "p->selectable_fd"
2532 * to -1, which means "sorry, you can't use 'select()' or 'poll()'
2533 * here". On all other BPF platforms, we set it to the FD for
2534 * the BPF device; in NetBSD, OpenBSD, and Darwin, a non-blocking
2535 * read will, if the hold buffer is empty and the store buffer
2536 * isn't empty, rotate the buffers and return what packets are
2537 * there (and in sufficiently recent versions of OpenBSD
2538 * "select()" and "poll()" should work correctly).
2540 * XXX - what about AIX?
2542 p
->selectable_fd
= p
->fd
; /* assume select() works until we know otherwise */
2545 * We can check what OS this is.
2547 if (strcmp(osinfo
.sysname
, "FreeBSD") == 0) {
2548 if (strncmp(osinfo
.release
, "4.3-", 4) == 0 ||
2549 strncmp(osinfo
.release
, "4.4-", 4) == 0)
2550 p
->selectable_fd
= -1;
2554 p
->read_op
= pcap_read_bpf
;
2555 p
->inject_op
= pcap_inject_bpf
;
2556 p
->setfilter_op
= pcap_setfilter_bpf
;
2557 p
->setdirection_op
= pcap_setdirection_bpf
;
2558 p
->set_datalink_op
= pcap_set_datalink_bpf
;
2559 p
->getnonblock_op
= pcap_getnonblock_bpf
;
2560 p
->setnonblock_op
= pcap_setnonblock_bpf
;
2561 p
->stats_op
= pcap_stats_bpf
;
2562 p
->cleanup_op
= pcap_cleanup_bpf
;
2566 pcap_cleanup_bpf(p
);
2571 * Not all interfaces can be bound to by BPF, so try to bind to
2572 * the specified interface; return 0 if we fail with
2573 * PCAP_ERROR_NO_SUCH_DEVICE (which means we got an ENXIO when we tried
2574 * to bind, which means this interface isn't in the list of interfaces
2575 * attached to BPF) and 1 otherwise.
2578 check_bpf_bindable(const char *name
)
2581 char errbuf
[PCAP_ERRBUF_SIZE
];
2584 * On macOS, we don't do this check if the device name begins
2585 * with "wlt"; at least some versions of macOS (actually, it
2586 * was called "Mac OS X" then...) offer monitor mode capturing
2587 * by having a separate "monitor mode" device for each wireless
2588 * adapter, rather than by implementing the ioctls that
2589 * {Free,Net,Open,DragonFly}BSD provide. Opening that device
2590 * puts the adapter into monitor mode, which, at least for
2591 * some adapters, causes them to deassociate from the network
2592 * with which they're associated.
2594 * Instead, we try to open the corresponding "en" device (so
2595 * that we don't end up with, for users without sufficient
2596 * privilege to open capture devices, a list of adapters that
2597 * only includes the wlt devices).
2600 if (strncmp(name
, "wlt", 3) == 0) {
2605 * Try to allocate a buffer for the "en"
2608 en_name_len
= strlen(name
) - 1;
2609 en_name
= malloc(en_name_len
+ 1);
2610 if (en_name
== NULL
) {
2611 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
,
2615 strcpy(en_name
, "en");
2616 strcat(en_name
, name
+ 3);
2617 fd
= bpf_open_and_bind(en_name
, errbuf
);
2620 #endif /* __APPLE */
2621 fd
= bpf_open_and_bind(name
, errbuf
);
2624 * Error - was it PCAP_ERROR_NO_SUCH_DEVICE?
2626 if (fd
== PCAP_ERROR_NO_SUCH_DEVICE
) {
2628 * Yes, so we can't bind to this because it's
2629 * not something supported by BPF.
2634 * No, so we don't know whether it's supported or not;
2635 * say it is, so that the user can at least try to
2636 * open it and report the error (which is probably
2637 * "you don't have permission to open BPF devices";
2638 * reporting those interfaces means users will ask
2639 * "why am I getting a permissions error when I try
2640 * to capture" rather than "why am I not seeing any
2641 * interfaces", making the underlying problem clearer).
2653 #if defined(__FreeBSD__) && defined(SIOCIFCREATE2)
2655 get_usb_if_flags(const char *name _U_
, bpf_u_int32
*flags _U_
, char *errbuf _U_
)
2658 * XXX - if there's a way to determine whether there's something
2659 * plugged into a given USB bus, use that to determine whether
2660 * this device is "connected" or not.
2666 finddevs_usb(pcap_if_list_t
*devlistp
, char *errbuf
)
2669 struct dirent
*usbitem
;
2674 * We might have USB sniffing support, so try looking for USB
2677 * We want to report a usbusN device for each USB bus, but
2678 * usbusN interfaces might, or might not, exist for them -
2679 * we create one if there isn't already one.
2681 * So, instead, we look in /dev/usb for all buses and create
2682 * a "usbusN" device for each one.
2684 usbdir
= opendir("/dev/usb");
2685 if (usbdir
== NULL
) {
2693 * Leave enough room for a 32-bit (10-digit) bus number.
2694 * Yes, that's overkill, but we won't be using
2695 * the buffer very long.
2697 name_max
= USBUS_PREFIX_LEN
+ 10 + 1;
2698 name
= malloc(name_max
);
2703 while ((usbitem
= readdir(usbdir
)) != NULL
) {
2707 if (strcmp(usbitem
->d_name
, ".") == 0 ||
2708 strcmp(usbitem
->d_name
, "..") == 0) {
2714 p
= strchr(usbitem
->d_name
, '.');
2717 busnumlen
= p
- usbitem
->d_name
;
2718 memcpy(name
, usbus_prefix
, USBUS_PREFIX_LEN
);
2719 memcpy(name
+ USBUS_PREFIX_LEN
, usbitem
->d_name
, busnumlen
);
2720 *(name
+ USBUS_PREFIX_LEN
+ busnumlen
) = '\0';
2722 * There's an entry in this directory for every USB device,
2723 * not for every bus; if there's more than one device on
2724 * the bus, there'll be more than one entry for that bus,
2725 * so we need to avoid adding multiple capture devices
2728 if (find_or_add_dev(devlistp
, name
, PCAP_IF_UP
,
2729 get_usb_if_flags
, NULL
, errbuf
) == NULL
) {
2732 return (PCAP_ERROR
);
2742 * Get additional flags for a device, using SIOCGIFMEDIA.
2746 get_if_flags(const char *name
, bpf_u_int32
*flags
, char *errbuf
)
2749 struct ifmediareq req
;
2751 sock
= socket(AF_INET
, SOCK_DGRAM
, 0);
2753 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
, errno
,
2754 "Can't create socket to get media information for %s",
2758 memset(&req
, 0, sizeof(req
));
2759 strncpy(req
.ifm_name
, name
, sizeof(req
.ifm_name
));
2760 if (ioctl(sock
, SIOCGIFMEDIA
, &req
) < 0) {
2761 if (errno
== EOPNOTSUPP
|| errno
== EINVAL
|| errno
== ENOTTY
||
2762 errno
== ENODEV
|| errno
== EPERM
) {
2764 * Not supported, so we can't provide any
2765 * additional information. Assume that
2766 * this means that "connected" vs.
2767 * "disconnected" doesn't apply.
2769 * The ioctl routine for Apple's pktap devices,
2770 * annoyingly, checks for "are you root?" before
2771 * checking whether the ioctl is valid, so it
2772 * returns EPERM, rather than ENOTSUP, for the
2773 * invalid SIOCGIFMEDIA, unless you're root.
2774 * So, just as we do for some ethtool ioctls
2775 * on Linux, which makes the same mistake, we
2776 * also treat EPERM as meaning "not supported".
2778 *flags
|= PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
;
2782 pcap_fmt_errmsg_for_errno(errbuf
, PCAP_ERRBUF_SIZE
, errno
,
2783 "SIOCGIFMEDIA on %s failed", name
);
2790 * OK, what type of network is this?
2792 switch (IFM_TYPE(req
.ifm_active
)) {
2798 *flags
|= PCAP_IF_WIRELESS
;
2803 * Do we know whether it's connected?
2805 if (req
.ifm_status
& IFM_AVALID
) {
2809 if (req
.ifm_status
& IFM_ACTIVE
) {
2813 *flags
|= PCAP_IF_CONNECTION_STATUS_CONNECTED
;
2816 * It's disconnected.
2818 *flags
|= PCAP_IF_CONNECTION_STATUS_DISCONNECTED
;
2825 get_if_flags(const char *name _U_
, bpf_u_int32
*flags _U_
, char *errbuf _U_
)
2828 * Nothing we can do other than mark loopback devices as "the
2829 * connected/disconnected status doesn't apply".
2831 * XXX - on Solaris, can we do what the dladm command does,
2832 * i.e. get a connected/disconnected indication from a kstat?
2833 * (Note that you can also get the link speed, and possibly
2834 * other information, from a kstat as well.)
2836 if (*flags
& PCAP_IF_LOOPBACK
) {
2838 * Loopback devices aren't wireless, and "connected"/
2839 * "disconnected" doesn't apply to them.
2841 *flags
|= PCAP_IF_CONNECTION_STATUS_NOT_APPLICABLE
;
2849 pcap_platform_finddevs(pcap_if_list_t
*devlistp
, char *errbuf
)
2852 * Get the list of regular interfaces first.
2854 if (pcap_findalldevs_interfaces(devlistp
, errbuf
, check_bpf_bindable
,
2855 get_if_flags
) == -1)
2856 return (-1); /* failure */
2858 #if defined(__FreeBSD__) && defined(SIOCIFCREATE2)
2859 if (finddevs_usb(devlistp
, errbuf
) == -1)
2866 #ifdef HAVE_BSD_IEEE80211
2868 monitor_mode(pcap_t
*p
, int set
)
2870 struct pcap_bpf
*pb
= p
->priv
;
2872 struct ifmediareq req
;
2873 IFM_ULIST_TYPE
*media_list
;
2878 sock
= socket(AF_INET
, SOCK_DGRAM
, 0);
2880 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2881 errno
, "can't open socket");
2882 return (PCAP_ERROR
);
2885 memset(&req
, 0, sizeof req
);
2886 strncpy(req
.ifm_name
, p
->opt
.device
, sizeof req
.ifm_name
);
2889 * Find out how many media types we have.
2891 if (ioctl(sock
, SIOCGIFMEDIA
, &req
) < 0) {
2893 * Can't get the media types.
2899 * There's no such device.
2902 return (PCAP_ERROR_NO_SUCH_DEVICE
);
2906 * Interface doesn't support SIOC{G,S}IFMEDIA.
2909 return (PCAP_ERROR_RFMON_NOTSUP
);
2912 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2913 errno
, "SIOCGIFMEDIA");
2915 return (PCAP_ERROR
);
2918 if (req
.ifm_count
== 0) {
2923 return (PCAP_ERROR_RFMON_NOTSUP
);
2927 * Allocate a buffer to hold all the media types, and
2928 * get the media types.
2930 media_list
= malloc(req
.ifm_count
* sizeof(*media_list
));
2931 if (media_list
== NULL
) {
2932 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2935 return (PCAP_ERROR
);
2937 req
.ifm_ulist
= media_list
;
2938 if (ioctl(sock
, SIOCGIFMEDIA
, &req
) < 0) {
2939 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
2940 errno
, "SIOCGIFMEDIA");
2943 return (PCAP_ERROR
);
2947 * Look for an 802.11 "automatic" media type.
2948 * We assume that all 802.11 adapters have that media type,
2949 * and that it will carry the monitor mode supported flag.
2952 for (i
= 0; i
< req
.ifm_count
; i
++) {
2953 if (IFM_TYPE(media_list
[i
]) == IFM_IEEE80211
2954 && IFM_SUBTYPE(media_list
[i
]) == IFM_AUTO
) {
2955 /* OK, does it do monitor mode? */
2956 if (media_list
[i
] & IFM_IEEE80211_MONITOR
) {
2965 * This adapter doesn't support monitor mode.
2968 return (PCAP_ERROR_RFMON_NOTSUP
);
2973 * Don't just check whether we can enable monitor mode,
2974 * do so, if it's not already enabled.
2976 if ((req
.ifm_current
& IFM_IEEE80211_MONITOR
) == 0) {
2978 * Monitor mode isn't currently on, so turn it on,
2979 * and remember that we should turn it off when the
2984 * If we haven't already done so, arrange to have
2985 * "pcap_close_all()" called when we exit.
2987 if (!pcap_do_addexit(p
)) {
2989 * "atexit()" failed; don't put the interface
2990 * in monitor mode, just give up.
2993 return (PCAP_ERROR
);
2995 memset(&ifr
, 0, sizeof(ifr
));
2996 (void)strncpy(ifr
.ifr_name
, p
->opt
.device
,
2997 sizeof(ifr
.ifr_name
));
2998 ifr
.ifr_media
= req
.ifm_current
| IFM_IEEE80211_MONITOR
;
2999 if (ioctl(sock
, SIOCSIFMEDIA
, &ifr
) == -1) {
3000 pcap_fmt_errmsg_for_errno(p
->errbuf
,
3001 PCAP_ERRBUF_SIZE
, errno
, "SIOCSIFMEDIA");
3003 return (PCAP_ERROR
);
3006 pb
->must_do_on_close
|= MUST_CLEAR_RFMON
;
3009 * Add this to the list of pcaps to close when we exit.
3011 pcap_add_to_pcaps_to_close(p
);
3016 #endif /* HAVE_BSD_IEEE80211 */
3018 #if defined(BIOCGDLTLIST) && (defined(__APPLE__) || defined(HAVE_BSD_IEEE80211))
3020 * Check whether we have any 802.11 link-layer types; return the best
3021 * of the 802.11 link-layer types if we find one, and return -1
3024 * DLT_IEEE802_11_RADIO, with the radiotap header, is considered the
3025 * best 802.11 link-layer type; any of the other 802.11-plus-radio
3026 * headers are second-best; 802.11 with no radio information is
3030 find_802_11(struct bpf_dltlist
*bdlp
)
3036 * Scan the list of DLT_ values, looking for 802.11 values,
3037 * and, if we find any, choose the best of them.
3040 for (i
= 0; i
< bdlp
->bfl_len
; i
++) {
3041 switch (bdlp
->bfl_list
[i
]) {
3043 case DLT_IEEE802_11
:
3045 * 802.11, but no radio.
3047 * Offer this, and select it as the new mode
3048 * unless we've already found an 802.11
3049 * header with radio information.
3052 new_dlt
= bdlp
->bfl_list
[i
];
3055 #ifdef DLT_PRISM_HEADER
3056 case DLT_PRISM_HEADER
:
3058 #ifdef DLT_AIRONET_HEADER
3059 case DLT_AIRONET_HEADER
:
3061 case DLT_IEEE802_11_RADIO_AVS
:
3063 * 802.11 with radio, but not radiotap.
3065 * Offer this, and select it as the new mode
3066 * unless we've already found the radiotap DLT_.
3068 if (new_dlt
!= DLT_IEEE802_11_RADIO
)
3069 new_dlt
= bdlp
->bfl_list
[i
];
3072 case DLT_IEEE802_11_RADIO
:
3074 * 802.11 with radiotap.
3076 * Offer this, and select it as the new mode.
3078 new_dlt
= bdlp
->bfl_list
[i
];
3091 #endif /* defined(BIOCGDLTLIST) && (defined(__APPLE__) || defined(HAVE_BSD_IEEE80211)) */
3093 #if defined(__APPLE__) && defined(BIOCGDLTLIST)
3095 * Remove non-802.11 header types from the list of DLT_ values, as we're in
3096 * monitor mode, and those header types aren't supported in monitor mode.
3099 remove_non_802_11(pcap_t
*p
)
3104 * Scan the list of DLT_ values and discard non-802.11 ones.
3107 for (i
= 0; i
< p
->dlt_count
; i
++) {
3108 switch (p
->dlt_list
[i
]) {
3113 * Not 802.11. Don't offer this one.
3119 * Just copy this mode over.
3125 * Copy this DLT_ value to its new position.
3127 p
->dlt_list
[j
] = p
->dlt_list
[i
];
3132 * Set the DLT_ count to the number of entries we copied.
3138 * Remove 802.11 link-layer types from the list of DLT_ values, as
3139 * we're not in monitor mode, and those DLT_ values will switch us
3143 remove_802_11(pcap_t
*p
)
3148 * Scan the list of DLT_ values and discard 802.11 values.
3151 for (i
= 0; i
< p
->dlt_count
; i
++) {
3152 switch (p
->dlt_list
[i
]) {
3154 case DLT_IEEE802_11
:
3155 #ifdef DLT_PRISM_HEADER
3156 case DLT_PRISM_HEADER
:
3158 #ifdef DLT_AIRONET_HEADER
3159 case DLT_AIRONET_HEADER
:
3161 case DLT_IEEE802_11_RADIO
:
3162 case DLT_IEEE802_11_RADIO_AVS
:
3167 * 802.11. Don't offer this one.
3173 * Just copy this mode over.
3179 * Copy this DLT_ value to its new position.
3181 p
->dlt_list
[j
] = p
->dlt_list
[i
];
3186 * Set the DLT_ count to the number of entries we copied.
3190 #endif /* defined(__APPLE__) && defined(BIOCGDLTLIST) */
3193 pcap_setfilter_bpf(pcap_t
*p
, struct bpf_program
*fp
)
3195 struct pcap_bpf
*pb
= p
->priv
;
3198 * Free any user-mode filter we might happen to have installed.
3200 pcap_freecode(&p
->fcode
);
3203 * Try to install the kernel filter.
3205 if (ioctl(p
->fd
, BIOCSETF
, (caddr_t
)fp
) == 0) {
3209 pb
->filtering_in_kernel
= 1; /* filtering in the kernel */
3212 * Discard any previously-received packets, as they might
3213 * have passed whatever filter was formerly in effect, but
3214 * might not pass this filter (BIOCSETF discards packets
3215 * buffered in the kernel, so you can lose packets in any
3225 * If it failed with EINVAL, that's probably because the program
3226 * is invalid or too big. Validate it ourselves; if we like it
3227 * (we currently allow backward branches, to support protochain),
3228 * run it in userland. (There's no notion of "too big" for
3231 * Otherwise, just give up.
3232 * XXX - if the copy of the program into the kernel failed,
3233 * we will get EINVAL rather than, say, EFAULT on at least
3236 if (errno
!= EINVAL
) {
3237 pcap_fmt_errmsg_for_errno(p
->errbuf
, PCAP_ERRBUF_SIZE
,
3243 * install_bpf_program() validates the program.
3245 * XXX - what if we already have a filter in the kernel?
3247 if (install_bpf_program(p
, fp
) < 0)
3249 pb
->filtering_in_kernel
= 0; /* filtering in userland */
3254 * Set direction flag: Which packets do we accept on a forwarding
3255 * single device? IN, OUT or both?
3257 #if defined(BIOCSDIRECTION)
3259 pcap_setdirection_bpf(pcap_t
*p
, pcap_direction_t d
)
3263 direction
= (d
== PCAP_D_IN
) ? BPF_D_IN
:
3264 ((d
== PCAP_D_OUT
) ? BPF_D_OUT
: BPF_D_INOUT
);
3265 if (ioctl(p
->fd
, BIOCSDIRECTION
, &direction
) == -1) {
3266 pcap_fmt_errmsg_for_errno(p
->errbuf
, sizeof(p
->errbuf
),
3267 errno
, "Cannot set direction to %s",
3268 (d
== PCAP_D_IN
) ? "PCAP_D_IN" :
3269 ((d
== PCAP_D_OUT
) ? "PCAP_D_OUT" : "PCAP_D_INOUT"));
3274 #elif defined(BIOCSSEESENT)
3276 pcap_setdirection_bpf(pcap_t
*p
, pcap_direction_t d
)
3281 * We don't support PCAP_D_OUT.
3283 if (d
== PCAP_D_OUT
) {
3284 snprintf(p
->errbuf
, sizeof(p
->errbuf
),
3285 "Setting direction to PCAP_D_OUT is not supported on BPF");
3289 seesent
= (d
== PCAP_D_INOUT
);
3290 if (ioctl(p
->fd
, BIOCSSEESENT
, &seesent
) == -1) {
3291 pcap_fmt_errmsg_for_errno(p
->errbuf
, sizeof(p
->errbuf
),
3292 errno
, "Cannot set direction to %s",
3293 (d
== PCAP_D_INOUT
) ? "PCAP_D_INOUT" : "PCAP_D_IN");
3300 pcap_setdirection_bpf(pcap_t
*p
, pcap_direction_t d _U_
)
3302 (void) snprintf(p
->errbuf
, sizeof(p
->errbuf
),
3303 "This system doesn't support BIOCSSEESENT, so the direction can't be set");
3310 pcap_set_datalink_bpf(pcap_t
*p
, int dlt
)
3312 if (ioctl(p
->fd
, BIOCSDLT
, &dlt
) == -1) {
3313 pcap_fmt_errmsg_for_errno(p
->errbuf
, sizeof(p
->errbuf
),
3314 errno
, "Cannot set DLT %d", dlt
);
3321 pcap_set_datalink_bpf(pcap_t
*p _U_
, int dlt _U_
)
3328 * Platform-specific information.
3331 pcap_lib_version(void)
3333 #ifdef HAVE_ZEROCOPY_BPF
3334 return (PCAP_VERSION_STRING
" (with zerocopy support)");
3336 return (PCAP_VERSION_STRING
);