bdaddr.1 2.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. .\" Man page generated from reStructuredText.
  2. .
  3. .TH BDADDR 1 "Sep 27, 2005" "BlueZ" "Linux System Administration"
  4. .SH NAME
  5. bdaddr \- Utility for changing the Bluetooth device address
  6. .
  7. .nr rst2man-indent-level 0
  8. .
  9. .de1 rstReportMargin
  10. \\$1 \\n[an-margin]
  11. level \\n[rst2man-indent-level]
  12. level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
  13. -
  14. \\n[rst2man-indent0]
  15. \\n[rst2man-indent1]
  16. \\n[rst2man-indent2]
  17. ..
  18. .de1 INDENT
  19. .\" .rstReportMargin pre:
  20. . RS \\$1
  21. . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
  22. . nr rst2man-indent-level +1
  23. .\" .rstReportMargin post:
  24. ..
  25. .de UNINDENT
  26. . RE
  27. .\" indent \\n[an-margin]
  28. .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
  29. .nr rst2man-indent-level -1
  30. .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
  31. .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
  32. ..
  33. .SH SYNOPSIS
  34. .sp
  35. \fBbdaddr\fP
  36. .sp
  37. \fBbdaddr\fP \-h
  38. .sp
  39. \fBbdaddr\fP [\-i <\fIdev\fP>] [\-r] [\-t] [\fInew_bdaddr\fP]
  40. .SH DESCRIPTION
  41. .sp
  42. \fBbdaddr(1)\fP is used to query or set the local Bluetooth device address
  43. (BD_ADDR). If run with no arguments, \fBbdaddr\fP prints the chip manufacturer\(aqs
  44. name, and the current BD_ADDR. If the IEEE OUI index file "oui.txt" is
  45. installed on the system, the BD_ADDR owner will be displayed. If the optional
  46. [\fInew_bdaddr\fP] argument is given, the device will be reprogrammed with that
  47. address. This can either be permanent or temporary, as specified by the \-t
  48. flag. In both cases, the device must be reset before the new address will
  49. become active. This can be done with a \(aqsoft\(aq reset by specifying the \-r
  50. flag, or a \(aqhard\(aq reset by removing and replugging the device. A \(aqhard\(aq reset
  51. will cause the address to revert to the current non\-volatile value.
  52. .sp
  53. \fBbdaddr\fP uses manufacturer specific commands to set the address, and is
  54. therefore device specific. For this reason, not all devices are supported,
  55. and not all options are supported on all devices. Current supported
  56. manufacturers are: \fBEricsson\fP, \fBCambridge Silicon Radio (CSR)\fP,
  57. \fBTexas Instruments (TI)\fP, \fBZeevo\fP and \fBST Microelectronics (ST)\fP\&.
  58. .SH OPTIONS
  59. .INDENT 0.0
  60. .TP
  61. .B \-h
  62. Gives a list of possible commands.
  63. .TP
  64. .BI \-i \ <dev>
  65. Specify a particular device to operate on. If not specified,
  66. default is the first available device.
  67. .TP
  68. .B \-r
  69. Reset device and make new BD_ADDR active. CSR devices only.
  70. .TP
  71. .B \-t
  72. Temporary change. Do not write to non\-volatile memory.
  73. CSR devices only.
  74. .UNINDENT
  75. .SH FILES
  76. .INDENT 0.0
  77. .TP
  78. .B /usr/share/misc/oui.txt
  79. IEEE Organizationally Unique Identifier consolidated file.
  80. Manually update from: \fI\%http://standards.ieee.org/regauth/oui/oui.txt\fP
  81. .UNINDENT
  82. .SH RESOURCES
  83. .sp
  84. \fI\%http://www.bluez.org\fP
  85. .SH REPORTING BUGS
  86. .sp
  87. \fI\%linux\-bluetooth@vger.kernel.org\fP
  88. .SH AUTHOR
  89. Marcel Holtmann <marcel@holtmann.org>, Adam Laurie <adam@algroup.co.uk>
  90. .SH COPYRIGHT
  91. Free use of this software is granted under ther terms of the GNU
  92. Lesser General Public Licenses (LGPL).
  93. .\" Generated by docutils manpage writer.
  94. .