ng_l2cap.4 (231564) | ng_l2cap.4 (242997) |
---|---|
1.\" Copyright (c) 2001-2002 Maksim Yevmenkin <m_evmenkin@yahoo.com> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 9 unchanged lines hidden (view full) --- 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $Id: ng_l2cap.4,v 1.4 2003/09/14 23:37:52 max Exp $ | 1.\" Copyright (c) 2001-2002 Maksim Yevmenkin <m_evmenkin@yahoo.com> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 9 unchanged lines hidden (view full) --- 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $Id: ng_l2cap.4,v 1.4 2003/09/14 23:37:52 max Exp $ |
26.\" $FreeBSD: head/share/man/man4/ng_l2cap.4 231564 2012-02-12 18:29:56Z ed $ | 26.\" $FreeBSD: head/share/man/man4/ng_l2cap.4 242997 2012-11-13 20:41:36Z joel $ |
27.\" 28.Dd July 4, 2002 29.Dt NG_L2CAP 4 30.Os 31.Sh NAME 32.Nm ng_l2cap 33.Nd Netgraph node type that implements Bluetooth Logical Link Control and 34Adaptation Protocol (L2CAP) --- 64 unchanged lines hidden (view full) --- 99.Pp 100CID assignment is relative to a particular device and a device can assign CIDs 101independently from other devices. 102Thus, even if the same CID value has been 103assigned to (remote) channel endpoints by several remote devices connected 104to a single local device, the local device can still uniquely associate each 105remote CID with a different device. 106.Ss Channel Operational States | 27.\" 28.Dd July 4, 2002 29.Dt NG_L2CAP 4 30.Os 31.Sh NAME 32.Nm ng_l2cap 33.Nd Netgraph node type that implements Bluetooth Logical Link Control and 34Adaptation Protocol (L2CAP) --- 64 unchanged lines hidden (view full) --- 99.Pp 100CID assignment is relative to a particular device and a device can assign CIDs 101independently from other devices. 102Thus, even if the same CID value has been 103assigned to (remote) channel endpoints by several remote devices connected 104to a single local device, the local device can still uniquely associate each 105remote CID with a different device. 106.Ss Channel Operational States |
107.Bl -tag -width indent | 107.Bl -tag -width foo |
108.It Dv NG_L2CAP_CLOSED 109In this state, there is no channel associated with this CID. 110This is the only 111state when a link level connection (Baseband) may not exist. 112Link disconnection 113forces all other states into the 114.Dv NG_L2CAP_CLOSED 115state. --- 88 unchanged lines hidden (view full) --- 204that is, L2CAP performs no retransmissions or checksum calculations. 205.It 206L2CAP does not support a reliable multicast channel. 207.It 208L2CAP does not support the concept of a global group name. 209.El 210.Sh HOOKS 211This node type supports the following hooks: | 108.It Dv NG_L2CAP_CLOSED 109In this state, there is no channel associated with this CID. 110This is the only 111state when a link level connection (Baseband) may not exist. 112Link disconnection 113forces all other states into the 114.Dv NG_L2CAP_CLOSED 115state. --- 88 unchanged lines hidden (view full) --- 204that is, L2CAP performs no retransmissions or checksum calculations. 205.It 206L2CAP does not support a reliable multicast channel. 207.It 208L2CAP does not support the concept of a global group name. 209.El 210.Sh HOOKS 211This node type supports the following hooks: |
212.Bl -tag -width indent 213.It Dv hci | 212.Bl -tag -width ".Va hci" 213.It Va hci |
214Bluetooth Host Controller Interface downstream hook. | 214Bluetooth Host Controller Interface downstream hook. |
215.It Dv l2c | 215.It Va l2c |
216Upper layer protocol upstream hook. 217Usually the Bluetooth L2CAP socket layer is connected to the hook. | 216Upper layer protocol upstream hook. 217Usually the Bluetooth L2CAP socket layer is connected to the hook. |
218.It Dv ctl | 218.It Va ctl |
219Control hook. 220Usually the Bluetooth raw L2CAP sockets layer is connected to the hook. 221.El 222.Sh INTERFACE TO THE UPPER LAYER PROTOCOLS (L2CA CONTROL MESSAGES) 223Bluetooth specification says that L2CA request must block until response 224is ready. 225L2CAP node uses 226.Va token --- 10 unchanged lines hidden (view full) --- 237Note that L2CA indication messages 238will not populate 239.Va token 240and will not set 241.Dv NGF_RESP 242flag. 243There is no reason for this, because they are just notifications and do 244not require acknowledgment. | 219Control hook. 220Usually the Bluetooth raw L2CAP sockets layer is connected to the hook. 221.El 222.Sh INTERFACE TO THE UPPER LAYER PROTOCOLS (L2CA CONTROL MESSAGES) 223Bluetooth specification says that L2CA request must block until response 224is ready. 225L2CAP node uses 226.Va token --- 10 unchanged lines hidden (view full) --- 237Note that L2CA indication messages 238will not populate 239.Va token 240and will not set 241.Dv NGF_RESP 242flag. 243There is no reason for this, because they are just notifications and do 244not require acknowledgment. |
245.Bl -tag -width indent | 245.Bl -tag -width foo |
246.It Dv NGM_L2CAP_L2CA_CON 247Requests the creation of a channel representing a logical connection to a 248physical address. 249Input parameters are the target protocol (PSM) and remote 250device's 48-bit address (BD_ADDR). 251Output parameters are the local CID (LCID) 252allocated by the local L2CAP entity, and Result of the request. 253If Result --- 121 unchanged lines hidden (view full) --- 375.It Dv NGM_L2CAP_L2CA_ENABLE_CLT 376Request to disable (enable) the reception of connectionless packets. 377The input 378parameter is the PSM value indicating service that should be blocked 379(unblocked) and Enable flag. 380.El 381.Sh NETGRAPH CONTROL MESSAGES 382This node type supports the generic control messages, plus the following: | 246.It Dv NGM_L2CAP_L2CA_CON 247Requests the creation of a channel representing a logical connection to a 248physical address. 249Input parameters are the target protocol (PSM) and remote 250device's 48-bit address (BD_ADDR). 251Output parameters are the local CID (LCID) 252allocated by the local L2CAP entity, and Result of the request. 253If Result --- 121 unchanged lines hidden (view full) --- 375.It Dv NGM_L2CAP_L2CA_ENABLE_CLT 376Request to disable (enable) the reception of connectionless packets. 377The input 378parameter is the PSM value indicating service that should be blocked 379(unblocked) and Enable flag. 380.El 381.Sh NETGRAPH CONTROL MESSAGES 382This node type supports the generic control messages, plus the following: |
383.Bl -tag -width indent | 383.Bl -tag -width foo |
384.It Dv NGM_L2CAP_NODE_GET_FLAGS 385Returns current state for the node. 386.It Dv NGM_L2CAP_NODE_GET_DEBUG 387Returns an integer containing the current debug level for the node. 388.It Dv NGM_L2CAP_NODE_SET_DEBUG 389This command takes an integer argument and sets current debug level 390for the node. 391.It Dv NGM_L2CAP_NODE_GET_CON_LIST --- 31 unchanged lines hidden --- | 384.It Dv NGM_L2CAP_NODE_GET_FLAGS 385Returns current state for the node. 386.It Dv NGM_L2CAP_NODE_GET_DEBUG 387Returns an integer containing the current debug level for the node. 388.It Dv NGM_L2CAP_NODE_SET_DEBUG 389This command takes an integer argument and sets current debug level 390for the node. 391.It Dv NGM_L2CAP_NODE_GET_CON_LIST --- 31 unchanged lines hidden --- |