Debian Codegraph @

README

raw
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.