btpin(1) - NetBSD Manual Pages

BTPIN(1)                NetBSD General Commands Manual                BTPIN(1)


NAME

     btpin -- Bluetooth PIN utility


SYNOPSIS

     btpin [-P] [-d device] [-s path] {-p pin | -r [-l len]} -a address


DESCRIPTION

     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:

     -a address  Specify the remote device address.  The address can be speci-
                 fied as BD_ADDR or a name.  If a name was specified, the
                 btpin utility attempts to resolve the name via
                 bt_gethostbyname(3).

     -d device   Specify the local device address.  The device can be speci-
                 fied 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.

     -l len      Specify length of PIN to generate, where 1 <= len <= 16.

     -P          Pair with remote device.  btpin will attempt to open an
                 authenticated L2CAP connection to the Service Discovery Ser-
                 vice on the remote device, to force immediate pairing.

     -p pin      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.

     -s path     Specify path to the control socket.  The default path is
                 /var/run/bthcid.


FILES

     /var/run/bthcid


EXIT STATUS

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


SEE ALSO

     btkey(1), btconfig(8), bthcid(8)


AUTHORS

     Iain Hibbert for Itronix, Inc

NetBSD 9.2                       May 16, 2009                       NetBSD 9.2