CRAWDAD tools/process/pcap/wifi_parser

Citation Author(s):
Doug
Madory
Renesys Corporation
Submitted by:
CRAWDAD Team
Last updated:
Mon, 11/05/2007 - 08:00
DOI:
10.15783/C7PP48
Data Format:
License:
55 Views
Categories:
Keywords:
0
0 ratings - Please login to submit your rating.

Abstract 

A tool for selectively printing out header fields/flags from either live or recorded 802.11 traffic.

This tool is able to select out header fields/flags from either live or recorded 802.11 traffic. Tcpdump and Tethereal have limited flexibility to tease out specific fields without printing out the entire packet.

Lastmodified :

2007-11-05

Dataname :

tools/process/pcap/wifi_parser

File :

wifi_parser_20071105.tar.gz

Releasedate :

2007-11-05

Change :

updated the types for ISO C compatibility (i.e., u_int instead of uint)

Website :

http://www.crawdad.org/tools/process/pcap/wifi_parser

Keyword :

802.11 frames
802.11
packet trace
tcpdump
signal strength

Output :

An example use of this tool is to process large capture files and
then perform mathematical analysis on the values contained in the fields.
Here is an example output of the tool in use:

%./wifi_parser -p -r mapreceiver-mapsampler1-100000.cap
-s aibstq -c 100
WiFi frame parser starting...
1142538621.941872  27 0_0_0_0_0_0_0_0 bssid: 000b868138b0 s: 000b868138b0
seq: 2290
1142538621.942814  27 0_0_0_0_0_0_0_0 bssid: 000b868138b1 s: 000b868138b1
seq: 2291
1142538622.396284  16 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3574
1142538622.436236  16 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3581
1142538622.439394  15 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3584
1142538622.456254  17 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3594
1142538622.460492  17 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3598
1142538622.461425  18 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3599
1142538622.496193  19 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3600
1142538622.498403  19 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3602
1142538622.501529  19 0_1_0_0_0_0_0_0 bssid: 000b868139c8 s: 0009e9b7400a
seq: 3605
1142538622.503735  19 0_0_0_0_0_0_0_0 bssid: 000b868139c8 s: 000b868139c8
seq: 3606

Parameters :

See the usage.

Usage :

Here is the help screen.

%./wifi_parser -h

Usage: ./wifi_parser

options:
-c count       number of packets to count before exiting
-i interface   wireless network interface (default: ath0)
-r filename    read input from filename (supercedes -i)
-f filter      input capture filter
-s selection   header selector
-p prism       source contains prism header
-h             this help

header selector options:
Prism:
h  host time
m  mac time
c  channel
i  rssi
n  signal quality
g  signal
n  noise
r  rate
x  istx
802.11:
t  timestamp
l  framelen
u  duration
f  frametype
y  subtype
d  destination
s  source
b  bssid
q  sequence numbers
a  flags
0:0:0:0:0:0:0:0
| | | | | | | \_Order
| | | | | | \___WEP
| | | | | \_____More Data
| | | | \_______Pwr Mgt
| | | \_________Retry
| | \___________More Frag
| \_____________From DS
\_______________To DS

Algorithm :

This tool is implemented in C using pcap library, especially exploiting the filter functions.
Instructions: 

The files in this directory are a CRAWDAD toolset hosted by IEEE DataPort. 

About CRAWDAD: the Community Resource for Archiving Wireless Data At Dartmouth is a data resource for the research community interested in wireless networks and mobile computing. 

CRAWDAD was founded at Dartmouth College in 2004, led by Tristan Henderson, David Kotz, and Chris McDonald. CRAWDAD toolsets are hosted by IEEE DataPort as of November 2022. 

Note: Please use the tools in an ethical and responsible way with the aim of doing no harm to any person or entity for the benefit of society at large. Please respect the privacy of any human subjects whose wireless-network activity is captured by the tools and comply with all applicable laws, including without limitation such applicable laws pertaining to the protection of personal information, security of data, and data breaches. Please do not apply, adapt or develop algorithms for the extraction of the true identity of users and other information of a personal nature, which might constitute personally identifiable information or protected health information under any such applicable laws. Do not publish or otherwise disclose to any other person or entity any information that constitutes personally identifiable information or protected health information under any such applicable laws derived from the tools through manual or automated techniques. 

Please acknowledge the source of the tools in any publications or presentations reporting use of this tools. 

Citation:

Doug Madory, CRAWDAD toolset tools/process/pcap/wifi_parser (v. 2007‑11‑05), https://doi.org/10.15783/C7PP48, Nov 2007.

Dataset Files

    Documentation

    These datasets are part of Community Resource for Archiving Wireless Data (CRAWDAD). CRAWDAD began in 2004 at Dartmouth College as a place to share wireless network data with the research community. Its purpose was to enable access to data from real networks and real mobile users at a time when collecting such data was challenging and expensive. The archive has continued to grow since its inception, and starting in summer 2022 is being housed on IEEE DataPort.

    Questions about CRAWDAD? See our CRAWDAD FAQ. Interested in submitting your dataset to the CRAWDAD collection? Get started, by submitting an Open Access Dataset.