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)
- Public Member Functions inherited from ns3::Object
virtual TypeId GetInstanceTypeId (void) const
template<typename T >
Ptr< T > GetObject (void) const
template<typename T >
Ptr< T > GetObject (TypeId tid) const
void Dispose (void)
void AggregateObject (Ptr< Object > other)
AggregateIterator GetAggregateIterator (void) const
void Start (void)
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount (const SimpleRefCount &o)
SimpleRefCountoperator= (const SimpleRefCount &o)
void Ref (void) const
void Unref (void) const
uint32_t GetReferenceCount (void) const
- Public Member Functions inherited from ns3::ObjectBase
void SetAttribute (std::string name, const AttributeValue &value)
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
void GetAttribute (std::string name, AttributeValue &value) const
bool GetAttributeFailSafe (std::string name, AttributeValue &attribute) const
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)

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)
- Protected Member Functions inherited from ns3::Object
virtual void NotifyNewAggregate (void)
 Object (const Object &o)

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)
bool ns3::Node::ChecksumEnabled ( void  )
static
void ns3::Node::DoDispose ( void  )
protectedvirtual

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.

References ns3::Object::Dispose().

void ns3::Node::DoStart ( void  )
protectedvirtual

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.

References ns3::Object::Start().

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

References NS_ASSERT_MSG.

Referenced by ns3::EpcHelper::ActivateEpsBearer(), and ns3::EpcHelper::AddEnb().

Ptr< NetDevice > ns3::Node::GetDevice ( uint32_t  index) const
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.

Referenced by AddApplication(), AddDevice(), ns3::AcousticModemEnergyModel::ChangeState(), ns3::Ipv4GlobalRoutingHelper::Create(), ns3::GlobalRouteManagerImpl::DeleteGlobalRoutes(), ns3::GlobalRouter::DiscoverLSAs(), ns3::UanHelper::EnableAscii(), ns3::PcapHelperForDevice::EnablePcap(), ns3::PcapHelperForIpv4::EnablePcapIpv4(), ns3::PcapHelperForIpv6::EnablePcapIpv6(), ns3::UanPhyGen::EnergyDepletionHandler(), ns3::PcapHelper::GetFilenameFromDevice(), ns3::AsciiTraceHelper::GetFilenameFromDevice(), ns3::PcapHelper::GetFilenameFromInterfacePair(), ns3::AsciiTraceHelper::GetFilenameFromInterfacePair(), ns3::AnimPacketInfo::GetRxInfo(), ns3::AcousticModemEnergyModel::HandleEnergyDepletion(), ns3::BridgeHelper::Install(), ns3::TapBridgeHelper::Install(), ns3::SpectrumAnalyzerHelper::Install(), ns3::ArpL3Protocol::Lookup(), ns3::AnimPacketInfo::ProcessRxBegin(), ns3::AnimPacketInfo::ProcessRxEnd(), ns3::ArpL3Protocol::Receive(), ns3::Ipv6L3Protocol::Receive(), ns3::Ipv4L3Protocol::Receive(), ns3::MpiInterface::ReceiveMessages(), ns3::AnimPacketInfo::RemoveRxInfo(), ns3::Ipv4ListRouting::RouteInput(), ns3::Ipv6ListRouting::RouteInput(), ns3::LoopbackNetDevice::Send(), ns3::LoopbackNetDevice::SendFrom(), ns3::AnimationInterface::SetConstantPosition(), ns3::GlobalRoutingLSA::SetNode(), ns3::AnimationInterface::SetNodeDescription(), ns3::AnimationInterface::StartAnimation(), ns3::SingleModelSpectrumChannel::StartTx(), ns3::MultiModelSpectrumChannel::StartTx(), and ns3::PointToPointRemoteChannel::TransmitStart().

uint32_t ns3::Node::GetNApplications ( void  ) const
Returns:
the number of applications associated to this Node.

Referenced by ns3::EpcHelper::ActivateEpsBearer(), and ns3::EpcHelper::AddEnb().

uint32_t ns3::Node::GetSystemId ( void  ) const
Returns:
the system id for parallel simulations associated to this node.

Referenced by ns3::GlobalRouteManagerImpl::InitializeRoutes(), ns3::PointToPointHelper::Install(), and ns3::MpiInterface::SendPacket().

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.

References ns3::TypeId::ATTR_GET, and ns3::TypeId::SetParent().

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

References ns3::MakeCallback(), and ns3::NetDevice::SetPromiscReceiveCallback().

Referenced by ns3::BridgeNetDevice::AddBridgePort(), ns3::MeshPointDevice::AddInterface(), ns3::Ipv6L3Protocol::AddInterface(), and ns3::Ipv4L3Protocol::AddInterface().

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.

Referenced by ns3::PacketSocket::Close().


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