Diffstat (limited to 'noncore/net/wellenreiter/README') (more/less context) (show whitespace changes)
-rw-r--r-- | noncore/net/wellenreiter/README | 110 |
1 files changed, 43 insertions, 67 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,2 +1,2 @@ | |||
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 */ |
@@ -4,8 +4,8 @@ | |||
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 | ||
@@ -15,3 +15,9 @@ Release Notes for Opie-ALPHA Version January 2002 | |||
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 | ||
@@ -23,11 +29,8 @@ Release Notes for Opie-ALPHA Version January 2002 | |||
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 | ||
@@ -35,12 +38,3 @@ noncore/net/wellenreiter/gui | |||
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 | ||
@@ -49,6 +43,6 @@ 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 | ||
@@ -59,3 +53,3 @@ make install | |||
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 | ||
@@ -66,46 +60,28 @@ http://opie.net.wox.org/wellenreiter/. This also includes a recent libpcap. | |||
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 | |||
71 | 1. Place card in monitor mode. This is device dependent. | ||
72 | |||
73 | Caution: Don't do this while you're logged in via ssh | ||
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 | 64 | ||
90 | In order to scan the complete frequency spectrum and thus be able | 65 | If this doesn't work, then try calling the wellenreiter daemon |
91 | to detect all available stations, you have to 'hop' through the | 66 | [wellenreiterd] manually. It has a command line interface. You can |
92 | channels frequently. You can do this manually (e.g. with 'iwconfig') | 67 | start the GUI before or after the daemon. |
93 | [hahaha] or you can use a channel hopper. | ||
94 | 68 | ||
95 | For convenience, the current Wellenreiter Alpha comes with a | 69 | ===================== |
96 | channel hopper for Orinoco-based cards. Start this via | 70 | = Credits = |
97 | orinoco_hopper <interface>. | 71 | ===================== |
98 | 72 | ||
99 | 3. Start the Wellenreiter sniffing daemon: wellenreiterd. | 73 | Wellenreiter/Opie is (C) 2002-2003 M-M-M |
100 | 74 | ||
101 | 4. Start the Wellenreiter GUI and sniff like hell. Don't press the button | 75 | Sniffer Engine: Max Moser <max@remote-exploit.org> |
102 | "Start Scan" yet, because it enables the demo mode and will crash the | 76 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> |
103 | wellenreiterd daemon if running. | 77 | GUI and Packaging: Michael Lauer <mickeyl@handhelds.org> |
104 | 78 | ||
105 | ===================== | 79 | ===================== |
106 | = Credits = | 80 | = Links = |
107 | ===================== | 81 | ===================== |
108 | 82 | ||
109 | Sniffer: Max Moser <max@remote-exploit.org> | 83 | Opie Project: http://opie.handhelds.org |
110 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> | 84 | OpenZaurus Project: http://openzaurus.org |
111 | GUI: Michael Lauer <mickeyl@handhelds.org> | 85 | Wellenreiter: http://www.remote-exploit.org |
86 | Wellenreiter/Opie: http://opie.net.wox.org/wellenreiter | ||
87 | |||