A Discrete-Event Network Simulator
API
ns3::OFSwitch13InternalHelper Class Reference

This helper extends the base class and can be instantiated to create and configure an OpenFlow 1.3 network domain composed of one or more OpenFlow switches connected to a single or multiple internal simulated OpenFlow controllers. More...

#include "ofswitch13-internal-helper.h"

+ Inheritance diagram for ns3::OFSwitch13InternalHelper:
+ Collaboration diagram for ns3::OFSwitch13InternalHelper:

Public Member Functions

 OFSwitch13InternalHelper ()
 Default constructor. More...
 
 ~OFSwitch13InternalHelper () override
 Dummy destructor, see DoDispose. More...
 
void CreateOpenFlowChannels () override
 This virtual method must interconnect all switches to all controllers installed by this helper and starts the individual OpenFlow channel connections. More...
 
Ptr< OFSwitch13ControllerInstallController (Ptr< Node > cNode, Ptr< OFSwitch13Controller > controller=CreateObject< OFSwitch13LearningController >())
 This method installs the given controller application into the given controller node. More...
 
- Public Member Functions inherited from ns3::OFSwitch13Helper
 OFSwitch13Helper ()
 Default constructor. More...
 
 ~OFSwitch13Helper () override
 Dummy destructor, see DoDispose. More...
 
void EnableDatapathStats (std::string prefix="datapath", bool useNodeNames=false)
 Enable OpenFlow datapath statistics at OpenFlow switch devices configured by this helper. More...
 
void EnableOpenFlowAscii (std::string prefix="ofchannel")
 Enable ASCII traces at OpenFlow channel between controller and switches. More...
 
void EnableOpenFlowPcap (std::string prefix="ofchannel", bool promiscuous=true)
 Enable pacp traces at OpenFlow channel between controller and switches. More...
 
OFSwitch13DeviceContainer InstallSwitch (NodeContainer &swNodes)
 This method creates and aggregates an OpenFlow device to each switch node in the container. More...
 
Ptr< OFSwitch13DeviceInstallSwitch (Ptr< Node > swNode)
 This method creates an OpenFlow device and aggregates it to the switch node. More...
 
Ptr< OFSwitch13DeviceInstallSwitch (Ptr< Node > swNode, NetDeviceContainer &swPorts)
 This method creates an OpenFlow device and aggregates it to the switch node. More...
 
virtual void SetChannelDataRate (DataRate rate)
 Set the OpenFlow channel data rate used to create the connections between switches and controllers. More...
 
virtual void SetChannelType (ChannelType type)
 Set the OpenFlow channel type used to create the connections between switches and controllers. More...
 
void SetDeviceAttribute (std::string n1, const AttributeValue &v1)
 Set an attribute on each OpenFlow device created by this helper. More...
 
- Public Member Functions inherited from ns3::Object
 Object ()
 Constructor. More...
 
 ~Object () override
 Destructor. More...
 
void AggregateObject (Ptr< Object > other)
 Aggregate two Objects together. More...
 
void Dispose ()
 Dispose of this Object. More...
 
AggregateIterator GetAggregateIterator () const
 Get an iterator to the Objects aggregated to this one. More...
 
TypeId GetInstanceTypeId () const override
 Get the most derived TypeId for this Object. More...
 
template<typename T >
Ptr< T > GetObject () const
 Get a pointer to the requested aggregated Object. More...
 
template<>
Ptr< ObjectGetObject () const
 Specialization of () for objects of type ns3::Object. More...
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 Get a pointer to the requested aggregated Object by TypeId. More...
 
template<>
Ptr< ObjectGetObject (TypeId tid) const
 Specialization of (TypeId tid) for objects of type ns3::Object. More...
 
void Initialize ()
 Invoke DoInitialize on all Objects aggregated to this one. More...
 
bool IsInitialized () const
 Check if the object has been initialized. More...
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Default constructor. More...
 
 SimpleRefCount (const SimpleRefCount &o[[maybe_unused]])
 Copy constructor. More...
 
uint32_t GetReferenceCount () const
 Get the reference count of the object. More...
 
SimpleRefCountoperator= (const SimpleRefCount &o[[maybe_unused]])
 Assignment operator. More...
 
void Ref () const
 Increment the reference count. More...
 
void Unref () const
 Decrement the reference count. More...
 
- Public Member Functions inherited from ns3::ObjectBase
virtual ~ObjectBase ()
 Virtual destructor. More...
 
void GetAttribute (std::string name, AttributeValue &value) const
 Get the value of an attribute, raising fatal errors if unsuccessful. More...
 
bool GetAttributeFailSafe (std::string name, AttributeValue &value) const
 Get the value of an attribute without raising errors. More...
 
void SetAttribute (std::string name, const AttributeValue &value)
 Set a single attribute, raising fatal errors if unsuccessful. More...
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 Set a single attribute without raising errors. More...
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 Connect a TraceSource to a Callback with a context. More...
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 Connect a TraceSource to a Callback without a context. More...
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected with a context. More...
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected without a context. More...
 

Static Public Member Functions

static TypeId GetTypeId ()
 Register this type. More...
 
- Static Public Member Functions inherited from ns3::OFSwitch13Helper
static void EnableDatapathLogs (std::string prefix="", bool explicitFilename=false)
 Enable OpenFlow datapath logs at all OpenFlow switch devices on the simulation. More...
 
static TypeId GetTypeId ()
 Register this type. More...
 
static void SetAddressBase (Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
 Set the IP network base address, used to assign IP addresses to switches and controllers during the CreateOpenFlowChannels () procedure. More...
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId ()
 Register this type. More...
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId ()
 Get the type ID. More...
 

Protected Member Functions

NetDeviceContainer Connect (Ptr< Node > ctrl, Ptr< Node > swtch)
 Create an individual connection between the switch and the controller node, using the already configured channel type. More...
 
void DoDispose () override
 Destructor implementation. More...
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 Copy an Object. More...
 
virtual void DoInitialize ()
 Initialize() implementation. More...
 
virtual void NotifyNewAggregate ()
 Notify all Objects aggregated to this one of a new Object being aggregated. More...
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 Complete construction of ObjectBase; invoked by derived classes. More...
 
virtual void NotifyConstructionCompleted ()
 Notifier called once the ObjectBase is fully constructed. More...
 

Protected Attributes

ApplicationContainer m_controlApps
 OF controller apps. More...
 
NodeContainer m_controlNodes
 OF controller nodes. More...
 
- Protected Attributes inherited from ns3::OFSwitch13Helper
bool m_blocked
 Block this helper. More...
 
DataRate m_channelDataRate
 OF channel data rate. More...
 
ChannelType m_channelType
 OF channel type. More...
 
NetDeviceContainer m_controlDevs
 OF channel ctrl devices. More...
 
CsmaHelper m_csmaHelper
 Helper for CSMA links. More...
 
ObjectFactory m_devFactory
 OF device factory. More...
 
InternetStackHelper m_internet
 Helper for TCP/IP stack. More...
 
OFSwitch13DeviceContainer m_openFlowDevs
 OF switch devices. More...
 
PointToPointHelper m_p2pHelper
 Helper for P2P links. More...
 
NodeContainer m_switchNodes
 OF switch nodes. More...
 

Additional Inherited Members

- Public Types inherited from ns3::OFSwitch13Helper
enum  ChannelType { SINGLECSMA = 0 , DEDICATEDCSMA = 1 , DEDICATEDP2P = 2 }
 OpenFlow channel type, used to create the connections. More...
 
- Static Protected Attributes inherited from ns3::OFSwitch13Helper
static Ipv4AddressHelper m_ipv4helper
 Helper for IP address. More...
 

Detailed Description

This helper extends the base class and can be instantiated to create and configure an OpenFlow 1.3 network domain composed of one or more OpenFlow switches connected to a single or multiple internal simulated OpenFlow controllers.

Introspection did not find any typical Config paths.

It brings methods for installing the controller and creating the OpenFlow channels.


No Attributes are defined for this type.

Attributes defined in parent class ns3::OFSwitch13Helper

  • ChannelDataRate: The data rate to be used for the OpenFlow channel.
  • ChannelType: The configuration used to create the OpenFlow channel
    • Set with class: ns3::EnumValue
    • Underlying type: SingleCsma|DedicatedCsma|DedicatedP2p
    • Initial value: SingleCsma
    • Flags: construct

No TraceSources are defined for this type.
Size of this type is 528 bytes (on a 64-bit architecture).

Definition at line 42 of file ofswitch13-internal-helper.h.

Constructor & Destructor Documentation

◆ OFSwitch13InternalHelper()

ns3::OFSwitch13InternalHelper::OFSwitch13InternalHelper ( )

Default constructor.

◆ ~OFSwitch13InternalHelper()

ns3::OFSwitch13InternalHelper::~OFSwitch13InternalHelper ( )
override

Dummy destructor, see DoDispose.

Member Function Documentation

◆ Connect()

NetDeviceContainer ns3::OFSwitch13InternalHelper::Connect ( Ptr< Node ctrl,
Ptr< Node swtch 
)
protected

Create an individual connection between the switch and the controller node, using the already configured channel type.

Parameters
ctrlThe controller node.
swtchThe switch node.
Returns
The devices created on both nodes.

◆ CreateOpenFlowChannels()

void ns3::OFSwitch13InternalHelper::CreateOpenFlowChannels ( )
overridevirtual

This virtual method must interconnect all switches to all controllers installed by this helper and starts the individual OpenFlow channel connections.

Attention
After calling this method, it will not be allowed to install more switches or controller using this helper.

Implements ns3::OFSwitch13Helper.

◆ DoDispose()

void ns3::OFSwitch13InternalHelper::DoDispose ( )
overrideprotectedvirtual

Destructor implementation.

Reimplemented from ns3::OFSwitch13Helper.

◆ GetTypeId()

static TypeId ns3::OFSwitch13InternalHelper::GetTypeId ( )
static

Register this type.

Returns
The object TypeId.

◆ InstallController()

Ptr<OFSwitch13Controller> ns3::OFSwitch13InternalHelper::InstallController ( Ptr< Node cNode,
Ptr< OFSwitch13Controller controller = CreateObjectOFSwitch13LearningController >() 
)

This method installs the given controller application into the given controller node.

If no application is given, a new (default) learning controller application is created and installed into controller node.

Parameters
cNodeThe node to configure as controller.
controllerThe controller application to install into cNode
Returns
The installed controller application.

Member Data Documentation

◆ m_controlApps

ApplicationContainer ns3::OFSwitch13InternalHelper::m_controlApps
protected

OF controller apps.

Definition at line 85 of file ofswitch13-internal-helper.h.

◆ m_controlNodes

NodeContainer ns3::OFSwitch13InternalHelper::m_controlNodes
protected

OF controller nodes.

Definition at line 86 of file ofswitch13-internal-helper.h.


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