NAME

       rfcomm - RFCOMM configuration utility

SYNOPSIS

       rfcomm [ options ] < command > < dev >

DESCRIPTION

       rfcomm  is used to set up, maintain, and inspect the RFCOMM configuration of the Bluetooth
       subsystem in the Linux kernel. If no command is given, or if the option -a is used, rfcomm
       prints information about the configured RFCOMM devices.

OPTIONS

       -h     Gives a list of possible commands.

       -a     Prints information about all configured RFCOMM devices.

       -r     Switch TTY into raw mode (doesn't work with "bind").

       -f <file>
              Specify alternate config file.

       -i <hciX> | <bdaddr>
              The  command  is applied to device -A Enable authentication.  -E Enable encryption.
              -S Secure connection.  -M Become the master of a piconet.  hciX , which must be the
              name or the address of an installed Bluetooth device. If not specified, the command
              will be use the first available Bluetooth device.

       -A     Enable authentification

       -E     Enable encryption

       -S     Secure connection

       -M     Become the master of a piconet

       -L <seconds>
              Set linger timeout

COMMANDS

       show <dev>
              Display the information about the specified device.

       connect <dev> [bdaddr] [channel]
              Connect the RFCOMM device to the remote Bluetooth device on the specified  channel.
              If no channel is specified, it will use the channel number 1. If also the Bluetooth
              address is left out, it tries to read the data from the config file.  This  command
              can be terminated with the key sequence CTRL-C.

       listen <dev> [channel] [cmd]
              Listen  on  a  specified RFCOMM channel for incoming connections.  If no channel is
              specified, it will use the channel number 1, but a channel must be specified before
              cmd.  If  cmd  is given, it will be executed as soon as a client connects. When the
              child process terminates or the client  disconnect,  the  command  will  terminate.
              Occurrences  of  {}  in  cmd will be replaced by the name of the device used by the
              connection. This command can be terminated with the key sequence CTRL-C.

       watch <dev> [channel] [cmd]
              Watch is identical to listen except that when the child process terminates  or  the
              client disconnect, the command will restart listening with the same parameters.

       bind <dev> [bdaddr] [channel]
              This  binds  the  RFCOMM  device  to a remote Bluetooth device. The command did not
              establish a connection to the remote device,  it  only  creates  the  binding.  The
              connection  will be established right after an application tries to open the RFCOMM
              device. If no channel number is specified, it uses the channel  number  1.  If  the
              Bluetooth address is also left out, it tries to read the data from the config file.

              If  all is specified for the RFCOMM device, then all devices that have bind yes set
              in the config will be bound.

       release <dev>
              This command releases a defined RFCOMM binding.

              If all is specified for the RFCOMM device, then all bindings will be removed.  This
              command didn't care about the settings in the config file.

AUTHOR

       Written by Marcel Holtmann <marcel@holtmann.org>.

                                          APRIL 28, 2002                                RFCOMM(1)