1 .TH BTPASSKEY "1" "November 2007" "btpasskey 1.0" "User Commands"
3 btpasskey\- waits for D-Bus signal and request passkey from stdin
6 [\fB--path\fR \fIagent-path\fI]
10 is a command line utility to enter passkeys during bluetooth pairing
11 process. When started it just sits and waits for D-BUS message from
12 bluez bluetooth stack.
14 When message recieved, it prints out name and bluetooth address of the
15 device requesting connection and expects numeric passkey to be entered
16 from stdin. Passkey entry should be finished by hitting Return key.
18 Entering empty passkey (just hitting enter) causes
20 to refuse answer to recieved message, which typically means cancelling
21 bluetooth connection, unless another passkey agent is listening on
25 is intended to run from some more sophisticated user interface, so it
26 uses unbuffered input/output. If another application starts it
27 redirecting stdin and stdout to pipes, application may expect complete
28 message to be read before
30 blocks waiting for input.
33 .BI "--path, -p " agent-path
34 Specify D-BUS path for agent, other than default.
37 Turn default adapter into discoverable mode while program is running and waiting for pairing request
39 .BI "--pair, -P " address
40 Initiate pairing with device with specified address.
42 .BI "--remove, -r " address
43 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.
46 Displays brief usage message.
49 Displays program version.
53 Closes D-BUS connection and terminates
56 Closes D-BUS connection and terminates
59 Closes D-BUS connection and terminates
61 Doesn't properly handle org.bluez.PasskeyAgent.Cancel method, when is blocked on reading from stdin.
63 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.
65 Victor B. Wagner <vitus@wagner.pp.ru>