io.aeron.driver

Interface CongestionControl

All Superinterfaces:

java.lang.AutoCloseable

All Known Implementing Classes:

CubicCongestionControl, StaticWindowCongestionControl

public interface CongestionControl
extends java.lang.AutoCloseable

Strategy for applying congestion control to determine the receiverWindowLength of the Status Messages

Method Summary

Modifier and Type	Method and Description
void	close()
int	initialWindowLength() Called by DriverConductor to initialise window length for a new PublicationImage.
void	onRttMeasurement(long now, long rttInNanos, java.net.InetSocketAddress srcAddress) Called by Receiver on reception of an RTT Measurement.
long	onTrackRebuild(long now, long newConsumptionPosition, long lastSmPosition, long hwmPosition, long startingRebuildPosition, long endingRebuildPosition, boolean lossOccurred) Called by DriverConductor upon execution of PublicationImage.trackRebuild(long, long) to pass on current status.
boolean	shouldMeasureRtt(long now) Polled by Receiver to determine when to initiate an RTT measurement to a Sender.

Method Detail

shouldMeasureRtt

boolean shouldMeasureRtt(long now)

Polled by Receiver to determine when to initiate an RTT measurement to a Sender.

Parameters:

now - in nanoseconds

Returns:

true for should measure RTT now or false for no measurement

onRttMeasurement

void onRttMeasurement(long now,
                      long rttInNanos,
                      java.net.InetSocketAddress srcAddress)

Called by Receiver on reception of an RTT Measurement.

Parameters:

now - in nanoseconds

rttInNanos - to the Sender

srcAddress - of the Sender

onTrackRebuild

long onTrackRebuild(long now,
                    long newConsumptionPosition,
                    long lastSmPosition,
                    long hwmPosition,
                    long startingRebuildPosition,
                    long endingRebuildPosition,
                    boolean lossOccurred)

Called by DriverConductor upon execution of PublicationImage.trackRebuild(long, long) to pass on current status. The return value must be packed using CongestionControlUtil.packOutcome(int, boolean).

Parameters:

now - in nanoseconds

newConsumptionPosition - of the Subscribers

lastSmPosition - of the image

hwmPosition - of the image

startingRebuildPosition - of the rebuild

endingRebuildPosition - of the rebuild

lossOccurred - during rebuild

Returns:

outcome of congestion control calculation containing window length and whether to force sending an SM.

initialWindowLength

int initialWindowLength()

Called by DriverConductor to initialise window length for a new PublicationImage.

Returns:

new image window length

close

void close()

Specified by:

close in interface java.lang.AutoCloseable