summaryrefslogtreecommitdiff
Unidiff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--noncore/net/wellenreiter/README17
1 files changed, 15 insertions, 2 deletions
diff --git a/noncore/net/wellenreiter/README b/noncore/net/wellenreiter/README
index af2e611..ada9321 100644
--- a/noncore/net/wellenreiter/README
+++ b/noncore/net/wellenreiter/README
@@ -1,99 +1,112 @@
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-January */ 5 /* Version: Opie-ALPHA-January */
6/*************************************************************************/ 6/*************************************************************************/
7 7
8-------------------------------------------------- 8--------------------------------------------------
9Release Notes for Opie-ALPHA Version January 2002 9Release Notes for Opie-ALPHA Version January 2002
10-------------------------------------------------- 10--------------------------------------------------
11 11
12===================== 12=====================
13= Supported Devices = 13= Supported Devices =
14===================== 14=====================
15 15
16* low-level orinoco_cs-based (including prism2 and spectrum_cs) 16* low-level orinoco_cs-based (including prism2 and spectrum_cs)
17 17
18===================== 18=====================
19= Build = 19= Build =
20===================== 20=====================
21 21
22(I) Opie Build Environment
23
22To compile Wellenreiter within the Opie build environment, add the 24To compile Wellenreiter within the Opie build environment, add the
23following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' 25following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS='
24 26
25noncore/net/wellenreiter/libwellenreiter \ 27noncore/net/wellenreiter/libwellenreiter \
26noncore/net/wellenreiter/daemon \ 28noncore/net/wellenreiter/daemon \
27noncore/net/wellenreiter/contrib/orinoco_hopper \ 29noncore/net/wellenreiter/contrib/orinoco_hopper \
28noncore/net/wellenreiter/gui 30noncore/net/wellenreiter/gui
29 31
30./configure and rebuild. Note that you need libpcap in your toolchain. 32./configure and rebuild. Note that you need libpcap in your toolchain.
31 33
34(II) OpenZaurus Build Environment
35
32To compile Wellenreiter within the OZ build environment, add the 36To compile Wellenreiter within the OZ build environment, add the
33following lines to $OPIEDIR/packages 37following lines to $OPIEDIR/packages:
34CONFIG_WELLENREITER noncore/net/wellenreiter/libwellenreiter libwellenreiter.pro 38CONFIG_WELLENREITER noncore/net/wellenreiter/libwellenreiter libwellenreiter.pro
35CONFIG_WELLENREITER noncore/net/wellenreiter/daemon daemon.pro 39CONFIG_WELLENREITER noncore/net/wellenreiter/daemon daemon.pro
36CONFIG_WELLENREITER noncore/net/wellenreiter/gui gui.pro 40CONFIG_WELLENREITER noncore/net/wellenreiter/gui gui.pro
37CONFIG_WELLENREITER noncore/net/wellenreiter/contrib/orinoco_hopper orinoco_hopper.pro 41CONFIG_WELLENREITER noncore/net/wellenreiter/contrib/orinoco_hopper orinoco_hopper.pro
38 42
39make -f Makefile.test clean-configs 43make -f Makefile.test clean-configs
40cd <BUILDROOT> 44cd <BUILDROOT>
41make SUBDIRS=packages/opie package 45make SUBDIRS=packages/opie package
42 46
47(III) To compile a standalone Wellenreiter for X11, you need Qt3 and the development
48packages for Qt3, e.g. libqt3-devel. Assuming, $OPIEDIR and $QTDIR is set to Opie resp.
49Qt (e.g. /usr/lib/qt3), do the following:
50export QMAKESPEC=$OPIEDIR/mkspecs/linux-g++
51cd $OPIEDIR/noncore/net/wellenreiter
52qmake -makefile wellenreiter.pro
53make qmake
54make
55
43===================== 56=====================
44= Install = 57= Install =
45===================== 58=====================
46 59
47Alternatively, you can use our precompiled ipk. Get it from 60Alternatively, you can use our precompiled ipk. Get it from
48http://opie.net.wox.org/wellenreiter/current/. This also includes a recent libpcap. 61http://opie.net.wox.org/wellenreiter/. This also includes a recent libpcap.
49 62
50===================== 63=====================
51= Run = 64= Run =
52===================== 65=====================
53 66
54There are two possible modes: <Manual> and <Automatic>. I suggest, you 67There are two possible modes: <Manual> and <Automatic>. I suggest, you
55start with the <Automatic> Mode. This works just using the "Start" 68start with the <Automatic> Mode. This works just using the "Start"
56and "Stop" Pushbuttons in the Wellenreiter GUI. If this doesn't work, 69and "Stop" Pushbuttons in the Wellenreiter GUI. If this doesn't work,
57then use the following strategy: 70then use the following strategy:
58 71
591. Place card in monitor mode. This is device dependent. 721. Place card in monitor mode. This is device dependent.
60 73
61 Caution: Don't do this while you're logged in via ssh 74 Caution: Don't do this while you're logged in via ssh
62 or otherwise using the wireless interface - your connection 75 or otherwise using the wireless interface - your connection
63 will freeze: The card can't be used normally when sniffing! 76 will freeze: The card can't be used normally when sniffing!
64 77
65 For most orinoco-based cards this can be done using either 78 For most orinoco-based cards this can be done using either
66 'iwpriv <interface> 2' or 'iwpriv <interface> 2 1'. 79 'iwpriv <interface> 2' or 'iwpriv <interface> 2 1'.
67 80
68 You can check if this works, by calling 'ifconfig <interface>'. 81 You can check if this works, by calling 'ifconfig <interface>'.
69 If you see 'Protocol: UNSPEC' and an unusual long MAC-Address, 82 If you see 'Protocol: UNSPEC' and an unusual long MAC-Address,
70 then your card has been successfully set to the monitor mode. 83 then your card has been successfully set to the monitor mode.
71 84
722. Start a channel hopper. A wireless card has several channels 852. Start a channel hopper. A wireless card has several channels
73 (e.g. radio frequencies) here it can listen for beacons. 86 (e.g. radio frequencies) here it can listen for beacons.
74 Beacons are management data frames from other stations. 87 Beacons are management data frames from other stations.
75 Remember, this is radio transmission, so the card has to be 88 Remember, this is radio transmission, so the card has to be
76 "tuned" to a certain channel to be able to receive the beacons. 89 "tuned" to a certain channel to be able to receive the beacons.
77 90
78 In order to scan the complete frequency spectrum and thus be able 91 In order to scan the complete frequency spectrum and thus be able
79 to detect all available stations, you have to 'hop' through the 92 to detect all available stations, you have to 'hop' through the
80 channels frequently. You can do this manually (e.g. with 'iwconfig') 93 channels frequently. You can do this manually (e.g. with 'iwconfig')
81 [hahaha] or you can use a channel hopper. 94 [hahaha] or you can use a channel hopper.
82 95
83 For convenience, the current Wellenreiter Alpha comes with a 96 For convenience, the current Wellenreiter Alpha comes with a
84 channel hopper for Orinoco-based cards. Start this via 97 channel hopper for Orinoco-based cards. Start this via
85 orinoco_hopper <interface>. 98 orinoco_hopper <interface>.
86 99
873. Start the Wellenreiter sniffing daemon: wellenreiterd. 1003. Start the Wellenreiter sniffing daemon: wellenreiterd.
88 101
894. Start the Wellenreiter GUI and sniff like hell. Don't press the button 1024. Start the Wellenreiter GUI and sniff like hell. Don't press the button
90 "Start Scan" yet, because it enables the demo mode and will crash the 103 "Start Scan" yet, because it enables the demo mode and will crash the
91 wellenreiterd daemon if running. 104 wellenreiterd daemon if running.
92 105
93===================== 106=====================
94= Credits = 107= Credits =
95===================== 108=====================
96 109
97Sniffer: Max Moser <max@remote-exploit.org> 110Sniffer: Max Moser <max@remote-exploit.org>
98Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> 111Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org>
99GUI: Michael Lauer <mickeyl@handhelds.org> 112GUI: Michael Lauer <mickeyl@handhelds.org>