author | mickeyl <mickeyl> | 2002-12-11 22:49:27 (UTC) |
---|---|---|
committer | mickeyl <mickeyl> | 2002-12-11 22:49:27 (UTC) |
commit | 8d5ae95e770bc387420fc094c54d8ac55e64e04b (patch) (unidiff) | |
tree | 6e033931ae32d0636519942508be4e257a051d55 | |
parent | e8b46ff4c84634956e6ca2c5b6180abcd6577aec (diff) | |
download | opie-8d5ae95e770bc387420fc094c54d8ac55e64e04b.zip opie-8d5ae95e770bc387420fc094c54d8ac55e64e04b.tar.gz opie-8d5ae95e770bc387420fc094c54d8ac55e64e04b.tar.bz2 |
Just compiled and tested the first version actually running on arm-linux.
This is pre-alpha work, but it is running - if you have an orinoco based
card as interface wlan0. Ad-hoc mode is buggy yet, Config in progress... :)
-rw-r--r-- | noncore/net/wellenreiter/README | 63 |
1 files changed, 56 insertions, 7 deletions
diff --git a/noncore/net/wellenreiter/README b/noncore/net/wellenreiter/README index 4ed5c28..c04d30c 100644 --- a/noncore/net/wellenreiter/README +++ b/noncore/net/wellenreiter/README | |||
@@ -2,36 +2,85 @@ | |||
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 */ | 5 | /* Version: Opie-ALPHA */ |
6 | /*************************************************************************/ | 6 | /*************************************************************************/ |
7 | 7 | ||
8 | -------------------------------------------------- | ||
8 | Release Notes for Opie-ALPHA Version December 2002 | 9 | Release Notes for Opie-ALPHA Version December 2002 |
9 | -------------------------------------------------- | 10 | -------------------------------------------------- |
10 | 11 | ||
12 | ===================== | ||
11 | = Supported Devices = | 13 | = Supported Devices = |
14 | ===================== | ||
12 | 15 | ||
13 | * low-level orinoco_cs-based (including prism2 and spectrum_cs) | 16 | * low-level orinoco_cs-based (including prism2 and spectrum_cs) |
14 | 17 | ||
15 | = Build = | 18 | * Supported Interfaces: wlan0 (yes, I know this is hardcoded and |
19 | lame, but we're in a hurry and this can be configured soon...) | ||
20 | |||
21 | ===================== | ||
22 | = Build = | ||
23 | ===================== | ||
16 | 24 | ||
17 | To compile Wellenreiter within the Opie build environment, add the | 25 | To compile Wellenreiter within the Opie build environment, add the |
18 | following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' | 26 | following directories to $OPIEDIR/Makefile, e.g. to 'NONAPPS=' |
19 | 27 | ||
20 | noncore/net/wellenreiter/libwellenreiter \ | 28 | noncore/net/wellenreiter/libwellenreiter \ |
21 | noncore/net/wellenreiter/daemon \ | 29 | noncore/net/wellenreiter/daemon \ |
22 | noncore/net/wellenreiter/contrib/orinoco_hopper \ | 30 | noncore/net/wellenreiter/contrib/orinoco_hopper \ |
23 | noncore/net/wellenreiter/gui | 31 | noncore/net/wellenreiter/gui |
24 | 32 | ||
25 | ./configure and rebuild. | 33 | ./configure and rebuild. Note that you need libpcap in your toolchain. |
34 | |||
35 | ===================== | ||
36 | = Install = | ||
37 | ===================== | ||
38 | |||
39 | Alternatively, you can use our precompiled ipk. Get it from | ||
40 | http://opie.net.wox.org/elan/current. You will also need libpcap. | ||
41 | |||
42 | ===================== | ||
43 | = Run = | ||
44 | ===================== | ||
45 | |||
46 | 1. Place card in monitor mode. This is device dependent. | ||
47 | |||
48 | Caution: Don't do this while you're logged in via ssh | ||
49 | or otherwise using the wireless interface - your connection | ||
50 | will freeze: The card can't be used normally when sniffing! | ||
51 | |||
52 | For most orinoco-based cards this can be done using | ||
53 | 'iwpriv <interface> 2' or 'iwpriv <interface> 2 1'. | ||
54 | |||
55 | You can check if this works, by calling 'ifconfig <interface>'. | ||
56 | If you see 'Protocol: UNSPEC' and an unusual long MAC-Address, | ||
57 | then your card has been successfully set to the monitor mode. | ||
58 | |||
59 | 2. Start a channel hopper. A wireless card has several channels | ||
60 | (e.g. radio frequencies) here it can listen for beacons. | ||
61 | Beacons are management data frames from other stations. | ||
62 | Remember, this is radio transmission, so the card has to be | ||
63 | "tuned" to a certain channel to be able to receive the beacons. | ||
64 | |||
65 | In order to scan the complete frequency spectrum and thus be able | ||
66 | to detect all available stations, you have to 'hop' through the | ||
67 | channels frequently. You can do this manually (e.g. with 'iwconfig') | ||
68 | [hahaha] or you can use a channel hopper. | ||
69 | |||
70 | For convenience, the current Wellenreiter Alpha comes with a | ||
71 | channel hopper for Orinoco-based cards. Start this via | ||
72 | orinoco_hopper <interface>. | ||
26 | 73 | ||
27 | = Run = | 74 | 3. Start the Wellenreiter sniffing daemon: wellenreiterd. |
28 | 75 | ||
29 | 1. Place card in monitor mode: iwpriv <interface> 2 1 | 76 | 4. Start the Wellenreiter GUI and sniff like hell. Don't press the button |
30 | 2. Start $OPIEDIR/bin/orinoco_hopper <interface> | 77 | "Start Scan" yet, because it enables the demo mode and will crash the |
31 | 3. Start Wellenreiter | 78 | wellenreiterd daemon if running. |
32 | 79 | ||
33 | = Credits = | 80 | ===================== |
81 | = Credits = | ||
82 | ===================== | ||
34 | 83 | ||
35 | Sniffer: Max Moser <max@remote-exploit.org> | 84 | Sniffer: Max Moser <max@remote-exploit.org> |
36 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> | 85 | Communication and Protocol: Martin J. Muench <mjm@remote-exploit.org> |
37 | GUI: Michael Lauer <mickeyl@handhelds.org> | 86 | GUI: Michael Lauer <mickeyl@handhelds.org> |