Unix/Linux Go Back    


NetBSD 6.1.5 - man page for btpand (netbsd section 8)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


BTPAND(8)			   BSD System Manager's Manual				BTPAND(8)

NAME
     btpand -- Bluetooth PAN daemon

SYNOPSIS
     btpand [-i ifname] [-m mode] -a addr -d device {-s service | -S service [-p psm]}
     btpand [-c path] [-i ifname] [-l limit] [-m mode] [-p psm] -d device
	    {-s service | -S service}

DESCRIPTION
     The btpand daemon handles Bluetooth Personal Area Networking services in the system.  It can
     operate in client mode as a Personal Area Networking User (PANU) or in server mode as Net-
     work Access Point (NAP), Group ad-hoc Network (GN) or PANU host.  btpand connects to the
     system via a tap(4) virtual Ethernet device and forwards Ethernet packets to remote Blue-
     tooth devices using the Bluetooth Network Encapsulation Protocol (BNEP).

     The PANU client is the device that uses either the NAP or GN service, or can talk directly
     to a PANU host in a crossover cable fashion.

     A GN host forwards Ethernet packets to each of the connected PAN users as needed but does
     not provide access to any additional networks.

     The NAP service provides some of the features of an Ethernet bridge, with the NAP host for-
     warding Ethernet packets between each of the connected PAN users, and a different network
     media.

     Note, the only differences between NAP and GN services as implemented by btpand are in the
     SDP service record.  The bridging of packets by the NAP must be configured separately with
     brconfig(8).

     The options are as follows:

     -a address  In client mode, address of remote server.  May be given as BDADDR or name, in
		 which case btpand will attempt to resolve the address via the
		 bt_gethostbyname(3) call.

     -c path	 In server mode, specify path to the sdpd(8) control socket.  The default path is
		 /var/run/sdp.

     -d device	 Restrict connections to the local device.  May be given as BDADDR or name, in
		 which case btpand will attempt to resolve the address via the bt_devaddr(3)
		 call.	btpand will set the tap(4) interface physical address to the BDADDR of
		 the Bluetooth radio.

     -i ifname	 btpand uses the tap(4) driver to create a new network interface for use.  Use
		 this option to select a specific tap(4) device interface which must already be
		 created.

     -l limit	 In server mode, limit the number of simultaneous connections.	The default limit
		 is 7 for NAP and GN servers, and 1 for a PANU server.

     -m mode	 Set L2CAP connection link mode.  Supported modes are:

		 auth	       require devices to be paired.
		 encrypt       auth, plus enable encryption.
		 secure        encryption, plus change of link key.

     -p psm	 Use an alternative L2CAP Protocol/Service Multiplexer (PSM) for server mode or
		 client mode (when not using Service Discovery).  The default PSM for BNEP is 15
		 (0x000f).

     -s service  Name of service to provide or connect to, the following services are recognised:

		 GN	       Group ad-hoc Network.
		 NAP	       Network Access Point.
		 PANU	       Personal Area Networking User.

     -S service  As per -s except that btpand will not use SDP services for connection setup.

     When providing networking services, the Bluetooth PAN profile says that the 'Class of
     Device' property of the bluetooth controller SHALL include Networking capability (set bit
     0x020000).  See btconfig(8) for details.

     After btpand has set up the client or server connection and opened the tap(4) interface, it
     will create a pid file and detach.

FILES
     /dev/tap
     /etc/bluetooth/hosts
     /var/run/sdp
     /var/run/tapN.pid

EXIT STATUS
     The btpand utility exits 0 on success, and >0 if an error occurs.

EXAMPLES
	   ifconfig tap1 create
	   btpand -a host -d ubt0 -s NAP -m encrypt -i tap1
	   dhclient -q -o -w -nw tap1

     Will create an encrypted connection to the NAP on host, and link that to the tap1 interface.

	   btpand -d ubt0 -s GN -m auth

     Will create a Group Network requiring authentication to join and register the GN service
     with the local SDP server.

SEE ALSO
     bluetooth(3), bluetooth(4), bridge(4), tap(4), brconfig(8), btconfig(8), dhclient(8),
     dhcpd(8), ifconfig(8), sdpd(8)

     The "Personal Area Networking Profile" and "Bluetooth Network Encapsulation Protocol" speci-
     fications are available at
	   http://www.bluetooth.com/

AUTHORS
     Iain Hibbert

BUGS
     There is no way to supply alternative values for the SDP record.

     There is no way to set net type or multicast address filters.

     btpand does not do any address routing except to directly connected unicast addresses.  All
     other packets are multicast.

     As btpand uses the BDADDR of the Bluetooth radio as the physical address of the tap, only
     one instance can be run per radio.

     btpand can only provide a single service.

BSD					 August 17, 2008				      BSD
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:08 AM.