blob: 10eb9b389014259617de84924a297634fe9b61d4 [file] [log] [blame]
Gustavo Padovan38351c62012-05-22 19:00:20 -03001/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07002 BlueZ - Bluetooth protocol stack for Linux
3 Copyright (C) 2000-2001 Qualcomm Incorporated
4
5 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License version 2 as
9 published by the Free Software Foundation;
10
11 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
12 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
14 IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
Gustavo Padovan38351c62012-05-22 19:00:20 -030015 CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
16 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
17 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
Linus Torvalds1da177e2005-04-16 15:20:36 -070018 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
19
Gustavo Padovan38351c62012-05-22 19:00:20 -030020 ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
21 COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
Linus Torvalds1da177e2005-04-16 15:20:36 -070022 SOFTWARE IS DISCLAIMED.
23*/
24
25#ifndef __BLUETOOTH_H
26#define __BLUETOOTH_H
27
Linus Torvalds1da177e2005-04-16 15:20:36 -070028#include <linux/poll.h>
29#include <net/sock.h>
Masatake YAMATO256a06c2012-07-26 01:26:32 +090030#include <linux/seq_file.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070031
32#ifndef AF_BLUETOOTH
33#define AF_BLUETOOTH 31
34#define PF_BLUETOOTH AF_BLUETOOTH
35#endif
36
Andrei Emeltchenkod095c1e2011-12-01 14:33:27 +020037/* Bluetooth versions */
38#define BLUETOOTH_VER_1_1 1
39#define BLUETOOTH_VER_1_2 2
40#define BLUETOOTH_VER_2_0 3
41
Linus Torvalds1da177e2005-04-16 15:20:36 -070042/* Reserv for core and drivers use */
43#define BT_SKB_RESERVE 8
44
45#define BTPROTO_L2CAP 0
46#define BTPROTO_HCI 1
47#define BTPROTO_SCO 2
48#define BTPROTO_RFCOMM 3
49#define BTPROTO_BNEP 4
50#define BTPROTO_CMTP 5
51#define BTPROTO_HIDP 6
52#define BTPROTO_AVDTP 7
53
54#define SOL_HCI 0
55#define SOL_L2CAP 6
56#define SOL_SCO 17
57#define SOL_RFCOMM 18
58
Marcel Holtmann8c1b2352009-01-15 21:58:04 +010059#define BT_SECURITY 4
60struct bt_security {
61 __u8 level;
Vinicius Costa Gomes8f360112011-07-08 18:31:46 -030062 __u8 key_size;
Marcel Holtmann8c1b2352009-01-15 21:58:04 +010063};
64#define BT_SECURITY_SDP 0
65#define BT_SECURITY_LOW 1
66#define BT_SECURITY_MEDIUM 2
67#define BT_SECURITY_HIGH 3
68
Marcel Holtmannc4f912e2009-01-15 21:52:16 +010069#define BT_DEFER_SETUP 7
70
Andrei Emeltchenkoe7021122011-01-03 11:14:36 +020071#define BT_FLUSHABLE 8
72
73#define BT_FLUSHABLE_OFF 0
74#define BT_FLUSHABLE_ON 1
75
Jaikumar Ganesh14b12d02011-05-23 18:06:04 -070076#define BT_POWER 9
77struct bt_power {
78 __u8 force_active;
79};
80#define BT_POWER_FORCE_ACTIVE_OFF 0
81#define BT_POWER_FORCE_ACTIVE_ON 1
82
Mat Martineauc14968b2011-11-02 16:18:28 -070083#define BT_CHANNEL_POLICY 10
84
85/* BR/EDR only (default policy)
86 * AMP controllers cannot be used.
87 * Channel move requests from the remote device are denied.
88 * If the L2CAP channel is currently using AMP, move the channel to BR/EDR.
89 */
90#define BT_CHANNEL_POLICY_BREDR_ONLY 0
91
92/* BR/EDR Preferred
93 * Allow use of AMP controllers.
94 * If the L2CAP channel is currently on AMP, move it to BR/EDR.
95 * Channel move requests from the remote device are allowed.
96 */
97#define BT_CHANNEL_POLICY_BREDR_PREFERRED 1
98
99/* AMP Preferred
100 * Allow use of AMP controllers
101 * If the L2CAP channel is currently on BR/EDR and AMP controller
102 * resources are available, initiate a channel move to AMP.
103 * Channel move requests from the remote device are allowed.
104 * If the L2CAP socket has not been connected yet, try to create
105 * and configure the channel directly on an AMP controller rather
106 * than BR/EDR.
107 */
108#define BT_CHANNEL_POLICY_AMP_PREFERRED 2
109
Joe Perches3ed70032012-02-16 23:32:42 -0800110__printf(1, 2)
111int bt_info(const char *fmt, ...);
112__printf(1, 2)
113int bt_err(const char *fmt, ...);
Joe Perchese1447d82011-06-30 19:15:37 -0300114
Joe Perches3ed70032012-02-16 23:32:42 -0800115#define BT_INFO(fmt, ...) bt_info(fmt "\n", ##__VA_ARGS__)
116#define BT_ERR(fmt, ...) bt_err(fmt "\n", ##__VA_ARGS__)
117#define BT_DBG(fmt, ...) pr_debug(fmt "\n", ##__VA_ARGS__)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700118
Linus Torvalds1da177e2005-04-16 15:20:36 -0700119/* Connection and socket states */
120enum {
121 BT_CONNECTED = 1, /* Equal to TCP_ESTABLISHED to make net code happy */
122 BT_OPEN,
123 BT_BOUND,
124 BT_LISTEN,
125 BT_CONNECT,
126 BT_CONNECT2,
127 BT_CONFIG,
128 BT_DISCONN,
129 BT_CLOSED
130};
131
Andrei Emeltchenko20d18032012-02-17 11:40:55 +0200132/* If unused will be removed by compiler */
133static inline const char *state_to_string(int state)
134{
135 switch (state) {
136 case BT_CONNECTED:
137 return "BT_CONNECTED";
138 case BT_OPEN:
139 return "BT_OPEN";
140 case BT_BOUND:
141 return "BT_BOUND";
142 case BT_LISTEN:
143 return "BT_LISTEN";
144 case BT_CONNECT:
145 return "BT_CONNECT";
146 case BT_CONNECT2:
147 return "BT_CONNECT2";
148 case BT_CONFIG:
149 return "BT_CONFIG";
150 case BT_DISCONN:
151 return "BT_DISCONN";
152 case BT_CLOSED:
153 return "BT_CLOSED";
154 }
155
156 return "invalid state";
157}
158
Linus Torvalds1da177e2005-04-16 15:20:36 -0700159/* BD Address */
160typedef struct {
161 __u8 b[6];
Gustavo F. Padovan66c853c2010-07-19 02:00:13 -0300162} __packed bdaddr_t;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700163
Andre Guedes591f47f2012-04-24 21:02:49 -0300164/* BD Address type */
165#define BDADDR_BREDR 0x00
166#define BDADDR_LE_PUBLIC 0x01
167#define BDADDR_LE_RANDOM 0x02
168
Johan Hedberg679efe22013-01-20 14:27:18 +0200169static inline bool bdaddr_type_is_valid(__u8 type)
170{
171 switch (type) {
172 case BDADDR_BREDR:
173 case BDADDR_LE_PUBLIC:
174 case BDADDR_LE_RANDOM:
175 return true;
176 }
177
178 return false;
179}
180
181static inline bool bdaddr_type_is_le(__u8 type)
182{
183 switch (type) {
184 case BDADDR_LE_PUBLIC:
185 case BDADDR_LE_RANDOM:
186 return true;
187 }
188
189 return false;
190}
191
Gustavo Padovanc3c7ea62012-05-23 04:04:20 -0300192#define BDADDR_ANY (&(bdaddr_t) {{0, 0, 0, 0, 0, 0} })
193#define BDADDR_LOCAL (&(bdaddr_t) {{0, 0, 0, 0xff, 0xff, 0xff} })
Linus Torvalds1da177e2005-04-16 15:20:36 -0700194
195/* Copy, swap, convert BD Address */
David Herrmannf53c20e2013-04-06 20:28:42 +0200196static inline int bacmp(const bdaddr_t *ba1, const bdaddr_t *ba2)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700197{
198 return memcmp(ba1, ba2, sizeof(bdaddr_t));
199}
David Herrmannf53c20e2013-04-06 20:28:42 +0200200static inline void bacpy(bdaddr_t *dst, const bdaddr_t *src)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700201{
202 memcpy(dst, src, sizeof(bdaddr_t));
203}
204
205void baswap(bdaddr_t *dst, bdaddr_t *src);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700206
207/* Common socket structures and functions */
208
209#define bt_sk(__sk) ((struct bt_sock *) __sk)
210
211struct bt_sock {
212 struct sock sk;
213 bdaddr_t src;
214 bdaddr_t dst;
215 struct list_head accept_q;
216 struct sock *parent;
Gustavo Padovanc5daa682012-05-16 12:17:10 -0300217 unsigned long flags;
218};
219
220enum {
221 BT_SK_DEFER_SETUP,
222 BT_SK_SUSPEND,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700223};
224
225struct bt_sock_list {
226 struct hlist_head head;
227 rwlock_t lock;
Masatake YAMATO256a06c2012-07-26 01:26:32 +0900228#ifdef CONFIG_PROC_FS
Masatake YAMATO256a06c2012-07-26 01:26:32 +0900229 int (* custom_seq_show)(struct seq_file *, void *);
230#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700231};
232
Stephen Hemmingerec1b4cf2009-10-05 05:58:39 +0000233int bt_sock_register(int proto, const struct net_proto_family *ops);
David Herrmannbe9f97f2013-02-24 19:36:52 +0100234void bt_sock_unregister(int proto);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700235void bt_sock_link(struct bt_sock_list *l, struct sock *s);
236void bt_sock_unlink(struct bt_sock_list *l, struct sock *s);
Waldemar Rymarkiewicz5a9d0a32011-06-07 11:18:06 +0200237int bt_sock_recvmsg(struct kiocb *iocb, struct socket *sock,
238 struct msghdr *msg, size_t len, int flags);
Mat Martineau796c86e2010-09-08 10:05:27 -0700239int bt_sock_stream_recvmsg(struct kiocb *iocb, struct socket *sock,
240 struct msghdr *msg, size_t len, int flags);
Gustavo Padovanc3c7ea62012-05-23 04:04:20 -0300241uint bt_sock_poll(struct file *file, struct socket *sock, poll_table *wait);
Marcel Holtmann3241ad82008-07-14 20:13:50 +0200242int bt_sock_ioctl(struct socket *sock, unsigned int cmd, unsigned long arg);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700243int bt_sock_wait_state(struct sock *sk, int state, unsigned long timeo);
244
245void bt_accept_enqueue(struct sock *parent, struct sock *sk);
246void bt_accept_unlink(struct sock *sk);
247struct sock *bt_accept_dequeue(struct sock *parent, struct socket *newsock);
248
249/* Skb helpers */
Mat Martineau00e31122012-03-23 16:56:56 -0700250struct l2cap_ctrl {
Gustavo Padovanc3c7ea62012-05-23 04:04:20 -0300251 unsigned int sframe:1,
252 poll:1,
253 final:1,
254 fcs:1,
255 sar:2,
256 super:2;
Mat Martineau00e31122012-03-23 16:56:56 -0700257 __u16 reqseq;
258 __u16 txseq;
259 __u8 retries;
260};
261
Johan Hedberg3119ae92013-03-05 20:37:44 +0200262struct hci_dev;
263
264typedef void (*hci_req_complete_t)(struct hci_dev *hdev, u8 status);
265
266struct hci_req_ctrl {
267 bool start;
Johan Hedberg02350a72013-04-03 21:50:29 +0300268 u8 event;
Johan Hedberg3119ae92013-03-05 20:37:44 +0200269 hci_req_complete_t complete;
270};
271
Linus Torvalds1da177e2005-04-16 15:20:36 -0700272struct bt_skb_cb {
Marcel Holtmann0d48d932005-08-09 20:30:28 -0700273 __u8 pkt_type;
274 __u8 incoming;
Suraj Sumangala33e882a2010-07-14 13:02:17 +0530275 __u16 expect;
Jaikumar Ganesh14b12d02011-05-23 18:06:04 -0700276 __u8 force_active;
Mat Martineau00e31122012-03-23 16:56:56 -0700277 struct l2cap_ctrl control;
Johan Hedberg3119ae92013-03-05 20:37:44 +0200278 struct hci_req_ctrl req;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700279};
Gustavo F. Padovan1c2acff2009-08-20 22:25:57 -0300280#define bt_cb(skb) ((struct bt_skb_cb *)((skb)->cb))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700281
Al Virodd0fc662005-10-07 07:46:04 +0100282static inline struct sk_buff *bt_skb_alloc(unsigned int len, gfp_t how)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700283{
284 struct sk_buff *skb;
285
Gustavo Padovanc3c7ea62012-05-23 04:04:20 -0300286 skb = alloc_skb(len + BT_SKB_RESERVE, how);
287 if (skb) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700288 skb_reserve(skb, BT_SKB_RESERVE);
289 bt_cb(skb)->incoming = 0;
290 }
291 return skb;
292}
293
Waldemar Rymarkiewicz5a9d0a32011-06-07 11:18:06 +0200294static inline struct sk_buff *bt_skb_send_alloc(struct sock *sk,
295 unsigned long len, int nb, int *err)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700296{
297 struct sk_buff *skb;
298
Gustavo Padovanc3c7ea62012-05-23 04:04:20 -0300299 skb = sock_alloc_send_skb(sk, len + BT_SKB_RESERVE, nb, err);
300 if (skb) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700301 skb_reserve(skb, BT_SKB_RESERVE);
302 bt_cb(skb)->incoming = 0;
303 }
Gustavo F. Padovane454c842010-09-21 16:31:11 -0300304
305 if (!skb && *err)
306 return NULL;
307
308 *err = sock_error(sk);
309 if (*err)
310 goto out;
311
312 if (sk->sk_shutdown) {
313 *err = -ECONNRESET;
314 goto out;
315 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700316
317 return skb;
Gustavo F. Padovane454c842010-09-21 16:31:11 -0300318
319out:
320 kfree_skb(skb);
321 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700322}
323
Joe Perchese1750722011-06-29 18:18:29 -0700324int bt_to_errno(__u16 code);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700325
Marcel Holtmann65164552005-10-28 19:20:48 +0200326extern int hci_sock_init(void);
Tobias Klauser04005dd2008-03-05 18:47:03 -0800327extern void hci_sock_cleanup(void);
Marcel Holtmann65164552005-10-28 19:20:48 +0200328
329extern int bt_sysfs_init(void);
330extern void bt_sysfs_cleanup(void);
331
Al Virob0316612013-04-04 19:14:33 -0400332extern int bt_procfs_init(struct net *net, const char *name,
Masatake YAMATO256a06c2012-07-26 01:26:32 +0900333 struct bt_sock_list* sk_list,
334 int (* seq_show)(struct seq_file *, void *));
335extern void bt_procfs_cleanup(struct net *net, const char *name);
336
Marcel Holtmannaef7d972010-03-21 05:27:45 +0100337extern struct dentry *bt_debugfs;
Marcel Holtmannbe9d1222005-11-08 09:57:38 -0800338
Gustavo F. Padovan64274512011-02-07 20:08:52 -0200339int l2cap_init(void);
340void l2cap_exit(void);
Gustavo F. Padovan64274512011-02-07 20:08:52 -0200341
Gustavo F. Padovan64274512011-02-07 20:08:52 -0200342int sco_init(void);
343void sco_exit(void);
Gustavo F. Padovan64274512011-02-07 20:08:52 -0200344
Octavian Purdilad22015a2012-01-22 00:28:34 +0200345void bt_sock_reclassify_lock(struct sock *sk, int proto);
346
Linus Torvalds1da177e2005-04-16 15:20:36 -0700347#endif /* __BLUETOOTH_H */