btpin —
Bluetooth PIN utility
  
    | btpin | [ -P] [-ddevice] [-spath] {-ppin |-r[-llen]}-aaddress | 
The btpin utility is used to register a temporary PIN
  with the bthcid(8) daemon for
  the purposes of pairing Bluetooth devices. The PIN will be valid for 5 minutes
  or until used, whichever comes first.
The options are as follows:
  - -aaddress
- Specify the remote device address. The address can be specified as BD_ADDR
      or a name. If a name was specified, the btpinutility attempts to resolve the name via
      bt_gethostbyname(3).
- -ddevice
- Specify the local device address. The device can be specified by BD_ADDR
      or device name. See
      btconfig(8) for a list of
      devices available. If no device is specified, the PIN will be valid for
      any local device.
- -llen
- Specify length of PIN to generate, where 1 ≤
      len ≤ 16.
- -P
- Pair with remote device. btpinwill attempt to
      open an authenticated L2CAP connection to the Service Discovery Service on
      the remote device, to force immediate pairing.
- -ppin
- The PIN to register. The PIN may be up to 16 bytes in length.
- -r
- Generate a random PIN, the default length is 4 bytes.
- -spath
- Specify path to the control socket. The default path is
      /var/run/bthcid.
Thebtpin utility exits 0 on success,
  and >0 if an error occurs.
Iain Hibbert for Itronix, Inc