bthidcontrol(8)

bthidcontrol8

Bluetooth hid control utility

Usage

bthidcontrol -h

bthidcontrol [-a BD_ADDR] [-c file] [-H file] [-v] command

Overview

The bthidcontrol utility can be used to query remote Bluetooth HID devices, dump HID descriptors in human readable form and perform simple manipulations on the Bluetooth HID daemon configuration files.

The bthidcontrol utility will print results to the standard output and error messages to the standard error.

The options are as follows:

-a BD_ADDR

Specify BD_ADDR for the HID device. Example: -a 00:01:02:03:04:05.

-c file

Specify path to the Bluetooth HID daemon configuration file. The default path is /etc/bluetooth/bthidd.conf.

-H file

Specify path to the Bluetooth HID daemon known HIDs file. The default path is /var/db/bthidd.hids.

-h

Display usage message and exit.

-v

Be verbose and show items that are being used for padding.

command

One of the supported commands (see below). Special command help can be used to obtain the list of all supported commands. To get more information about specific command use help command.

Commands

The currently supported node commands in bthidcontrol are:

Query
Dump
Known
Forget

Files

/etc/bluetooth/bthidd.conf
/var/db/bthidd.hids

Exit status

The bthidcontrol utility exits 0 on success, and >0 if an error occurs.

Releases

47 releases since FreeBSD 6.2-RELEASE; the text changed 32 times.

  1. 6.2–6.3
  2. 6.4
  3. 7.0
  4. 7.1
  5. 7.2
  6. 7.3
  7. 7.4
  8. 8.0
  9. 8.1
  10. 8.2
  11. 8.3
  12. 8.4
  13. 9.0
  14. 9.1
  15. 9.2
  16. 9.3
  17. 10.0
  18. 10.1
  19. 10.2
  20. 10.3
  21. 10.4
  22. 11.0
  23. 11.1
  24. 11.2
  25. 11.3
  26. 11.4
  27. 12.0
  28. 12.1
  29. 12.2
  30. 12.3
  31. 12.4
  32. 13.0–13.2
  33. 13.3–16.0

-v since FreeBSD 7.0-RELEASE.

Authors

Maksim Yevmenkin ⟨[email protected]⟩

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.