-rw-r--r-- | noncore/net/wellenreiter/README | 17 |
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 | -------------------------------------------------- |
9 | Release Notes for Opie-ALPHA Version January 2002 | 9 | Release 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 | |||
22 | To compile Wellenreiter within the Opie build environment, add the | 24 | To compile Wellenreiter within the Opie build environment, add the |
23 | following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' | 25 | following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' |
24 | 26 | ||
25 | noncore/net/wellenreiter/libwellenreiter \ | 27 | noncore/net/wellenreiter/libwellenreiter \ |
26 | noncore/net/wellenreiter/daemon \ | 28 | noncore/net/wellenreiter/daemon \ |
27 | noncore/net/wellenreiter/contrib/orinoco_hopper \ | 29 | noncore/net/wellenreiter/contrib/orinoco_hopper \ |
28 | noncore/net/wellenreiter/gui | 30 | noncore/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 | |||
32 | To compile Wellenreiter within the OZ build environment, add the | 36 | To compile Wellenreiter within the OZ build environment, add the |
33 | following lines to $OPIEDIR/packages | 37 | following lines to $OPIEDIR/packages: |
34 | CONFIG_WELLENREITER noncore/net/wellenreiter/libwellenreiter libwellenreiter.pro | 38 | CONFIG_WELLENREITER noncore/net/wellenreiter/libwellenreiter libwellenreiter.pro |
35 | CONFIG_WELLENREITER noncore/net/wellenreiter/daemon daemon.pro | 39 | CONFIG_WELLENREITER noncore/net/wellenreiter/daemon daemon.pro |
36 | CONFIG_WELLENREITER noncore/net/wellenreiter/gui gui.pro | 40 | CONFIG_WELLENREITER noncore/net/wellenreiter/gui gui.pro |
37 | CONFIG_WELLENREITER noncore/net/wellenreiter/contrib/orinoco_hopper orinoco_hopper.pro | 41 | CONFIG_WELLENREITER noncore/net/wellenreiter/contrib/orinoco_hopper orinoco_hopper.pro |
38 | 42 | ||
39 | make -f Makefile.test clean-configs | 43 | make -f Makefile.test clean-configs |
40 | cd <BUILDROOT> | 44 | cd <BUILDROOT> |
41 | make SUBDIRS=packages/opie package | 45 | make SUBDIRS=packages/opie package |
42 | 46 | ||
47 | (III) To compile a standalone Wellenreiter for X11, you need Qt3 and the development | ||
48 | packages for Qt3, e.g. libqt3-devel. Assuming, $OPIEDIR and $QTDIR is set to Opie resp. | ||
49 | Qt (e.g. /usr/lib/qt3), do the following: | ||
50 | export QMAKESPEC=$OPIEDIR/mkspecs/linux-g++ | ||
51 | cd $OPIEDIR/noncore/net/wellenreiter | ||
52 | qmake -makefile wellenreiter.pro | ||
53 | make qmake | ||
54 | make | ||
55 | |||
43 | ===================== | 56 | ===================== |
44 | = Install = | 57 | = Install = |
45 | ===================== | 58 | ===================== |
46 | 59 | ||
47 | Alternatively, you can use our precompiled ipk. Get it from | 60 | Alternatively, you can use our precompiled ipk. Get it from |
48 | http://opie.net.wox.org/wellenreiter/current/. This also includes a recent libpcap. | 61 | http://opie.net.wox.org/wellenreiter/. This also includes a recent libpcap. |
49 | 62 | ||
50 | ===================== | 63 | ===================== |
51 | = Run = | 64 | = Run = |
52 | ===================== | 65 | ===================== |
53 | 66 | ||
54 | There are two possible modes: <Manual> and <Automatic>. I suggest, you | 67 | There are two possible modes: <Manual> and <Automatic>. I suggest, you |
55 | start with the <Automatic> Mode. This works just using the "Start" | 68 | start with the <Automatic> Mode. This works just using the "Start" |
56 | and "Stop" Pushbuttons in the Wellenreiter GUI. If this doesn't work, | 69 | and "Stop" Pushbuttons in the Wellenreiter GUI. If this doesn't work, |
57 | then use the following strategy: | 70 | then use the following strategy: |
58 | 71 | ||
59 | 1. Place card in monitor mode. This is device dependent. | 72 | 1. 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 | ||
72 | 2. Start a channel hopper. A wireless card has several channels | 85 | 2. 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 | ||
87 | 3. Start the Wellenreiter sniffing daemon: wellenreiterd. | 100 | 3. Start the Wellenreiter sniffing daemon: wellenreiterd. |
88 | 101 | ||
89 | 4. Start the Wellenreiter GUI and sniff like hell. Don't press the button | 102 | 4. 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 | ||
97 | Sniffer: Max Moser <max@remote-exploit.org> | 110 | Sniffer: Max Moser <max@remote-exploit.org> |
98 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> | 111 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> |
99 | GUI: Michael Lauer <mickeyl@handhelds.org> | 112 | GUI: Michael Lauer <mickeyl@handhelds.org> |