.TH BTPASSKEY "1" "November 2007" "btpasskey 1.0" "User Commands" .SH NAME btpasskey\- waits for D-Bus signal and request passkey from stdin .SH SYNOPSIS .B btpasskey [\fB--path\fR \fIagent-path\fI] .SH DESCRIPTION .PP .B btpasskey is a command line utility to enter passkeys during bluetooth pairing process. When started it just sits and waits for D-BUS message from bluez bluetooth stack. .PP When message recieved, it prints out name and bluetooth address of the device requesting connection and expects numeric passkey to be entered from stdin. Passkey entry should be finished by hitting Return key. .PP Entering empty passkey (just hitting enter) causes .B btpasskey to refuse answer to recieved message, which typically means cancelling bluetooth connection, unless another passkey agent is listening on system message bus. .PP .B btpasskey is intended to run from some more sophisticated user interface, so it uses unbuffered input/output. If another application starts it redirecting stdin and stdout to pipes, application may expect complete message to be read before .B btpasswd blocks waiting for input. .SH OPTIONS .TP .BI "--path, -p " agent-path Specify D-BUS path for agent, other than default. .TP .B --discoverable, -d Turn default adapter into discoverable mode while program is running and waiting for pairing request .TP .BI "--pair, -P " address Initiate pairing with device with specified address. .TP .BI "--remove, -r " address Instead of waiting for pairing request and ask user for passkey, just remove bonding with specified device and exit. This operation may be needed if device was prevoisly paired with this computer, then was paired with another computer and forgot link key. In this case we need to remove link key from our computer before pairing once again. .TP .B --help, -h Displays brief usage message. .TP .B --version, -V Displays program version. .SH SIGNALS .TP .B SIGINT Closes D-BUS connection and terminates .TP .B SIGTERM Closes D-BUS connection and terminates .TP .B SIGPIPE Closes D-BUS connection and terminates .SH BUGS Doesn't properly handle org.bluez.PasskeyAgent.Cancel method, when is blocked on reading from stdin. .PP All mode changes and pairing operations (-d,-P,-r) work only with default Bluetooth adapter. There is no way to specify other adapter to operate with. .SH AUTHOR Victor B. Wagner