Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rfcomm_sppd(1) [netbsd man page]

RFCOMM_SPPD(1)						    BSD General Commands Manual 					    RFCOMM_SPPD(1)

rfcomm_sppd -- RFCOMM Serial Port Profile daemon SYNOPSIS
rfcomm_sppd [-d device] [-m mode] [-p psm] [-s service] [-t tty] {-a address | [-c channel]} DESCRIPTION
The rfcomm_sppd utility is a Serial Port Profile daemon, providing serial access over an RFCOMM connection to a remote device. rfcomm_sppd can work in client or server mode. In client mode, rfcomm_sppd initiates an RFCOMM connection to the service at the remote address. In server mode, rfcomm_sppd registers the service with the local SDP server and listens on the specified RFCOMM channel for an incoming con- nection, or the first unused channel if none was given. The options are as follows: -a address Client mode. Specify the address of the remote RFCOMM device. The address can be specified as BD_ADDR or name. If given as a name, then the rfcomm_sppd utility will attempt to resolve the name via bt_gethostbyname(3). -c channel In server mode, specify the RFCOMM channel number to listen on. rfcomm_sppd will register the service with the local sdpd(8) daemon. Note that registering services with sdpd(8) is a privileged operation. -d device Use the local device with the specified address. The device can be specified by BD_ADDR or device name. See btconfig(8) for a list of available devices. If no device is specified, the connection will be set up on a system determined device. -m mode Set connection link mode. Supported modes are: auth require devices be paired. encrypt auth, plus enable encryption. secure encryption, plus change of link key. -p psm Specify the "Protocol/Service Multiplexer" value to be used for the RFCOMM protocol. In client mode where Service Discovery is being used, this value will be ignored. -s service Name of service class to connect to or register. If no service is given, the default "Serial Port" service class will be used. Known service classes are: DUN Dialup Networking LAN LAN access using PPP SP Serial Port In client mode, the service class may be given as a channel number, for instances where the remote device does not provide Ser- vice Discovery. -t tty Slave pseudo tty name. If this option is given, rfcomm_sppd will detach from the controlling process after the Bluetooth connec- tion is made, and operate over the named pty(4) pair. Otherwise, stdin/stdout will be used. FILES
/dev/pty[p-sP-S][0-9a-v] master pseudo terminals /dev/tty[p-sP-S][0-9a-v] slave pseudo terminals EXIT STATUS
The rfcomm_sppd utility exits 0 on success, and >0 if an error occurs. EXAMPLES
rfcomm_sppd -a 00:01:02:03:04:05 -s 1 -t /dev/ttyp1 Will open an RFCOMM connection to the server at 00:01:02:03:04:05 on channel 1. Once the connection has been established, rfcomm_sppd will detach and /dev/ttyp1 can be used to communicate with the remote serial port on the server, e.g. with the use of cu -l /dev/ttyp1 In order to use rfcomm_sppd to automatically create a secured link for pppd(8), use pty "rfcomm_sppd -a 00:01:02:03:04:05 -s DUN -m secure" in your pppd(8) configuration file. SEE ALSO
bluetooth(3), bluetooth(4), pty(4), btconfig(8), pppd(8), sdpd(8) HISTORY
The rfcomm_sppd program first appeared in FreeBSD and was ported to NetBSD 4.0 by Iain Hibbert under the sponsorship of Itronix, Inc. AUTHORS
Maksim Yevmenkin <>, Iain Hibbert BUGS
Please report if found. BSD
November 2, 2010 BSD

Check Out this Related Man Page

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

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 Net- working User (PANU) or in server mode as Network 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 Bluetooth devices using the Bluetooth Network Encapsulation Pro- tocol (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 forwarding Ethernet packets between each of the con- nected 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/ 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" specifications are available at 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
Man Page