| 1 |
Running |
| 2 |
------- |
| 3 |
btscanner [--no-reset] [--cfg=<filename>] [--help] |
| 4 |
--no-reset => Do not reset the Bluetooth device(s) before starting the |
| 5 |
scan. |
| 6 |
--cfg=<file> => Use <file> as the config file rather than the default. |
| 7 |
--help => Print the help screen. |
| 8 |
|
| 9 |
Scroll through the list of found devices, press enter to probe the device |
| 10 |
for more information and a running RSSI/Link quality meter. This may |
| 11 |
trigger a pairing request if you are not paired with the peer device. Use |
| 12 |
'q' to quit the screen and 'Q' to quit the application. |
| 13 |
|
| 14 |
|
| 15 |
How it works |
| 16 |
------------ |
| 17 |
Btscanner is managed by a single thread, this updates the display and |
| 18 |
starts all the scanning threads when needed. When a scan is invoked, a |
| 19 |
thread is started for each avilable and configured Bluetooth interface. |
| 20 |
Two scan types exist, inquiry and brute force. In inquiry mode, each |
| 21 |
interface scans for new devices and retrieves any information requested. |
| 22 |
In brute force mode, each interface takes the next address in the sequence |
| 23 |
and probes for a device using that address. |
| 24 |
|
| 25 |
|
| 26 |
Commands |
| 27 |
-------- |
| 28 |
i => Start and inquiry scan |
| 29 |
b => Start a brute force scan |
| 30 |
a => Abort any current scans |
| 31 |
q => Quit the current screen |
| 32 |
Q => Quit Btscanner |
| 33 |
s => Dump a summary of all actions since the last summary. |
| 34 |
o => Sorting. Follow the on screen instructions. |
| 35 |
|
| 36 |
Saved Data |
| 37 |
---------- |
| 38 |
When a device is found, information regarding the scan is saved to disk. |
| 39 |
Any device information is saved to ~/bts/<BDADDR>/info. A timestamp is |
| 40 |
also saved in ~/bts/<BDADDR>/timestamps. The timestamp enables the user to |
| 41 |
monitor when and for how long the device was in range. |
| 42 |
|
| 43 |
Btscanner is also capable of saving summary logs. A summary log is a list |
| 44 |
of all the devices scanned since the last summary log or since Btscanner |
| 45 |
was started. |
| 46 |
|
| 47 |
|
| 48 |
Required Libraries/Packages |
| 49 |
--------------------------- |
| 50 |
Linux kernel 2.4.26 |
| 51 |
bluez-libs 2.10 |
| 52 |
bluez-tools 2.10 |
| 53 |
libXML 2.6.7 |
| 54 |
ncurses 5.4 |
| 55 |
|
| 56 |
Installation |
| 57 |
------------ |
| 58 |
./configure [--prefix=<prefix>] |
| 59 |
make |
| 60 |
make install |
| 61 |
|
| 62 |
|
| 63 |
OUI Database |
| 64 |
------------ |
| 65 |
Upadted versions of the IEEE OUI database can be downloaded from: |
| 66 |
http://standards.ieee.org/regauth/oui/index.shtml |
| 67 |
|
| 68 |
Tim Hurman <bluetooth at pentest.co.uk> |
| 69 |
November 2004. |