3 releases

0.1.2 Aug 4, 2023
0.1.1 Aug 3, 2023
0.1.0 Aug 3, 2023

#1102 in Network programming

44 downloads per month

MIT/Apache

1.5MB
44K SLoC

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.

Dependencies

~2.4–4MB
~76K SLoC