1RFCOMM(1)                                                            RFCOMM(1)
2
3
4

NAME

6       rfcomm - RFCOMM configuration utility
7

SYNOPSIS

9       rfcomm [ options ] < command > < dev >
10

DESCRIPTION

12       rfcomm  is  used to set up, maintain, and inspect the RFCOMM configura‐
13       tion of the Bluetooth subsystem in the Linux kernel. If no  command  is
14       given, or if the option -a is used, rfcomm prints information about the
15       configured RFCOMM devices.
16

OPTIONS

18       -h     Gives a list of possible commands.
19
20       -a     Prints information about all configured RFCOMM devices.
21
22       -r     Switch TTY into raw mode (doesn't work with "bind").
23
24       -f [file]
25              Specify alternate config file.
26
27       -i <hciX> | <bdaddr>
28              The command is applied to device hciX , which must be  the  name
29              or  the  address of an installed Bluetooth device. If not speci‐
30              fied, the command will be  use  the  first  available  Bluetooth
31              device.
32
33       -A     Enable authentification
34
35       -E     Enable encryption
36
37       -S     Secure connection
38
39       -M     Become the master of a piconet
40

COMMANDS

42       show <dev>
43              Display the information about the specified device.
44
45       connect <dev> [bdaddr] [channel]
46              Connect  the RFCOMM device to the remote Bluetooth device on the
47              specified channel. If no channel is specified, it will  use  the
48              channel  number 1. If also the Bluetooth address is left out, it
49              tries to read the data from the config file. This command can be
50              terminated with the key sequence CTRL-C.
51
52       listen <dev> [channel] [cmd]
53              Listen  on  a specified RFCOMM channel for incoming connections.
54              If no channel is specified, it will use the  channel  number  1,
55              but  a channel must be specified before cmd. If cmd is given, it
56              will be executed as soon as a client connects.  When  the  child
57              process  terminates  or  the client disconnect, the command will
58              terminate.  Occurences of {} in cmd will be replaced by the name
59              of the device used by the connection. This command can be termi‐
60              nated with the key sequence CTRL-C.
61
62       watch <dev> [channel] [cmd]
63              Watch is identical to listen except that when the child  process
64              terminates  or  the  client disconnect, the command will restart
65              listening with the same parameters.
66
67       bind <dev> [bdaddr] [channel]
68              This binds the RFCOMM device to a remote Bluetooth  device.  The
69              command  did not establish a connection to the remote device, it
70              only creates the binding. The  connection  will  be  established
71              right  after  an application tries to open the RFCOMM device. If
72              no channel number is specified, it uses the channel number 1. If
73              the  Bluetooth  address  is  also left out, it tries to read the
74              data from the config file.
75
76              If all is specified for the RFCOMM device, then all devices that
77              have bind yes set in the config will be bound.
78
79       release <dev>
80              This command releases a defined RFCOMM binding.
81
82              If  all  is  specified  for the RFCOMM device, then all bindings
83              will be removed.  This command didn't care about the settings in
84              the config file.
85

AUTHOR

87       Written by Marcel Holtmann <marcel@holtmann.org>.
88
89
90
91                                APRIL 28, 2002                       RFCOMM(1)