mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
06433426cf
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.
29 lines
859 B
Markdown
29 lines
859 B
Markdown
# 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:
|
|
|
|
```bash
|
|
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.:
|
|
|
|
```lua
|
|
local next_dis = Dissector.get("ipv6")
|
|
```
|