summaryrefslogtreecommitdiff
Side-by-side diff
Diffstat (more/less context) (ignore whitespace changes)
-rw-r--r--noncore/net/wellenreiter/README63
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
@@ -6,12 +6,20 @@
/*************************************************************************/
+--------------------------------------------------
Release Notes for Opie-ALPHA Version December 2002
--------------------------------------------------
+=====================
= Supported Devices =
+=====================
* low-level orinoco_cs-based (including prism2 and spectrum_cs)
-= Build =
+* Supported Interfaces: wlan0 (yes, I know this is hardcoded and
+ lame, but we're in a hurry and this can be configured soon...)
+
+=====================
+= Build =
+=====================
To compile Wellenreiter within the Opie build environment, add the
@@ -23,13 +31,54 @@ noncore/net/wellenreiter/contrib/orinoco_hopper \
noncore/net/wellenreiter/gui
-./configure and rebuild.
+./configure and rebuild. Note that you need libpcap in your toolchain.
+
+=====================
+= Install =
+=====================
+
+Alternatively, you can use our precompiled ipk. Get it from
+http://opie.net.wox.org/elan/current. You will also need libpcap.
+
+=====================
+= Run =
+=====================
+
+1. Place card in monitor mode. This is device dependent.
+
+ Caution: Don't do this while you're logged in via ssh
+ or otherwise using the wireless interface - your connection
+ will freeze: The card can't be used normally when sniffing!
+
+ For most orinoco-based cards this can be done using
+ 'iwpriv <interface> 2' or 'iwpriv <interface> 2 1'.
+
+ You can check if this works, by calling 'ifconfig <interface>'.
+ If you see 'Protocol: UNSPEC' and an unusual long MAC-Address,
+ then your card has been successfully set to the monitor mode.
+
+2. Start a channel hopper. A wireless card has several channels
+ (e.g. radio frequencies) here it can listen for beacons.
+ Beacons are management data frames from other stations.
+ Remember, this is radio transmission, so the card has to be
+ "tuned" to a certain channel to be able to receive the beacons.
+
+ In order to scan the complete frequency spectrum and thus be able
+ to detect all available stations, you have to 'hop' through the
+ channels frequently. You can do this manually (e.g. with 'iwconfig')
+ [hahaha] or you can use a channel hopper.
+
+ For convenience, the current Wellenreiter Alpha comes with a
+ channel hopper for Orinoco-based cards. Start this via
+ orinoco_hopper <interface>.
-= Run =
+3. Start the Wellenreiter sniffing daemon: wellenreiterd.
-1. Place card in monitor mode: iwpriv <interface> 2 1
-2. Start $OPIEDIR/bin/orinoco_hopper <interface>
-3. Start Wellenreiter
+4. Start the Wellenreiter GUI and sniff like hell. Don't press the button
+ "Start Scan" yet, because it enables the demo mode and will crash the
+ wellenreiterd daemon if running.
-= Credits =
+=====================
+= Credits =
+=====================
Sniffer: Max Moser <max@remote-exploit.org>