forked from br101/horst
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME
101 lines (71 loc) · 3.22 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
HORST - Horsts OLSR Radio Scanning Tool (or)
HORST - Highly Optimized Radio Scanning Tool
--------------------------------------------
Copyright (C) 2005-2012 Bruno Randolf ([email protected])
Licensed under the GNU Public License (GPL) V2
= Overview =
"horst" is a scanning and analysis tool for IEEE802.11 wireless ad-hoc (IBSS)
networks and the OLSR mesh routing protocol. it can be used discover the best
OLSR nodes in the neighborhood, to optimize antenna positions and to discover
problems in the mesh network.
See the man page for more detailed and up-to-date info:
$ man -l horst.1
(or)
$ nroff -mandoc horst.1
= Description =
with the usual wireless tools like iwconfig and iwspy (and even kismet) it is
hard to measure the received signal strength (SNR or RSSI) for each of the
*different* nodes which form an ad-hoc network, since they all treat the whole
IBSS as one. this information however is very important for setting up,
debugging and optimizing wireless mesh networks.
"horst" aims to fill this gap and lists each single node of an ad-hoc network
separately, showing the signal strength (SNR) of the last received packet. this
way you can see which nodes are part of a specific ad-hoc cell (BSSID), discover
problems with ad-hoc cell merging ("cell splitting" - a problem of many wlan
drivers), which of the nodes send OLSR packets, whether they use the OLSR link
quality extension, how many neighbors they see, etc.
to do this, it uses the monitor mode including prism2 or radiotap headers (for
the signal strength information) of the wlan cards and listens to all packets
which come in the wireless interface. these packets are scanned for OLSR
traffic, summarized by the MAC address of the sending node, and displayed in a
simple text (ncurses) interface.
"horst" should work with any wlan card which can do monitor mode, with either
"prism2" or "radiotap" headers.
= Interpreting the Output =
we try to fit a lot of mostly binary or numeric information to a tiny screen, so
at first it will look confusing ;)
the upper box shows a summary of the information we gathered for each MAC
address (node) we saw, each one in a row:
IP IP address (if available)
SNR Signal/Noise ratio of the LAST packet
SOURCE MAC address of the source
BSSID The BSSID this MAC is on
LQ Marked when OLSR Link Quality (LQ) Extension is used
GW Marked when this OLSR Node probably knows a default gateway
NEIGH Number of Neighbours
OLSR Number of OLSR Pakets received
COUNT Number of all packets received
TSF The high part of the TSF
the lower box dumps all received packets and shows some information for it:
Sig Signal in dBm
Noi Noise in dBm
SOURCE MAC Address of the Sender
BSSID The BSSID the Sender belongs to
TYPE Packet Type
INFO Additional packet information, depending on type
the lower right box shows the status and displays the SNR of the last packet
graphically with a bar.
= Building =
"horst" is just a simple tool, so "libncurses" is the only requirement (be sure
to install it's header files too). therefore building is as simple as typing:
$ make
for debugging you can use
$ make DEBUG=1
= Contributors =
Thanks to the following persons for contributions:
Horst Krause
Sven-Ola Tuecke
Robert Schuster
Jonathan Guerin
David Rowe
Antoine Beaupré