Loading...
1/*
2 BlueZ - Bluetooth protocol stack for Linux
3 Copyright (C) 2000-2001 Qualcomm Incorporated
4 Copyright (C) 2009-2010 Gustavo F. Padovan <gustavo@padovan.org>
5 Copyright (C) 2010 Google Inc.
6
7 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
8
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License version 2 as
11 published by the Free Software Foundation;
12
13 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
14 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
16 IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
17 CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
18 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
19 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
20 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21
22 ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
23 COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
24 SOFTWARE IS DISCLAIMED.
25*/
26
27#ifndef __L2CAP_H
28#define __L2CAP_H
29
30#include <asm/unaligned.h>
31#include <linux/atomic.h>
32
33/* L2CAP defaults */
34#define L2CAP_DEFAULT_MTU 672
35#define L2CAP_DEFAULT_MIN_MTU 48
36#define L2CAP_DEFAULT_FLUSH_TO 0xFFFF
37#define L2CAP_EFS_DEFAULT_FLUSH_TO 0xFFFFFFFF
38#define L2CAP_DEFAULT_TX_WINDOW 63
39#define L2CAP_DEFAULT_EXT_WINDOW 0x3FFF
40#define L2CAP_DEFAULT_MAX_TX 3
41#define L2CAP_DEFAULT_RETRANS_TO 2000 /* 2 seconds */
42#define L2CAP_DEFAULT_MONITOR_TO 12000 /* 12 seconds */
43#define L2CAP_DEFAULT_MAX_PDU_SIZE 1492 /* Sized for AMP packet */
44#define L2CAP_DEFAULT_ACK_TO 200
45#define L2CAP_DEFAULT_MAX_SDU_SIZE 0xFFFF
46#define L2CAP_DEFAULT_SDU_ITIME 0xFFFFFFFF
47#define L2CAP_DEFAULT_ACC_LAT 0xFFFFFFFF
48#define L2CAP_BREDR_MAX_PAYLOAD 1019 /* 3-DH5 packet */
49#define L2CAP_LE_MIN_MTU 23
50
51#define L2CAP_DISC_TIMEOUT msecs_to_jiffies(100)
52#define L2CAP_DISC_REJ_TIMEOUT msecs_to_jiffies(5000)
53#define L2CAP_ENC_TIMEOUT msecs_to_jiffies(5000)
54#define L2CAP_CONN_TIMEOUT msecs_to_jiffies(40000)
55#define L2CAP_INFO_TIMEOUT msecs_to_jiffies(4000)
56#define L2CAP_MOVE_TIMEOUT msecs_to_jiffies(4000)
57#define L2CAP_MOVE_ERTX_TIMEOUT msecs_to_jiffies(60000)
58#define L2CAP_WAIT_ACK_POLL_PERIOD msecs_to_jiffies(200)
59#define L2CAP_WAIT_ACK_TIMEOUT msecs_to_jiffies(10000)
60
61#define L2CAP_A2MP_DEFAULT_MTU 670
62
63/* L2CAP socket address */
64struct sockaddr_l2 {
65 sa_family_t l2_family;
66 __le16 l2_psm;
67 bdaddr_t l2_bdaddr;
68 __le16 l2_cid;
69 __u8 l2_bdaddr_type;
70};
71
72/* L2CAP socket options */
73#define L2CAP_OPTIONS 0x01
74struct l2cap_options {
75 __u16 omtu;
76 __u16 imtu;
77 __u16 flush_to;
78 __u8 mode;
79 __u8 fcs;
80 __u8 max_tx;
81 __u16 txwin_size;
82};
83
84#define L2CAP_CONNINFO 0x02
85struct l2cap_conninfo {
86 __u16 hci_handle;
87 __u8 dev_class[3];
88};
89
90#define L2CAP_LM 0x03
91#define L2CAP_LM_MASTER 0x0001
92#define L2CAP_LM_AUTH 0x0002
93#define L2CAP_LM_ENCRYPT 0x0004
94#define L2CAP_LM_TRUSTED 0x0008
95#define L2CAP_LM_RELIABLE 0x0010
96#define L2CAP_LM_SECURE 0x0020
97#define L2CAP_LM_FIPS 0x0040
98
99/* L2CAP command codes */
100#define L2CAP_COMMAND_REJ 0x01
101#define L2CAP_CONN_REQ 0x02
102#define L2CAP_CONN_RSP 0x03
103#define L2CAP_CONF_REQ 0x04
104#define L2CAP_CONF_RSP 0x05
105#define L2CAP_DISCONN_REQ 0x06
106#define L2CAP_DISCONN_RSP 0x07
107#define L2CAP_ECHO_REQ 0x08
108#define L2CAP_ECHO_RSP 0x09
109#define L2CAP_INFO_REQ 0x0a
110#define L2CAP_INFO_RSP 0x0b
111#define L2CAP_CREATE_CHAN_REQ 0x0c
112#define L2CAP_CREATE_CHAN_RSP 0x0d
113#define L2CAP_MOVE_CHAN_REQ 0x0e
114#define L2CAP_MOVE_CHAN_RSP 0x0f
115#define L2CAP_MOVE_CHAN_CFM 0x10
116#define L2CAP_MOVE_CHAN_CFM_RSP 0x11
117#define L2CAP_CONN_PARAM_UPDATE_REQ 0x12
118#define L2CAP_CONN_PARAM_UPDATE_RSP 0x13
119#define L2CAP_LE_CONN_REQ 0x14
120#define L2CAP_LE_CONN_RSP 0x15
121#define L2CAP_LE_CREDITS 0x16
122
123/* L2CAP extended feature mask */
124#define L2CAP_FEAT_FLOWCTL 0x00000001
125#define L2CAP_FEAT_RETRANS 0x00000002
126#define L2CAP_FEAT_BIDIR_QOS 0x00000004
127#define L2CAP_FEAT_ERTM 0x00000008
128#define L2CAP_FEAT_STREAMING 0x00000010
129#define L2CAP_FEAT_FCS 0x00000020
130#define L2CAP_FEAT_EXT_FLOW 0x00000040
131#define L2CAP_FEAT_FIXED_CHAN 0x00000080
132#define L2CAP_FEAT_EXT_WINDOW 0x00000100
133#define L2CAP_FEAT_UCD 0x00000200
134
135/* L2CAP checksum option */
136#define L2CAP_FCS_NONE 0x00
137#define L2CAP_FCS_CRC16 0x01
138
139/* L2CAP fixed channels */
140#define L2CAP_FC_SIG_BREDR 0x02
141#define L2CAP_FC_CONNLESS 0x04
142#define L2CAP_FC_A2MP 0x08
143#define L2CAP_FC_ATT 0x10
144#define L2CAP_FC_SIG_LE 0x20
145#define L2CAP_FC_SMP_LE 0x40
146#define L2CAP_FC_SMP_BREDR 0x80
147
148/* L2CAP Control Field bit masks */
149#define L2CAP_CTRL_SAR 0xC000
150#define L2CAP_CTRL_REQSEQ 0x3F00
151#define L2CAP_CTRL_TXSEQ 0x007E
152#define L2CAP_CTRL_SUPERVISE 0x000C
153
154#define L2CAP_CTRL_RETRANS 0x0080
155#define L2CAP_CTRL_FINAL 0x0080
156#define L2CAP_CTRL_POLL 0x0010
157#define L2CAP_CTRL_FRAME_TYPE 0x0001 /* I- or S-Frame */
158
159#define L2CAP_CTRL_TXSEQ_SHIFT 1
160#define L2CAP_CTRL_SUPER_SHIFT 2
161#define L2CAP_CTRL_POLL_SHIFT 4
162#define L2CAP_CTRL_FINAL_SHIFT 7
163#define L2CAP_CTRL_REQSEQ_SHIFT 8
164#define L2CAP_CTRL_SAR_SHIFT 14
165
166/* L2CAP Extended Control Field bit mask */
167#define L2CAP_EXT_CTRL_TXSEQ 0xFFFC0000
168#define L2CAP_EXT_CTRL_SAR 0x00030000
169#define L2CAP_EXT_CTRL_SUPERVISE 0x00030000
170#define L2CAP_EXT_CTRL_REQSEQ 0x0000FFFC
171
172#define L2CAP_EXT_CTRL_POLL 0x00040000
173#define L2CAP_EXT_CTRL_FINAL 0x00000002
174#define L2CAP_EXT_CTRL_FRAME_TYPE 0x00000001 /* I- or S-Frame */
175
176#define L2CAP_EXT_CTRL_FINAL_SHIFT 1
177#define L2CAP_EXT_CTRL_REQSEQ_SHIFT 2
178#define L2CAP_EXT_CTRL_SAR_SHIFT 16
179#define L2CAP_EXT_CTRL_SUPER_SHIFT 16
180#define L2CAP_EXT_CTRL_POLL_SHIFT 18
181#define L2CAP_EXT_CTRL_TXSEQ_SHIFT 18
182
183/* L2CAP Supervisory Function */
184#define L2CAP_SUPER_RR 0x00
185#define L2CAP_SUPER_REJ 0x01
186#define L2CAP_SUPER_RNR 0x02
187#define L2CAP_SUPER_SREJ 0x03
188
189/* L2CAP Segmentation and Reassembly */
190#define L2CAP_SAR_UNSEGMENTED 0x00
191#define L2CAP_SAR_START 0x01
192#define L2CAP_SAR_END 0x02
193#define L2CAP_SAR_CONTINUE 0x03
194
195/* L2CAP Command rej. reasons */
196#define L2CAP_REJ_NOT_UNDERSTOOD 0x0000
197#define L2CAP_REJ_MTU_EXCEEDED 0x0001
198#define L2CAP_REJ_INVALID_CID 0x0002
199
200/* L2CAP structures */
201struct l2cap_hdr {
202 __le16 len;
203 __le16 cid;
204} __packed;
205#define L2CAP_HDR_SIZE 4
206#define L2CAP_ENH_HDR_SIZE 6
207#define L2CAP_EXT_HDR_SIZE 8
208
209#define L2CAP_FCS_SIZE 2
210#define L2CAP_SDULEN_SIZE 2
211#define L2CAP_PSMLEN_SIZE 2
212#define L2CAP_ENH_CTRL_SIZE 2
213#define L2CAP_EXT_CTRL_SIZE 4
214
215struct l2cap_cmd_hdr {
216 __u8 code;
217 __u8 ident;
218 __le16 len;
219} __packed;
220#define L2CAP_CMD_HDR_SIZE 4
221
222struct l2cap_cmd_rej_unk {
223 __le16 reason;
224} __packed;
225
226struct l2cap_cmd_rej_mtu {
227 __le16 reason;
228 __le16 max_mtu;
229} __packed;
230
231struct l2cap_cmd_rej_cid {
232 __le16 reason;
233 __le16 scid;
234 __le16 dcid;
235} __packed;
236
237struct l2cap_conn_req {
238 __le16 psm;
239 __le16 scid;
240} __packed;
241
242struct l2cap_conn_rsp {
243 __le16 dcid;
244 __le16 scid;
245 __le16 result;
246 __le16 status;
247} __packed;
248
249/* protocol/service multiplexer (PSM) */
250#define L2CAP_PSM_SDP 0x0001
251#define L2CAP_PSM_RFCOMM 0x0003
252#define L2CAP_PSM_3DSP 0x0021
253#define L2CAP_PSM_IPSP 0x0023 /* 6LoWPAN */
254
255#define L2CAP_PSM_DYN_START 0x1001
256#define L2CAP_PSM_DYN_END 0xffff
257#define L2CAP_PSM_AUTO_END 0x10ff
258#define L2CAP_PSM_LE_DYN_START 0x0080
259#define L2CAP_PSM_LE_DYN_END 0x00ff
260
261/* channel identifier */
262#define L2CAP_CID_SIGNALING 0x0001
263#define L2CAP_CID_CONN_LESS 0x0002
264#define L2CAP_CID_A2MP 0x0003
265#define L2CAP_CID_ATT 0x0004
266#define L2CAP_CID_LE_SIGNALING 0x0005
267#define L2CAP_CID_SMP 0x0006
268#define L2CAP_CID_SMP_BREDR 0x0007
269#define L2CAP_CID_DYN_START 0x0040
270#define L2CAP_CID_DYN_END 0xffff
271#define L2CAP_CID_LE_DYN_END 0x007f
272
273/* connect/create channel results */
274#define L2CAP_CR_SUCCESS 0x0000
275#define L2CAP_CR_PEND 0x0001
276#define L2CAP_CR_BAD_PSM 0x0002
277#define L2CAP_CR_SEC_BLOCK 0x0003
278#define L2CAP_CR_NO_MEM 0x0004
279#define L2CAP_CR_BAD_AMP 0x0005
280#define L2CAP_CR_INVALID_SCID 0x0006
281#define L2CAP_CR_SCID_IN_USE 0x0007
282
283/* credit based connect results */
284#define L2CAP_CR_LE_SUCCESS 0x0000
285#define L2CAP_CR_LE_BAD_PSM 0x0002
286#define L2CAP_CR_LE_NO_MEM 0x0004
287#define L2CAP_CR_LE_AUTHENTICATION 0x0005
288#define L2CAP_CR_LE_AUTHORIZATION 0x0006
289#define L2CAP_CR_LE_BAD_KEY_SIZE 0x0007
290#define L2CAP_CR_LE_ENCRYPTION 0x0008
291#define L2CAP_CR_LE_INVALID_SCID 0x0009
292#define L2CAP_CR_LE_SCID_IN_USE 0X000A
293
294/* connect/create channel status */
295#define L2CAP_CS_NO_INFO 0x0000
296#define L2CAP_CS_AUTHEN_PEND 0x0001
297#define L2CAP_CS_AUTHOR_PEND 0x0002
298
299struct l2cap_conf_req {
300 __le16 dcid;
301 __le16 flags;
302 __u8 data[0];
303} __packed;
304
305struct l2cap_conf_rsp {
306 __le16 scid;
307 __le16 flags;
308 __le16 result;
309 __u8 data[0];
310} __packed;
311
312#define L2CAP_CONF_SUCCESS 0x0000
313#define L2CAP_CONF_UNACCEPT 0x0001
314#define L2CAP_CONF_REJECT 0x0002
315#define L2CAP_CONF_UNKNOWN 0x0003
316#define L2CAP_CONF_PENDING 0x0004
317#define L2CAP_CONF_EFS_REJECT 0x0005
318
319/* configuration req/rsp continuation flag */
320#define L2CAP_CONF_FLAG_CONTINUATION 0x0001
321
322struct l2cap_conf_opt {
323 __u8 type;
324 __u8 len;
325 __u8 val[0];
326} __packed;
327#define L2CAP_CONF_OPT_SIZE 2
328
329#define L2CAP_CONF_HINT 0x80
330#define L2CAP_CONF_MASK 0x7f
331
332#define L2CAP_CONF_MTU 0x01
333#define L2CAP_CONF_FLUSH_TO 0x02
334#define L2CAP_CONF_QOS 0x03
335#define L2CAP_CONF_RFC 0x04
336#define L2CAP_CONF_FCS 0x05
337#define L2CAP_CONF_EFS 0x06
338#define L2CAP_CONF_EWS 0x07
339
340#define L2CAP_CONF_MAX_SIZE 22
341
342struct l2cap_conf_rfc {
343 __u8 mode;
344 __u8 txwin_size;
345 __u8 max_transmit;
346 __le16 retrans_timeout;
347 __le16 monitor_timeout;
348 __le16 max_pdu_size;
349} __packed;
350
351#define L2CAP_MODE_BASIC 0x00
352#define L2CAP_MODE_RETRANS 0x01
353#define L2CAP_MODE_FLOWCTL 0x02
354#define L2CAP_MODE_ERTM 0x03
355#define L2CAP_MODE_STREAMING 0x04
356
357/* Unlike the above this one doesn't actually map to anything that would
358 * ever be sent over the air. Therefore, use a value that's unlikely to
359 * ever be used in the BR/EDR configuration phase.
360 */
361#define L2CAP_MODE_LE_FLOWCTL 0x80
362
363struct l2cap_conf_efs {
364 __u8 id;
365 __u8 stype;
366 __le16 msdu;
367 __le32 sdu_itime;
368 __le32 acc_lat;
369 __le32 flush_to;
370} __packed;
371
372#define L2CAP_SERV_NOTRAFIC 0x00
373#define L2CAP_SERV_BESTEFFORT 0x01
374#define L2CAP_SERV_GUARANTEED 0x02
375
376#define L2CAP_BESTEFFORT_ID 0x01
377
378struct l2cap_disconn_req {
379 __le16 dcid;
380 __le16 scid;
381} __packed;
382
383struct l2cap_disconn_rsp {
384 __le16 dcid;
385 __le16 scid;
386} __packed;
387
388struct l2cap_info_req {
389 __le16 type;
390} __packed;
391
392struct l2cap_info_rsp {
393 __le16 type;
394 __le16 result;
395 __u8 data[0];
396} __packed;
397
398struct l2cap_create_chan_req {
399 __le16 psm;
400 __le16 scid;
401 __u8 amp_id;
402} __packed;
403
404struct l2cap_create_chan_rsp {
405 __le16 dcid;
406 __le16 scid;
407 __le16 result;
408 __le16 status;
409} __packed;
410
411struct l2cap_move_chan_req {
412 __le16 icid;
413 __u8 dest_amp_id;
414} __packed;
415
416struct l2cap_move_chan_rsp {
417 __le16 icid;
418 __le16 result;
419} __packed;
420
421#define L2CAP_MR_SUCCESS 0x0000
422#define L2CAP_MR_PEND 0x0001
423#define L2CAP_MR_BAD_ID 0x0002
424#define L2CAP_MR_SAME_ID 0x0003
425#define L2CAP_MR_NOT_SUPP 0x0004
426#define L2CAP_MR_COLLISION 0x0005
427#define L2CAP_MR_NOT_ALLOWED 0x0006
428
429struct l2cap_move_chan_cfm {
430 __le16 icid;
431 __le16 result;
432} __packed;
433
434#define L2CAP_MC_CONFIRMED 0x0000
435#define L2CAP_MC_UNCONFIRMED 0x0001
436
437struct l2cap_move_chan_cfm_rsp {
438 __le16 icid;
439} __packed;
440
441/* info type */
442#define L2CAP_IT_CL_MTU 0x0001
443#define L2CAP_IT_FEAT_MASK 0x0002
444#define L2CAP_IT_FIXED_CHAN 0x0003
445
446/* info result */
447#define L2CAP_IR_SUCCESS 0x0000
448#define L2CAP_IR_NOTSUPP 0x0001
449
450struct l2cap_conn_param_update_req {
451 __le16 min;
452 __le16 max;
453 __le16 latency;
454 __le16 to_multiplier;
455} __packed;
456
457struct l2cap_conn_param_update_rsp {
458 __le16 result;
459} __packed;
460
461/* Connection Parameters result */
462#define L2CAP_CONN_PARAM_ACCEPTED 0x0000
463#define L2CAP_CONN_PARAM_REJECTED 0x0001
464
465struct l2cap_le_conn_req {
466 __le16 psm;
467 __le16 scid;
468 __le16 mtu;
469 __le16 mps;
470 __le16 credits;
471} __packed;
472
473struct l2cap_le_conn_rsp {
474 __le16 dcid;
475 __le16 mtu;
476 __le16 mps;
477 __le16 credits;
478 __le16 result;
479} __packed;
480
481struct l2cap_le_credits {
482 __le16 cid;
483 __le16 credits;
484} __packed;
485
486/* ----- L2CAP channels and connections ----- */
487struct l2cap_seq_list {
488 __u16 head;
489 __u16 tail;
490 __u16 mask;
491 __u16 *list;
492};
493
494#define L2CAP_SEQ_LIST_CLEAR 0xFFFF
495#define L2CAP_SEQ_LIST_TAIL 0x8000
496
497struct l2cap_chan {
498 struct l2cap_conn *conn;
499 struct hci_conn *hs_hcon;
500 struct hci_chan *hs_hchan;
501 struct kref kref;
502 atomic_t nesting;
503
504 __u8 state;
505
506 bdaddr_t dst;
507 __u8 dst_type;
508 bdaddr_t src;
509 __u8 src_type;
510 __le16 psm;
511 __le16 sport;
512 __u16 dcid;
513 __u16 scid;
514
515 __u16 imtu;
516 __u16 omtu;
517 __u16 flush_to;
518 __u8 mode;
519 __u8 chan_type;
520 __u8 chan_policy;
521
522 __u8 sec_level;
523
524 __u8 ident;
525
526 __u8 conf_req[64];
527 __u8 conf_len;
528 __u8 num_conf_req;
529 __u8 num_conf_rsp;
530
531 __u8 fcs;
532
533 __u16 tx_win;
534 __u16 tx_win_max;
535 __u16 ack_win;
536 __u8 max_tx;
537 __u16 retrans_timeout;
538 __u16 monitor_timeout;
539 __u16 mps;
540
541 __u16 tx_credits;
542 __u16 rx_credits;
543
544 __u8 tx_state;
545 __u8 rx_state;
546
547 unsigned long conf_state;
548 unsigned long conn_state;
549 unsigned long flags;
550
551 __u8 remote_amp_id;
552 __u8 local_amp_id;
553 __u8 move_id;
554 __u8 move_state;
555 __u8 move_role;
556
557 __u16 next_tx_seq;
558 __u16 expected_ack_seq;
559 __u16 expected_tx_seq;
560 __u16 buffer_seq;
561 __u16 srej_save_reqseq;
562 __u16 last_acked_seq;
563 __u16 frames_sent;
564 __u16 unacked_frames;
565 __u8 retry_count;
566 __u16 sdu_len;
567 struct sk_buff *sdu;
568 struct sk_buff *sdu_last_frag;
569
570 __u16 remote_tx_win;
571 __u8 remote_max_tx;
572 __u16 remote_mps;
573
574 __u8 local_id;
575 __u8 local_stype;
576 __u16 local_msdu;
577 __u32 local_sdu_itime;
578 __u32 local_acc_lat;
579 __u32 local_flush_to;
580
581 __u8 remote_id;
582 __u8 remote_stype;
583 __u16 remote_msdu;
584 __u32 remote_sdu_itime;
585 __u32 remote_acc_lat;
586 __u32 remote_flush_to;
587
588 struct delayed_work chan_timer;
589 struct delayed_work retrans_timer;
590 struct delayed_work monitor_timer;
591 struct delayed_work ack_timer;
592
593 struct sk_buff *tx_send_head;
594 struct sk_buff_head tx_q;
595 struct sk_buff_head srej_q;
596 struct l2cap_seq_list srej_list;
597 struct l2cap_seq_list retrans_list;
598
599 struct list_head list;
600 struct list_head global_l;
601
602 void *data;
603 const struct l2cap_ops *ops;
604 struct mutex lock;
605};
606
607struct l2cap_ops {
608 char *name;
609
610 struct l2cap_chan *(*new_connection) (struct l2cap_chan *chan);
611 int (*recv) (struct l2cap_chan * chan,
612 struct sk_buff *skb);
613 void (*teardown) (struct l2cap_chan *chan, int err);
614 void (*close) (struct l2cap_chan *chan);
615 void (*state_change) (struct l2cap_chan *chan,
616 int state, int err);
617 void (*ready) (struct l2cap_chan *chan);
618 void (*defer) (struct l2cap_chan *chan);
619 void (*resume) (struct l2cap_chan *chan);
620 void (*suspend) (struct l2cap_chan *chan);
621 void (*set_shutdown) (struct l2cap_chan *chan);
622 long (*get_sndtimeo) (struct l2cap_chan *chan);
623 struct sk_buff *(*alloc_skb) (struct l2cap_chan *chan,
624 unsigned long hdr_len,
625 unsigned long len, int nb);
626};
627
628struct l2cap_conn {
629 struct hci_conn *hcon;
630 struct hci_chan *hchan;
631
632 unsigned int mtu;
633
634 __u32 feat_mask;
635 __u8 remote_fixed_chan;
636 __u8 local_fixed_chan;
637
638 __u8 info_state;
639 __u8 info_ident;
640
641 struct delayed_work info_timer;
642
643 struct sk_buff *rx_skb;
644 __u32 rx_len;
645 __u8 tx_ident;
646 struct mutex ident_lock;
647
648 struct sk_buff_head pending_rx;
649 struct work_struct pending_rx_work;
650
651 struct work_struct id_addr_update_work;
652
653 __u8 disc_reason;
654
655 struct l2cap_chan *smp;
656
657 struct list_head chan_l;
658 struct mutex chan_lock;
659 struct kref ref;
660 struct list_head users;
661};
662
663struct l2cap_user {
664 struct list_head list;
665 int (*probe) (struct l2cap_conn *conn, struct l2cap_user *user);
666 void (*remove) (struct l2cap_conn *conn, struct l2cap_user *user);
667};
668
669#define L2CAP_INFO_CL_MTU_REQ_SENT 0x01
670#define L2CAP_INFO_FEAT_MASK_REQ_SENT 0x04
671#define L2CAP_INFO_FEAT_MASK_REQ_DONE 0x08
672
673#define L2CAP_CHAN_RAW 1
674#define L2CAP_CHAN_CONN_LESS 2
675#define L2CAP_CHAN_CONN_ORIENTED 3
676#define L2CAP_CHAN_FIXED 4
677
678/* ----- L2CAP socket info ----- */
679#define l2cap_pi(sk) ((struct l2cap_pinfo *) sk)
680
681struct l2cap_pinfo {
682 struct bt_sock bt;
683 struct l2cap_chan *chan;
684 struct sk_buff *rx_busy_skb;
685};
686
687enum {
688 CONF_REQ_SENT,
689 CONF_INPUT_DONE,
690 CONF_OUTPUT_DONE,
691 CONF_MTU_DONE,
692 CONF_MODE_DONE,
693 CONF_CONNECT_PEND,
694 CONF_RECV_NO_FCS,
695 CONF_STATE2_DEVICE,
696 CONF_EWS_RECV,
697 CONF_LOC_CONF_PEND,
698 CONF_REM_CONF_PEND,
699 CONF_NOT_COMPLETE,
700};
701
702#define L2CAP_CONF_MAX_CONF_REQ 2
703#define L2CAP_CONF_MAX_CONF_RSP 2
704
705enum {
706 CONN_SREJ_SENT,
707 CONN_WAIT_F,
708 CONN_SREJ_ACT,
709 CONN_SEND_PBIT,
710 CONN_REMOTE_BUSY,
711 CONN_LOCAL_BUSY,
712 CONN_REJ_ACT,
713 CONN_SEND_FBIT,
714 CONN_RNR_SENT,
715};
716
717/* Definitions for flags in l2cap_chan */
718enum {
719 FLAG_ROLE_SWITCH,
720 FLAG_FORCE_ACTIVE,
721 FLAG_FORCE_RELIABLE,
722 FLAG_FLUSHABLE,
723 FLAG_EXT_CTRL,
724 FLAG_EFS_ENABLE,
725 FLAG_DEFER_SETUP,
726 FLAG_LE_CONN_REQ_SENT,
727 FLAG_PENDING_SECURITY,
728 FLAG_HOLD_HCI_CONN,
729};
730
731/* Lock nesting levels for L2CAP channels. We need these because lockdep
732 * otherwise considers all channels equal and will e.g. complain about a
733 * connection oriented channel triggering SMP procedures or a listening
734 * channel creating and locking a child channel.
735 */
736enum {
737 L2CAP_NESTING_SMP,
738 L2CAP_NESTING_NORMAL,
739 L2CAP_NESTING_PARENT,
740};
741
742enum {
743 L2CAP_TX_STATE_XMIT,
744 L2CAP_TX_STATE_WAIT_F,
745};
746
747enum {
748 L2CAP_RX_STATE_RECV,
749 L2CAP_RX_STATE_SREJ_SENT,
750 L2CAP_RX_STATE_MOVE,
751 L2CAP_RX_STATE_WAIT_P,
752 L2CAP_RX_STATE_WAIT_F,
753};
754
755enum {
756 L2CAP_TXSEQ_EXPECTED,
757 L2CAP_TXSEQ_EXPECTED_SREJ,
758 L2CAP_TXSEQ_UNEXPECTED,
759 L2CAP_TXSEQ_UNEXPECTED_SREJ,
760 L2CAP_TXSEQ_DUPLICATE,
761 L2CAP_TXSEQ_DUPLICATE_SREJ,
762 L2CAP_TXSEQ_INVALID,
763 L2CAP_TXSEQ_INVALID_IGNORE,
764};
765
766enum {
767 L2CAP_EV_DATA_REQUEST,
768 L2CAP_EV_LOCAL_BUSY_DETECTED,
769 L2CAP_EV_LOCAL_BUSY_CLEAR,
770 L2CAP_EV_RECV_REQSEQ_AND_FBIT,
771 L2CAP_EV_RECV_FBIT,
772 L2CAP_EV_RETRANS_TO,
773 L2CAP_EV_MONITOR_TO,
774 L2CAP_EV_EXPLICIT_POLL,
775 L2CAP_EV_RECV_IFRAME,
776 L2CAP_EV_RECV_RR,
777 L2CAP_EV_RECV_REJ,
778 L2CAP_EV_RECV_RNR,
779 L2CAP_EV_RECV_SREJ,
780 L2CAP_EV_RECV_FRAME,
781};
782
783enum {
784 L2CAP_MOVE_ROLE_NONE,
785 L2CAP_MOVE_ROLE_INITIATOR,
786 L2CAP_MOVE_ROLE_RESPONDER,
787};
788
789enum {
790 L2CAP_MOVE_STABLE,
791 L2CAP_MOVE_WAIT_REQ,
792 L2CAP_MOVE_WAIT_RSP,
793 L2CAP_MOVE_WAIT_RSP_SUCCESS,
794 L2CAP_MOVE_WAIT_CONFIRM,
795 L2CAP_MOVE_WAIT_CONFIRM_RSP,
796 L2CAP_MOVE_WAIT_LOGICAL_COMP,
797 L2CAP_MOVE_WAIT_LOGICAL_CFM,
798 L2CAP_MOVE_WAIT_LOCAL_BUSY,
799 L2CAP_MOVE_WAIT_PREPARE,
800};
801
802void l2cap_chan_hold(struct l2cap_chan *c);
803void l2cap_chan_put(struct l2cap_chan *c);
804
805static inline void l2cap_chan_lock(struct l2cap_chan *chan)
806{
807 mutex_lock_nested(&chan->lock, atomic_read(&chan->nesting));
808}
809
810static inline void l2cap_chan_unlock(struct l2cap_chan *chan)
811{
812 mutex_unlock(&chan->lock);
813}
814
815static inline void l2cap_set_timer(struct l2cap_chan *chan,
816 struct delayed_work *work, long timeout)
817{
818 BT_DBG("chan %p state %s timeout %ld", chan,
819 state_to_string(chan->state), timeout);
820
821 /* If delayed work cancelled do not hold(chan)
822 since it is already done with previous set_timer */
823 if (!cancel_delayed_work(work))
824 l2cap_chan_hold(chan);
825
826 schedule_delayed_work(work, timeout);
827}
828
829static inline bool l2cap_clear_timer(struct l2cap_chan *chan,
830 struct delayed_work *work)
831{
832 bool ret;
833
834 /* put(chan) if delayed work cancelled otherwise it
835 is done in delayed work function */
836 ret = cancel_delayed_work(work);
837 if (ret)
838 l2cap_chan_put(chan);
839
840 return ret;
841}
842
843#define __set_chan_timer(c, t) l2cap_set_timer(c, &c->chan_timer, (t))
844#define __clear_chan_timer(c) l2cap_clear_timer(c, &c->chan_timer)
845#define __clear_retrans_timer(c) l2cap_clear_timer(c, &c->retrans_timer)
846#define __clear_monitor_timer(c) l2cap_clear_timer(c, &c->monitor_timer)
847#define __set_ack_timer(c) l2cap_set_timer(c, &chan->ack_timer, \
848 msecs_to_jiffies(L2CAP_DEFAULT_ACK_TO));
849#define __clear_ack_timer(c) l2cap_clear_timer(c, &c->ack_timer)
850
851static inline int __seq_offset(struct l2cap_chan *chan, __u16 seq1, __u16 seq2)
852{
853 if (seq1 >= seq2)
854 return seq1 - seq2;
855 else
856 return chan->tx_win_max + 1 - seq2 + seq1;
857}
858
859static inline __u16 __next_seq(struct l2cap_chan *chan, __u16 seq)
860{
861 return (seq + 1) % (chan->tx_win_max + 1);
862}
863
864static inline struct l2cap_chan *l2cap_chan_no_new_connection(struct l2cap_chan *chan)
865{
866 return NULL;
867}
868
869static inline int l2cap_chan_no_recv(struct l2cap_chan *chan, struct sk_buff *skb)
870{
871 return -ENOSYS;
872}
873
874static inline struct sk_buff *l2cap_chan_no_alloc_skb(struct l2cap_chan *chan,
875 unsigned long hdr_len,
876 unsigned long len, int nb)
877{
878 return ERR_PTR(-ENOSYS);
879}
880
881static inline void l2cap_chan_no_teardown(struct l2cap_chan *chan, int err)
882{
883}
884
885static inline void l2cap_chan_no_close(struct l2cap_chan *chan)
886{
887}
888
889static inline void l2cap_chan_no_ready(struct l2cap_chan *chan)
890{
891}
892
893static inline void l2cap_chan_no_state_change(struct l2cap_chan *chan,
894 int state, int err)
895{
896}
897
898static inline void l2cap_chan_no_defer(struct l2cap_chan *chan)
899{
900}
901
902static inline void l2cap_chan_no_suspend(struct l2cap_chan *chan)
903{
904}
905
906static inline void l2cap_chan_no_resume(struct l2cap_chan *chan)
907{
908}
909
910static inline void l2cap_chan_no_set_shutdown(struct l2cap_chan *chan)
911{
912}
913
914static inline long l2cap_chan_no_get_sndtimeo(struct l2cap_chan *chan)
915{
916 return 0;
917}
918
919extern bool disable_ertm;
920
921int l2cap_init_sockets(void);
922void l2cap_cleanup_sockets(void);
923bool l2cap_is_socket(struct socket *sock);
924
925void __l2cap_le_connect_rsp_defer(struct l2cap_chan *chan);
926void __l2cap_connect_rsp_defer(struct l2cap_chan *chan);
927
928int l2cap_add_psm(struct l2cap_chan *chan, bdaddr_t *src, __le16 psm);
929int l2cap_add_scid(struct l2cap_chan *chan, __u16 scid);
930
931struct l2cap_chan *l2cap_chan_create(void);
932void l2cap_chan_close(struct l2cap_chan *chan, int reason);
933int l2cap_chan_connect(struct l2cap_chan *chan, __le16 psm, u16 cid,
934 bdaddr_t *dst, u8 dst_type);
935int l2cap_chan_send(struct l2cap_chan *chan, struct msghdr *msg, size_t len);
936void l2cap_chan_busy(struct l2cap_chan *chan, int busy);
937int l2cap_chan_check_security(struct l2cap_chan *chan, bool initiator);
938void l2cap_chan_set_defaults(struct l2cap_chan *chan);
939int l2cap_ertm_init(struct l2cap_chan *chan);
940void l2cap_chan_add(struct l2cap_conn *conn, struct l2cap_chan *chan);
941void __l2cap_chan_add(struct l2cap_conn *conn, struct l2cap_chan *chan);
942void l2cap_chan_del(struct l2cap_chan *chan, int err);
943void l2cap_send_conn_req(struct l2cap_chan *chan);
944void l2cap_move_start(struct l2cap_chan *chan);
945void l2cap_logical_cfm(struct l2cap_chan *chan, struct hci_chan *hchan,
946 u8 status);
947void __l2cap_physical_cfm(struct l2cap_chan *chan, int result);
948
949struct l2cap_conn *l2cap_conn_get(struct l2cap_conn *conn);
950void l2cap_conn_put(struct l2cap_conn *conn);
951
952int l2cap_register_user(struct l2cap_conn *conn, struct l2cap_user *user);
953void l2cap_unregister_user(struct l2cap_conn *conn, struct l2cap_user *user);
954
955#endif /* __L2CAP_H */
1/*
2 BlueZ - Bluetooth protocol stack for Linux
3 Copyright (C) 2000-2001 Qualcomm Incorporated
4 Copyright (C) 2009-2010 Gustavo F. Padovan <gustavo@padovan.org>
5 Copyright (C) 2010 Google Inc.
6
7 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
8
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License version 2 as
11 published by the Free Software Foundation;
12
13 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
14 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
16 IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
17 CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
18 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
19 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
20 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21
22 ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
23 COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
24 SOFTWARE IS DISCLAIMED.
25*/
26
27#ifndef __L2CAP_H
28#define __L2CAP_H
29
30#include <asm/unaligned.h>
31#include <linux/atomic.h>
32
33/* L2CAP defaults */
34#define L2CAP_DEFAULT_MTU 672
35#define L2CAP_DEFAULT_MIN_MTU 48
36#define L2CAP_DEFAULT_FLUSH_TO 0xFFFF
37#define L2CAP_EFS_DEFAULT_FLUSH_TO 0xFFFFFFFF
38#define L2CAP_DEFAULT_TX_WINDOW 63
39#define L2CAP_DEFAULT_EXT_WINDOW 0x3FFF
40#define L2CAP_DEFAULT_MAX_TX 3
41#define L2CAP_DEFAULT_RETRANS_TO 2000 /* 2 seconds */
42#define L2CAP_DEFAULT_MONITOR_TO 12000 /* 12 seconds */
43#define L2CAP_DEFAULT_MAX_PDU_SIZE 1492 /* Sized for AMP packet */
44#define L2CAP_DEFAULT_ACK_TO 200
45#define L2CAP_DEFAULT_MAX_SDU_SIZE 0xFFFF
46#define L2CAP_DEFAULT_SDU_ITIME 0xFFFFFFFF
47#define L2CAP_DEFAULT_ACC_LAT 0xFFFFFFFF
48#define L2CAP_BREDR_MAX_PAYLOAD 1019 /* 3-DH5 packet */
49#define L2CAP_LE_MIN_MTU 23
50
51#define L2CAP_DISC_TIMEOUT msecs_to_jiffies(100)
52#define L2CAP_DISC_REJ_TIMEOUT msecs_to_jiffies(5000)
53#define L2CAP_ENC_TIMEOUT msecs_to_jiffies(5000)
54#define L2CAP_CONN_TIMEOUT msecs_to_jiffies(40000)
55#define L2CAP_INFO_TIMEOUT msecs_to_jiffies(4000)
56#define L2CAP_MOVE_TIMEOUT msecs_to_jiffies(4000)
57#define L2CAP_MOVE_ERTX_TIMEOUT msecs_to_jiffies(60000)
58#define L2CAP_WAIT_ACK_POLL_PERIOD msecs_to_jiffies(200)
59#define L2CAP_WAIT_ACK_TIMEOUT msecs_to_jiffies(10000)
60
61#define L2CAP_A2MP_DEFAULT_MTU 670
62
63/* L2CAP socket address */
64struct sockaddr_l2 {
65 sa_family_t l2_family;
66 __le16 l2_psm;
67 bdaddr_t l2_bdaddr;
68 __le16 l2_cid;
69 __u8 l2_bdaddr_type;
70};
71
72/* L2CAP socket options */
73#define L2CAP_OPTIONS 0x01
74struct l2cap_options {
75 __u16 omtu;
76 __u16 imtu;
77 __u16 flush_to;
78 __u8 mode;
79 __u8 fcs;
80 __u8 max_tx;
81 __u16 txwin_size;
82};
83
84#define L2CAP_CONNINFO 0x02
85struct l2cap_conninfo {
86 __u16 hci_handle;
87 __u8 dev_class[3];
88};
89
90#define L2CAP_LM 0x03
91#define L2CAP_LM_MASTER 0x0001
92#define L2CAP_LM_AUTH 0x0002
93#define L2CAP_LM_ENCRYPT 0x0004
94#define L2CAP_LM_TRUSTED 0x0008
95#define L2CAP_LM_RELIABLE 0x0010
96#define L2CAP_LM_SECURE 0x0020
97#define L2CAP_LM_FIPS 0x0040
98
99/* L2CAP command codes */
100#define L2CAP_COMMAND_REJ 0x01
101#define L2CAP_CONN_REQ 0x02
102#define L2CAP_CONN_RSP 0x03
103#define L2CAP_CONF_REQ 0x04
104#define L2CAP_CONF_RSP 0x05
105#define L2CAP_DISCONN_REQ 0x06
106#define L2CAP_DISCONN_RSP 0x07
107#define L2CAP_ECHO_REQ 0x08
108#define L2CAP_ECHO_RSP 0x09
109#define L2CAP_INFO_REQ 0x0a
110#define L2CAP_INFO_RSP 0x0b
111#define L2CAP_CREATE_CHAN_REQ 0x0c
112#define L2CAP_CREATE_CHAN_RSP 0x0d
113#define L2CAP_MOVE_CHAN_REQ 0x0e
114#define L2CAP_MOVE_CHAN_RSP 0x0f
115#define L2CAP_MOVE_CHAN_CFM 0x10
116#define L2CAP_MOVE_CHAN_CFM_RSP 0x11
117#define L2CAP_CONN_PARAM_UPDATE_REQ 0x12
118#define L2CAP_CONN_PARAM_UPDATE_RSP 0x13
119#define L2CAP_LE_CONN_REQ 0x14
120#define L2CAP_LE_CONN_RSP 0x15
121#define L2CAP_LE_CREDITS 0x16
122
123/* L2CAP extended feature mask */
124#define L2CAP_FEAT_FLOWCTL 0x00000001
125#define L2CAP_FEAT_RETRANS 0x00000002
126#define L2CAP_FEAT_BIDIR_QOS 0x00000004
127#define L2CAP_FEAT_ERTM 0x00000008
128#define L2CAP_FEAT_STREAMING 0x00000010
129#define L2CAP_FEAT_FCS 0x00000020
130#define L2CAP_FEAT_EXT_FLOW 0x00000040
131#define L2CAP_FEAT_FIXED_CHAN 0x00000080
132#define L2CAP_FEAT_EXT_WINDOW 0x00000100
133#define L2CAP_FEAT_UCD 0x00000200
134
135/* L2CAP checksum option */
136#define L2CAP_FCS_NONE 0x00
137#define L2CAP_FCS_CRC16 0x01
138
139/* L2CAP fixed channels */
140#define L2CAP_FC_SIG_BREDR 0x02
141#define L2CAP_FC_CONNLESS 0x04
142#define L2CAP_FC_A2MP 0x08
143#define L2CAP_FC_ATT 0x10
144#define L2CAP_FC_SIG_LE 0x20
145#define L2CAP_FC_SMP_LE 0x40
146#define L2CAP_FC_SMP_BREDR 0x80
147
148/* L2CAP Control Field bit masks */
149#define L2CAP_CTRL_SAR 0xC000
150#define L2CAP_CTRL_REQSEQ 0x3F00
151#define L2CAP_CTRL_TXSEQ 0x007E
152#define L2CAP_CTRL_SUPERVISE 0x000C
153
154#define L2CAP_CTRL_RETRANS 0x0080
155#define L2CAP_CTRL_FINAL 0x0080
156#define L2CAP_CTRL_POLL 0x0010
157#define L2CAP_CTRL_FRAME_TYPE 0x0001 /* I- or S-Frame */
158
159#define L2CAP_CTRL_TXSEQ_SHIFT 1
160#define L2CAP_CTRL_SUPER_SHIFT 2
161#define L2CAP_CTRL_POLL_SHIFT 4
162#define L2CAP_CTRL_FINAL_SHIFT 7
163#define L2CAP_CTRL_REQSEQ_SHIFT 8
164#define L2CAP_CTRL_SAR_SHIFT 14
165
166/* L2CAP Extended Control Field bit mask */
167#define L2CAP_EXT_CTRL_TXSEQ 0xFFFC0000
168#define L2CAP_EXT_CTRL_SAR 0x00030000
169#define L2CAP_EXT_CTRL_SUPERVISE 0x00030000
170#define L2CAP_EXT_CTRL_REQSEQ 0x0000FFFC
171
172#define L2CAP_EXT_CTRL_POLL 0x00040000
173#define L2CAP_EXT_CTRL_FINAL 0x00000002
174#define L2CAP_EXT_CTRL_FRAME_TYPE 0x00000001 /* I- or S-Frame */
175
176#define L2CAP_EXT_CTRL_FINAL_SHIFT 1
177#define L2CAP_EXT_CTRL_REQSEQ_SHIFT 2
178#define L2CAP_EXT_CTRL_SAR_SHIFT 16
179#define L2CAP_EXT_CTRL_SUPER_SHIFT 16
180#define L2CAP_EXT_CTRL_POLL_SHIFT 18
181#define L2CAP_EXT_CTRL_TXSEQ_SHIFT 18
182
183/* L2CAP Supervisory Function */
184#define L2CAP_SUPER_RR 0x00
185#define L2CAP_SUPER_REJ 0x01
186#define L2CAP_SUPER_RNR 0x02
187#define L2CAP_SUPER_SREJ 0x03
188
189/* L2CAP Segmentation and Reassembly */
190#define L2CAP_SAR_UNSEGMENTED 0x00
191#define L2CAP_SAR_START 0x01
192#define L2CAP_SAR_END 0x02
193#define L2CAP_SAR_CONTINUE 0x03
194
195/* L2CAP Command rej. reasons */
196#define L2CAP_REJ_NOT_UNDERSTOOD 0x0000
197#define L2CAP_REJ_MTU_EXCEEDED 0x0001
198#define L2CAP_REJ_INVALID_CID 0x0002
199
200/* L2CAP structures */
201struct l2cap_hdr {
202 __le16 len;
203 __le16 cid;
204} __packed;
205#define L2CAP_HDR_SIZE 4
206#define L2CAP_ENH_HDR_SIZE 6
207#define L2CAP_EXT_HDR_SIZE 8
208
209#define L2CAP_FCS_SIZE 2
210#define L2CAP_SDULEN_SIZE 2
211#define L2CAP_PSMLEN_SIZE 2
212#define L2CAP_ENH_CTRL_SIZE 2
213#define L2CAP_EXT_CTRL_SIZE 4
214
215struct l2cap_cmd_hdr {
216 __u8 code;
217 __u8 ident;
218 __le16 len;
219} __packed;
220#define L2CAP_CMD_HDR_SIZE 4
221
222struct l2cap_cmd_rej_unk {
223 __le16 reason;
224} __packed;
225
226struct l2cap_cmd_rej_mtu {
227 __le16 reason;
228 __le16 max_mtu;
229} __packed;
230
231struct l2cap_cmd_rej_cid {
232 __le16 reason;
233 __le16 scid;
234 __le16 dcid;
235} __packed;
236
237struct l2cap_conn_req {
238 __le16 psm;
239 __le16 scid;
240} __packed;
241
242struct l2cap_conn_rsp {
243 __le16 dcid;
244 __le16 scid;
245 __le16 result;
246 __le16 status;
247} __packed;
248
249/* protocol/service multiplexer (PSM) */
250#define L2CAP_PSM_SDP 0x0001
251#define L2CAP_PSM_RFCOMM 0x0003
252#define L2CAP_PSM_3DSP 0x0021
253#define L2CAP_PSM_IPSP 0x0023 /* 6LoWPAN */
254
255#define L2CAP_PSM_DYN_START 0x1001
256#define L2CAP_PSM_DYN_END 0xffff
257#define L2CAP_PSM_AUTO_END 0x10ff
258#define L2CAP_PSM_LE_DYN_START 0x0080
259#define L2CAP_PSM_LE_DYN_END 0x00ff
260
261/* channel identifier */
262#define L2CAP_CID_SIGNALING 0x0001
263#define L2CAP_CID_CONN_LESS 0x0002
264#define L2CAP_CID_A2MP 0x0003
265#define L2CAP_CID_ATT 0x0004
266#define L2CAP_CID_LE_SIGNALING 0x0005
267#define L2CAP_CID_SMP 0x0006
268#define L2CAP_CID_SMP_BREDR 0x0007
269#define L2CAP_CID_DYN_START 0x0040
270#define L2CAP_CID_DYN_END 0xffff
271#define L2CAP_CID_LE_DYN_END 0x007f
272
273/* connect/create channel results */
274#define L2CAP_CR_SUCCESS 0x0000
275#define L2CAP_CR_PEND 0x0001
276#define L2CAP_CR_BAD_PSM 0x0002
277#define L2CAP_CR_SEC_BLOCK 0x0003
278#define L2CAP_CR_NO_MEM 0x0004
279#define L2CAP_CR_BAD_AMP 0x0005
280#define L2CAP_CR_AUTHENTICATION 0x0005
281#define L2CAP_CR_AUTHORIZATION 0x0006
282#define L2CAP_CR_BAD_KEY_SIZE 0x0007
283#define L2CAP_CR_ENCRYPTION 0x0008
284#define L2CAP_CR_INVALID_SCID 0x0009
285#define L2CAP_CR_SCID_IN_USE 0x0010
286
287/* connect/create channel status */
288#define L2CAP_CS_NO_INFO 0x0000
289#define L2CAP_CS_AUTHEN_PEND 0x0001
290#define L2CAP_CS_AUTHOR_PEND 0x0002
291
292struct l2cap_conf_req {
293 __le16 dcid;
294 __le16 flags;
295 __u8 data[0];
296} __packed;
297
298struct l2cap_conf_rsp {
299 __le16 scid;
300 __le16 flags;
301 __le16 result;
302 __u8 data[0];
303} __packed;
304
305#define L2CAP_CONF_SUCCESS 0x0000
306#define L2CAP_CONF_UNACCEPT 0x0001
307#define L2CAP_CONF_REJECT 0x0002
308#define L2CAP_CONF_UNKNOWN 0x0003
309#define L2CAP_CONF_PENDING 0x0004
310#define L2CAP_CONF_EFS_REJECT 0x0005
311
312/* configuration req/rsp continuation flag */
313#define L2CAP_CONF_FLAG_CONTINUATION 0x0001
314
315struct l2cap_conf_opt {
316 __u8 type;
317 __u8 len;
318 __u8 val[0];
319} __packed;
320#define L2CAP_CONF_OPT_SIZE 2
321
322#define L2CAP_CONF_HINT 0x80
323#define L2CAP_CONF_MASK 0x7f
324
325#define L2CAP_CONF_MTU 0x01
326#define L2CAP_CONF_FLUSH_TO 0x02
327#define L2CAP_CONF_QOS 0x03
328#define L2CAP_CONF_RFC 0x04
329#define L2CAP_CONF_FCS 0x05
330#define L2CAP_CONF_EFS 0x06
331#define L2CAP_CONF_EWS 0x07
332
333#define L2CAP_CONF_MAX_SIZE 22
334
335struct l2cap_conf_rfc {
336 __u8 mode;
337 __u8 txwin_size;
338 __u8 max_transmit;
339 __le16 retrans_timeout;
340 __le16 monitor_timeout;
341 __le16 max_pdu_size;
342} __packed;
343
344#define L2CAP_MODE_BASIC 0x00
345#define L2CAP_MODE_RETRANS 0x01
346#define L2CAP_MODE_FLOWCTL 0x02
347#define L2CAP_MODE_ERTM 0x03
348#define L2CAP_MODE_STREAMING 0x04
349
350/* Unlike the above this one doesn't actually map to anything that would
351 * ever be sent over the air. Therefore, use a value that's unlikely to
352 * ever be used in the BR/EDR configuration phase.
353 */
354#define L2CAP_MODE_LE_FLOWCTL 0x80
355
356struct l2cap_conf_efs {
357 __u8 id;
358 __u8 stype;
359 __le16 msdu;
360 __le32 sdu_itime;
361 __le32 acc_lat;
362 __le32 flush_to;
363} __packed;
364
365#define L2CAP_SERV_NOTRAFIC 0x00
366#define L2CAP_SERV_BESTEFFORT 0x01
367#define L2CAP_SERV_GUARANTEED 0x02
368
369#define L2CAP_BESTEFFORT_ID 0x01
370
371struct l2cap_disconn_req {
372 __le16 dcid;
373 __le16 scid;
374} __packed;
375
376struct l2cap_disconn_rsp {
377 __le16 dcid;
378 __le16 scid;
379} __packed;
380
381struct l2cap_info_req {
382 __le16 type;
383} __packed;
384
385struct l2cap_info_rsp {
386 __le16 type;
387 __le16 result;
388 __u8 data[0];
389} __packed;
390
391struct l2cap_create_chan_req {
392 __le16 psm;
393 __le16 scid;
394 __u8 amp_id;
395} __packed;
396
397struct l2cap_create_chan_rsp {
398 __le16 dcid;
399 __le16 scid;
400 __le16 result;
401 __le16 status;
402} __packed;
403
404struct l2cap_move_chan_req {
405 __le16 icid;
406 __u8 dest_amp_id;
407} __packed;
408
409struct l2cap_move_chan_rsp {
410 __le16 icid;
411 __le16 result;
412} __packed;
413
414#define L2CAP_MR_SUCCESS 0x0000
415#define L2CAP_MR_PEND 0x0001
416#define L2CAP_MR_BAD_ID 0x0002
417#define L2CAP_MR_SAME_ID 0x0003
418#define L2CAP_MR_NOT_SUPP 0x0004
419#define L2CAP_MR_COLLISION 0x0005
420#define L2CAP_MR_NOT_ALLOWED 0x0006
421
422struct l2cap_move_chan_cfm {
423 __le16 icid;
424 __le16 result;
425} __packed;
426
427#define L2CAP_MC_CONFIRMED 0x0000
428#define L2CAP_MC_UNCONFIRMED 0x0001
429
430struct l2cap_move_chan_cfm_rsp {
431 __le16 icid;
432} __packed;
433
434/* info type */
435#define L2CAP_IT_CL_MTU 0x0001
436#define L2CAP_IT_FEAT_MASK 0x0002
437#define L2CAP_IT_FIXED_CHAN 0x0003
438
439/* info result */
440#define L2CAP_IR_SUCCESS 0x0000
441#define L2CAP_IR_NOTSUPP 0x0001
442
443struct l2cap_conn_param_update_req {
444 __le16 min;
445 __le16 max;
446 __le16 latency;
447 __le16 to_multiplier;
448} __packed;
449
450struct l2cap_conn_param_update_rsp {
451 __le16 result;
452} __packed;
453
454/* Connection Parameters result */
455#define L2CAP_CONN_PARAM_ACCEPTED 0x0000
456#define L2CAP_CONN_PARAM_REJECTED 0x0001
457
458#define L2CAP_LE_MAX_CREDITS 10
459#define L2CAP_LE_DEFAULT_MPS 230
460
461struct l2cap_le_conn_req {
462 __le16 psm;
463 __le16 scid;
464 __le16 mtu;
465 __le16 mps;
466 __le16 credits;
467} __packed;
468
469struct l2cap_le_conn_rsp {
470 __le16 dcid;
471 __le16 mtu;
472 __le16 mps;
473 __le16 credits;
474 __le16 result;
475} __packed;
476
477struct l2cap_le_credits {
478 __le16 cid;
479 __le16 credits;
480} __packed;
481
482/* ----- L2CAP channels and connections ----- */
483struct l2cap_seq_list {
484 __u16 head;
485 __u16 tail;
486 __u16 mask;
487 __u16 *list;
488};
489
490#define L2CAP_SEQ_LIST_CLEAR 0xFFFF
491#define L2CAP_SEQ_LIST_TAIL 0x8000
492
493struct l2cap_chan {
494 struct l2cap_conn *conn;
495 struct hci_conn *hs_hcon;
496 struct hci_chan *hs_hchan;
497 struct kref kref;
498 atomic_t nesting;
499
500 __u8 state;
501
502 bdaddr_t dst;
503 __u8 dst_type;
504 bdaddr_t src;
505 __u8 src_type;
506 __le16 psm;
507 __le16 sport;
508 __u16 dcid;
509 __u16 scid;
510
511 __u16 imtu;
512 __u16 omtu;
513 __u16 flush_to;
514 __u8 mode;
515 __u8 chan_type;
516 __u8 chan_policy;
517
518 __u8 sec_level;
519
520 __u8 ident;
521
522 __u8 conf_req[64];
523 __u8 conf_len;
524 __u8 num_conf_req;
525 __u8 num_conf_rsp;
526
527 __u8 fcs;
528
529 __u16 tx_win;
530 __u16 tx_win_max;
531 __u16 ack_win;
532 __u8 max_tx;
533 __u16 retrans_timeout;
534 __u16 monitor_timeout;
535 __u16 mps;
536
537 __u16 tx_credits;
538 __u16 rx_credits;
539
540 __u8 tx_state;
541 __u8 rx_state;
542
543 unsigned long conf_state;
544 unsigned long conn_state;
545 unsigned long flags;
546
547 __u8 remote_amp_id;
548 __u8 local_amp_id;
549 __u8 move_id;
550 __u8 move_state;
551 __u8 move_role;
552
553 __u16 next_tx_seq;
554 __u16 expected_ack_seq;
555 __u16 expected_tx_seq;
556 __u16 buffer_seq;
557 __u16 srej_save_reqseq;
558 __u16 last_acked_seq;
559 __u16 frames_sent;
560 __u16 unacked_frames;
561 __u8 retry_count;
562 __u16 sdu_len;
563 struct sk_buff *sdu;
564 struct sk_buff *sdu_last_frag;
565
566 __u16 remote_tx_win;
567 __u8 remote_max_tx;
568 __u16 remote_mps;
569
570 __u8 local_id;
571 __u8 local_stype;
572 __u16 local_msdu;
573 __u32 local_sdu_itime;
574 __u32 local_acc_lat;
575 __u32 local_flush_to;
576
577 __u8 remote_id;
578 __u8 remote_stype;
579 __u16 remote_msdu;
580 __u32 remote_sdu_itime;
581 __u32 remote_acc_lat;
582 __u32 remote_flush_to;
583
584 struct delayed_work chan_timer;
585 struct delayed_work retrans_timer;
586 struct delayed_work monitor_timer;
587 struct delayed_work ack_timer;
588
589 struct sk_buff *tx_send_head;
590 struct sk_buff_head tx_q;
591 struct sk_buff_head srej_q;
592 struct l2cap_seq_list srej_list;
593 struct l2cap_seq_list retrans_list;
594
595 struct list_head list;
596 struct list_head global_l;
597
598 void *data;
599 const struct l2cap_ops *ops;
600 struct mutex lock;
601};
602
603struct l2cap_ops {
604 char *name;
605
606 struct l2cap_chan *(*new_connection) (struct l2cap_chan *chan);
607 int (*recv) (struct l2cap_chan * chan,
608 struct sk_buff *skb);
609 void (*teardown) (struct l2cap_chan *chan, int err);
610 void (*close) (struct l2cap_chan *chan);
611 void (*state_change) (struct l2cap_chan *chan,
612 int state, int err);
613 void (*ready) (struct l2cap_chan *chan);
614 void (*defer) (struct l2cap_chan *chan);
615 void (*resume) (struct l2cap_chan *chan);
616 void (*suspend) (struct l2cap_chan *chan);
617 void (*set_shutdown) (struct l2cap_chan *chan);
618 long (*get_sndtimeo) (struct l2cap_chan *chan);
619 struct sk_buff *(*alloc_skb) (struct l2cap_chan *chan,
620 unsigned long hdr_len,
621 unsigned long len, int nb);
622};
623
624struct l2cap_conn {
625 struct hci_conn *hcon;
626 struct hci_chan *hchan;
627
628 unsigned int mtu;
629
630 __u32 feat_mask;
631 __u8 remote_fixed_chan;
632 __u8 local_fixed_chan;
633
634 __u8 info_state;
635 __u8 info_ident;
636
637 struct delayed_work info_timer;
638
639 struct sk_buff *rx_skb;
640 __u32 rx_len;
641 __u8 tx_ident;
642 struct mutex ident_lock;
643
644 struct sk_buff_head pending_rx;
645 struct work_struct pending_rx_work;
646
647 struct work_struct id_addr_update_work;
648
649 __u8 disc_reason;
650
651 struct l2cap_chan *smp;
652
653 struct list_head chan_l;
654 struct mutex chan_lock;
655 struct kref ref;
656 struct list_head users;
657};
658
659struct l2cap_user {
660 struct list_head list;
661 int (*probe) (struct l2cap_conn *conn, struct l2cap_user *user);
662 void (*remove) (struct l2cap_conn *conn, struct l2cap_user *user);
663};
664
665#define L2CAP_INFO_CL_MTU_REQ_SENT 0x01
666#define L2CAP_INFO_FEAT_MASK_REQ_SENT 0x04
667#define L2CAP_INFO_FEAT_MASK_REQ_DONE 0x08
668
669#define L2CAP_CHAN_RAW 1
670#define L2CAP_CHAN_CONN_LESS 2
671#define L2CAP_CHAN_CONN_ORIENTED 3
672#define L2CAP_CHAN_FIXED 4
673
674/* ----- L2CAP socket info ----- */
675#define l2cap_pi(sk) ((struct l2cap_pinfo *) sk)
676
677struct l2cap_pinfo {
678 struct bt_sock bt;
679 struct l2cap_chan *chan;
680 struct sk_buff *rx_busy_skb;
681};
682
683enum {
684 CONF_REQ_SENT,
685 CONF_INPUT_DONE,
686 CONF_OUTPUT_DONE,
687 CONF_MTU_DONE,
688 CONF_MODE_DONE,
689 CONF_CONNECT_PEND,
690 CONF_RECV_NO_FCS,
691 CONF_STATE2_DEVICE,
692 CONF_EWS_RECV,
693 CONF_LOC_CONF_PEND,
694 CONF_REM_CONF_PEND,
695 CONF_NOT_COMPLETE,
696};
697
698#define L2CAP_CONF_MAX_CONF_REQ 2
699#define L2CAP_CONF_MAX_CONF_RSP 2
700
701enum {
702 CONN_SREJ_SENT,
703 CONN_WAIT_F,
704 CONN_SREJ_ACT,
705 CONN_SEND_PBIT,
706 CONN_REMOTE_BUSY,
707 CONN_LOCAL_BUSY,
708 CONN_REJ_ACT,
709 CONN_SEND_FBIT,
710 CONN_RNR_SENT,
711};
712
713/* Definitions for flags in l2cap_chan */
714enum {
715 FLAG_ROLE_SWITCH,
716 FLAG_FORCE_ACTIVE,
717 FLAG_FORCE_RELIABLE,
718 FLAG_FLUSHABLE,
719 FLAG_EXT_CTRL,
720 FLAG_EFS_ENABLE,
721 FLAG_DEFER_SETUP,
722 FLAG_LE_CONN_REQ_SENT,
723 FLAG_PENDING_SECURITY,
724 FLAG_HOLD_HCI_CONN,
725};
726
727/* Lock nesting levels for L2CAP channels. We need these because lockdep
728 * otherwise considers all channels equal and will e.g. complain about a
729 * connection oriented channel triggering SMP procedures or a listening
730 * channel creating and locking a child channel.
731 */
732enum {
733 L2CAP_NESTING_SMP,
734 L2CAP_NESTING_NORMAL,
735 L2CAP_NESTING_PARENT,
736};
737
738enum {
739 L2CAP_TX_STATE_XMIT,
740 L2CAP_TX_STATE_WAIT_F,
741};
742
743enum {
744 L2CAP_RX_STATE_RECV,
745 L2CAP_RX_STATE_SREJ_SENT,
746 L2CAP_RX_STATE_MOVE,
747 L2CAP_RX_STATE_WAIT_P,
748 L2CAP_RX_STATE_WAIT_F,
749};
750
751enum {
752 L2CAP_TXSEQ_EXPECTED,
753 L2CAP_TXSEQ_EXPECTED_SREJ,
754 L2CAP_TXSEQ_UNEXPECTED,
755 L2CAP_TXSEQ_UNEXPECTED_SREJ,
756 L2CAP_TXSEQ_DUPLICATE,
757 L2CAP_TXSEQ_DUPLICATE_SREJ,
758 L2CAP_TXSEQ_INVALID,
759 L2CAP_TXSEQ_INVALID_IGNORE,
760};
761
762enum {
763 L2CAP_EV_DATA_REQUEST,
764 L2CAP_EV_LOCAL_BUSY_DETECTED,
765 L2CAP_EV_LOCAL_BUSY_CLEAR,
766 L2CAP_EV_RECV_REQSEQ_AND_FBIT,
767 L2CAP_EV_RECV_FBIT,
768 L2CAP_EV_RETRANS_TO,
769 L2CAP_EV_MONITOR_TO,
770 L2CAP_EV_EXPLICIT_POLL,
771 L2CAP_EV_RECV_IFRAME,
772 L2CAP_EV_RECV_RR,
773 L2CAP_EV_RECV_REJ,
774 L2CAP_EV_RECV_RNR,
775 L2CAP_EV_RECV_SREJ,
776 L2CAP_EV_RECV_FRAME,
777};
778
779enum {
780 L2CAP_MOVE_ROLE_NONE,
781 L2CAP_MOVE_ROLE_INITIATOR,
782 L2CAP_MOVE_ROLE_RESPONDER,
783};
784
785enum {
786 L2CAP_MOVE_STABLE,
787 L2CAP_MOVE_WAIT_REQ,
788 L2CAP_MOVE_WAIT_RSP,
789 L2CAP_MOVE_WAIT_RSP_SUCCESS,
790 L2CAP_MOVE_WAIT_CONFIRM,
791 L2CAP_MOVE_WAIT_CONFIRM_RSP,
792 L2CAP_MOVE_WAIT_LOGICAL_COMP,
793 L2CAP_MOVE_WAIT_LOGICAL_CFM,
794 L2CAP_MOVE_WAIT_LOCAL_BUSY,
795 L2CAP_MOVE_WAIT_PREPARE,
796};
797
798void l2cap_chan_hold(struct l2cap_chan *c);
799void l2cap_chan_put(struct l2cap_chan *c);
800
801static inline void l2cap_chan_lock(struct l2cap_chan *chan)
802{
803 mutex_lock_nested(&chan->lock, atomic_read(&chan->nesting));
804}
805
806static inline void l2cap_chan_unlock(struct l2cap_chan *chan)
807{
808 mutex_unlock(&chan->lock);
809}
810
811static inline void l2cap_set_timer(struct l2cap_chan *chan,
812 struct delayed_work *work, long timeout)
813{
814 BT_DBG("chan %p state %s timeout %ld", chan,
815 state_to_string(chan->state), timeout);
816
817 /* If delayed work cancelled do not hold(chan)
818 since it is already done with previous set_timer */
819 if (!cancel_delayed_work(work))
820 l2cap_chan_hold(chan);
821
822 schedule_delayed_work(work, timeout);
823}
824
825static inline bool l2cap_clear_timer(struct l2cap_chan *chan,
826 struct delayed_work *work)
827{
828 bool ret;
829
830 /* put(chan) if delayed work cancelled otherwise it
831 is done in delayed work function */
832 ret = cancel_delayed_work(work);
833 if (ret)
834 l2cap_chan_put(chan);
835
836 return ret;
837}
838
839#define __set_chan_timer(c, t) l2cap_set_timer(c, &c->chan_timer, (t))
840#define __clear_chan_timer(c) l2cap_clear_timer(c, &c->chan_timer)
841#define __clear_retrans_timer(c) l2cap_clear_timer(c, &c->retrans_timer)
842#define __clear_monitor_timer(c) l2cap_clear_timer(c, &c->monitor_timer)
843#define __set_ack_timer(c) l2cap_set_timer(c, &chan->ack_timer, \
844 msecs_to_jiffies(L2CAP_DEFAULT_ACK_TO));
845#define __clear_ack_timer(c) l2cap_clear_timer(c, &c->ack_timer)
846
847static inline int __seq_offset(struct l2cap_chan *chan, __u16 seq1, __u16 seq2)
848{
849 if (seq1 >= seq2)
850 return seq1 - seq2;
851 else
852 return chan->tx_win_max + 1 - seq2 + seq1;
853}
854
855static inline __u16 __next_seq(struct l2cap_chan *chan, __u16 seq)
856{
857 return (seq + 1) % (chan->tx_win_max + 1);
858}
859
860static inline struct l2cap_chan *l2cap_chan_no_new_connection(struct l2cap_chan *chan)
861{
862 return NULL;
863}
864
865static inline int l2cap_chan_no_recv(struct l2cap_chan *chan, struct sk_buff *skb)
866{
867 return -ENOSYS;
868}
869
870static inline struct sk_buff *l2cap_chan_no_alloc_skb(struct l2cap_chan *chan,
871 unsigned long hdr_len,
872 unsigned long len, int nb)
873{
874 return ERR_PTR(-ENOSYS);
875}
876
877static inline void l2cap_chan_no_teardown(struct l2cap_chan *chan, int err)
878{
879}
880
881static inline void l2cap_chan_no_close(struct l2cap_chan *chan)
882{
883}
884
885static inline void l2cap_chan_no_ready(struct l2cap_chan *chan)
886{
887}
888
889static inline void l2cap_chan_no_state_change(struct l2cap_chan *chan,
890 int state, int err)
891{
892}
893
894static inline void l2cap_chan_no_defer(struct l2cap_chan *chan)
895{
896}
897
898static inline void l2cap_chan_no_suspend(struct l2cap_chan *chan)
899{
900}
901
902static inline void l2cap_chan_no_resume(struct l2cap_chan *chan)
903{
904}
905
906static inline void l2cap_chan_no_set_shutdown(struct l2cap_chan *chan)
907{
908}
909
910static inline long l2cap_chan_no_get_sndtimeo(struct l2cap_chan *chan)
911{
912 return 0;
913}
914
915extern bool disable_ertm;
916
917int l2cap_init_sockets(void);
918void l2cap_cleanup_sockets(void);
919bool l2cap_is_socket(struct socket *sock);
920
921void __l2cap_le_connect_rsp_defer(struct l2cap_chan *chan);
922void __l2cap_connect_rsp_defer(struct l2cap_chan *chan);
923
924int l2cap_add_psm(struct l2cap_chan *chan, bdaddr_t *src, __le16 psm);
925int l2cap_add_scid(struct l2cap_chan *chan, __u16 scid);
926
927struct l2cap_chan *l2cap_chan_create(void);
928void l2cap_chan_close(struct l2cap_chan *chan, int reason);
929int l2cap_chan_connect(struct l2cap_chan *chan, __le16 psm, u16 cid,
930 bdaddr_t *dst, u8 dst_type);
931int l2cap_chan_send(struct l2cap_chan *chan, struct msghdr *msg, size_t len);
932void l2cap_chan_busy(struct l2cap_chan *chan, int busy);
933int l2cap_chan_check_security(struct l2cap_chan *chan, bool initiator);
934void l2cap_chan_set_defaults(struct l2cap_chan *chan);
935int l2cap_ertm_init(struct l2cap_chan *chan);
936void l2cap_chan_add(struct l2cap_conn *conn, struct l2cap_chan *chan);
937void __l2cap_chan_add(struct l2cap_conn *conn, struct l2cap_chan *chan);
938void l2cap_chan_del(struct l2cap_chan *chan, int err);
939void l2cap_send_conn_req(struct l2cap_chan *chan);
940void l2cap_move_start(struct l2cap_chan *chan);
941void l2cap_logical_cfm(struct l2cap_chan *chan, struct hci_chan *hchan,
942 u8 status);
943void __l2cap_physical_cfm(struct l2cap_chan *chan, int result);
944
945struct l2cap_conn *l2cap_conn_get(struct l2cap_conn *conn);
946void l2cap_conn_put(struct l2cap_conn *conn);
947
948int l2cap_register_user(struct l2cap_conn *conn, struct l2cap_user *user);
949void l2cap_unregister_user(struct l2cap_conn *conn, struct l2cap_user *user);
950
951#endif /* __L2CAP_H */