2 * Copyright (c) 2006 Paolo Abeni (Italy)
5 * Redistribution and use in source and binary forms, with or without
6 * 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. The name of the author may not be used to endorse or promote
15 * products derived from this software without specific prior written
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 * Bluetooth sniffing API implementation for Linux platform
31 * By Paolo Abeni <paolo.abeni@email.it>
40 #include "pcap-bt-linux.h"
41 #include "pcap/bluetooth.h"
48 #include <sys/ioctl.h>
49 #include <sys/socket.h>
50 #include <arpa/inet.h>
52 #include <bluetooth/bluetooth.h>
53 #include <bluetooth/hci.h>
55 #define BT_IFACE "bluetooth"
56 #define BT_CTRL_SIZE 128
58 /* forward declaration */
59 static int bt_activate(pcap_t
*);
60 static int bt_read_linux(pcap_t
*, int , pcap_handler
, u_char
*);
61 static int bt_inject_linux(pcap_t
*, const void *, size_t);
62 static int bt_setdirection_linux(pcap_t
*, pcap_direction_t
);
63 static int bt_stats_linux(pcap_t
*, struct pcap_stat
*);
66 * Private data for capturing on Linux Bluetooth devices.
69 int dev_id
; /* device ID of device we're bound to */
73 bt_findalldevs(pcap_if_list_t
*devlistp
, char *err_str
)
75 struct hci_dev_list_req
*dev_list
;
76 struct hci_dev_req
*dev_req
;
81 sock
= socket(AF_BLUETOOTH
, SOCK_RAW
, BTPROTO_HCI
);
84 /* if bluetooth is not supported this is not fatal*/
85 if (errno
== EAFNOSUPPORT
)
87 pcap_fmt_errmsg_for_errno(err_str
, PCAP_ERRBUF_SIZE
,
88 errno
, "Can't open raw Bluetooth socket");
92 dev_list
= malloc(HCI_MAX_DEV
* sizeof(*dev_req
) + sizeof(*dev_list
));
95 pcap_snprintf(err_str
, PCAP_ERRBUF_SIZE
, "Can't allocate %zu bytes for Bluetooth device list",
96 HCI_MAX_DEV
* sizeof(*dev_req
) + sizeof(*dev_list
));
101 dev_list
->dev_num
= HCI_MAX_DEV
;
103 if (ioctl(sock
, HCIGETDEVLIST
, (void *) dev_list
) < 0)
105 pcap_fmt_errmsg_for_errno(err_str
, PCAP_ERRBUF_SIZE
,
106 errno
, "Can't get Bluetooth device list via ioctl");
111 dev_req
= dev_list
->dev_req
;
112 for (i
= 0; i
< dev_list
->dev_num
; i
++, dev_req
++) {
113 char dev_name
[20], dev_descr
[40];
115 pcap_snprintf(dev_name
, sizeof(dev_name
), BT_IFACE
"%u", dev_req
->dev_id
);
116 pcap_snprintf(dev_descr
, sizeof(dev_descr
), "Bluetooth adapter number %u", i
);
119 * Bluetooth is a wireless technology.
120 * XXX - if there's the notion of associating with a
121 * network, and we can determine whether the interface
122 * is associated with a network, check that and set
123 * the status to PCAP_IF_CONNECTION_STATUS_CONNECTED
124 * or PCAP_IF_CONNECTION_STATUS_DISCONNECTED.
126 if (add_dev(devlistp
, dev_name
, PCAP_IF_WIRELESS
, dev_descr
, err_str
) == NULL
)
142 bt_create(const char *device
, char *ebuf
, int *is_ours
)
149 /* Does this look like a Bluetooth device? */
150 cp
= strrchr(device
, '/');
153 /* Does it begin with BT_IFACE? */
154 if (strncmp(cp
, BT_IFACE
, sizeof BT_IFACE
- 1) != 0) {
155 /* Nope, doesn't begin with BT_IFACE */
159 /* Yes - is BT_IFACE followed by a number? */
160 cp
+= sizeof BT_IFACE
- 1;
161 devnum
= strtol(cp
, &cpend
, 10);
162 if (cpend
== cp
|| *cpend
!= '\0') {
163 /* Not followed by a number. */
168 /* Followed by a non-valid number. */
173 /* OK, it's probably ours. */
176 p
= pcap_create_common(ebuf
, sizeof (struct pcap_bt
));
180 p
->activate_op
= bt_activate
;
185 bt_activate(pcap_t
* handle
)
187 struct pcap_bt
*handlep
= handle
->priv
;
188 struct sockaddr_hci addr
;
191 struct hci_filter flt
;
192 int err
= PCAP_ERROR
;
194 /* get bt interface id */
195 if (sscanf(handle
->opt
.device
, BT_IFACE
"%d", &dev_id
) != 1)
197 pcap_snprintf(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
198 "Can't get Bluetooth device index from %s",
204 * Turn a negative snapshot value (invalid), a snapshot value of
205 * 0 (unspecified), or a value bigger than the normal maximum
206 * value, into the maximum allowed value.
208 * If some application really *needs* a bigger snapshot
209 * length, we should just increase MAXIMUM_SNAPLEN.
211 if (handle
->snapshot
<= 0 || handle
->snapshot
> MAXIMUM_SNAPLEN
)
212 handle
->snapshot
= MAXIMUM_SNAPLEN
;
214 /* Initialize some components of the pcap structure. */
215 handle
->bufsize
= BT_CTRL_SIZE
+sizeof(pcap_bluetooth_h4_header
)+handle
->snapshot
;
216 handle
->linktype
= DLT_BLUETOOTH_HCI_H4_WITH_PHDR
;
218 handle
->read_op
= bt_read_linux
;
219 handle
->inject_op
= bt_inject_linux
;
220 handle
->setfilter_op
= install_bpf_program
; /* no kernel filtering */
221 handle
->setdirection_op
= bt_setdirection_linux
;
222 handle
->set_datalink_op
= NULL
; /* can't change data link type */
223 handle
->getnonblock_op
= pcap_getnonblock_fd
;
224 handle
->setnonblock_op
= pcap_setnonblock_fd
;
225 handle
->stats_op
= bt_stats_linux
;
226 handlep
->dev_id
= dev_id
;
228 /* Create HCI socket */
229 handle
->fd
= socket(AF_BLUETOOTH
, SOCK_RAW
, BTPROTO_HCI
);
230 if (handle
->fd
< 0) {
231 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
232 errno
, "Can't create raw socket");
236 handle
->buffer
= malloc(handle
->bufsize
);
237 if (!handle
->buffer
) {
238 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
239 errno
, "Can't allocate dump buffer");
244 if (setsockopt(handle
->fd
, SOL_HCI
, HCI_DATA_DIR
, &opt
, sizeof(opt
)) < 0) {
245 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
246 errno
, "Can't enable data direction info");
251 if (setsockopt(handle
->fd
, SOL_HCI
, HCI_TIME_STAMP
, &opt
, sizeof(opt
)) < 0) {
252 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
253 errno
, "Can't enable time stamp");
257 /* Setup filter, do not call hci function to avoid dependence on
259 memset(&flt
, 0, sizeof(flt
));
260 memset((void *) &flt
.type_mask
, 0xff, sizeof(flt
.type_mask
));
261 memset((void *) &flt
.event_mask
, 0xff, sizeof(flt
.event_mask
));
262 if (setsockopt(handle
->fd
, SOL_HCI
, HCI_FILTER
, &flt
, sizeof(flt
)) < 0) {
263 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
264 errno
, "Can't set filter");
269 /* Bind socket to the HCI device */
270 addr
.hci_family
= AF_BLUETOOTH
;
271 addr
.hci_dev
= handlep
->dev_id
;
272 #ifdef HAVE_STRUCT_SOCKADDR_HCI_HCI_CHANNEL
273 addr
.hci_channel
= HCI_CHANNEL_RAW
;
275 if (bind(handle
->fd
, (struct sockaddr
*) &addr
, sizeof(addr
)) < 0) {
276 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
277 errno
, "Can't attach to device %d", handlep
->dev_id
);
281 if (handle
->opt
.rfmon
) {
283 * Monitor mode doesn't apply to Bluetooth devices.
285 err
= PCAP_ERROR_RFMON_NOTSUP
;
289 if (handle
->opt
.buffer_size
!= 0) {
291 * Set the socket buffer size to the specified value.
293 if (setsockopt(handle
->fd
, SOL_SOCKET
, SO_RCVBUF
,
294 &handle
->opt
.buffer_size
,
295 sizeof(handle
->opt
.buffer_size
)) == -1) {
296 pcap_fmt_errmsg_for_errno(handle
->errbuf
,
297 errno
, PCAP_ERRBUF_SIZE
, "SO_RCVBUF");
302 handle
->selectable_fd
= handle
->fd
;
306 pcap_cleanup_live_common(handle
);
311 bt_read_linux(pcap_t
*handle
, int max_packets _U_
, pcap_handler callback
, u_char
*user
)
313 struct cmsghdr
*cmsg
;
317 struct pcap_pkthdr pkth
;
318 pcap_bluetooth_h4_header
* bthdr
;
322 pktd
= (u_char
*)handle
->buffer
+ BT_CTRL_SIZE
;
323 bthdr
= (pcap_bluetooth_h4_header
*)(void *)pktd
;
324 iv
.iov_base
= pktd
+ sizeof(pcap_bluetooth_h4_header
);
325 iv
.iov_len
= handle
->snapshot
;
327 memset(&msg
, 0, sizeof(msg
));
330 msg
.msg_control
= handle
->buffer
;
331 msg
.msg_controllen
= BT_CTRL_SIZE
;
333 /* ignore interrupt system call error */
335 ret
= recvmsg(handle
->fd
, &msg
, 0);
336 if (handle
->break_loop
)
338 handle
->break_loop
= 0;
341 } while ((ret
== -1) && (errno
== EINTR
));
344 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
345 errno
, "Can't receive packet");
351 /* get direction and timestamp*/
352 cmsg
= CMSG_FIRSTHDR(&msg
);
354 switch (cmsg
->cmsg_type
) {
356 memcpy(&in
, CMSG_DATA(cmsg
), sizeof in
);
358 case HCI_CMSG_TSTAMP
:
359 memcpy(&pkth
.ts
, CMSG_DATA(cmsg
),
363 cmsg
= CMSG_NXTHDR(&msg
, cmsg
);
365 if ((in
&& (handle
->direction
== PCAP_D_OUT
)) ||
366 ((!in
) && (handle
->direction
== PCAP_D_IN
)))
369 bthdr
->direction
= htonl(in
!= 0);
370 pkth
.caplen
+=sizeof(pcap_bluetooth_h4_header
);
371 pkth
.len
= pkth
.caplen
;
372 if (handle
->fcode
.bf_insns
== NULL
||
373 bpf_filter(handle
->fcode
.bf_insns
, pktd
, pkth
.len
, pkth
.caplen
)) {
374 callback(user
, &pkth
, pktd
);
377 return 0; /* didn't pass filter */
381 bt_inject_linux(pcap_t
*handle
, const void *buf _U_
, size_t size _U_
)
383 pcap_snprintf(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
384 "Packet injection is not supported on Bluetooth devices");
390 bt_stats_linux(pcap_t
*handle
, struct pcap_stat
*stats
)
392 struct pcap_bt
*handlep
= handle
->priv
;
394 struct hci_dev_info dev_info
;
395 struct hci_dev_stats
* s
= &dev_info
.stat
;
396 dev_info
.dev_id
= handlep
->dev_id
;
400 ret
= ioctl(handle
->fd
, HCIGETDEVINFO
, (void *)&dev_info
);
401 } while ((ret
== -1) && (errno
== EINTR
));
404 pcap_fmt_errmsg_for_errno(handle
->errbuf
, PCAP_ERRBUF_SIZE
,
405 errno
, "Can't get stats via ioctl");
410 /* we receive both rx and tx frames, so comulate all stats */
411 stats
->ps_recv
= s
->evt_rx
+ s
->acl_rx
+ s
->sco_rx
+ s
->cmd_tx
+
412 s
->acl_tx
+s
->sco_tx
;
413 stats
->ps_drop
= s
->err_rx
+ s
->err_tx
;
414 stats
->ps_ifdrop
= 0;
419 bt_setdirection_linux(pcap_t
*p
, pcap_direction_t d
)