Running
-------
Simple:
./btscanner [--device <hcidev>]

Scroll through the list of found devices, press enter to probe the device
for more information and a running RSSI/Link quality meter. This may
trigger a pairing request if you are not paired with the peer device. Use
'q' to quit the screen or application.


How it works
------------
There are 4 threads, a monitor, a screen updater, a scanner and a device
probe. The scanner will try to put the Bluetooth device into a scan mode
"hcitool scan" and retrieve a list of found devices. This will only find
devices that are left in a discoverable state. The results are sent back
to the screen thread which updates information shown. Once a device is
found it will not be removed. When enter is pressed on the main screen,
the scanner is paused and the device probe tries to retrieve as much
information as is it can, this may trigger a pair request. To exit the
infro screen, press 'q'. To quit the application, press 'q'.


Reccomended CFLAGS
------------------
-g -ggdb -Wall -Wshadow -Wbad-function-cast -Wformat -Wimplicit-function-dec \
-Wparentheses -Wsign-compare -pedantic -Wstrict-prototypes -fstrict-aliasing \
-Wstrict-prototypes -Wtrigraphs -Wundef -W -Wunused -Wformat-security \
-Wmissing-braces -Wbad-function-cast -Wcast-qual -fstack-check -fbounds-check


Recommended Libraries/Packages
------------------------------
Linux kernel 2.4.22
bluez-libs 2.4
bluez-sdp 1.5


Installation
------------
./configure [--prefix=<prefix>]
make
make install


OUI Database
------------
Upadted versions of the IEEE OUI database can be downloaded from:
http://standards.ieee.org/regauth/oui/index.shtml

Todo
----
1) Main screen (discovered device list) scolling.
2) Brute force scanning of OUI ranges (user specified)
   Two methods to brute force scanning, hci probes and sdp probes
3) Try to connect to services, particularly OBEX which requires no pair.

Tim Hurman <bluetooth at pentest.co.uk>
Sept 2003.
