Diffstat (limited to 'noncore/net/wellenreiter/README') (more/less context) (ignore whitespace changes)
-rw-r--r-- | noncore/net/wellenreiter/README | 124 |
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,55 +1,49 @@ | |||
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 | ---------------------------------------------------- |
9 | Release Notes for Opie-ALPHA Version January 2002 | 9 | Release 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 | ||
24 | To compile Wellenreiter within the Opie build environment, add the | 30 | To compile Wellenreiter within the Opie build environment, do |
25 | following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' | 31 | 'make menuconfig' and check Wellenreiter in the subsection |
26 | 32 | "Communications and Networking" | |
27 | noncore/net/wellenreiter/libwellenreiter \ | ||
28 | noncore/net/wellenreiter/daemon \ | ||
29 | noncore/net/wellenreiter/contrib/orinoco_hopper \ | ||
30 | noncore/net/wellenreiter/gui | ||
31 | 33 | ||
32 | ./configure and rebuild. Note that you need libpcap in your toolchain. | 34 | do 'make SUBDIRS=noncore/net/wellenreiter' or 'make' (to build everything) |
35 | Note that you need to have libpcap in your toolchain. | ||
33 | 36 | ||
34 | (II) OpenZaurus Build Environment | 37 | (II) OpenZaurus Build Environment |
35 | 38 | ||
36 | To compile Wellenreiter within the OZ build environment, add the | 39 | See (I), but do 'make SUBDIRS=packages/opie' |
37 | following lines to $OPIEDIR/packages: | ||
38 | CONFIG_WELLENREITER noncore/net/wellenreiter/libwellenreiter libwellenreiter.pro | ||
39 | CONFIG_WELLENREITER noncore/net/wellenreiter/daemon daemon.pro | ||
40 | CONFIG_WELLENREITER noncore/net/wellenreiter/gui gui.pro | ||
41 | CONFIG_WELLENREITER noncore/net/wellenreiter/contrib/orinoco_hopper orinoco_hopper.pro | ||
42 | |||
43 | make -f Makefile.test clean-configs | ||
44 | cd <BUILDROOT> | ||
45 | make 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 |
48 | packages for Qt3, e.g. libqt3-devel. Assuming, $QTDIR is set to your Qt-Director | 42 | packages 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 |
50 | export QMAKESPEC=$QTDIR/mkspecs/linux-g++ | 44 | 'export QMAKESPEC=$QTDIR/mkspecs/linux-g++' |
51 | qmake "platform=x11" wellenreiter.pro | 45 | 'qmake "platform=x11" wellenreiter.pro' |
52 | make | 46 | 'make' |
53 | make install | 47 | 'make install' |
54 | 48 | ||
55 | ===================== | 49 | ===================== |
@@ -58,5 +52,5 @@ make install | |||
58 | 52 | ||
59 | Alternatively, you can use our precompiled ipk. Get it from | 53 | Alternatively, you can use our precompiled ipk. Get it from |
60 | http://opie.net.wox.org/wellenreiter/. This also includes a recent libpcap. | 54 | http://opie.net.wox.org/wellenreiter/. There is also a recent libpcap available. |
61 | 55 | ||
62 | ===================== | 56 | ===================== |
@@ -65,41 +59,11 @@ http://opie.net.wox.org/wellenreiter/. This also includes a recent libpcap. | |||
65 | 59 | ||
66 | There are two possible modes: <Manual> and <Automatic>. I suggest, you | 60 | There are two possible modes: <Manual> and <Automatic>. I suggest, you |
67 | start with the <Automatic> Mode. This works just using the "Start" | 61 | start with the <Automatic> Mode. This works just using the Start/Stop |
68 | and "Stop" Pushbuttons in the Wellenreiter GUI. If this doesn't work, | 62 | Toolbutton in the Wellenreiter Menubar. Note that you need to configure |
69 | then use the following strategy: | 63 | your card before the Start/Stop-Toolbutton can be clicked. |
70 | 64 | ||
71 | 1. Place card in monitor mode. This is device dependent. | 65 | If 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 | 67 | start 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 | |||
84 | 2. 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 | |||
99 | 3. Start the Wellenreiter sniffing daemon: wellenreiterd. | ||
100 | |||
101 | 4. 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 | ===================== |
@@ -107,5 +71,17 @@ then use the following strategy: | |||
107 | ===================== | 71 | ===================== |
108 | 72 | ||
109 | Sniffer: Max Moser <max@remote-exploit.org> | 73 | Wellenreiter/Opie is (C) 2002-2003 M-M-M |
74 | |||
75 | Sniffer Engine: Max Moser <max@remote-exploit.org> | ||
110 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> | 76 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> |
111 | GUI: Michael Lauer <mickeyl@handhelds.org> | 77 | GUI and Packaging: Michael Lauer <mickeyl@handhelds.org> |
78 | |||
79 | ===================== | ||
80 | = Links = | ||
81 | ===================== | ||
82 | |||
83 | Opie Project: http://opie.handhelds.org | ||
84 | OpenZaurus Project: http://openzaurus.org | ||
85 | Wellenreiter: http://www.remote-exploit.org | ||
86 | Wellenreiter/Opie: http://opie.net.wox.org/wellenreiter | ||
87 | |||