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

devfree(1M)						  System Administration Commands					       devfree(1M)

NAME

       devfree - release devices from exclusive use

SYNOPSIS

       devfree key [device]...

DESCRIPTION

       devfree releases devices from exclusive use. Exclusive use is requested with the command devreserv.

       When   devfree  is invoked with only the key argument, it releases all devices that have been reserved for that	key. When called with  key
       and  device arguments,  devfree releases  the specified devices that have been reserved with that  key.

OPERANDS

       The following operands are supported:

       device	 Defines device that this command will release from exclusive use. device can be the pathname of the device or the device alias.

       key	 Designates the unique key on which the device was reserved.

EXIT STATUS

       The following exit values are returned:

       0    Successful completion.

       1    Command syntax was incorrect, an invalid option was used, or an internal error occurred.

       2    Device table or device reservation table could not be opened for reading.

       3    Reservation release could not be completely fulfilled because one or more of the devices was not reserved or was not reserved  on  the
	    specified key.

FILES

       /etc/device.tab

       /etc/devlkfile

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       devreserv(1M), attributes(5)

NOTES

       The  commands  devreserv  and  devfree  are  used to manage the	availability of devices on a system. These commands do not place any  con-
       straints on the access to the device. They serve only as a centralized bookkeeping point for those who wish to use them. Processes that	do
       not use devreserv may concurrently use a device with a process that has reserved that device.

SunOS 5.11							    5 Jul 1990							       devfree(1M)

Linux and UNIX Man Pages

btkey(1) [netbsd man page]

Check Out this Related Man Page