mirror of
https://github.com/refraction-networking/uquic.git
synced 2025-04-04 20:57:36 +03:00
440ff107a3
Duplicate detection uses the same data structure that is used to track received packets to generate ACK frames. That means that after an old ACK range has been pruned, a severly delayed packet might be incorrectly detected as a duplicate. As we wouldn't have acknowledged receipt of this packet, this situation would have resulted in a retransmission by the peer anyway, so dropping the packet won't cause a big regression.
69 lines
2.5 KiB
Go
69 lines
2.5 KiB
Go
package ackhandler
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/lucas-clemente/quic-go/internal/protocol"
|
|
"github.com/lucas-clemente/quic-go/internal/wire"
|
|
"github.com/lucas-clemente/quic-go/quictrace"
|
|
)
|
|
|
|
// A Packet is a packet
|
|
type Packet struct {
|
|
PacketNumber protocol.PacketNumber
|
|
Frames []Frame
|
|
LargestAcked protocol.PacketNumber // InvalidPacketNumber if the packet doesn't contain an ACK
|
|
Length protocol.ByteCount
|
|
EncryptionLevel protocol.EncryptionLevel
|
|
SendTime time.Time
|
|
|
|
includedInBytesInFlight bool
|
|
}
|
|
|
|
// SentPacketHandler handles ACKs received for outgoing packets
|
|
type SentPacketHandler interface {
|
|
// SentPacket may modify the packet
|
|
SentPacket(packet *Packet)
|
|
ReceivedAck(ackFrame *wire.AckFrame, encLevel protocol.EncryptionLevel, recvTime time.Time) error
|
|
DropPackets(protocol.EncryptionLevel)
|
|
ResetForRetry() error
|
|
SetHandshakeComplete()
|
|
|
|
// The SendMode determines if and what kind of packets can be sent.
|
|
SendMode() SendMode
|
|
// TimeUntilSend is the time when the next packet should be sent.
|
|
// It is used for pacing packets.
|
|
TimeUntilSend() time.Time
|
|
// ShouldSendNumPackets returns the number of packets that should be sent immediately.
|
|
// It always returns a number greater or equal than 1.
|
|
// A number greater than 1 is returned when the pacing delay is smaller than the minimum pacing delay.
|
|
// Note that the number of packets is only calculated based on the pacing algorithm.
|
|
// Before sending any packet, SendingAllowed() must be called to learn if we can actually send it.
|
|
ShouldSendNumPackets() int
|
|
|
|
// only to be called once the handshake is complete
|
|
QueueProbePacket(protocol.EncryptionLevel) bool /* was a packet queued */
|
|
|
|
PeekPacketNumber(protocol.EncryptionLevel) (protocol.PacketNumber, protocol.PacketNumberLen)
|
|
PopPacketNumber(protocol.EncryptionLevel) protocol.PacketNumber
|
|
|
|
GetLossDetectionTimeout() time.Time
|
|
OnLossDetectionTimeout() error
|
|
|
|
// report some congestion statistics. For tracing only.
|
|
GetStats() *quictrace.TransportState
|
|
}
|
|
|
|
type sentPacketTracker interface {
|
|
GetLowestPacketNotConfirmedAcked() protocol.PacketNumber
|
|
}
|
|
|
|
// ReceivedPacketHandler handles ACKs needed to send for incoming packets
|
|
type ReceivedPacketHandler interface {
|
|
IsPotentiallyDuplicate(protocol.PacketNumber, protocol.EncryptionLevel) bool
|
|
ReceivedPacket(pn protocol.PacketNumber, encLevel protocol.EncryptionLevel, rcvTime time.Time, shouldInstigateAck bool) error
|
|
DropPackets(protocol.EncryptionLevel)
|
|
|
|
GetAlarmTimeout() time.Time
|
|
GetAckFrame(protocol.EncryptionLevel) *wire.AckFrame
|
|
}
|