rfcomm.rst 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100
  1. ======
  2. rfcomm
  3. ======
  4. ----------------------------
  5. RFCOMM configuration utility
  6. ----------------------------
  7. :Author: Marcel Holtmann <marcel@holtmann.org>
  8. :Version: BlueZ
  9. :Copyright: Free use of this software is granted under ther terms of the GNU
  10. Lesser General Public Licenses (LGPL).
  11. :Date: April 28, 2002
  12. :Manual section: 1
  13. :Manual group: Linux System Administration
  14. SYNOPSIS
  15. ========
  16. **rfcomm** [*OPTIONS*] <*COMMAND*> <*dev*>
  17. DESCRIPTION
  18. ===========
  19. **rfcomm(1)** is used to set up, maintain, and inspect the RFCOMM configuration
  20. of the Bluetooth subsystem in the Linux kernel. If no **command** is given,
  21. or if the option **-a** is used, **rfcomm** prints information about the
  22. configured RFCOMM devices.
  23. OPTIONS
  24. =======
  25. -h Gives a list of possible commands.
  26. -a Prints information about all configured RFCOMM devices.
  27. -r Switch TTY into raw mode (doesn't work with "bind").
  28. -i <*hciX*> | <*bdaddr*>
  29. The command is applied to device *hciX*, which must be the name or the
  30. address of an installed Bluetooth device. If not specified, the command
  31. will be use the first available Bluetooth device.
  32. -A Enable authentication
  33. -E Enable encryption
  34. -S Secure connection
  35. -C Become the central of a piconet
  36. -L <seconds> Set linger timeout
  37. COMMANDS
  38. ========
  39. show <*dev*>
  40. Display the information about the specified device.
  41. connect <*dev*> [*bdaddr*] [*channel*]
  42. Connect the RFCOMM device to the remote Bluetooth device on the specified
  43. channel. If no channel is specified, it will use the channel
  44. number **1**. This command can be terminated with the key sequence CTRL-C.
  45. listen <*dev*> [*channel*] [*cmd*]
  46. Listen on a specified RFCOMM channel for incoming connections. If no
  47. channel is specified, it will use the channel number **1**, but a channel
  48. must be specified before cmd. If cmd is given, it will be executed as soon
  49. as a client connects. When the child process terminates or the client
  50. disconnect, the command will terminate. Occurrences of {} in cmd will be
  51. replaced by the name of the device used by the connection. This command
  52. can be terminated with the key sequence CTRL-C.
  53. watch <*dev*> [*channel*] [*cmd*]
  54. Watch is identical to listen except that when the child process
  55. terminates or the client disconnect, the command will restart listening
  56. with the same parameters.
  57. bind <*dev*> [*bdaddr*] [*channel*]
  58. This binds the RFCOMM device to a remote Bluetooth device. The command
  59. does not establish a connection to the remote device, it only creates
  60. the binding. The connection will be established right after an application
  61. tries to open the RFCOMM device. If no channel number is specified, it
  62. uses the channel number **1**.
  63. release <*dev*>
  64. This command releases a defined RFCOMM binding.
  65. If **all** is specified for the RFCOMM device, then all bindings will be
  66. removed.
  67. RESOURCES
  68. =========
  69. http://www.bluez.org
  70. REPORTING BUGS
  71. ==============
  72. linux-bluetooth@vger.kernel.org