summaryrefslogtreecommitdiff
authormickeyl <mickeyl>2002-12-11 22:49:27 (UTC)
committer mickeyl <mickeyl>2002-12-11 22:49:27 (UTC)
commit8d5ae95e770bc387420fc094c54d8ac55e64e04b (patch) (side-by-side diff)
tree6e033931ae32d0636519942508be4e257a051d55
parente8b46ff4c84634956e6ca2c5b6180abcd6577aec (diff)
downloadopie-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... :)
Diffstat (more/less context) (show whitespace changes)
-rw-r--r--noncore/net/wellenreiter/README57
1 files changed, 53 insertions, 4 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)
+* 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>.
+
+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 =
+=====================
Sniffer: Max Moser <max@remote-exploit.org>