"Fossies" - the Fresh Open Source Software Archive

Member "tcpflow-1.6.1/src/wifipcap/README.txt" (19 Feb 2021, 2024 Bytes) of package /linux/misc/tcpflow-1.6.1.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 MAINTAINER
    2 ==========
    3 Simson L. Garfinkel <simsong@acm.org>
    4 
    5 
    6 ACKNOWLEDGEMENTS
    7 ================
    8 Thanks to:
    9 * Jeffrey Pang, for the radiotap implementation
   10 * Doug Madory, for the  Wifi parser
   11 * Jeremy Elson, for the original idea and initial tcp/ip implementation
   12 
   13 Title:   Wifipcap Library
   14 Authors: Jeff Pang, 
   15          Simson L. Garfinkel
   16 
   17 Description:
   18 ============
   19 
   20 A simple C++ wrapper around libpcap that allows applications to
   21 selectively demultiplex 802.11 frames, and the most common layer 2 and
   22 layer 3 protocols contained within them. Basically, the wifipcap
   23 library handles all the parsing of 802.11 frames (and/or layer 2/3
   24 packets) from the pcap file (or stream).
   25 
   26 Some of the code is derived from tcpdump.
   27 
   28 This program somewhat reworked by Simson Garfinkel
   29 
   30 Linux: Requires libpcap >= 0.9.4 on Linux.
   31 
   32 Windows: Requires WinPcap >= 4.0.2 and AirPcap for 802.11 capture
   33 See: http://www.cacetech.com/support/downloads.htm
   34 
   35 Usage:
   36 ======
   37 
   38 For an overview see wifipcap.h. For an example, see sample.cpp.
   39 
   40 (0) Compile wifipcap. 
   41 
   42     In Linux:
   43     Enter this directory and type:
   44    
   45     make
   46 
   47     In Windows:
   48     Open wifipcap.sln in Visual Studio and build it.
   49     You will need to have the winpcap include and library files
   50     in the appropriate search paths.
   51 
   52 (1) Include the header "wifipcap.h" in your application C++ file(s).
   53 
   54 (2) Implement a subclass of WifipcapCallbacks. This class has one
   55     member function for each type of 802.11 frame and layer 2/3
   56     packets. Each of these functions will be called as a frame/packet
   57     is parsed.
   58 
   59 (3) Create an instance of Wifipcap with either a pcap trace file or
   60     a live device to capture packets from.
   61 
   62 (4) Call Wifipcap::Run with your instance of WifipcapCallbacks.
   63 
   64 (5) Compile your program linking to libpcap and wifipcap.a. 
   65 
   66     On Linux:
   67     g++ -o myprogram myprogram.c /path/to/wifipcap.a -lpcap
   68 
   69     On Windows:
   70     Link the following libraries: 
   71     wpcap.lib ws2_32.lib WINMM.LIB wifipcap.lib 
   72 
   73     Make sure wifipcap.lib is in the library path.