wsdf

Crates.iowsdf
lib.rswsdf
version0.1.2
sourcesrc
created_at2023-08-03 07:58:33.051208
updated_at2023-08-04 14:49:13.594794
descriptionProc-macro based Wireshark Dissector Framework
homepagehttps://github.com/ghpr-asia/wsdf
repositoryhttps://github.com/ghpr-asia/wsdf
max_upload_size
id933486
size71,191
Michiel van Slobbe (mvanslobbe)

documentation

https://docs.rs/wsdf

README

docs.rs crates.io CI

wsdf (Wireshark Dissector Framework) is a proc-macro based framework to generate Wireshark dissectors from your Rust data types. Using wsdf, you can write dissectors in a declarative way, all from within Rust.

Here is what a dissector for UDP looks like:

#[derive(wsdf::Protocol)]
#[wsdf(decode_from = [("ip.proto", 17)])]
struct UDP {
    src_port: u16,
    dst_port: u16,
    length: u16,
    checksum: u16,
    #[wsdf(subdissector = ("udp.port", "dst_port", "src_port"))]
    payload: Vec<u8>,
}

Check out the docs for more information. Some examples are also available, including a simple dissector for DNS, showcased below.

DNS dissector showcase

wsdf has been tested on Linux against Wireshark 4.0.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Commit count: 12

cargo fmt