packetgen

Documentation

Overview

Package packetgen [allows sending customized tcp/udp traffic. Inspired by https://github.com/bilalcaliskan/syn-flood]

Index

• Constants
• func BuildLinkLayer(c LayerConfig) (gopacket.LinkLayer, error)
• func BuildNetworkLayer(c LayerConfig) (gopacket.NetworkLayer, error)
• func BuildPayload(c LayerConfig) (gopacket.Layer, error)
• func BuildTransportLayer(c LayerConfig, network gopacket.NetworkLayer) (gopacket.TransportLayer, error)
• func Serialize(payloadBuf gopacket.SerializeBuffer, layer gopacket.Layer) error
• func SerializeLayers(payloadBuf gopacket.SerializeBuffer, layers ...gopacket.Layer) error
• type Connection
  • func OpenConnection(ctx context.Context, c ConnectionConfig) (Connection, error)
• type ConnectionConfig
• type DNSPacketConfig
• type DNSQuestion
• type EthernetPacketConfig
• type ICMPV4PacketConfig
• type IPPacketConfig
• type LayerConfig
• type Packet
  • func (p Packet) IP() net.IP
  • func (p Packet) Serialize(payloadBuf gopacket.SerializeBuffer) (err error)
• type PacketConfig
  • func (c PacketConfig) Build() (result Packet, err error)
• type TCPFlagsConfig
• type TCPPacketConfig
• type UDPPacketConfig

Constants

const (
	TCPHeaderSize = 25 // 20 for header + at least 5 for options
	UDPHeaderSize = 8
	IPHeaderSize  = 20
)

Common protocol header sizes to help with metrics

Functions

func BuildLinkLayer

func BuildLinkLayer(c LayerConfig) (gopacket.LinkLayer, error)

func BuildNetworkLayer

func BuildNetworkLayer(c LayerConfig) (gopacket.NetworkLayer, error)

func BuildPayload

func BuildPayload(c LayerConfig) (gopacket.Layer, error)

func BuildTransportLayer

func BuildTransportLayer(c LayerConfig, network gopacket.NetworkLayer) (gopacket.TransportLayer, error)

func Serialize

func Serialize(payloadBuf gopacket.SerializeBuffer, layer gopacket.Layer) error

func SerializeLayers

func SerializeLayers(payloadBuf gopacket.SerializeBuffer, layers ...gopacket.Layer) error

Types

type Connection

type Connection interface {
	Write(Packet) (int, error)
	Read([]byte) (int, error)
	Close() error
	Target() string
}

func OpenConnection

func OpenConnection(ctx context.Context, c ConnectionConfig) (Connection, error)

type ConnectionConfig

type ConnectionConfig struct {
	Type  string
	Args  map[string]any
	Proxy *utils.ProxyParams
}

ConnectionConfig describes which network to use when sending packets

type DNSPacketConfig

type DNSPacketConfig struct {
	ID     uint16
	Qr     bool
	OpCode uint8

	AA bool  // Authoritative answer
	TC bool  // Truncated
	RD bool  // Recursion desired
	RA bool  // Recursion available
	Z  uint8 // Reserved for future use

	ResponseCode uint8
	QDCount      *uint16 // Number of questions to expect

	// Entries
	Questions []DNSQuestion
}

type DNSQuestion

type DNSQuestion struct {
	Name  string
	Type  layers.DNSType
	Class layers.DNSClass
}

DNSQuestion wraps a single request (question) within a DNS query.

type EthernetPacketConfig

type EthernetPacketConfig struct {
	SrcMAC string
	DstMAC string
}

EthernetPacketConfig describes ethernet layer configuration

type ICMPV4PacketConfig

type ICMPV4PacketConfig struct {
	TypeCode uint16
	ID       uint16
	Seq      uint16
}

type IPPacketConfig

type IPPacketConfig struct {
	SrcIP        string
	DstIP        string
	NextProtocol *int
	TTL          uint8
}

IPPacketConfig describes ip layer configuration

type LayerConfig

type LayerConfig struct {
	Type string
	Data map[string]any
}

type Packet

type Packet struct {
	Link      gopacket.LinkLayer
	Network   gopacket.NetworkLayer
	Transport gopacket.TransportLayer
	Payload   gopacket.Layer
}

func (Packet) IP

func (p Packet) IP() net.IP

func (Packet) Serialize

func (p Packet) Serialize(payloadBuf gopacket.SerializeBuffer) (err error)

type PacketConfig

type PacketConfig struct {
	Link      LayerConfig
	Network   LayerConfig
	Transport LayerConfig
	Payload   LayerConfig
}

func (PacketConfig) Build

func (c PacketConfig) Build() (result Packet, err error)

type TCPFlagsConfig

type TCPFlagsConfig struct {
	SYN bool
	ACK bool
	FIN bool
	RST bool
	PSH bool
	URG bool
	ECE bool
	CWR bool
	NS  bool
}

TCPFlagsConfig stores flags to be set on tcp layer

type TCPPacketConfig

type TCPPacketConfig struct {
	SrcPort int
	DstPort int
	Seq     uint32
	Ack     uint32
	Window  uint16
	Urgent  uint16
	Flags   TCPFlagsConfig
}

TCPPacketConfig describes tcp layer configuration

type UDPPacketConfig

type UDPPacketConfig struct {
	SrcPort int
	DstPort int
}

UDPPacketConfig describes udp layer configuration