1 .\" $NetBSD: btpand.8,v 1.3 2008/08/17 14:43:07 plunky Exp $
4 .\" Copyright (c) 2008 Iain Hibbert
5 .\" All rights reserved.
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in the
14 .\" documentation and/or other materials provided with the distribution.
16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 .Nd Bluetooth PAN daemon
39 .Brq Fl s Ar service | Fl S Ar service Op Fl p Ar psm
47 .Brq Fl s Ar service | Fl S Ar service
51 daemon handles Bluetooth Personal Area Networking services
53 It can operate in client mode as a Personal Area Networking User
55 or in server mode as Network Access Point
61 connects to the system via a
63 virtual Ethernet device and forwards Ethernet packets to
64 remote Bluetooth devices using the Bluetooth Network Encapsulation
68 The PANU client is the device that uses either the NAP or GN
69 service, or can talk directly to a PANU host in a crossover
72 A GN host forwards Ethernet packets to each of the connected PAN
73 users as needed but does not provide access to any additional networks.
75 The NAP service provides some of the features of an Ethernet bridge,
76 with the NAP host forwarding Ethernet packets between each of the
77 connected PAN users, and a different network
80 Note, the only differences between NAP and GN services as implemented by
82 are in the SDP service record.
83 The bridging of packets by the NAP must be configured separately.
85 The options are as follows:
86 .Bl -tag -width ".Fl a Ar address"
88 In client mode, address of remote server.
89 May be given as BDADDR or name, in which case
91 will attempt to resolve the address via the
92 .Xr bt_gethostbyname 3
95 In server mode, specify
103 Restrict connections to the local
105 May be given as BDADDR or name, in which case
107 will attempt to resolve the address via the
113 interface physical address to the BDADDR
114 of the Bluetooth radio.
119 driver to create a new network interface for use.
120 Use this option to select a specific
122 device interface which must already be created.
124 In server mode, limit the number of simultaneous connections.
125 The default limit is 7 for NAP and GN servers,
126 and 1 for a PANU server.
128 Set L2CAP connection link mode.
131 .Bl -tag -width 8n -compact
133 require devices to be paired.
135 auth, plus enable encryption.
137 encryption, plus change of link key.
141 Use global device settings to set authentication and encryption.
143 Use an alternative L2CAP Protocol/Service Multiplexer
145 for server mode or client mode
146 .Pq when not using Service Discovery .
147 The default PSM for BNEP is 15
152 to provide or connect to, the following services are recognised:
154 .Bl -tag -width 8n -compact
156 Group ad-hoc Network.
158 Network Access Point.
160 Personal Area Networking User.
167 will not use SDP services for connection setup.
170 When providing networking services, the Bluetooth PAN profile says that the
172 property of the bluetooth controller SHALL include Networking capability
173 .Pq set bit 0x020000 .
180 has set up the client or server connection and opened the
182 interface, it will create a pid file and detach.
184 .Bl -tag -width "Pa /etc/bluetooth/hosts" -compact
186 .It Pa /etc/bluetooth/hosts
188 .It Pa /var/run/tap Ns Em N Ns No .pid
193 .Dl ifconfig tap1 create
194 .Dl btpand -a host -d mydevice -s NAP -i tap1
197 Will create a connection to the NAP on
203 .Dl btpand -d mydevice -s GN
205 Will create a Group Network and register the GN service with the local
217 .Qq Personal Area Networking Profile
219 .Qq Bluetooth Network Encapsulation Protocol
220 specifications are available at
221 .Dl http://www.bluetooth.com/
225 There is no way to supply alternative values for the SDP record.
227 There is no way to set net type or multicast address filters.
230 does not do any address routing except to directly connected
232 All other packets are multicast.
236 uses the BDADDR of the Bluetooth radio as the physical address
237 of the tap, only one instance can be run per radio.
240 can only provide a single service.