quicutils

Documentation

Index

• Constants
• Variables
• func BigEndianUvarint(buf []byte) (uint64, int, error)
• func DecryptQuic_(header []byte, blockEnd int, destConnId []byte) (plaintext []byte, err error)
• func HkdfExpandLabelFromPool(h func() hash.Hash, secret, label []byte, context []byte, length int) ([]byte, error)
• type BuiltinBytesLocator
  • func (l BuiltinBytesLocator) At(i int) (byte, error)
  • func (l BuiltinBytesLocator) Bytes() ([]byte, error)
  • func (l BuiltinBytesLocator) Len() int
  • func (l BuiltinBytesLocator) Range(i, j int) ([]byte, error)
  • func (l BuiltinBytesLocator) Slice(i, j int) (Locator, error)
• type CryptoFrameOffset
  • func ExtractCryptoFrameOffset(remainder []byte, transportOffset int) (offset *CryptoFrameOffset, frameSize int, err error)
  • func ReassembleCryptos(offsets []*CryptoFrameOffset, newPayload []byte) (newOffsets []*CryptoFrameOffset, err error)
• type Keys
  • func NewKeys(clientDstConnectionId []byte, version Version, ...) (keys *Keys, err error)
  • func (k *Keys) Close() error
  • func (k *Keys) HeaderProtection_(sample []byte, longHeader bool, firstByte *byte, potentialPacketNumber []byte) (packetNumber []byte, err error)
  • func (k *Keys) PayloadDecrypt(ciphertext []byte, packetNumber []byte, header []byte) (plaintext []byte, err error)
• type LinearLocator
  • func NewLinearLocator(o []*CryptoFrameOffset) *LinearLocator
  • func (l *LinearLocator) At(i int) (byte, error)
  • func (l *LinearLocator) Bytes() ([]byte, error)
  • func (l *LinearLocator) Len() int
  • func (l *LinearLocator) Range(i, j int) ([]byte, error)
  • func (l *LinearLocator) Slice(i, j int) (Locator, error)
• type Locator
• type Version
  • func ParseVersion(version uint32) (Version, error)
  • func (v Version) HpLabel() []byte
  • func (v Version) InitialSalt() []byte
  • func (v Version) IvLabel() []byte
  • func (v Version) KeyLabel() []byte

Constants

const (
	MaxVarintLen64 = 8

	MaxPacketNumberLength = 4
	SampleSize            = 16
)

const (
	Quic_FrameType_Padding          = 0
	Quic_FrameType_Ping             = 1
	Quic_FrameType_Crypto           = 6
	Quic_FrameType_ConnectionClose  = 0x1c
	Quic_FrameType_ConnectionClose2 = 0x1d
)

const (
	Version_Draft = iota
	Version_V1
	Version_V2
)

Variables

var (
	ErrUnknownFrameType = fmt.Errorf("unknown frame type")
	ErrOutOfRange       = fmt.Errorf("index out of range")
)

var (
	ErrMissingCrypto = fmt.Errorf("missing crypto frame")
)

var (
	InitialClientLabel = []byte("client in")
)

Functions

func BigEndianUvarint

func BigEndianUvarint(buf []byte) (uint64, int, error)

BigEndianUvarint decodes a uint64 from buf and returns that value and the number of bytes read (> 0).

func DecryptQuic_

func DecryptQuic_(header []byte, blockEnd int, destConnId []byte) (plaintext []byte, err error)

func HkdfExpandLabelFromPool

func HkdfExpandLabelFromPool(h func() hash.Hash, secret, label []byte, context []byte, length int) ([]byte, error)

HkdfExpandLabelFromPool HKDF expands a label. Since this implementation avoids using a cryptobyte.Builder, it is about 15% faster than the hkdfExpandLabel in the standard library.

Types

type BuiltinBytesLocator

type BuiltinBytesLocator []byte

func (BuiltinBytesLocator) At

func (l BuiltinBytesLocator) At(i int) (byte, error)

func (BuiltinBytesLocator) Bytes

func (l BuiltinBytesLocator) Bytes() ([]byte, error)

func (BuiltinBytesLocator) Len

func (l BuiltinBytesLocator) Len() int

func (BuiltinBytesLocator) Range

func (l BuiltinBytesLocator) Range(i, j int) ([]byte, error)

func (BuiltinBytesLocator) Slice

func (l BuiltinBytesLocator) Slice(i, j int) (Locator, error)

type CryptoFrameOffset

type CryptoFrameOffset struct {
	UpperAppOffset int
	// Offset of data in quic payload.
	Data []byte
}

func ExtractCryptoFrameOffset

func ExtractCryptoFrameOffset(remainder []byte, transportOffset int) (offset *CryptoFrameOffset, frameSize int, err error)

func ReassembleCryptos

func ReassembleCryptos(offsets []*CryptoFrameOffset, newPayload []byte) (newOffsets []*CryptoFrameOffset, err error)

type Keys

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

func NewKeys

func NewKeys(clientDstConnectionId []byte, version Version, newAead func(key []byte) (cipher.AEAD, error)) (keys *Keys, err error)

func (*Keys) Close

func (k *Keys) Close() error

func (*Keys) HeaderProtection_

func (k *Keys) HeaderProtection_(sample []byte, longHeader bool, firstByte *byte, potentialPacketNumber []byte) (packetNumber []byte, err error)

HeaderProtection_ encrypt/decrypt firstByte and packetNumber in place.

func (*Keys) PayloadDecrypt

func (k *Keys) PayloadDecrypt(ciphertext []byte, packetNumber []byte, header []byte) (plaintext []byte, err error)

type LinearLocator

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

LinearLocator only searches forward and have no boundary check.

func NewLinearLocator

func NewLinearLocator(o []*CryptoFrameOffset) *LinearLocator

func (*LinearLocator) At

func (l *LinearLocator) At(i int) (byte, error)

func (*LinearLocator) Bytes

func (l *LinearLocator) Bytes() ([]byte, error)

func (*LinearLocator) Len

func (l *LinearLocator) Len() int

func (*LinearLocator) Range

func (l *LinearLocator) Range(i, j int) ([]byte, error)

func (*LinearLocator) Slice

func (l *LinearLocator) Slice(i, j int) (Locator, error)

type Locator

type Locator interface {
	Range(i, j int) ([]byte, error)
	Slice(i, j int) (Locator, error)
	At(i int) (byte, error)
	Len() int
	Bytes() ([]byte, error)
}

type Version

type Version int

func ParseVersion

func ParseVersion(version uint32) (Version, error)

func (Version) HpLabel

func (v Version) HpLabel() []byte

func (Version) InitialSalt

func (v Version) InitialSalt() []byte

func (Version) IvLabel

func (v Version) IvLabel() []byte

func (Version) KeyLabel

func (v Version) KeyLabel() []byte