quicproxy

Documentation

Index

• type DelayCallback
• type Direction
  • func (d Direction) Is(dir Direction) bool
  • func (d Direction) String() string
• type DropCallback
• type Opts
• type QuicProxy
  • func NewQuicProxy(local string, opts *Opts) (*QuicProxy, error)
  • func (p *QuicProxy) Close() error
  • func (p *QuicProxy) LocalAddr() net.Addr
  • func (p *QuicProxy) LocalPort() int

Types

type DelayCallback

type DelayCallback func(dir Direction, packetCount uint64) time.Duration

DelayCallback is a callback that determines how much delay to apply to a packet.

var NoDelay DelayCallback = func(Direction, uint64) time.Duration {
	return 0
}

NoDelay doesn't apply a delay.

type Direction

type Direction int

Direction is the direction a packet is sent.

const (
	// DirectionIncoming is the direction from the client to the server.
	DirectionIncoming Direction = iota
	// DirectionOutgoing is the direction from the server to the client.
	DirectionOutgoing
	// DirectionBoth is both incoming and outgoing
	DirectionBoth
)

func (Direction) Is

func (d Direction) Is(dir Direction) bool

Is says if one direction matches another direction. For example, incoming matches both incoming and both, but not outgoing.

func (Direction) String

func (d Direction) String() string

type DropCallback

type DropCallback func(dir Direction, packetCount uint64) bool

DropCallback is a callback that determines which packet gets dropped.

var NoDropper DropCallback = func(Direction, uint64) bool {
	return false
}

NoDropper doesn't drop packets.

type Opts

type Opts struct {
	// The address this proxy proxies packets to.
	RemoteAddr string
	// DropPacket determines whether a packet gets dropped.
	DropPacket DropCallback
	// DelayPacket determines how long a packet gets delayed. This allows
	// simulating a connection with non-zero RTTs.
	// Note that the RTT is the sum of the delay for the incoming and the outgoing packet.
	DelayPacket DelayCallback
}

Opts are proxy options.

type QuicProxy

type QuicProxy struct {
	// contains filtered or unexported fields
}

QuicProxy is a QUIC proxy that can drop and delay packets.

func NewQuicProxy

func NewQuicProxy(local string, opts *Opts) (*QuicProxy, error)

NewQuicProxy creates a new UDP proxy

func (*QuicProxy) Close

func (p *QuicProxy) Close() error

Close stops the UDP Proxy

func (*QuicProxy) LocalAddr

func (p *QuicProxy) LocalAddr() net.Addr

LocalAddr is the address the proxy is listening on.

func (*QuicProxy) LocalPort

func (p *QuicProxy) LocalPort() int

LocalPort is the UDP port number the proxy is listening on.