btkey(1) [netbsd man page]

BTKEY(1)						    BSD General Commands Manual 						  BTKEY(1)

NAME

     btkey -- Bluetooth Link Key management utility

SYNOPSIS

     btkey [-CcRrWw] [-k key] -a address -d device
     btkey -Ll [-d device]

DESCRIPTION

     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
     systems 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 required.

     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 device.

     -c 	 Clear key from file.

     -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 device.

     -l 	 List keys stored in file.

     -R 	 Read key from device.

     -r 	 Read key from file.

     -W 	 Write key to device.

     -w 	 Write key to file.

     Super-user privileges are required to read or write link keys.

EXIT STATUS

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

FILES

     /var/db/bthcid.keys

EXAMPLES

     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

SEE ALSO

     btpin(1), btconfig(8), bthcid(8)

AUTHORS

     Iain Hibbert

BSD
								 November 8, 2007							       BSD

Check Out this Related Man Page

HCSECD.CONF(5)						      BSD File Formats Manual						    HCSECD.CONF(5)

NAME

     hcsecd.conf -- hcsecd(8) configuration file

DESCRIPTION

     The hcsecd.conf file is the configuration file for the hcsecd(8) Bluetooth link keys/PIN codes management daemon.

     The hcsecd.conf file is a free-form ASCII text file.  It is parsed by the recursive-descent parser built into hcsecd(8).  The file may con-
     tain extra tabs and newlines for formatting purposes.  Keywords in the file are case-sensitive.  Comments may be placed anywhere within the
     file (except within quotes).  Comments begin with the '#' character and end at the end of the line.

FILE FORMAT

     The hcsecd.conf file consists of a list of device entries.  Each device entry defines a link key or PIN code for a remote Bluetooth device.
     Each remote Bluetooth device is identified by its unique BD_ADDR.

     The device entry

     device { option argument; [option argument;] }

     The following section describes all supported options and arguments.

     bdaddr BD_ADDR
	     Specify remote device BD_ADDR for the entry.

     name device_name
	     Specify user friendly name for the entry.	Name is a string in straight double quotes.

     key link_key
	     Specify link key for the entry.  Link key is hexadecimal string up to 32 characters in length starting with '0x'.

     key nokey
	     Specify no link key for the entry.

     pin PIN_code
	     Specify PIN code for the entry.  PIN code is a string up to 16 characters in length in straight double quotes.

     pin nopin
	     Specify no PIN code for the entry.

EXAMPLES

     A sample hcsecd.conf file:

     # Default entry is applied if no better match found
     # It MUST have 00:00:00:00:00:00 as bdaddr
     device {
	     bdaddr  00:00:00:00:00:00;
	     name    "Default entry";
	     key     nokey;
	     pin     nopin;
     }

     # Ericsson T68 phone
     device {
	     bdaddr  00:80:37:5e:4d:d4;
	     name    "Ericsson T68 phone";
	     key     nokey;
	     pin     "0000"; # PIN code
     }

     # Dummy device
     device {
	     bdaddr  00:11:22:33:44:55;
	     name    "Dummy";
	     key     0x00112233445566778899aabbccddeeff; # 16 bytes key
	     pin     nopin;
     }

SEE ALSO

     hcsecd(8)

AUTHORS

     Maksim Yevmenkin <m_evmenkin@yahoo.com>

BSD
								   May 26, 2003 							       BSD

Linux and UNIX Man Pages

btkey(1) [netbsd man page]

Check Out this Related Man Page