A library for parsing & writing a bunch of packet based protocols (EthernetII, IPv4, IPv6, UDP ...).
Currently supported are: * Ethernet II * IEEE 802.1Q VLAN Tagging Header * IPv4 * IPv6 (missing extension headers, but supporting skipping them) * UDP
First, add the following to your Cargo.toml:
toml
[dependencies]
etherparse = "0.3.1"
Next, add this to your crate root:
rust
extern crate etherparse;
Etherparse is intended to provide the basic network parsing functions that allow for easy analysis, transformation or generation of recorded network data.
Some key points are:
There is the option to use the PacketBuilder, which provides a high level interface to create UDP network packets. The PacketBuilder will take care of setting all the fields which can be deduced from the content and compositions of the packet (checksums, lengths, ethertype, ip protocol number).
Example: ```rust let builder = PacketBuilder:: ethernet2([1,2,3,4,5,6], //source mac [7,8,9,10,11,12]) //destionation mac .ipv4([192,168,1,1], //source ip [192,168,1,2], //desitionation ip 20) //time to life .udp(21, //source port 1234); //desitnation port
//payload of the udp packet let payload = [1,2,3,4,5,6,7,8];
//serialize //this will automatically set all length fields, checksums and identifiers (ethertype & protocol) //before writing the packet out to "result" builder.write(&mut result, &payload).unwrap(); ```
Check out the PacketBuilder documentation for more informations.
Alternativly it is possible to manually build a packet (example). Generally each struct representing a header has a "write" method that allows it to be serialized. These write methods sometimes automatically calculate checksums and fill them in. In case this is unwanted behavior (e.g. if you want to generate a packet with an invalid checksum), it is also possible to call a "write_raw" method that will simply serialize the data without doing checksum calculations.
Read the documentations of the different methods for a more details: