- Citation Author(s):
- Submitted by:
- CRAWDAD Team
- Last updated:
- Thu, 02/12/2009 - 08:00
- Data Format:
Tool to synchronize the timestamps of packets of 802.11-based experiments to a common time basis.
Pcapsync is a tool to time-synchronize tracefiles recorded in libpcap format. Its main application area are logfiles of real-world experiments with wireless multihop networks like MANETs (mobile ad-hoc networks), VANETs (vehicular ad-hoc networks) or mesh networks. The underlying algorithm, however, is more general and can be applied to any network with local broadcast characteristic.
the initial version.
802.11 MANET packet trace tcpdump vehicular network wireless mesh network wireless multihop networks
Before using the tool, we strongly recommend to read "On the Time Synchronization of Distributed Log Files in Networks with Local Broadcast Media", available at http://www.cn.uni-duesseldorf.de/publications/details/Scheuermann2008c.html This paper explains the details of the algorithm used for the synchronization, furthermore it contains some estimates of the achievable accuracy. To quote pcapsync, use this paper. For information, bug reports, feature requests, ... please refer to firstname.lastname@example.org
To compile pcapsync, the following packages must be installed: - openssl for the lcrypto library - libpcap for the lpcap library - flex - bison Then type 'make'.
- Input files naming convention The input files for pcapsync have to be named beginning with the MAC adress of the recording interface, followed by a dot. An example for this is "00099D9F1B3C.cap".
Usage: pcapsync [flags] [options] <list_of_input_files> flags: -h Print this help text and terminate. -s Output one .synced file for each input file. -g Output a global .synced file to the output directory. -t Output files for use with tsc. -l Logs swaped packets during the synchronization. options: -o <outputDirectory> Defines an output directory. If no output directory is defined every output file is written to its input file directory.
A fundamental problem in real-world computer network experiments is that each system uses its own local clock to timestamp events. These clocks are not perfectly accurate, and thus deviate from each other. Event timestamps assigned by different nodes can therefore not immediately be compared, making the analysis of experimental results difficult. In order to solve this issue we have proposed in a previous publication to record the occurring events with the deviating, local clocks and synchronize the resulting event log files offline after the experiment. The synchronization is based on so-called anchor points, that is, on events that have been recorded and timestamped by more than one node in parallel. The anchor points allow to set the clocks of the nodes into relation. In networks where the medium has a broadcast characteristic (like many wireless networks, but also Ethernet using hubs), the (almost) parallel reception of a packet transmission by multiple nodes can serve as such an anchor point. This algorithm is implemented in pcapsync, a tool to synchronize event logs from experiments in IEEE 802.11 wireless networks. It reads a set of log files that have been recorded in libpcap format (used, e. g., by tcpdump and Wireshark), identifies potential anchor points in them, applies our offline time synchronization algorithm, maps the recorded local timestamps to a common, global time scale, and finally writes back a corresponding set of synchronized libpcap files. Its output can thus immediately be used for further analysis with standard tools.
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.
Björn Scheuermann, Wolfgang Kiess, Daniel Marks, CRAWDAD toolset tools/process/pcap/pcapsync (v. 2008‑08‑23), https://doi.org/10.15783/C7T01G, Aug 2008.
- pcapsync_v0.1.tar.gz (21.37 kB)
Open Access dataset files are accessible to all logged in users. Don't have a login? Create a free IEEE account. IEEE Membership is not required.
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.