A IPv6 header consists of a set of fields:
Copy 1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-------+---------------+---------------------------------------+
|VERSION| Traffic Class | Flow Label |
+-------+---------------+-------+---------------+---------------+
| Payload Length | Next Header | Hop-Limit |
+-------------------------------+---------------+---------------+
| |
| Source Address |
| (128 bits) |
| |
+---------------------------------------------------------------+
| |
| Destination Address |
| (128 bits) |
| |
+---------------------------------------------------------------+ 4-bit protocol version (IPV6#version). Attended value is 6 for IPv6,
8-bit traffic class (`IPV6#traffic_class),
20-bit flow label (IPv6#flow_label),
16-bit payload length (IPV6#length), size of IPV6 payload, excluding the header,
8-bit next header (IPV6#next) to indicate upper protocol (6 for TCP, and 17 for UDP
by example, but this may also be IPv6 options),
8-bit hop-limit (IPV6#hop),
128-bit source IPV6 address (IPV6#src),
128-bit destination IPV6 address (IPV6#dst),
a body (IPV6#body) containing data conveyed by IPv6.
A IPV6 header may be built this way:
Copy pg> PacketGen::Header::IPv6.new(hop: 32, src: '::1', dst: '::1')
=> ---- PacketGen::Header::IPv6 -----------------------------------------
Int32 u32: 1610612736 (0x60000000)
version: 6
tclass: 0 (0x00)
flow_label: 0 (0x00000)
Int16 length: 0 (0x0000)
Int8 next: 0 (0x00)
Int8 hop: 32 (0x20)
Addr src: ::1
Addr dst: ::1 IPv6 Packet
A IPv6 packet may be created this way:
Copy pkt = PacketGen . gen ( 'IPV6' , ttl: 32 , src: '10.0.0.1' , dst: '20.0.0.1' , flag_df: true )
pkt . is? 'IPVv' # => true
pkt . ipv6 # => PacketGen::Header::IPv6
pkt . ipv6 . version # => 6
pkt . ipv6 . tclass # => Integer
pkt . ipv6 . flow_label # => Integer
pkt . ipv6 . length # => 0
pkt . ipv6 . next # => Integer
pkt . ipv6 . hop # => 32
pkt . ipv6 . dst # => '::1'
pkt . ipv6 . src = '::2'
pkt . ipv6 . src # => '::2'
pkt . body = 'This is a body'
pkt . length # => 0 As you can see, length is not automatically set to correct value. But it may be set easily with IPv6#calc_length. Packet#calc may be used too: it automatically call #calc_sum and #calc_length on all headers responding to them:
Copy pg> pkt.calc
pg> pkt
=> -- PacketGen::Packet -------------------------------------------------
---- PacketGen::Header::IPv6 -----------------------------------------
Int32 u32: 1610612736 (0x60000000)
version: 6
tclass: 0 (0x00)
flow_label: 0 (0x00000)
Int16 length: 14 (0x000e)
Int8 next: 0 (0x00)
Int8 hop: 32 (0x20)
Addr src: ::2
Addr dst: ::1
---- Body ------------------------------------------------------------
00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15
----------------------------------------------------------------------
54 68 69 73 20 69 73 20 61 20 62 6f 64 79 This is a body
---------------------------------------------------------------------- TCP and UDP headers over IPv6
TCP and UDP headers may be added to a IPv6 packet:
Copy pg > pkt = PacketGen . gen ( 'IPv6' , src: '::1' , dst: '::1' )
pg > pkt . add ( 'TCP' , dport: 80 , sport: 51234 )
pg > pkt
=> -- PacketGen :: Packet -------------------------------------------------
---- PacketGen :: Header :: IPv6 -----------------------------------------
Int32 u32: 1610612736 ( 0x60000000 )
version: 6
tclass: 0 ( 0x00 )
flow_label: 0 ( 0x00000 )
Int16 length: 0 ( 0x0000 )
Int8 next: 6 ( 0x06 )
Int8 hop: 64 ( 0x40 )
Addr src: :: 1
Addr dst: :: 1
---- PacketGen :: Header :: TCP ------------------------------------------
Int16 sport: 51234 ( 0xc822 )
Int16 dport: 80 ( 0x0050 )
Int32 seqnum: 6082437 ( 0x005ccf85 )
Int32 acknum: 0 ( 0x00000000 )
Int16 u16: 20480 ( 0x5000 )
data_offset: 5 ( 0x5 )
reserved: 0
flags: .........
Int16 window: 0 ( 0x0000 )
Int16 checksum: 0 ( 0x0000 )
Int16 urg_pointer: 0 ( 0x0000 )
Options options: See also http://rubydoc.info/gems/packetgen/PacketGen/Header/IPv6 .
