Tests of TCP implementation loss behavior. More...

Inheritance diagram for Ns3TcpLossTestCase:

Collaboration diagram for Ns3TcpLossTestCase:

Public Member Functions
	Ns3TcpLossTestCase ()

	Ns3TcpLossTestCase (std::string tcpModel, uint32_t testCase)
	Constructor.

	~Ns3TcpLossTestCase () override

Public Member Functions inherited from ns3::TestCase
	TestCase (const TestCase &)=delete

virtual	~TestCase ()
	Destructor.

std::string	GetName () const

TestCase &	operator= (const TestCase &)=delete

Private Member Functions
void	CwndTracer (uint32_t oldval, uint32_t newval)
	CWND trace.

void	DoRun () override
	Implementation to actually run this TestCase.

void	DoSetup () override
	Implementation to do any local setup required for this TestCase.

void	DoTeardown () override
	Implementation to do any local setup required for this TestCase.

void	Ipv4L3Tx (std::string context, Ptr< const Packet > packet, Ptr< Ipv4 > ipv4, uint32_t interface)
	Check that the transmitted packets are consistent with the trace.

void	StartFlow (Ptr< Socket > localSocket, Ipv4Address servAddress, uint16_t servPort)
	Start transmitting a TCP flow.

void	WriteUntilBufferFull (Ptr< Socket > localSocket, uint32_t txSpace)
	Write to the socket until the buffer is full.

Private Attributes
uint32_t	m_currentTxBytes
	Current number of bytes sent.

bool	m_needToClose
	Check if the sending socket need to be closed.

Ptr< OutputStreamWrapper >	m_osw
	The output stream.

PcapFile	m_pcapFile
	The PCAP ffile.

std::string	m_pcapFilename
	The PCAP filename.

std::string	m_tcpModel
	The TCP model name.

uint32_t	m_testCase
	Testcase number.

uint32_t	m_totalTxBytes
	Total number of bytes to send.

bool	m_writeLogging
	True if write logging.

bool	m_writeResults
	True if write PCAP files.

bool	m_writeVectors
	True if response vectors have to be written (and not read).

Additional Inherited Members
Public Types inherited from ns3::TestCase
enum class	Duration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
	How long the test takes to execute. More...

Static Public Attributes inherited from ns3::TestCase
static constexpr auto	QUICK = Duration::QUICK
	Deprecated test duration simple enums.

static constexpr auto	EXTENSIVE = Duration::EXTENSIVE

static constexpr auto	TAKES_FOREVER = Duration::TAKES_FOREVER

Protected Member Functions inherited from ns3::TestCase
	TestCase (std::string name)
	Constructor.

void	AddTestCase (TestCase *testCase, Duration duration=Duration::QUICK)
	Add an individual child TestCase to this test suite.

TestCase *	GetParent () const
	Get the parent of this TestCase.

bool	IsStatusFailure () const
	Check if any tests failed.

bool	IsStatusSuccess () const
	Check if all tests passed.

void	SetDataDir (std::string directory)
	Set the data directory where reference trace files can be found.

void	ReportTestFailure (std::string cond, std::string actual, std::string limit, std::string message, std::string file, int32_t line)
	Log the failure of this TestCase.

bool	MustAssertOnFailure () const
	Check if this run should assert on failure.

bool	MustContinueOnFailure () const
	Check if this run should continue on failure.

std::string	CreateDataDirFilename (std::string filename)
	Construct the full path to a file in the data directory.

std::string	CreateTempDirFilename (std::string filename)
	Construct the full path to a file in a temporary directory.

Detailed Description

Tests of TCP implementation loss behavior.

Definition at line 58 of file ns3tcp-loss-test-suite.cc.

Constructor & Destructor Documentation

◆ Ns3TcpLossTestCase() [1/2]

Ns3TcpLossTestCase::Ns3TcpLossTestCase ( )

Definition at line 129 of file ns3tcp-loss-test-suite.cc.

◆ Ns3TcpLossTestCase() [2/2]

Ns3TcpLossTestCase::Ns3TcpLossTestCase	(	std::string	tcpModel,
		uint32_t	testCase )

Constructor.

Parameters

tcpModel	The TCP model name.
testCase	Testcase number.

Definition at line 142 of file ns3tcp-loss-test-suite.cc.

◆ ~Ns3TcpLossTestCase()

Ns3TcpLossTestCase::~Ns3TcpLossTestCase ( )

inlineoverride

Definition at line 71 of file ns3tcp-loss-test-suite.cc.

Member Function Documentation

◆ CwndTracer()

void Ns3TcpLossTestCase::CwndTracer	(	uint32_t	oldval,
		uint32_t	newval )

private

CWND trace.

Parameters

oldval	The old value.
newval	The new value.

Definition at line 268 of file ns3tcp-loss-test-suite.cc.

References ns3::Time::GetSeconds(), m_osw, m_writeLogging, and ns3::Simulator::Now().

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DoRun()

void Ns3TcpLossTestCase::DoRun ( )

overrideprivatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 329 of file ns3tcp-loss-test-suite.cc.

References ns3::NodeContainer::Add(), ns3::Config::Connect(), ns3::Config::ConnectWithoutContext(), ns3::NodeContainer::Create(), ns3::AsciiTraceHelper::CreateFileStream(), ns3::CreateObject(), ns3::Socket::CreateSocket(), CwndTracer(), ns3::Simulator::Destroy(), ns3::NetDeviceContainer::Get(), ns3::NodeContainer::Get(), ns3::Ipv4InterfaceContainer::GetAddress(), ns3::Ipv4Address::GetAny(), ns3::TcpSocketFactory::GetTypeId(), Ipv4L3Tx(), ns3::LOG_LEVEL_ALL, ns3::LOG_LEVEL_DEBUG, ns3::LOG_LEVEL_INFO, ns3::LOG_PREFIX_FUNC, ns3::LogComponentEnable(), ns3::LogComponentEnableAll(), m_osw, m_tcpModel, m_testCase, m_writeLogging, m_writeResults, ns3::MakeCallback(), NS_FATAL_ERROR, ns3::Ipv4GlobalRoutingHelper::PopulateRoutingTables(), ns3::Simulator::Run(), ns3::Simulator::ScheduleNow(), ns3::Seconds(), ns3::Config::SetDefault(), sink, ns3::ApplicationContainer::Start(), StartFlow(), ns3::ApplicationContainer::Stop(), and ns3::Simulator::Stop().

Here is the call graph for this function:

◆ DoSetup()

void Ns3TcpLossTestCase::DoSetup ( )

overrideprivatevirtual

Implementation to do any local setup required for this TestCase.

Subclasses should override this method to perform any costly per-test setup before DoRun is invoked.

Reimplemented from ns3::TestCase.

Definition at line 156 of file ns3tcp-loss-test-suite.cc.

References ns3::TestCase::CreateDataDirFilename(), ns3::PcapFile::GetDataLinkType(), ns3::TcpClassicRecovery::GetTypeId(), ns3::PcapFile::Init(), m_pcapFile, m_pcapFilename, m_tcpModel, m_testCase, m_writeVectors, NS_ABORT_MSG_UNLESS, ns3::PcapFile::Open(), PCAP_LINK_TYPE, PCAP_SNAPLEN, and ns3::Config::SetDefault().

Here is the call graph for this function:

◆ DoTeardown()

void Ns3TcpLossTestCase::DoTeardown ( )

overrideprivatevirtual

Implementation to do any local setup required for this TestCase.

Subclasses should override this method to perform any costly per-test teardown

Reimplemented from ns3::TestCase.

Definition at line 188 of file ns3tcp-loss-test-suite.cc.

References ns3::PcapFile::Close(), and m_pcapFile.

Here is the call graph for this function:

◆ Ipv4L3Tx()

void Ns3TcpLossTestCase::Ipv4L3Tx	(	std::string	context,
		Ptr< const Packet >	packet,
		Ptr< Ipv4 >	ipv4,
		uint32_t	interface )

private

Check that the transmitted packets are consistent with the trace.

This callback is hooked to ns3::Ipv4L3Protocol/Tx.

Parameters

context	The callback context (unused).
packet	The transmitted packet.
ipv4	The IPv4 object that did send the packet (unused).
interface	The IPv4 interface that did send the packet (unused).

Definition at line 194 of file ns3tcp-loss-test-suite.cc.

References ns3::Create(), ns3::Time::GetMicroSeconds(), ns3::TestCase::IsStatusSuccess(), m_pcapFile, m_tcpModel, m_testCase, m_writeVectors, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_INFO, NS_TEST_EXPECT_MSG_EQ, PCAP_SNAPLEN, ns3::PcapFile::Read(), and ns3::PcapFile::Write().

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StartFlow()

void Ns3TcpLossTestCase::StartFlow	(	Ptr< Socket >	localSocket,
		Ipv4Address	servAddress,
		uint16_t	servPort )

private

Start transmitting a TCP flow.

Parameters

localSocket	The sending socket.
servAddress	The IPv4 address of the server (i.e., the destination address).
servPort	The TCP port of the server (i.e., the destination port).

Definition at line 314 of file ns3tcp-loss-test-suite.cc.

References ns3::Time::GetSeconds(), m_writeLogging, ns3::MakeCallback(), ns3::Simulator::Now(), and WriteUntilBufferFull().

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ WriteUntilBufferFull()

void Ns3TcpLossTestCase::WriteUntilBufferFull	(	Ptr< Socket >	localSocket,
		uint32_t	txSpace )

private

Write to the socket until the buffer is full.

Parameters

localSocket	The output socket.
txSpace	The space left on the socket (unused).

Definition at line 280 of file ns3tcp-loss-test-suite.cc.

References ns3::Time::GetSeconds(), m_currentTxBytes, m_needToClose, m_totalTxBytes, m_writeLogging, ns3::Simulator::Now(), and NS_ASSERT.

Referenced by StartFlow().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ m_currentTxBytes

uint32_t Ns3TcpLossTestCase::m_currentTxBytes

private

Current number of bytes sent.

Definition at line 85 of file ns3tcp-loss-test-suite.cc.

Referenced by WriteUntilBufferFull().

◆ m_needToClose

bool Ns3TcpLossTestCase::m_needToClose

private

Check if the sending socket need to be closed.

Definition at line 89 of file ns3tcp-loss-test-suite.cc.

Referenced by WriteUntilBufferFull().

◆ m_osw

Ptr<OutputStreamWrapper> Ns3TcpLossTestCase::m_osw

private

The output stream.

Definition at line 80 of file ns3tcp-loss-test-suite.cc.

Referenced by CwndTracer(), and DoRun().

◆ m_pcapFile

PcapFile Ns3TcpLossTestCase::m_pcapFile

private

The PCAP ffile.

Definition at line 82 of file ns3tcp-loss-test-suite.cc.

Referenced by DoSetup(), DoTeardown(), and Ipv4L3Tx().

◆ m_pcapFilename

std::string Ns3TcpLossTestCase::m_pcapFilename

private

The PCAP filename.

Definition at line 81 of file ns3tcp-loss-test-suite.cc.

Referenced by DoSetup().

◆ m_tcpModel

std::string Ns3TcpLossTestCase::m_tcpModel

private

The TCP model name.

Definition at line 90 of file ns3tcp-loss-test-suite.cc.

Referenced by DoRun(), DoSetup(), and Ipv4L3Tx().

◆ m_testCase

uint32_t Ns3TcpLossTestCase::m_testCase

private

Testcase number.

Definition at line 83 of file ns3tcp-loss-test-suite.cc.

Referenced by DoRun(), DoSetup(), and Ipv4L3Tx().

◆ m_totalTxBytes

uint32_t Ns3TcpLossTestCase::m_totalTxBytes

private

Total number of bytes to send.

Definition at line 84 of file ns3tcp-loss-test-suite.cc.

Referenced by WriteUntilBufferFull().

◆ m_writeLogging

bool Ns3TcpLossTestCase::m_writeLogging

private

True if write logging.

Definition at line 88 of file ns3tcp-loss-test-suite.cc.

Referenced by CwndTracer(), DoRun(), StartFlow(), and WriteUntilBufferFull().

◆ m_writeResults

bool Ns3TcpLossTestCase::m_writeResults

private

True if write PCAP files.

Definition at line 87 of file ns3tcp-loss-test-suite.cc.

Referenced by DoRun().

◆ m_writeVectors

bool Ns3TcpLossTestCase::m_writeVectors

private

True if response vectors have to be written (and not read).

Definition at line 86 of file ns3tcp-loss-test-suite.cc.

Referenced by DoSetup(), and Ipv4L3Tx().

The documentation for this class was generated from the following file:

src/test/ns3tcp/ns3tcp-loss-test-suite.cc

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Ns3TcpLossTestCase() [1/2]

◆ Ns3TcpLossTestCase() [2/2]

◆ ~Ns3TcpLossTestCase()

Member Function Documentation

◆ CwndTracer()

◆ DoRun()

◆ DoSetup()

◆ DoTeardown()

◆ Ipv4L3Tx()

◆ StartFlow()

◆ WriteUntilBufferFull()

Member Data Documentation

◆ m_currentTxBytes

◆ m_needToClose

◆ m_osw

◆ m_pcapFile

◆ m_pcapFilename

◆ m_tcpModel

◆ m_testCase

◆ m_totalTxBytes

◆ m_writeLogging

◆ m_writeResults

◆ m_writeVectors