debian/0000755000000000000000000000000012013036414007160 5ustar debian/gbp.conf0000644000000000000000000000011712013036414010576 0ustar [git-buildpackage] overlay = true tarball-dir = .. export-dir = ../build-area/ debian/rules0000755000000000000000000000077412013036414010250 0ustar #!/usr/bin/make -f # -*- makefile -*- # Sample debian/rules that uses debhelper. # This file was originally written by Joey Hess and Craig Small. # As a special exception, when this file is copied by dh-make into a # dh-make output file, you may use that output file without restriction. # This special exception was added by Craig Small in version 0.37 of dh-make. # Uncomment this to turn on verbose mode. #export DH_VERBOSE=1 DPKG_EXPORT_BUILDFLAGS = 1 include /usr/share/dpkg/buildflags.mk %: dh $@ debian/source/0000755000000000000000000000000012013036414010460 5ustar debian/source/format0000644000000000000000000000001412013036414011666 0ustar 3.0 (quilt) debian/compat0000644000000000000000000000000212013036414010356 0ustar 8 debian/watch0000644000000000000000000000015712013036414010214 0ustar # Compulsory line, this is a version 3 file version=3 http://br1.einfach.org/horst_dl/horst-([\d\.]*)\.tar\.gz debian/menu0000644000000000000000000000021112013036414010041 0ustar ?package(horst):needs="text" section="Applications/Network/Monitoring"\ title="HORST" command="/usr/bin/su-to-root -c /usr/sbin/horst" debian/copyright0000644000000000000000000001465112013036414011122 0ustar Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: horst Source: http://br1.einfach.org/tech/horst/ Files: * Copyright: 2005-2011 Bruno Randolf License: GPL-2.0+ Files: capture-pcap.c Copyright: 2005-2011 Bruno Randolf 2007 Sven-Ola Tuecke License: GPL-2.0+ Files: ieee80211_util.c Copyright: 2002-2005, Instant802 Networks, Inc. 2005-2006, Devicescape Software, Inc. 2006-2007 Jiri Benc 2007 Johannes Berg License: GPL-2.0+ Files: listsort.c Copyright: 2005-2011 Bruno Randolf 2001 Simon Tatham License: GPL-2.0+ and Expat Files: average.* Source: First committed to linux kernel Copyright: 2010 Bruno Randolf License: GPL-2.0 Files: batman_header.h Source: batman batman.h Copyright: 2006 B.A.T.M.A.N. contributors: Thomas Lopatic, Corinna 'Elektra' Aichele, Axel Neumann, Marek Lindner License: GPL-2.0 Files: capture-pcap.c Copyright: 2005-2011 Bruno Randolf (br1@einfach.org) 2007 Sven-Ola Tuecke License: GPL-2.0 Files: ieee80211.h Source: copied from linux wireless-2.6/linux/ieee80211.h Copyright: 2001-2002, SSH Communications Security Corp and Jouni Malinen 2002-2003, Jouni Malinen 2005, Devicescape Software, Inc. 2006, Michael Wu License: GPL-2.0 Files: ieee80211_radiotap.h Source: copied from madwifi net80211/ieee80211_radiotap.h Copyright: 2003, 2004 David Young. All rights reserved. License: BSD Files: ieee80211_util.[ch] Source: copied from linux wireless-2.6/net/mac80211/util.c Copyright: 2002-2005, Instant802 Networks, Inc. 2005-2006, Devicescape Software, Inc. 2006-2007 Jiri Benc 2007 Johannes Berg License: GPL-2.0 Files: list.h Copyright: 2005 Linus Torvalds Source: Linux kernel Comment: Not sure who is the copyright holder, maybe Linus Torvalds? See: http://lkml.indiana.edu/hypermail/linux/kernel/0508.3/1309.html License: GPL-2.0 Files: listsort.c Copyright: 2001 Simon Tatham 2005-2011 Bruno Randolf (br1@einfach.org) Comment: originally BSD, additions by Bruno Randolf are GPL-2.0 License: BSD and GPL-2.0 Files: olsr_header.h Copyright: 2004, Andreas Tønnesen(andreto@olsr.org) Source: copied from olsr olsr_protocol.h License: BSD Files: prism_header.h Copyright: 2005 John Bicket Source: copied from madwifi net80211/ieee80211_monitor.h License: BSD License: BSD Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission. . THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. License: GPL-2.0 This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this package; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA License: Expat Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: . The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. . THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL SIMON TATHAM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Files: debian/* Copyright: 2012 Antoine Beaupré License: GPL-2.0+ License: GPL-2.0+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see . On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2". debian/control0000644000000000000000000000326712013036414010573 0ustar Source: horst Section: net Priority: extra Maintainer: Antoine Beaupré Build-Depends: debhelper (>= 8.0.0), dpkg-dev (>= 1.16.1~), libncurses5-dev Standards-Version: 3.9.3 Homepage: http://br1.einfach.org/tech/horst/ Vcs-Git: git://git.debian.org/collab-maint/horst.git Vcs-Browser: http://git.debian.org/?p=collab-maint/horst.git;a=summary Package: horst Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} Description: Highly Optimized Radio Scanning Tool horst is a small, lightweight IEEE802.11 wireless LAN analyzer with a text interface. Its basic function is similar to tcpdump, Wireshark or Kismet, but it's much smaller and shows different, aggregated information which is not easily available from other tools. It is mainly targeted at debugging wireless LANs with a focus on ad-hoc (IBSS) mode in larger mesh networks. It can be useful to get a quick overview of what is happening on all wireless LAN channels and to identify problems. . * Shows signal/noise values per station * Calculates channel utilization ("usage") by adding up the amount of time the packets actually occupy the medium * "Spectrum Analyzer" shows signal levels and usage per channel Graphical packet history, with signal/noise, packet type and physical rate * Shows all stations per ESSID and the live TSF per node as it is counting * Detects IBSS "splits" (same ESSID but different BSSID \u2013 this is a common driver problem) * Statistics of packets/bytes per physical rate and per packet type * Has some support for mesh protocols (OLSR and batman) * Can filter specific packet types source addresses or BSSIDs * Client/server support for monitoring on remote nodes debian/changelog0000644000000000000000000000104412013036414011031 0ustar horst (3.0-2) unstable; urgency=low * add missing copyright files, thanks Bruno Randolf for the huge help * simplify watch file to use HTTP listing * refer to the README file in manpage * update manpage from upstream, with small spelling fixes * remove our README.Debian file now that the manpage is complete -- Antoine Beaupré Wed, 15 Aug 2012 20:08:58 -0400 horst (3.0-1) unstable; urgency=low * Initial release (Closes: #684440) -- Antoine Beaupré Thu, 09 Aug 2012 22:27:34 -0400 debian/horst.install0000644000000000000000000000001712013036414011705 0ustar horst usr/sbin debian/docs0000644000000000000000000000001412013036414010026 0ustar README TODO debian/horst.manpages0000644000000000000000000000001712013036414012032 0ustar debian/horst.1 debian/horst.10000644000000000000000000001047612013036414010411 0ustar .\" Hey, EMACS: -*- nroff -*- .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .TH HORST 8 "August 14, 2012" .\" Please adjust this date whenever revising the manpage. .SH NAME horst \- Highly Optimized Radio Scanning Tool .SH SYNOPSIS .B horst .RB [\| \-h \|] .RB [\| \-q \|] .RB [\| \-s \|] .RB [\| \-i .IR interface \|] .RB [\| \-t .IR sec \|] .RB [\| \-c .IR IP \|] .RB [\| \-C \|] .RB [\| \-p .IR port \|] .RB [\| \-e .IR mac \|] .RB [\| \-d .IR ms \|] .RB [\| \-o .IR file \|] .RB [\| \-b .IR bytes \|] .SH DESCRIPTION \fBhorst\fP is a small, lightweight IEEE802.11 wireless LAN analyzer with a text interface. Its basic function is similar to tcpdump, Wireshark or Kismet, but it's much smaller and shows different, aggregated information which is not easily available from other tools. It is mainly targeted at debugging wireless LANs with a focus on ad\-hoc (IBSS) mode in larger mesh networks. It can be useful to get a quick overview of what's going on on all wireless LAN channels and to identify problems. .IP \[bu] 2 Shows signal/noise values per station .IP \[bu] 2 Calculates channel utilization ("usage") by adding up the amount of time the packets actually occupy the medium .IP \[bu] 2 "Spectrum Analyzer" shows signal levels and usage per channel Graphical packet history, with signal/noise, packet type and physical rate .IP \[bu] 2 Shows all stations per ESSID and the live TSF per node as it is counting .IP \[bu] 2 Detects IBSS "splits" (same ESSID but different BSSID \- this is a common driver problem) .IP \[bu] 2 Statistics of packets/bytes per physical rate and per packet type .IP \[bu] 2 Has some support for mesh protocols (OLSR and batman) .IP \[bu] 2 Can filter specific packet types source addresses or BSSIDs .IP \[bu] 2 Client/server support for monitoring on remote nodes .SH OPTIONS .TP .BI \-h Show summary of options. .TP .BI \-q Quiet mode. Don't show user interface. This is only useful in conjunction with running in server mode (\-C) or writing to a file (\-o). .TP .BI \-s Show "spectrum analyzer". The same can be achieved by running \fBhorst\fP as normal and pressing the button 's' (Spec); then 'c' (Chan) and 'a' (Automatically change channel). .TP .BI \-i\ intf Operate on given interface instead of the default "wlan0". Note that the interface is assumed to be in monitor mode already. See MONITOR MODE below on more information about monitor mode. .TP .BI \-t\ sec Timeout (remove) nodes after not receiving packets from them for this time in seconds (default: 60 sec). .TP .BI \-c\ IP Connect to a \fBhorst\fP instance running in server-mode at the specified IP address. .TP .BI \-C Allow client connections. Server mode. Only one client connection is supported at the moment (default: off). .TP .BI \-p\ port Use the specified port (default: 4444) for client/server connections. .TP .BI \-e\ mac Filter all MAC addresses except these. This option can be specified multiple times to show only packets originating from the specified MAC addresses. .TP .BI \-d\ ms Display update interval. The default value of 100ms can be increased to reduce CPU load. .TP .BI \-o\ filename Write a summary packet info into file. .TP .BI \-b\ bytes Receive buffer size. The receive buffer size can be explicitly set to tune memory consumption and reduce lost packets. .SH MONITOR MODE \fBhorst\fP should work with any wireleass LAN card and driver which supports monitor mode, with either "prism2" or "radiotap" headers. This includes most modern mac80211-based drivers. You have to put your card in monitor mode and set the channel manually before you start \fBhorst\fP. Usually this has to be done as root. .TP Using iw: .nf iw wlan0 interface add mon0 type monitor .fi .TP Using iwconfig: .nf iwconfig wlan0 mode monitor iwconfig wlan0 channel 1 ifconfig wlan0 up .fi .TP Using madwifi: wlanconfig wlan0 create wlandev wifi0 wlanmode monitor .TP Using hostap: .nf iwconfig wlan0 mode monitor iwpriv wlan0 monitor_type 1 .fi .SH SEE ALSO .BR tcpdump (1), .BR wireshark (1), .BR kismet (1), .BI README .SH AUTHOR horst was written by Bruno Randolf . .PP This manual page was written by Antoine Beaupré , for the Debian project (and may be used by others). debian/README.source0000644000000000000000000000042112013036414011334 0ustar horst for Debian ---------------- To build this package, follow those steps: uscan --download-current git-buildpackage We use the "underlay" mechanism of git-buildpackage to build this. -- Antoine Beaupré , Thu, 9 Aug 2012 23:39:39 -0400