fd-emu-udp-echo.cc

Go to the documentation of this file.

/*
 * Copyright (c) 2012 University of Washington, 2012 INRIA
 *
 * SPDX-License-Identifier: GPL-2.0-only
 */
 
// Network topology
//
// Normally, the use case for emulated net devices is in collections of
// small simulations that connect to the outside world through specific
// interfaces.  For example, one could construct a number of virtual
// machines and connect them via a host-only network.  To use the emulated
// net device, you would need to set all of the host-only interfaces in
// promiscuous mode and provide an appropriate device name (search for "eth1"
// below).  One could also use the emulated net device in a testbed situation
// where the host on which the simulation is running has a specific interface
// of interested.  You would also need to set this specific interface into
// promiscuous mode and provide an appropriate device name.
//
// This philosophy carries over to this simple example.
//
// We don't assume any special configuration and all of the ns-3 emulated net
// devices will actually talk to the same underlying OS device.  We rely on
// the fact that the OS will deliver copies of our packets to the other ns-3
// net devices since we operate in promiscuous mode.
//
// Packets will be sent out over the device, but we use MAC spoofing.  The
// MAC addresses will be generated using the Organizationally Unique Identifier
// (OUI) 00:00:00 as a base.  This vendor code is not assigned to any
// organization and so should not conflict with any real hardware.  We'll use
// the first n of these addresses, where n is the number of nodes, in this
// simulation.  It is up to you to determine that using these MAC addresses is
// okay on your network and won't conflict with anything else (including another
// simulation using emu devices) on your network.  Once you have made this
// determination, you need to put the interface you chose into promiscuous mode.
// We don't do it for you since you need to think about it first.
//
// This simulation uses the real-time simulator and so will consume ten seconds
// of real time.
//
// By default, we create the following topology
//
//            n0    n1
//            |     |
//            -------
//             "eth1"
//
// - UDP flows from n0 to n1 and back
// - DropTail queues
// - Tracing of queues and packet receptions to file "udp-echo.tr"
// - pcap tracing on all devices
//
// Another mode of operation corresponds to the wiki HOWTO
// 'HOWTO use ns-3 scripts to drive real hardware'
//
// If the --client mode is specified, only one ns-3 node is created
// on the specified device name, assuming that a server node is
// on another virtual machine.  The client node will use 10.1.1.2
//
// If the --server mode is specified, only one ns-3 node is created
// on the specified device name, assuming that a client node is
// on another virtual machine.  The server node will use 10.1.1.1
 
#include "ns3/applications-module.h"
#include "ns3/core-module.h"
#include "ns3/fd-net-device-module.h"
#include "ns3/internet-module.h"
 
#include <fstream>
 
using namespace ns3;
 
NS_LOG_COMPONENT_DEFINE("EmulatedUdpEchoExample");
 
int
main(int argc, char* argv[])
{
    std::string deviceName("eth1");
    std::string encapMode("Dix");
    bool clientMode = false;
    bool serverMode = false;
    double stopTime = 10;
    uint32_t nNodes = 2;
 
    //
    // Allow the user to override any of the defaults at run-time, via command-line
    // arguments
    //
    CommandLine cmd(__FILE__);
    cmd.AddValue("client", "client mode", clientMode);
    cmd.AddValue("server", "server mode", serverMode);
    cmd.AddValue("deviceName", "device name", deviceName);
    cmd.AddValue("stopTime", "stop time (seconds)", stopTime);
    cmd.AddValue("encapsulationMode",
                 "encapsulation mode of emu device (\"Dix\" [default] or \"Llc\")",
                 encapMode);
    cmd.AddValue("nNodes", "number of nodes to create (>= 2)", nNodes);
 
    cmd.Parse(argc, argv);
 
    GlobalValue::Bind("SimulatorImplementationType", StringValue("ns3::RealtimeSimulatorImpl"));
 
    GlobalValue::Bind("ChecksumEnabled", BooleanValue(true));
 
    if (clientMode && serverMode)
    {
        NS_FATAL_ERROR("Error, both client and server options cannot be enabled.");
    }
    //
    // need at least two nodes
    //
    nNodes = nNodes < 2 ? 2 : nNodes;
 
    //
    // Explicitly create the nodes required by the topology (shown above).
    //
    NS_LOG_INFO("Create nodes.");
    NodeContainer n;
    n.Create(nNodes);
 
    InternetStackHelper internet;
    internet.Install(n);
 
    //
    // Explicitly create the channels required by the topology (shown above).
    //
    NS_LOG_INFO("Create channels.");
    EmuFdNetDeviceHelper emu;
    emu.SetDeviceName(deviceName);
    emu.SetAttribute("EncapsulationMode", StringValue(encapMode));
 
    NetDeviceContainer d;
    Ipv4AddressHelper ipv4;
    Ipv4InterfaceContainer i;
    ApplicationContainer apps;
 
    ipv4.SetBase("10.1.1.0", "255.255.255.0");
    if (clientMode)
    {
        d = emu.Install(n.Get(0));
        // Note:  incorrect MAC address assignments are one of the confounding
        // aspects of network emulation experiments.  Here, we assume that there
        // will be a server mode taking the first MAC address, so we need to
        // force the MAC address to be one higher (just like IP address below)
        Ptr<FdNetDevice> dev = d.Get(0)->GetObject<FdNetDevice>();
        dev->SetAddress(Mac48Address("00:00:00:00:00:02"));
        NS_LOG_INFO("Assign IP Addresses.");
        ipv4.NewAddress(); // burn the 10.1.1.1 address so that 10.1.1.2 is next
        i = ipv4.Assign(d);
    }
    else if (serverMode)
    {
        d = emu.Install(n.Get(0));
        NS_LOG_INFO("Assign IP Addresses.");
        i = ipv4.Assign(d);
    }
    else
    {
        d = emu.Install(n);
        NS_LOG_INFO("Assign IP Addresses.");
        i = ipv4.Assign(d);
    }
 
    if (serverMode)
    {
        //
        // Create a UdpEchoServer application
        //
        NS_LOG_INFO("Create Applications.");
        UdpEchoServerHelper server(9);
        apps = server.Install(n.Get(0));
        apps.Start(Seconds(1.0));
        apps.Stop(Seconds(stopTime));
    }
    else if (clientMode)
    {
        //
        // Create a UdpEchoClient application to send UDP datagrams
        //
        uint32_t packetSize = 1024;
        uint32_t maxPacketCount = 20;
        Time interPacketInterval = Seconds(0.1);
        UdpEchoClientHelper client(Ipv4Address("10.1.1.1"), 9);
        client.SetAttribute("MaxPackets", UintegerValue(maxPacketCount));
        client.SetAttribute("Interval", TimeValue(interPacketInterval));
        client.SetAttribute("PacketSize", UintegerValue(packetSize));
        apps = client.Install(n.Get(0));
        apps.Start(Seconds(2.0));
        apps.Stop(Seconds(stopTime));
    }
    else
    {
        //
        // Create a UdpEchoServer application on node one.
        //
        NS_LOG_INFO("Create Applications.");
        UdpEchoServerHelper server(9);
        apps = server.Install(n.Get(1));
        apps.Start(Seconds(1.0));
        apps.Stop(Seconds(stopTime));
 
        //
        // Create a UdpEchoClient application to send UDP datagrams from node zero to node one.
        //
        uint32_t packetSize = 1024;
        uint32_t maxPacketCount = 20;
        Time interPacketInterval = Seconds(0.1);
        UdpEchoClientHelper client(i.GetAddress(1), 9);
        client.SetAttribute("MaxPackets", UintegerValue(maxPacketCount));
        client.SetAttribute("Interval", TimeValue(interPacketInterval));
        client.SetAttribute("PacketSize", UintegerValue(packetSize));
        apps = client.Install(n.Get(0));
        apps.Start(Seconds(2.0));
        apps.Stop(Seconds(stopTime));
    }
 
    emu.EnablePcapAll("fd-emu-udp-echo", true);
    emu.EnableAsciiAll("fd-emu-udp-echo.tr");
 
    //
    // Now, do the actual simulation.
    //
    NS_LOG_INFO("Run Simulation.");
    Simulator::Stop(Seconds(stopTime + 2));
    Simulator::Run();
    Simulator::Destroy();
    NS_LOG_INFO("Done.");
 
    return 0;
}