ns3tcp-state-test-suite.cc

Go to the documentation of this file.

/*
 * Copyright (c) 2010 University of Washington
 *
 * SPDX-License-Identifier: GPL-2.0-only
 */
 
#include "ns3tcp-socket-writer.h"
 
#include "ns3/abort.h"
#include "ns3/boolean.h"
#include "ns3/config.h"
#include "ns3/data-rate.h"
#include "ns3/error-model.h"
#include "ns3/inet-socket-address.h"
#include "ns3/internet-stack-helper.h"
#include "ns3/ipv4-address-helper.h"
#include "ns3/ipv4-global-routing-helper.h"
#include "ns3/log.h"
#include "ns3/node-container.h"
#include "ns3/packet-sink-helper.h"
#include "ns3/pcap-file.h"
#include "ns3/point-to-point-helper.h"
#include "ns3/pointer.h"
#include "ns3/simulator.h"
#include "ns3/string.h"
#include "ns3/tcp-header.h"
#include "ns3/tcp-socket-factory.h"
#include "ns3/test.h"
#include "ns3/traffic-control-helper.h"
#include "ns3/uinteger.h"
 
#include <iomanip>
#include <string>
 
using namespace ns3;
 
NS_LOG_COMPONENT_DEFINE("Ns3TcpStateTest");
 
// The below boolean constants should only be changed to 'true'
// during test debugging (i.e. do not commit the value 'true')
 
// set to 'true' to have the test suite overwrite the response vectors
// stored in the test directory.  This should only be done if you are
// convinced through other means (e.g. pcap tracing or logging) that the
// revised vectors are the correct ones.  In other words, don't simply
// enable this to true to clear a failing test without looking at the
// results closely.
const bool WRITE_VECTORS = false; //!< Set to true to write response vectors.
const bool WRITE_PCAP = false;    //!< Set to true to write out pcap.
const bool WRITE_LOGGING = false; //!< Set to true to write logging.
const uint32_t PCAP_LINK_TYPE =
    1187373554; //!< Some large random number -- we use to verify data was written by this program.
const uint32_t PCAP_SNAPLEN = 64; //!< Don't bother to save much data.
 
/**
 * @ingroup system-tests-tcp
 *
 * @brief Tests of TCP implementation state machine behavior
 */
class Ns3TcpStateTestCase : public TestCase
{
  public:
    Ns3TcpStateTestCase();
    /**
     * Constructor.
     * @param testCase Testcase number.
     */
    Ns3TcpStateTestCase(uint32_t testCase);
 
    ~Ns3TcpStateTestCase() override
    {
    }
 
  private:
    void DoSetup() override;
    void DoRun() override;
    void DoTeardown() override;
 
    std::string m_pcapFilename; //!< The PCAP filename.
    PcapFile m_pcapFile;        //!< The PCAP ffile.
    uint32_t m_testCase;        //!< Testcase number.
    uint32_t m_totalTxBytes;    //!< Total number of bytes to send.
    uint32_t m_currentTxBytes;  //!< Current number of bytes sent.
    bool m_writeVectors;        //!< True if response vectors have to be written (and not read).
    bool m_writeResults;        //!< True if write PCAP files.
    bool m_writeLogging;        //!< True if write logging.
    bool m_needToClose;         //!< Check if the sending socket need to be closed.
 
    /**
     * Check that the transmitted packets are consistent with the trace.
     * This callback is hooked to ns3::Ipv4L3Protocol/Tx.
     *
     * @param context The callback context (unused).
     * @param packet The transmitted packet.
     * @param ipv4 The IPv4 object that did send the packet (unused).
     * @param interface The IPv4 interface that did send the packet (unused).
     */
    void Ipv4L3Tx(std::string context,
                  Ptr<const Packet> packet,
                  Ptr<Ipv4> ipv4,
                  uint32_t interface);
    /**
     * Check that the received packets are consistent with the trace.
     * This callback is hooked to ns3::Ipv4L3Protocol/Tx.
     *
     * @param context The callback context (unused).
     * @param packet The transmitted packet.
     * @param ipv4 The IPv4 object that did send the packet (unused).
     * @param interface The IPv4 interface that did send the packet (unused).
     */
    void Ipv4L3Rx(std::string context,
                  Ptr<const Packet> packet,
                  Ptr<Ipv4> ipv4,
                  uint32_t interface);
    /**
     * Write to the socket until the buffer is full.
     *
     * @param localSocket The output socket.
     * @param txSpace The space left on the socket (unused).
     */
    void WriteUntilBufferFull(Ptr<Socket> localSocket, uint32_t txSpace);
    /**
     * Start transmitting a TCP flow.
     *
     * @param localSocket The sending socket.
     * @param servAddress The IPv4 address of the server (i.e., the destination address).
     * @param servPort The TCP port of the server (i.e., the destination port).
     */
    void StartFlow(Ptr<Socket> localSocket, Ipv4Address servAddress, uint16_t servPort);
};
 
Ns3TcpStateTestCase::Ns3TcpStateTestCase()
    : TestCase("Check the operation of the TCP state machine for several cases"),
      m_testCase(0),
      m_totalTxBytes(20000),
      m_currentTxBytes(0),
      m_writeVectors(WRITE_VECTORS),
      m_writeResults(WRITE_PCAP),
      m_writeLogging(WRITE_LOGGING),
      m_needToClose(true)
{
}
 
Ns3TcpStateTestCase::Ns3TcpStateTestCase(uint32_t testCase)
    : TestCase("Check the operation of the TCP state machine for several cases"),
      m_testCase(testCase),
      m_totalTxBytes(20000),
      m_currentTxBytes(0),
      m_writeVectors(WRITE_VECTORS),
      m_writeResults(WRITE_PCAP),
      m_writeLogging(WRITE_LOGGING),
      m_needToClose(true)
{
}
 
void
Ns3TcpStateTestCase::DoSetup()
{
    //
    // We expect there to be a file called ns3tcp-state-response-vectors.pcap in
    // the data directory
    //
    std::ostringstream oss;
    oss << "ns3tcp-state" << m_testCase << "-response-vectors.pcap";
    m_pcapFilename = CreateDataDirFilename(oss.str());
    NS_LOG_INFO("m_pcapFilename=" << m_pcapFilename);
 
    if (m_writeVectors)
    {
        m_pcapFile.Open(m_pcapFilename, std::ios::out | std::ios::binary);
        m_pcapFile.Init(PCAP_LINK_TYPE, PCAP_SNAPLEN);
    }
    else
    {
        m_pcapFile.Open(m_pcapFilename, std::ios::in | std::ios::binary);
        NS_ABORT_MSG_UNLESS(m_pcapFile.GetDataLinkType() == PCAP_LINK_TYPE,
                            "Wrong response vectors in directory: opening " << m_pcapFilename);
    }
}
 
void
Ns3TcpStateTestCase::DoTeardown()
{
    m_pcapFile.Close();
}
 
void
Ns3TcpStateTestCase::Ipv4L3Rx(std::string, Ptr<const Packet> packet, Ptr<Ipv4>, uint32_t)
{
    Ptr<Packet> received = packet->Copy();
    Ipv4Header ipHeader;
    TcpHeader tcpHeader;
    received->RemoveHeader(ipHeader);
    received->RemoveHeader(tcpHeader);
 
    NS_LOG_DEBUG("Received: " << tcpHeader);
}
 
void
Ns3TcpStateTestCase::Ipv4L3Tx(std::string, Ptr<const Packet> packet, Ptr<Ipv4>, uint32_t)
{
    //
    // We're not testing IP so remove and toss the header.  In order to do this,
    // though, we need to copy the packet since we have a const version.
    //
    Ptr<Packet> received = packet->Copy();
    Ipv4Header ipHeader;
    received->RemoveHeader(ipHeader);
 
    //
    // What is left is the TCP header and any data that may be sent.  We aren't
    // sending any TCP data, so we expect what remains is only TCP header, which
    // is a small thing to save.
    //
    if (m_writeVectors)
    {
        //
        // Save the TCP under test response for later testing.
        //
        Time tNow = Simulator::Now();
        int64_t tMicroSeconds = tNow.GetMicroSeconds();
 
        m_pcapFile.Write(uint32_t(tMicroSeconds / 1000000),
                         uint32_t(tMicroSeconds % 1000000),
                         received);
    }
    else
    {
        //
        // Read the TCP under test expected response from the expected vector
        // file and see if it still does the right thing.
        //
        uint8_t expectedBuffer[PCAP_SNAPLEN];
        uint32_t tsSec;
        uint32_t tsUsec;
        uint32_t inclLen;
        uint32_t origLen;
        uint32_t readLen;
        m_pcapFile
            .Read(expectedBuffer, sizeof(expectedBuffer), tsSec, tsUsec, inclLen, origLen, readLen);
 
        NS_LOG_INFO("read " << readLen << " bytes");
 
        auto actual = new uint8_t[readLen];
        received->CopyData(actual, readLen);
 
        int result = memcmp(actual, expectedBuffer, readLen);
 
        TcpHeader expectedHeader;
        TcpHeader receivedHeader;
        Ptr<Packet> expected = Create<Packet>(expectedBuffer, readLen);
 
        expected->RemoveHeader(expectedHeader);
        received->RemoveHeader(receivedHeader);
 
        NS_LOG_DEBUG("Expected " << expectedHeader << " received: " << receivedHeader);
 
        delete[] actual;
 
        //
        // Avoid streams of errors -- only report the first.
        //
        if (IsStatusSuccess())
        {
            NS_TEST_EXPECT_MSG_EQ(result, 0, "Expected data comparison error");
        }
    }
}
 
////////////////////////////////////////////////////////////////////
// Implementing an "application" to send bytes over a TCP connection
void
Ns3TcpStateTestCase::WriteUntilBufferFull(Ptr<Socket> localSocket, uint32_t txSpace)
{
    while (m_currentTxBytes < m_totalTxBytes)
    {
        uint32_t left = m_totalTxBytes - m_currentTxBytes;
        uint32_t dataOffset = m_currentTxBytes % 1040;
        uint32_t toWrite = 1040 - dataOffset;
        uint32_t txAvail = localSocket->GetTxAvailable();
        toWrite = std::min(toWrite, left);
        toWrite = std::min(toWrite, txAvail);
        if (txAvail == 0)
        {
            return;
        }
        if (m_writeLogging)
        {
            std::clog << "Submitting " << toWrite << " bytes to TCP socket" << std::endl;
        }
        int amountSent = localSocket->Send(nullptr, toWrite, 0);
        NS_ASSERT(amountSent > 0); // Given GetTxAvailable() non-zero, amountSent should not be zero
        m_currentTxBytes += amountSent;
    }
    if (m_needToClose)
    {
        if (m_writeLogging)
        {
            std::clog << "Close socket at " << Simulator::Now().GetSeconds() << std::endl;
        }
        localSocket->Close();
        m_needToClose = false;
    }
}
 
void
Ns3TcpStateTestCase::StartFlow(Ptr<Socket> localSocket, Ipv4Address servAddress, uint16_t servPort)
{
    if (m_writeLogging)
    {
        std::clog << "Starting flow at time " << Simulator::Now().GetSeconds() << std::endl;
    }
 
    localSocket->Connect(InetSocketAddress(servAddress, servPort)); // connect
 
    // tell the tcp implementation to call WriteUntilBufferFull again
    // if we blocked and new tx buffer space becomes available
    localSocket->SetSendCallback(MakeCallback(&Ns3TcpStateTestCase::WriteUntilBufferFull, this));
    WriteUntilBufferFull(localSocket, localSocket->GetTxAvailable());
}
 
void
Ns3TcpStateTestCase::DoRun()
{
    // Network topology
    //
    //           10Mb/s, 0.1ms      10Mb/s, 0.1ms
    //       n0-----------------n1-----------------n2
 
    std::string tcpModel("ns3::TcpNewReno");
 
    Config::SetDefault("ns3::TcpSocketBase::Sack", BooleanValue(false));
    Config::SetDefault("ns3::TcpL4Protocol::SocketType", StringValue(tcpModel));
    Config::SetDefault("ns3::TcpSocket::SegmentSize", UintegerValue(1000));
    Config::SetDefault("ns3::TcpSocket::DelAckCount", UintegerValue(1));
    Config::SetDefault("ns3::DropTailQueue<Packet>::MaxSize", StringValue("20p"));
    Config::SetDefault("ns3::TcpSocketBase::Timestamp", BooleanValue(false));
 
    if (m_writeLogging)
    {
        LogComponentEnableAll(LOG_PREFIX_FUNC);
        LogComponentEnable("ErrorModel", LOG_LEVEL_DEBUG);
        LogComponentEnable("Ns3TcpStateTest", LOG_LEVEL_DEBUG);
        LogComponentEnable("TcpCongestionOps", LOG_LEVEL_INFO);
        LogComponentEnable("TcpSocketBase", LOG_LEVEL_INFO);
    }
 
    ////////////////////////////////////////////////////////
    // Topology construction
    //
 
    // Create three nodes
    NodeContainer n0n1;
    n0n1.Create(2);
 
    NodeContainer n1n2;
    n1n2.Add(n0n1.Get(1));
    n1n2.Create(1);
 
    // Set up TCP/IP stack to all nodes (and create loopback device at device 0)
    InternetStackHelper internet;
    internet.InstallAll();
 
    // Connect the nodes
    PointToPointHelper p2p;
    p2p.SetDeviceAttribute("DataRate", DataRateValue(DataRate(1000000)));
    p2p.SetChannelAttribute("Delay", TimeValue(Seconds(0.0001)));
    NetDeviceContainer dev0 = p2p.Install(n0n1);
    NetDeviceContainer dev1 = p2p.Install(n1n2);
 
    // Use PfifoFast queue disc
    TrafficControlHelper tch;
    tch.SetRootQueueDisc("ns3::PfifoFastQueueDisc");
    tch.Install(dev0);
    tch.Install(dev1);
 
    // Add IP addresses to each network interfaces
    Ipv4AddressHelper ipv4;
    ipv4.SetBase("10.1.3.0", "255.255.255.0");
    ipv4.Assign(dev0);
    ipv4.SetBase("10.1.2.0", "255.255.255.0");
    Ipv4InterfaceContainer ipInterfs = ipv4.Assign(dev1);
 
    // Set up routes to all nodes
    Ipv4GlobalRoutingHelper::PopulateRoutingTables();
 
    ////////////////////////////////////////////////////////
    // A flow from node n0 to node n2
    //
 
    // Create a packet sink to receive packets on node n2
    uint16_t servPort = 50000; // Destination port number
    PacketSinkHelper sink("ns3::TcpSocketFactory",
                          InetSocketAddress(Ipv4Address::GetAny(), servPort));
    ApplicationContainer sinkApps = sink.Install(n1n2.Get(1));
    sinkApps.Start(Seconds(0));
    sinkApps.Stop(Seconds(100));
 
    // Create a data source to send packets on node n0
    // Instead of full application, here use the socket directly by
    // registering callbacks in function StarFlow().
    Ptr<Socket> localSocket = Socket::CreateSocket(n0n1.Get(0), TcpSocketFactory::GetTypeId());
    localSocket->Bind();
    Simulator::ScheduleNow(&Ns3TcpStateTestCase::StartFlow,
                           this,
                           localSocket,
                           ipInterfs.GetAddress(1),
                           servPort);
 
    Config::Connect("/NodeList/0/$ns3::Ipv4L3Protocol/Tx",
                    MakeCallback(&Ns3TcpStateTestCase::Ipv4L3Tx, this));
 
    Config::Connect("/NodeList/0/$ns3::Ipv4L3Protocol/Rx",
                    MakeCallback(&Ns3TcpStateTestCase::Ipv4L3Rx, this));
 
    ////////////////////////////////////////////////////////
    // Set up different test cases: Lost model at node n1, different file size
    //
 
    std::list<uint32_t> dropListN0;
    std::list<uint32_t> dropListN1;
    std::string caseDescription;
    switch (m_testCase)
    {
    case 0:
        m_totalTxBytes = 1000;
        caseDescription = "Verify connection establishment";
        break;
    case 1:
        m_totalTxBytes = 100 * 1000;
        caseDescription = "Verify a bigger (100 pkts) transfer: Sliding window operation, etc.";
        break;
    case 2:
        m_totalTxBytes = 1000;
        caseDescription = "Survive a SYN lost";
        dropListN0.push_back(0);
        break;
    case 3:
        m_totalTxBytes = 2000;
        caseDescription = "Survive a SYN+ACK lost";
        dropListN1.push_back(0);
        break;
    case 4:
        m_totalTxBytes = 2000;
        caseDescription = "Survive a ACK (last packet in 3-way handshake) lost";
        dropListN0.push_back(1);
        break;
    case 5:
        m_totalTxBytes = 0;
        caseDescription = "Immediate FIN upon SYN_RCVD";
        m_needToClose = false;
        dropListN0.push_back(1); // Hide the ACK in 3WHS
        Simulator::Schedule(Seconds(0.002), &Socket::Close, localSocket);
        break;
    case 6:
        m_totalTxBytes = 5000;
        caseDescription = "Simulated simultaneous close";
        dropListN1.push_back(5); // Hide the ACK-to-FIN from n2
        break;
    case 7:
        m_totalTxBytes = 5000;
        caseDescription = "FIN check 1: Loss of initiator's FIN. Wait until app close";
        m_needToClose = false;
        dropListN0.push_back(7); // Hide the FIN from n0
        Simulator::Schedule(Seconds(0.04), &Socket::Close, localSocket);
        break;
    case 8:
        m_totalTxBytes = 5000;
        caseDescription =
            "FIN check 2: Loss responder's FIN. FIN will be resent after last ack timeout";
        dropListN1.push_back(6); // Hide the FIN from n2
        break;
    default:
        NS_FATAL_ERROR("Program fatal error: specified test case not supported: " << m_testCase);
        break;
    }
 
    Ptr<ReceiveListErrorModel> errN0 = CreateObject<ReceiveListErrorModel>();
    errN0->SetList(dropListN0);
    dev0.Get(1)->SetAttribute("ReceiveErrorModel", PointerValue(errN0));
 
    Ptr<ReceiveListErrorModel> errN1 = CreateObject<ReceiveListErrorModel>();
    errN1->SetList(dropListN1);
    dev1.Get(0)->SetAttribute("ReceiveErrorModel", PointerValue(errN1));
 
    std::ostringstream oss;
    oss << "tcp-state" << m_testCase << "-test-case";
    if (m_writeResults)
    {
        p2p.EnablePcapAll(oss.str());
        p2p.EnableAsciiAll(oss.str());
    }
 
    if (m_writeLogging)
    {
        Ptr<OutputStreamWrapper> osw = Create<OutputStreamWrapper>(&std::clog);
        *(osw->GetStream()) << std::setprecision(9) << std::fixed;
        p2p.EnableAsciiAll(osw);
 
        std::clog << std::endl
                  << "Running TCP test-case " << m_testCase << ": " << caseDescription << std::endl;
    }
 
    // Finally, set up the simulator to run.  The 1000 second hard limit is a
    // failsafe in case some change above causes the simulation to never end
    Simulator::Stop(Seconds(1000));
    Simulator::Run();
    Simulator::Destroy();
}
 
/**
 * @ingroup system-tests-tcp
 *
 * TCP implementation state machine behavior TestSuite.
 */
class Ns3TcpStateTestSuite : public TestSuite
{
  public:
    Ns3TcpStateTestSuite();
};
 
Ns3TcpStateTestSuite::Ns3TcpStateTestSuite()
    : TestSuite("ns3-tcp-state", Type::SYSTEM)
{
    // We can't use NS_TEST_SOURCEDIR variable here because we use subdirectories
    SetDataDir("src/test/ns3tcp/response-vectors");
    Packet::EnablePrinting(); // Enable packet metadata for all test cases
 
    AddTestCase(new Ns3TcpStateTestCase(0), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(1), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(2), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(3), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(4), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(5), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(6), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(7), TestCase::Duration::QUICK);
    AddTestCase(new Ns3TcpStateTestCase(8), TestCase::Duration::QUICK);
}
 
/// Do not forget to allocate an instance of this TestSuite.
static Ns3TcpStateTestSuite g_ns3TcpLossTestSuite;