1 .\" Copyright (c) 2001-2003 Maksim Yevmenkin <m_evmenkin@yahoo.com>
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
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
25 .\" $Id: rfcomm_sppd.1,v 1.3 2003/09/07 18:15:55 max Exp $
33 .Nd RFCOMM Serial Port Profile daemon
43 utility is a Serial Port Profile daemon.
44 It can operate in two modes: client and server.
48 opens RFCOMM connection to the specified
52 Once connection is established, the
54 utility provides access to the server's remote serial port via stdin/stdout
65 will operate in server mode and act as RFCOMM server,
68 address and advertising a virtual serial port
74 options was specified,
75 the server side of the virtual serial port is attached to the pseudo-terminal
77 Otherwise the virtual serial port is attached to the stdin/stdout.
79 should be run as root in order to communicate with
85 utility opens both master and slave pseudo terminals.
86 This is done to ensure that RFCOMM connection stays open until
89 The data received from the master pseudo terminal are sent over
90 the RFCOMM connection.
91 The data received from the RFCOMM connection are written
92 into master pseudo terminal.
93 The application in its turn opens the slave pseudo
94 terminal and operates on it just like it would operate over the standard serial
97 The options are as follows:
98 .Bl -tag -width indent
101 this required option specifies the address of the remote RFCOMM server.
102 If this option is specified in server mode,
104 will only accept connections from the
108 The address can be specified as BD_ADDR or name.
109 If name was specified then
111 utility will attempt to resolve the name via
112 .Xr bt_gethostbyname 3 .
114 Detach from the controlling terminal, i.e., run in background.
116 In both client and server mode,
117 this option specifies the RFCOMM channel to connect to or listen on.
119 the channel should be a number between 1 and 30.
124 RFCOMM channel number.
125 The actual RFCOMM channel will be obtained via
127 call and will be used to register Serial Port service with
130 the channel could either be a number between 1 and 30 or a service name.
131 Supported service names are:
133 (for DialUp Networking service),
137 (for LAN Access Using PPP service) and
139 (for Serial Port service).
140 If channel was not specified then
142 utility will try to obtain RFCOMM channel for Serial Port service via Service
143 Discovery Protocol from the server.
145 Display usage message and exit.
150 Slave pseudo tty name.
151 If not set stdin/stdout will be used.
152 This option is required if
154 option was specified.
157 .Bl -tag -width ".Pa /dev/tty[p-sP-S][0-9a-v]" -compact
158 .It Pa /dev/pty[p-sP-S][0-9a-v]
159 master pseudo terminals
160 .It Pa /dev/tty[p-sP-S][0-9a-v]
161 slave pseudo terminals
166 .Dl "rfcomm_sppd -a 00:01:02:03:04:05 -c 1 -t /dev/ttyp1"
170 utility and open RFCOMM connection to the server at
171 .Li 00:01:02:03:04:05
174 Once the connection has been established,
176 can be used to talk to the remote serial port on the server.
184 .An Maksim Yevmenkin Aq m_evmenkin@yahoo.com
186 Please report if found.