1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/dist/tools/wireshark_dissector
Sebastian Sontberg 06433426cf wireshark: fix dissector plugin and expand documentation
The wireshark dissector plugin currently fails with a "Lua Error" when
trying to parse nativenet packets. This patch restores working behaviour
by commenting the offending line introduced in 1258675, which intention
was to account for padding in small packets. It further adds a comment
on how to edit the plugin for the case padding information is required.

The README.md now contains a usage note for configuration on fedora
which might also be helpful for users of other distributions.
2014-06-04 20:36:18 +02:00
..
README.md wireshark: fix dissector plugin and expand documentation 2014-06-04 20:36:18 +02:00
riot.lua wireshark: fix dissector plugin and expand documentation 2014-06-04 20:36:18 +02:00

RIOT nativenet wireshark dissector

This allows wireshark to parse packets sent over TAP by RIOT's native port.

Installation

Just copy the script riot.lua to $HOME/.wireshark/plugins and restart Wireshark.

Usage

Debian/Ubuntu

Ensure that dumpcat is available for you as non-superusers:

sudo dpkg-reconfigure wireshark-common
sudo usermod -a -G wireshark $USER

Fedora (and possibly others)

The 'wireshark-devel' package must be installed to run the plugin.

Configuration

Depending on what you want to send over the native TAP you might want to change the next header dissector. Currently we have included the dissectors for IEEE 802.15.4 and 6LoWPAN into the script file, but anything is thinkable. Refer to the wireshark manual to get the protocol names, e.g.:

    local next_dis = Dissector.get("ipv6")