https://github.com/ghostiam/sharkuana

Sharkuana - Wireshark plugin bindings for the ZIG language
https://github.com/ghostiam/sharkuana

wireshark wireshark-dissector wireshark-plugin zig ziglang

Last synced: 5 days ago
JSON representation

Sharkuana - Wireshark plugin bindings for the ZIG language

• Host: GitHub
• URL: https://github.com/ghostiam/sharkuana
• Owner: ghostiam
• License: mit
• Created: 2024-10-10T23:54:27.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2024-12-22T23:32:09.000Z (about 2 months ago)
• Last Synced: 2024-12-23T00:28:35.823Z (about 2 months ago)
• Topics: wireshark, wireshark-dissector, wireshark-plugin, zig, ziglang
• Language: Zig
• Homepage:
• Size: 27.3 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Sharkuana - Wireshark plugin bindings for the ZIG language

A **very early**, API for creating Wireshark plugins in the ZIG language.

At the moment, only the ability to build for MacOS and Linux has been tested,

but as soon as the main functionality is completed, support for Windows will be implemented.

## Build Wireshark libraries

To build the Wireshark libraries, you need to have `nix` installed.

```shell

nix develop --command ./scripts/build-wireshark-libs.bash

```

If you don't have `nix`, you can use the fallback script

which will try using the 

- `nix`;

- `docker` with `nix` (This build will only be for Linux);

- run script locally(You will need to install dependencies manually).

```shell

./nix-fallback.bash ./scripts/build-wireshark-libs.bash

```

[//]: # (TODO: Build in CI and import as zig deps)

## Building a minimal plugin

To quickly test the plugin, use the command:

```shell

zig build && mkdir -p ~/.local/lib/wireshark/plugins/4-4/epan && cp zig-out/lib/libsharkuana.dylib ~/.local/lib/wireshark/plugins/4-4/epan/libsharkuana.so && /Applications/Wireshark.app/Contents/MacOS/Wireshark --log-domains sharkuana --log-level noisy

```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.