summaryrefslogtreecommitdiff
path: root/noncore/net/wellenreiter/README
Unidiff
Diffstat (limited to 'noncore/net/wellenreiter/README') (more/less context) (ignore whitespace changes)
-rw-r--r--noncore/net/wellenreiter/README124
1 files changed, 50 insertions, 74 deletions
diff --git a/noncore/net/wellenreiter/README b/noncore/net/wellenreiter/README
index 7de6a33..ef094c4 100644
--- a/noncore/net/wellenreiter/README
+++ b/noncore/net/wellenreiter/README
@@ -1,111 +1,87 @@
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-February */
6/*************************************************************************/ 6/************************************************************************/
7 7
8-------------------------------------------------- 8----------------------------------------------------
9Release Notes for Opie-ALPHA Version January 2002 9Release Notes for Opie-ALPHA Version February 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- HERMES chipset [ orinoco ], e.g. Lucent/Agere cards
17- PRISM2 chipset [ orinoco or hostap ], e.g. D-Link, Buffallo
18- SYMBOL/SPECTRUM chipset* [ orinoco ], e.g. Symbol Spectrum 24, Socket Lowpower CF
19- CISCO chipset
20
21* Warning: Current Symbol/Spectrum CF drivers have bugs - they freeze the system in monitor mode.
22 This has nothing todo with Wellenreiter as its a driver problem.
17 23
18===================== 24=====================
19= Build = 25= Build =
20===================== 26=====================
21 27
22(I) Opie Build Environment 28(I) Opie Build Environment
23 29
24To compile Wellenreiter within the Opie build environment, add the 30To compile Wellenreiter within the Opie build environment, do
25following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' 31'make menuconfig' and check Wellenreiter in the subsection
26 32"Communications and Networking"
27noncore/net/wellenreiter/libwellenreiter \
28noncore/net/wellenreiter/daemon \
29noncore/net/wellenreiter/contrib/orinoco_hopper \
30noncore/net/wellenreiter/gui
31 33
32./configure and rebuild. Note that you need libpcap in your toolchain. 34do 'make SUBDIRS=noncore/net/wellenreiter' or 'make' (to build everything)
35Note that you need to have libpcap in your toolchain.
33 36
34(II) OpenZaurus Build Environment 37(II) OpenZaurus Build Environment
35 38
36To compile Wellenreiter within the OZ build environment, add the 39See (I), but do 'make SUBDIRS=packages/opie'
37following lines to $OPIEDIR/packages:
38CONFIG_WELLENREITER noncore/net/wellenreiter/libwellenreiter libwellenreiter.pro
39CONFIG_WELLENREITER noncore/net/wellenreiter/daemon daemon.pro
40CONFIG_WELLENREITER noncore/net/wellenreiter/gui gui.pro
41CONFIG_WELLENREITER noncore/net/wellenreiter/contrib/orinoco_hopper orinoco_hopper.pro
42
43make -f Makefile.test clean-configs
44cd <BUILDROOT>
45make SUBDIRS=packages/opie package
46 40
47(III) To compile a standalone Wellenreiter for X11, you need Qt3 and the development 41(III) To compile a standalone Wellenreiter for X11, you need Qt3 and the development
48packages for Qt3, e.g. libqt3-devel. Assuming, $QTDIR is set to your Qt-Director 42packages for Qt3, e.g. libqt3-devel. Assuming, $QTDIR is set to your Qt-Director
49(e.g. /usr/lib/qt3), set $OPIEDIR to your installation prefix, e.g. /usr/local, then 43(e.g. /usr/lib/qt3), set $OPIEDIR to your installation prefix, e.g. /usr/local, then
50export QMAKESPEC=$QTDIR/mkspecs/linux-g++ 44'export QMAKESPEC=$QTDIR/mkspecs/linux-g++'
51qmake "platform=x11" wellenreiter.pro 45'qmake "platform=x11" wellenreiter.pro'
52make 46'make'
53make install 47'make install'
54 48
55===================== 49=====================
56= Install = 50= Install =
57===================== 51=====================
58 52
59Alternatively, you can use our precompiled ipk. Get it from 53Alternatively, you can use our precompiled ipk. Get it from
60http://opie.net.wox.org/wellenreiter/. This also includes a recent libpcap. 54http://opie.net.wox.org/wellenreiter/. There is also a recent libpcap available.
61 55
62===================== 56=====================
63= Run = 57= Run =
64===================== 58=====================
65 59
66There are two possible modes: <Manual> and <Automatic>. I suggest, you 60There are two possible modes: <Manual> and <Automatic>. I suggest, you
67start with the <Automatic> Mode. This works just using the "Start" 61start with the <Automatic> Mode. This works just using the Start/Stop
68and "Stop" Pushbuttons in the Wellenreiter GUI. If this doesn't work, 62Toolbutton in the Wellenreiter Menubar. Note that you need to configure
69then use the following strategy: 63your card before the Start/Stop-Toolbutton can be clicked.
70 64
711. Place card in monitor mode. This is device dependent. 65If this doesn't work, then try calling the wellenreiter daemon
72 66[wellenreiterd] manually. It has a command line interface. You can
73 Caution: Don't do this while you're logged in via ssh 67start the GUI before or after the daemon.
74 or otherwise using the wireless interface - your connection
75 will freeze: The card can't be used normally when sniffing!
76
77 For most orinoco-based cards this can be done using either
78 'iwpriv <interface> 2' or 'iwpriv <interface> 2 1'.
79
80 You can check if this works, by calling 'ifconfig <interface>'.
81 If you see 'Protocol: UNSPEC' and an unusual long MAC-Address,
82 then your card has been successfully set to the monitor mode.
83
842. Start a channel hopper. A wireless card has several channels
85 (e.g. radio frequencies) here it can listen for beacons.
86 Beacons are management data frames from other stations.
87 Remember, this is radio transmission, so the card has to be
88 "tuned" to a certain channel to be able to receive the beacons.
89
90 In order to scan the complete frequency spectrum and thus be able
91 to detect all available stations, you have to 'hop' through the
92 channels frequently. You can do this manually (e.g. with 'iwconfig')
93 [hahaha] or you can use a channel hopper.
94
95 For convenience, the current Wellenreiter Alpha comes with a
96 channel hopper for Orinoco-based cards. Start this via
97 orinoco_hopper <interface>.
98
993. Start the Wellenreiter sniffing daemon: wellenreiterd.
100
1014. Start the Wellenreiter GUI and sniff like hell. Don't press the button
102 "Start Scan" yet, because it enables the demo mode and will crash the
103 wellenreiterd daemon if running.
104 68
105===================== 69=====================
106= Credits = 70= Credits =
107===================== 71=====================
108 72
109Sniffer: Max Moser <max@remote-exploit.org> 73Wellenreiter/Opie is (C) 2002-2003 M-M-M
74
75Sniffer Engine: Max Moser <max@remote-exploit.org>
110Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> 76Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org>
111GUI: Michael Lauer <mickeyl@handhelds.org> 77GUI and Packaging: Michael Lauer <mickeyl@handhelds.org>
78
79=====================
80= Links =
81=====================
82
83Opie Project: http://opie.handhelds.org
84OpenZaurus Project: http://openzaurus.org
85Wellenreiter: http://www.remote-exploit.org
86Wellenreiter/Opie: http://opie.net.wox.org/wellenreiter
87