275 lines
7.1 KiB
Go
275 lines
7.1 KiB
Go
package wire
|
|
|
|
import (
|
|
"bytes"
|
|
"encoding/binary"
|
|
"errors"
|
|
"fmt"
|
|
"io"
|
|
|
|
"github.com/lucas-clemente/quic-go/internal/protocol"
|
|
"github.com/lucas-clemente/quic-go/internal/utils"
|
|
"github.com/lucas-clemente/quic-go/quicvarint"
|
|
)
|
|
|
|
// ParseConnectionID parses the destination connection ID of a packet.
|
|
// It uses the data slice for the connection ID.
|
|
// That means that the connection ID must not be used after the packet buffer is released.
|
|
func ParseConnectionID(data []byte, shortHeaderConnIDLen int) (protocol.ConnectionID, error) {
|
|
if len(data) == 0 {
|
|
return nil, io.EOF
|
|
}
|
|
isLongHeader := data[0]&0x80 > 0
|
|
if !isLongHeader {
|
|
if len(data) < shortHeaderConnIDLen+1 {
|
|
return nil, io.EOF
|
|
}
|
|
return protocol.ConnectionID(data[1 : 1+shortHeaderConnIDLen]), nil
|
|
}
|
|
if len(data) < 6 {
|
|
return nil, io.EOF
|
|
}
|
|
destConnIDLen := int(data[5])
|
|
if len(data) < 6+destConnIDLen {
|
|
return nil, io.EOF
|
|
}
|
|
return protocol.ConnectionID(data[6 : 6+destConnIDLen]), nil
|
|
}
|
|
|
|
// IsVersionNegotiationPacket says if this is a version negotiation packet
|
|
func IsVersionNegotiationPacket(b []byte) bool {
|
|
if len(b) < 5 {
|
|
return false
|
|
}
|
|
return b[0]&0x80 > 0 && b[1] == 0 && b[2] == 0 && b[3] == 0 && b[4] == 0
|
|
}
|
|
|
|
// Is0RTTPacket says if this is a 0-RTT packet.
|
|
// A packet sent with a version we don't understand can never be a 0-RTT packet.
|
|
func Is0RTTPacket(b []byte) bool {
|
|
if len(b) < 5 {
|
|
return false
|
|
}
|
|
if b[0]&0x80 == 0 {
|
|
return false
|
|
}
|
|
version := protocol.VersionNumber(binary.BigEndian.Uint32(b[1:5]))
|
|
if !protocol.IsSupportedVersion(protocol.SupportedVersions, version) {
|
|
return false
|
|
}
|
|
if version == protocol.Version2 {
|
|
return b[0]>>4&0b11 == 0b10
|
|
}
|
|
return b[0]>>4&0b11 == 0b01
|
|
}
|
|
|
|
var ErrUnsupportedVersion = errors.New("unsupported version")
|
|
|
|
// The Header is the version independent part of the header
|
|
type Header struct {
|
|
IsLongHeader bool
|
|
typeByte byte
|
|
Type protocol.PacketType
|
|
|
|
Version protocol.VersionNumber
|
|
SrcConnectionID protocol.ConnectionID
|
|
DestConnectionID protocol.ConnectionID
|
|
|
|
Length protocol.ByteCount
|
|
|
|
Token []byte
|
|
|
|
parsedLen protocol.ByteCount // how many bytes were read while parsing this header
|
|
}
|
|
|
|
// ParsePacket parses a packet.
|
|
// If the packet has a long header, the packet is cut according to the length field.
|
|
// If we understand the version, the packet is header up unto the packet number.
|
|
// Otherwise, only the invariant part of the header is parsed.
|
|
func ParsePacket(data []byte, shortHeaderConnIDLen int) (*Header, []byte /* packet data */, []byte /* rest */, error) {
|
|
hdr, err := parseHeader(bytes.NewReader(data), shortHeaderConnIDLen)
|
|
if err != nil {
|
|
if err == ErrUnsupportedVersion {
|
|
return hdr, nil, nil, ErrUnsupportedVersion
|
|
}
|
|
return nil, nil, nil, err
|
|
}
|
|
var rest []byte
|
|
if hdr.IsLongHeader {
|
|
if protocol.ByteCount(len(data)) < hdr.ParsedLen()+hdr.Length {
|
|
return nil, nil, nil, fmt.Errorf("packet length (%d bytes) is smaller than the expected length (%d bytes)", len(data)-int(hdr.ParsedLen()), hdr.Length)
|
|
}
|
|
packetLen := int(hdr.ParsedLen() + hdr.Length)
|
|
rest = data[packetLen:]
|
|
data = data[:packetLen]
|
|
}
|
|
return hdr, data, rest, nil
|
|
}
|
|
|
|
// ParseHeader parses the header.
|
|
// For short header packets: up to the packet number.
|
|
// For long header packets:
|
|
// * if we understand the version: up to the packet number
|
|
// * if not, only the invariant part of the header
|
|
func parseHeader(b *bytes.Reader, shortHeaderConnIDLen int) (*Header, error) {
|
|
startLen := b.Len()
|
|
h, err := parseHeaderImpl(b, shortHeaderConnIDLen)
|
|
if err != nil {
|
|
return h, err
|
|
}
|
|
h.parsedLen = protocol.ByteCount(startLen - b.Len())
|
|
return h, err
|
|
}
|
|
|
|
func parseHeaderImpl(b *bytes.Reader, shortHeaderConnIDLen int) (*Header, error) {
|
|
typeByte, err := b.ReadByte()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
h := &Header{
|
|
typeByte: typeByte,
|
|
IsLongHeader: typeByte&0x80 > 0,
|
|
}
|
|
|
|
if !h.IsLongHeader {
|
|
if h.typeByte&0x40 == 0 {
|
|
return nil, errors.New("not a QUIC packet")
|
|
}
|
|
if err := h.parseShortHeader(b, shortHeaderConnIDLen); err != nil {
|
|
return nil, err
|
|
}
|
|
return h, nil
|
|
}
|
|
return h, h.parseLongHeader(b)
|
|
}
|
|
|
|
func (h *Header) parseShortHeader(b *bytes.Reader, shortHeaderConnIDLen int) error {
|
|
var err error
|
|
h.DestConnectionID, err = protocol.ReadConnectionID(b, shortHeaderConnIDLen)
|
|
return err
|
|
}
|
|
|
|
func (h *Header) parseLongHeader(b *bytes.Reader) error {
|
|
v, err := utils.BigEndian.ReadUint32(b)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
h.Version = protocol.VersionNumber(v)
|
|
if h.Version != 0 && h.typeByte&0x40 == 0 {
|
|
return errors.New("not a QUIC packet")
|
|
}
|
|
destConnIDLen, err := b.ReadByte()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
h.DestConnectionID, err = protocol.ReadConnectionID(b, int(destConnIDLen))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
srcConnIDLen, err := b.ReadByte()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
h.SrcConnectionID, err = protocol.ReadConnectionID(b, int(srcConnIDLen))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if h.Version == 0 { // version negotiation packet
|
|
return nil
|
|
}
|
|
// If we don't understand the version, we have no idea how to interpret the rest of the bytes
|
|
if !protocol.IsSupportedVersion(protocol.SupportedVersions, h.Version) {
|
|
return ErrUnsupportedVersion
|
|
}
|
|
|
|
if h.Version == protocol.Version2 {
|
|
switch h.typeByte >> 4 & 0b11 {
|
|
case 0b00:
|
|
h.Type = protocol.PacketTypeRetry
|
|
case 0b01:
|
|
h.Type = protocol.PacketTypeInitial
|
|
case 0b10:
|
|
h.Type = protocol.PacketType0RTT
|
|
case 0b11:
|
|
h.Type = protocol.PacketTypeHandshake
|
|
}
|
|
} else {
|
|
switch h.typeByte >> 4 & 0b11 {
|
|
case 0b00:
|
|
h.Type = protocol.PacketTypeInitial
|
|
case 0b01:
|
|
h.Type = protocol.PacketType0RTT
|
|
case 0b10:
|
|
h.Type = protocol.PacketTypeHandshake
|
|
case 0b11:
|
|
h.Type = protocol.PacketTypeRetry
|
|
}
|
|
}
|
|
|
|
if h.Type == protocol.PacketTypeRetry {
|
|
tokenLen := b.Len() - 16
|
|
if tokenLen <= 0 {
|
|
return io.EOF
|
|
}
|
|
h.Token = make([]byte, tokenLen)
|
|
if _, err := io.ReadFull(b, h.Token); err != nil {
|
|
return err
|
|
}
|
|
_, err := b.Seek(16, io.SeekCurrent)
|
|
return err
|
|
}
|
|
|
|
if h.Type == protocol.PacketTypeInitial {
|
|
tokenLen, err := quicvarint.Read(b)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if tokenLen > uint64(b.Len()) {
|
|
return io.EOF
|
|
}
|
|
h.Token = make([]byte, tokenLen)
|
|
if _, err := io.ReadFull(b, h.Token); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
pl, err := quicvarint.Read(b)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
h.Length = protocol.ByteCount(pl)
|
|
return nil
|
|
}
|
|
|
|
// ParsedLen returns the number of bytes that were consumed when parsing the header
|
|
func (h *Header) ParsedLen() protocol.ByteCount {
|
|
return h.parsedLen
|
|
}
|
|
|
|
// ParseExtended parses the version dependent part of the header.
|
|
// The Reader has to be set such that it points to the first byte of the header.
|
|
func (h *Header) ParseExtended(b *bytes.Reader, ver protocol.VersionNumber) (*ExtendedHeader, error) {
|
|
extHdr := h.toExtendedHeader()
|
|
reservedBitsValid, err := extHdr.parse(b, ver)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if !reservedBitsValid {
|
|
return extHdr, ErrInvalidReservedBits
|
|
}
|
|
return extHdr, nil
|
|
}
|
|
|
|
func (h *Header) toExtendedHeader() *ExtendedHeader {
|
|
return &ExtendedHeader{Header: *h}
|
|
}
|
|
|
|
// PacketType is the type of the packet, for logging purposes
|
|
func (h *Header) PacketType() string {
|
|
if h.IsLongHeader {
|
|
return h.Type.String()
|
|
}
|
|
return "1-RTT"
|
|
}
|