NS-3
ns3::Node Class Reference

A network Node. More...

#include <node.h>

Inheritance diagram for ns3::Node:
Collaboration diagram for ns3::Node:

List of all members.

Classes

struct  ProtocolHandlerEntry

Public Types

typedef Callback< void, Ptr
< NetDevice >, Ptr< const
Packet >, uint16_t, const
Address &, const Address
&, NetDevice::PacketType
ProtocolHandler
typedef Callback< void, Ptr
< NetDevice > > 
DeviceAdditionListener

Public Member Functions

 Node ()
 Node (uint32_t systemId)
uint32_t GetId (void) const
uint32_t GetSystemId (void) const
uint32_t AddDevice (Ptr< NetDevice > device)
Ptr< NetDeviceGetDevice (uint32_t index) const
uint32_t GetNDevices (void) const
uint32_t AddApplication (Ptr< Application > application)
Ptr< ApplicationGetApplication (uint32_t index) const
uint32_t GetNApplications (void) const
void RegisterProtocolHandler (ProtocolHandler handler, uint16_t protocolType, Ptr< NetDevice > device, bool promiscuous=false)
void UnregisterProtocolHandler (ProtocolHandler handler)
void RegisterDeviceAdditionListener (DeviceAdditionListener listener)
void UnregisterDeviceAdditionListener (DeviceAdditionListener listener)

Static Public Member Functions

static TypeId GetTypeId (void)
 This method returns the TypeId associated to ns3::Node.
static bool ChecksumEnabled (void)

Protected Member Functions

virtual void DoDispose (void)
virtual void DoStart (void)

Detailed Description

A network Node.

This class holds together:

  • a list of NetDevice objects which represent the network interfaces of this node which are connected to other Node instances through Channel instances.
  • a list of Application objects which represent the userspace traffic generation applications which interact with the Node through the Socket API.
  • a node Id: a unique per-node identifier.
  • a system Id: a unique Id used for parallel simulations.

Every Node created is added to the NodeList automatically.


Member Typedef Documentation

A callback invoked whenever a device is added to a node.

typedef Callback<void,Ptr<NetDevice>, Ptr<const Packet>,uint16_t,const Address &, const Address &, NetDevice::PacketType> ns3::Node::ProtocolHandler

A protocol handler

Parameters:
devicea pointer to the net device which received the packet
packetthe packet received
protocolthe 16 bit protocol number associated with this packet. This protocol number is expected to be the same protocol number given to the Send method by the user on the sender side.
senderthe address of the sender
receiverthe address of the receiver; Note: this value is only valid for promiscuous mode protocol handlers. Note: If the L2 protocol does not use L2 addresses, the address reported here is the value of device->GetAddress().
packetTypetype of packet received (broadcast/multicast/unicast/otherhost); Note: this value is only valid for promiscuous mode protocol handlers.

Constructor & Destructor Documentation

ns3::Node::Node ( )

Must be invoked by subclasses only.

ns3::Node::Node ( uint32_t  systemId)
Parameters:
systemIda unique integer used for parallel simulations.

Must be invoked by subclasses only.


Member Function Documentation

uint32_t ns3::Node::AddApplication ( Ptr< Application application)
Parameters:
applicationApplication to associate to this node.
Returns:
the index of the Application within the Node's list of Application.

Associated this Application to this Node. This method is called automatically from Application::Application so the user has little reasons to call this method directly.

uint32_t ns3::Node::AddDevice ( Ptr< NetDevice device)
Parameters:
deviceNetDevice to associate to this node.
Returns:
the index of the NetDevice into the Node's list of NetDevice.

Associate this device to this node.

static bool ns3::Node::ChecksumEnabled ( void  ) [static]
Returns:
true if checksums are enabled, false otherwise.
virtual void ns3::Node::DoDispose ( void  ) [protected, virtual]

The dispose method. Subclasses must override this method and must chain up to it by calling Node::DoDispose at the end of their own DoDispose method.

Reimplemented from ns3::Object.

virtual void ns3::Node::DoStart ( void  ) [protected, virtual]

This method is called only once by Object::Start. If the user calls Object::Start multiple times, DoStart is called only the first time.

Subclasses are expected to override this method and _chain up_ to their parent's implementation once they are done. It is safe to call GetObject and AggregateObject from within this method.

Reimplemented from ns3::Object.

Ptr<Application> ns3::Node::GetApplication ( uint32_t  index) const
Parameters:
index
Returns:
the application associated to this requested index within this Node.
Ptr<NetDevice> ns3::Node::GetDevice ( uint32_t  index) const
Parameters:
indexthe index of the requested NetDevice
Returns:
the requested NetDevice associated to this Node.

The indexes used by the GetDevice method start at one and end at GetNDevices ()

uint32_t ns3::Node::GetId ( void  ) const
Returns:
the unique id of this node.

This unique id happens to be also the index of the Node into the NodeList.

uint32_t ns3::Node::GetNApplications ( void  ) const
Returns:
the number of applications associated to this Node.
uint32_t ns3::Node::GetNDevices ( void  ) const
Returns:
the number of NetDevice instances associated to this Node.
uint32_t ns3::Node::GetSystemId ( void  ) const
Returns:
the system id for parallel simulations associated to this node.
static TypeId ns3::Node::GetTypeId ( void  ) [static]

This method returns the TypeId associated to ns3::Node.

This object is accessible through the following paths with Config::Set and Config::Connect:

  • /NodeList/[i]

Attributes defined for this type:

No TraceSources defined for this type.

Reimplemented from ns3::Object.

void ns3::Node::RegisterDeviceAdditionListener ( DeviceAdditionListener  listener)
Parameters:
listenerthe listener to add

Add a new listener to the list of listeners for the device-added event. When a new listener is added, it is notified of the existance of all already-added devices to make discovery of devices easier.

void ns3::Node::RegisterProtocolHandler ( ProtocolHandler  handler,
uint16_t  protocolType,
Ptr< NetDevice device,
bool  promiscuous = false 
)
Parameters:
handlerthe handler to register
protocolTypethe type of protocol this handler is interested in. This protocol type is a so-called EtherType, as registered here: http://standards.ieee.org/regauth/ethertype/eth.txt the value zero is interpreted as matching all protocols.
devicethe device attached to this handler. If the value is zero, the handler is attached to all devices on this node.
promiscuouswhether to register a promiscuous mode handler
void ns3::Node::UnregisterDeviceAdditionListener ( DeviceAdditionListener  listener)
Parameters:
listenerthe listener to remove

Remove an existing listener from the list of listeners for the device-added event.

void ns3::Node::UnregisterProtocolHandler ( ProtocolHandler  handler)
Parameters:
handlerthe handler to unregister

After this call returns, the input handler will never be invoked anymore.


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