summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--noncore/net/wellenreiter/README63
1 files changed, 56 insertions, 7 deletions
diff --git a/noncore/net/wellenreiter/README b/noncore/net/wellenreiter/README
index 4ed5c28..c04d30c 100644
--- a/noncore/net/wellenreiter/README
+++ b/noncore/net/wellenreiter/README
@@ -1,37 +1,86 @@
1/*************************************************************************/ 1/*************************************************************************/
2/* W e l l e n r e i t e r I I */ 2/* W e l l e n r e i t e r I I */
3/* =============================== */ 3/* =============================== */
4/* */ 4/* */
5/* Version: Opie-ALPHA */ 5/* Version: Opie-ALPHA */
6/*************************************************************************/ 6/*************************************************************************/
7 7
8--------------------------------------------------
8Release Notes for Opie-ALPHA Version December 2002 9Release Notes for Opie-ALPHA Version December 2002
9-------------------------------------------------- 10--------------------------------------------------
10 11
12=====================
11= Supported Devices = 13= Supported Devices =
14=====================
12 15
13* low-level orinoco_cs-based (including prism2 and spectrum_cs) 16* low-level orinoco_cs-based (including prism2 and spectrum_cs)
14 17
15= Build = 18* Supported Interfaces: wlan0 (yes, I know this is hardcoded and
19 lame, but we're in a hurry and this can be configured soon...)
20
21=====================
22= Build =
23=====================
16 24
17To compile Wellenreiter within the Opie build environment, add the 25To compile Wellenreiter within the Opie build environment, add the
18following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' 26following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS='
19 27
20noncore/net/wellenreiter/libwellenreiter \ 28noncore/net/wellenreiter/libwellenreiter \
21noncore/net/wellenreiter/daemon \ 29noncore/net/wellenreiter/daemon \
22noncore/net/wellenreiter/contrib/orinoco_hopper \ 30noncore/net/wellenreiter/contrib/orinoco_hopper \
23noncore/net/wellenreiter/gui 31noncore/net/wellenreiter/gui
24 32
25./configure and rebuild. 33./configure and rebuild. Note that you need libpcap in your toolchain.
34
35=====================
36= Install =
37=====================
38
39Alternatively, you can use our precompiled ipk. Get it from
40http://opie.net.wox.org/elan/current. You will also need libpcap.
41
42=====================
43= Run =
44=====================
45
461. Place card in monitor mode. This is device dependent.
47
48 Caution: Don't do this while you're logged in via ssh
49 or otherwise using the wireless interface - your connection
50 will freeze: The card can't be used normally when sniffing!
51
52 For most orinoco-based cards this can be done using
53 'iwpriv <interface> 2' or 'iwpriv <interface> 2 1'.
54
55 You can check if this works, by calling 'ifconfig <interface>'.
56 If you see 'Protocol: UNSPEC' and an unusual long MAC-Address,
57 then your card has been successfully set to the monitor mode.
58
592. Start a channel hopper. A wireless card has several channels
60 (e.g. radio frequencies) here it can listen for beacons.
61 Beacons are management data frames from other stations.
62 Remember, this is radio transmission, so the card has to be
63 "tuned" to a certain channel to be able to receive the beacons.
64
65 In order to scan the complete frequency spectrum and thus be able
66 to detect all available stations, you have to 'hop' through the
67 channels frequently. You can do this manually (e.g. with 'iwconfig')
68 [hahaha] or you can use a channel hopper.
69
70 For convenience, the current Wellenreiter Alpha comes with a
71 channel hopper for Orinoco-based cards. Start this via
72 orinoco_hopper <interface>.
26 73
27= Run = 743. Start the Wellenreiter sniffing daemon: wellenreiterd.
28 75
291. Place card in monitor mode: iwpriv <interface> 2 1 764. Start the Wellenreiter GUI and sniff like hell. Don't press the button
302. Start $OPIEDIR/bin/orinoco_hopper <interface> 77 "Start Scan" yet, because it enables the demo mode and will crash the
313. Start Wellenreiter 78 wellenreiterd daemon if running.
32 79
33= Credits = 80=====================
81= Credits =
82=====================
34 83
35Sniffer: Max Moser <max@remote-exploit.org> 84Sniffer: Max Moser <max@remote-exploit.org>
36Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> 85Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org>
37GUI: Michael Lauer <mickeyl@handhelds.org> 86GUI: Michael Lauer <mickeyl@handhelds.org>