- NetBSD Manual Pages
BTKEY(1) NetBSD General Commands Manual BTKEY(1)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
btkey -- Bluetooth Link Key management utility
btkey [-cCrRwW] [-k key] -a address -d device
btkey -lL [-d device]
The btkey program is used to manage Bluetooth Link Key storage. Keys are
normally handled by the bthcid(8) daemon which caches them in the
/var/db/bthcid.keys file and provides them as required when Bluetooth
connections need to be authenticated.
These keys are required for connections between remote devices and the
specific controller (not the Operating System) and so for multi-boot sys-
tems where it may not always be possible to specify the same key across
all OS's it can be better to have the Bluetooth controller provide the
keys directly from its semi-permanent memory once devices are paired.
btkey will read, write or clear keys in device memory or the key cache as
Note that without the bthcid(8) daemon running users will be unable to
supply PINs, and Link Keys resulting from new pairings will not be
stored. If no new pairings are expected and the keys are stored in the
controller then bthcid(8) is not required.
The options are as follows:
-a address Specify the remote device address. May be given as a BDADDR
or a name.
-c Clear key from file.
-C Clear key from device.
-d device Specify the local device address. May be given as a BDADDR
or a name.
-k key Supply a Link Key as a string of hexadecimal digits. Up to
32 digits will be processed and the resulting key will be
zero padded to 16 octets.
-l List keys stored in file.
-L List keys stored in device.
-r Read key from file.
-R Read key from device.
-w Write key to file.
-W Write key to device.
Super-user privileges are required to read or write link keys.
Read key for mouse at ubt0 from file and write to device
btkey -d ubt0 -a mouse -rW
Write new key for keyboard at ubt0 to file
btkey -d ubt0 -a keyboard -k 92beda6cd8b8f66ebd2af270d55d70ec -w
Clear key for phone at bt3c0 from file and device
btkey -d bt3c0 -a phone -cC
The btkey utility exits 0 on success, and >0 if an error occurs.
btpin(1), btconfig(8), bthcid(8)
NetBSD 5.0 November 8, 2007 NetBSD 5.0