packetgen 1.1.0 has been released.
* home: <https://github.com/sdaubert/packetgen>
* bugs: <https://github.com/sdaubert/packetgen/issues>
* doc: <http://www.rubydoc.info/gems/packetgen>
PacketGen provides simple ways to generate, send and capture network
packets easily.
Known protocols are: Ethernet, IP, IPv6, ARP, ICMP, ICMPv6, UDP and TCP.
# Create packets:
pkt = PacketGen.gen('Eth').add('IP')
pkt = PacketGen.gen('IP', src: '192.168.1.2', dst:
'192.168.1.3').add('UDP', dport: 53, sport: 45657)
# Manipulate packets:
pkt.is? 'Eth' # => true
pkt.eth.dst = '00:00:01:02:03:04'
pkt.ip.sum = 0xffff
# Get packet binary data:
pkt.to_s
# Send packet on wire:
pkt.to_w # send on eth0
pkt.to_w('eth1')
# Capture packets from wire
PacketGen.capture('eth0') do |packet|
do_stuffs_with_packet
end
packets = PacketGen.capture('eth0', max: 6) # Get 6 packets
packets = PacketGen.capture('eth0', timeout: 10, filter: 'ip') # Get
all IP packets during 10 seconds
# Read/write packets from/to file
packets = PacketNG::Packet.read('file.pcapng')
pkt.to_f('file.pcapng')
PacketNG::Packet.write('another_file.pcapng', ary_of_packets)
# Parse a string:
pkt = PacketGen.parse(str)
Changes:
### 1.1.0 / 2016-12-28
* add Packet#encapsulate and Packet#decapsulate to easily encapsulate a
packet into another, and to decapsulate an inner packet.
* add a new mechanism to declare custom header classes. See README.