用法

创建新数据包

步骤 1

导入包的适当部分，并创建一个新的数据包结构以开始填充它。有两种创建新数据包的方法，方法 1 将设置内部缓冲区的容量为给定协议的适当长度，方法 2 将创建一个完全空的数据包，内部缓冲区容量设置为 0。对于大型数据包，推荐使用方法 1，因为它将更有效率，因为无需在添加数据时不断增加缓冲区的容量。

extern crate packet_crafter;

use packet_crafter::{
	//import sub-modules
	headers,
	protocol_numbers,
	ethertype_numbers,
	
	//import data types
	Packet,
	Protocol
};

fn main() {		
	// method 1 (preferred)
	let mut new_packet = Packet::new(
		vec![
			Protocol::ETH,
			Protocol::IP,
			Protocol::TCP
		]
	);

	// method 2
	let mut new_packet = Packet::new_empty();

步骤 2

创建标题并将它们添加到数据包中。这里我们将采用步骤 1 中的方法 1 的数据包结构，即以太网 > IP > TCP

	new_packet.add_header(
		headers::EthernetHeader::new(
			[6,5,4,3,2,1], // source mac address
			[1,2,3,4,5,6], // destination mac address
			ethertype_numbers::ETHERTYPE_IPV4
		)
	);

	new_packet.add_header(
		headers::IpHeader::new(
			[192, 168, 1, 128], // source IP
			[192, 168, 1, 38], // destination IP
			Protocol::TCP // next protocol
		)
	);

	new_packet.add_header(
		headers::TcpHeader::new(
			3838, // source port
			3838 // destination port
		)
	);

步骤 3

这一步可能并不总是必要的，例如在ICMP回显的情况下，因为只需要读取头部而不需要数据。然而，在许多情况下，您可能想要添加一些有效载荷数据。同样，有两种方法可以实现这一点，方法1将覆盖现有的有效载荷数据（如果这是一个新数据包，那么将没有数据，但如果这是一个从原始数据解析出来的数据包，那么可能有一些数据），方法2将附加到现有的有效载荷数据。注意方法2中没有出现 .collect()，尽管代码仍然可以工作，但这并不是必需的。如果您查看源代码中的函数签名，您就会明白为什么不需要它。

	// method 1
	new_packet.set_payload("Hello, world!".bytes().collect());
	
	// method 2
	new_packet.extend_payload("Hello, world!".bytes());

步骤4

数据现在已经准备好了，我们只需要烘焙数据包。这是填充校验和字段和长度字段的地方，例如IP头部中的长度字段（有关为什么即使在操作系统可能会覆盖这些字段的情况下，我仍然决定计算这些字段的原因，请参见这个文档页面）

	let data: Vec<u8> = new_packet.into_vec();
}