A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ns3::Ipv6Interface Class Reference

The IPv6 representation of a network interface. More...

#include <ipv6-interface.h>

+ Inheritance diagram for ns3::Ipv6Interface:
+ Collaboration diagram for ns3::Ipv6Interface:

Public Member Functions

 Ipv6Interface ()
 Constructs an Ipv6Interface. More...
 
virtual ~Ipv6Interface ()
 Destructor. More...
 
bool AddAddress (Ipv6InterfaceAddress iface)
 Add an IPv6 address. More...
 
Ipv6InterfaceAddress GetAddress (uint32_t index) const
 Get an address from IPv6 interface. More...
 
Ipv6InterfaceAddress GetAddressMatchingDestination (Ipv6Address dst)
 Get an address which is in the same network prefix as destination. More...
 
uint16_t GetBaseReachableTime () const
 Get the base reachable time. More...
 
uint8_t GetCurHopLimit () const
 Get the current hop limit value. More...
 
virtual Ptr< NetDeviceGetDevice () const
 Get the NetDevice. More...
 
Ipv6InterfaceAddress GetLinkLocalAddress () const
 Get link-local address from IPv6 interface. More...
 
uint16_t GetMetric () const
 Get the metric. More...
 
uint32_t GetNAddresses (void) const
 Get number of addresses on this IPv6 interface. More...
 
uint16_t GetReachableTime () const
 Get the reachable time. More...
 
uint16_t GetRetransTimer () const
 Get the retransmission timer. More...
 
bool IsDown () const
 Is the interface DOWN ? More...
 
bool IsForwarding () const
 If the interface allows forwarding packets. More...
 
bool IsUp () const
 Is the interface UP ? More...
 
Ipv6InterfaceAddress RemoveAddress (uint32_t index)
 Remove an address from interface. More...
 
Ipv6InterfaceAddress RemoveAddress (Ipv6Address address)
 Remove the given Ipv6 address from the interface. More...
 
void Send (Ptr< Packet > p, Ipv6Address dest)
 Send a packet through this interface. More...
 
void SetBaseReachableTime (uint16_t baseReachableTime)
 Set the base reachable time. More...
 
void SetCurHopLimit (uint8_t curHopLimit)
 Set the current hop limit. More...
 
void SetDevice (Ptr< NetDevice > device)
 Set the NetDevice. More...
 
void SetDown ()
 Disable this interface. More...
 
void SetForwarding (bool forward)
 Set forwarding enabled or not. More...
 
void SetMetric (uint16_t metric)
 Set the metric. More...
 
void SetNode (Ptr< Node > node)
 Set node associated with interface. More...
 
void SetNsDadUid (Ipv6Address address, uint32_t uid)
 Update NS DAD packet UID of an interface address. More...
 
void SetReachableTime (uint16_t reachableTime)
 Set the reachable time. More...
 
void SetRetransTimer (uint16_t retransTimer)
 Set the retransmission timer. More...
 
void SetState (Ipv6Address address, Ipv6InterfaceAddress::State_e state)
 Update state of an interface address. More...
 
void SetUp ()
 Enable this interface. More...
 
- Public Member Functions inherited from ns3::Object
 Object ()
 
virtual ~Object ()
 
void AggregateObject (Ptr< Object > other)
 
void Dispose (void)
 Run the DoDispose methods of this object and all the objects aggregated to it. More...
 
AggregateIterator GetAggregateIterator (void) const
 
virtual TypeId GetInstanceTypeId (void) const
 
template<typename T >
Ptr< T > GetObject (void) const
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 
void Initialize (void)
 This method calls the virtual DoInitialize method on all the objects aggregated to this object. More...
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Constructor. More...
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor. More...
 
uint32_t GetReferenceCount (void) const
 Get the reference count of the object. More...
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment. More...
 
void Ref (void) const
 Increment the reference count. More...
 
void Unref (void) 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
 
bool GetAttributeFailSafe (std::string name, AttributeValue &attribute) const
 
void SetAttribute (std::string name, const AttributeValue &value)
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 
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 ()
 Get the type ID. More...
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId (void)
 Register this type. More...
 
- Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
static void Cleanup (void)
 Noop. More...
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId (void)
 Get the type ID. More...
 

Protected Member Functions

virtual void DoDispose ()
 Dispose this object. More...
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 
virtual void DoInitialize (void)
 This method is called only once by Object::Initialize. More...
 
virtual void NotifyNewAggregate (void)
 This method is invoked whenever two sets of objects are aggregated together. More...
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 
virtual void NotifyConstructionCompleted (void)
 This method is invoked once all member attributes have been initialized. More...
 

Private Types

typedef std::list
< Ipv6InterfaceAddress
Ipv6InterfaceAddressList
 Container for the Ipv6InterfaceAddresses. More...
 
typedef std::list
< Ipv6InterfaceAddress >
::const_iterator 
Ipv6InterfaceAddressListCI
 Const Container Iterator for the Ipv6InterfaceAddresses. More...
 
typedef std::list
< Ipv6InterfaceAddress >
::iterator 
Ipv6InterfaceAddressListI
 Container Iterator for the Ipv6InterfaceAddresses. More...
 

Private Member Functions

void DoSetup ()
 Initialize interface. More...
 

Private Attributes

Ipv6InterfaceAddressList m_addresses
 The addresses assigned to this interface. More...
 
uint16_t m_baseReachableTime
 Base value used for computing the random reachable time value (in millisecond). More...
 
uint8_t m_curHopLimit
 Current hop limit. More...
 
Ptr< NetDevicem_device
 NetDevice associated with this interface. More...
 
bool m_forwarding
 Forwarding state. More...
 
bool m_ifup
 The state of this interface. More...
 
uint16_t m_metric
 The metric. More...
 
Ptr< NdiscCachem_ndCache
 Neighbor cache. More...
 
Ptr< Nodem_node
 Node associated with this interface. More...
 
uint16_t m_reachableTime
 Reachable time (in millisecond). More...
 
uint16_t m_retransTimer
 Retransmission timer (in millisecond). More...
 

Detailed Description

The IPv6 representation of a network interface.

Config Paths

ns3::Ipv6Interface is accessible through the following paths with Config::Set and Config::Connect:

  • /NodeList/[i]/$ns3::Ipv6L3Protocol/InterfaceList/[i]

No Attributes are defined for this type.
No TraceSources are defined for this type.

By default IPv6 interfaces are created in the "down" state with IP "fe80::1" and a /64 prefix. Before becoming usable, the user must invoke SetUp on them once the final IPv6 address and mask has been set.

Definition at line 49 of file ipv6-interface.h.

Member Typedef Documentation

Container for the Ipv6InterfaceAddresses.

Definition at line 263 of file ipv6-interface.h.

Const Container Iterator for the Ipv6InterfaceAddresses.

Definition at line 273 of file ipv6-interface.h.

Container Iterator for the Ipv6InterfaceAddresses.

Definition at line 268 of file ipv6-interface.h.

Constructor & Destructor Documentation

ns3::Ipv6Interface::Ipv6Interface ( )

Constructs an Ipv6Interface.

Definition at line 49 of file ipv6-interface.cc.

References NS_LOG_FUNCTION.

ns3::Ipv6Interface::~Ipv6Interface ( )
virtual

Destructor.

Definition at line 64 of file ipv6-interface.cc.

References NS_LOG_FUNCTION_NOARGS.

Member Function Documentation

bool ns3::Ipv6Interface::AddAddress ( Ipv6InterfaceAddress  iface)

Add an IPv6 address.

Parameters
ifaceaddress to add
Returns
true if address was added, false otherwise

Definition at line 204 of file ipv6-interface.cc.

References ns3::Icmpv6L4Protocol::DoDAD(), ns3::Icmpv6L4Protocol::FunctionDadTimeout(), ns3::Ipv6InterfaceAddress::GetAddress(), ns3::Object::GetObject(), ns3::Icmpv6L4Protocol::GetStaticProtocolNumber(), ns3::Ipv6Address::IsAny(), ns3::Ipv6Address::IsLocalhost(), m_addresses, m_node, NS_LOG_FUNCTION_NOARGS, and ns3::Simulator::Schedule().

Referenced by ns3::Ipv6L3Protocol::AddAddress(), and DoSetup().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Ipv6Interface::DoDispose ( void  )
protectedvirtual

Dispose this object.

Reimplemented from ns3::Object.

Definition at line 69 of file ipv6-interface.cc.

References ns3::Object::DoDispose(), m_device, m_ndCache, m_node, and NS_LOG_FUNCTION_NOARGS.

+ Here is the call graph for this function:

Ipv6InterfaceAddress ns3::Ipv6Interface::GetAddress ( uint32_t  index) const

Get an address from IPv6 interface.

Parameters
indexindex
Returns
Ipv6InterfaceAddress address whose index is i

Definition at line 262 of file ipv6-interface.cc.

References m_addresses, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

Referenced by ns3::Icmpv6L4Protocol::FunctionDadTimeout(), ns3::Ipv6L3Protocol::GetAddress(), ns3::Icmpv6L4Protocol::HandleNA(), ns3::Icmpv6L4Protocol::HandleNS(), and ns3::Ipv6L3Protocol::RemoveAutoconfiguredAddress().

+ Here is the caller graph for this function:

Ipv6InterfaceAddress ns3::Ipv6Interface::GetAddressMatchingDestination ( Ipv6Address  dst)

Get an address which is in the same network prefix as destination.

Parameters
dstdestination address
Returns
Corresponding Ipv6InterfaceAddress or assert if not found

Definition at line 340 of file ipv6-interface.cc.

References ns3::Ipv6InterfaceAddress::GetAddress(), ns3::Ipv6InterfaceAddress::GetPrefix(), ns3::Ipv6Prefix::IsMatch(), m_addresses, and NS_LOG_FUNCTION.

Referenced by ns3::Icmpv6L4Protocol::Lookup().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

uint16_t ns3::Ipv6Interface::GetBaseReachableTime ( ) const

Get the base reachable time.

Returns
base reachable time

Definition at line 448 of file ipv6-interface.cc.

References m_baseReachableTime, and NS_LOG_FUNCTION_NOARGS.

uint8_t ns3::Ipv6Interface::GetCurHopLimit ( ) const

Get the current hop limit value.

Returns
current hop limit

Definition at line 436 of file ipv6-interface.cc.

References m_curHopLimit, and NS_LOG_FUNCTION_NOARGS.

Ipv6InterfaceAddress ns3::Ipv6Interface::GetLinkLocalAddress ( ) const

Get link-local address from IPv6 interface.

Returns
link-local Ipv6InterfaceAddress, assert if not found

Definition at line 245 of file ipv6-interface.cc.

References m_addresses, NS_ASSERT_MSG, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::Icmpv6L4Protocol::HandleEchoRequest(), ns3::Icmpv6L4Protocol::HandleNS(), ns3::Ipv6L3Protocol::IpForward(), and ns3::Icmpv6L4Protocol::Lookup().

+ Here is the caller graph for this function:

uint16_t ns3::Ipv6Interface::GetMetric ( void  ) const

Get the metric.

Returns
the metric

Definition at line 155 of file ipv6-interface.cc.

References m_metric, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::Ipv6L3Protocol::GetMetric().

+ Here is the caller graph for this function:

uint32_t ns3::Ipv6Interface::GetNAddresses ( void  ) const

Get number of addresses on this IPv6 interface.

Returns
number of address

Definition at line 284 of file ipv6-interface.cc.

References m_addresses, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::Icmpv6L4Protocol::FunctionDadTimeout(), ns3::Ipv6L3Protocol::GetNAddresses(), ns3::Icmpv6L4Protocol::HandleNA(), ns3::Icmpv6L4Protocol::HandleNS(), ns3::Icmpv6L4Protocol::Lookup(), and ns3::Ipv6L3Protocol::RemoveAutoconfiguredAddress().

+ Here is the caller graph for this function:

uint16_t ns3::Ipv6Interface::GetReachableTime ( ) const

Get the reachable time.

Returns
reachable time

Definition at line 460 of file ipv6-interface.cc.

References m_reachableTime, and NS_LOG_FUNCTION_NOARGS.

uint16_t ns3::Ipv6Interface::GetRetransTimer ( ) const

Get the retransmission timer.

Returns
retransmission timer

Definition at line 472 of file ipv6-interface.cc.

References m_retransTimer, and NS_LOG_FUNCTION_NOARGS.

TypeId ns3::Ipv6Interface::GetTypeId ( void  )
static

Get the type ID.

Returns
type ID

Definition at line 41 of file ipv6-interface.cc.

References ns3::TypeId::SetParent().

+ Here is the call graph for this function:

bool ns3::Ipv6Interface::IsDown ( void  ) const

Is the interface DOWN ?

Returns
true if interface is disabled, false otherwise.

Definition at line 167 of file ipv6-interface.cc.

References m_ifup, and NS_LOG_FUNCTION_NOARGS.

bool ns3::Ipv6Interface::IsForwarding ( void  ) const

If the interface allows forwarding packets.

Returns
true if forwarding is enabled, false otherwise

Definition at line 192 of file ipv6-interface.cc.

References m_forwarding, and NS_LOG_FUNCTION_NOARGS.

bool ns3::Ipv6Interface::IsUp ( void  ) const

Is the interface UP ?

Returns
true if interface is enabled, false otherwise.

Definition at line 161 of file ipv6-interface.cc.

References m_ifup, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::Ipv6L3Protocol::IsUp(), ns3::Ipv6L3Protocol::Receive(), and Send().

+ Here is the caller graph for this function:

Ipv6InterfaceAddress ns3::Ipv6Interface::RemoveAddress ( uint32_t  index)

Remove an address from interface.

Parameters
indexindex to remove
Returns
Ipv6InterfaceAddress address whose index is index

Definition at line 290 of file ipv6-interface.cc.

References m_addresses, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

Ipv6InterfaceAddress ns3::Ipv6Interface::RemoveAddress ( Ipv6Address  address)

Remove the given Ipv6 address from the interface.

Parameters
addressThe Ipv6 address to remove
Returns
The removed Ipv6 interface address
The null interface address if the interface did not contain the address or if loopback address was passed as argument

Definition at line 318 of file ipv6-interface.cc.

References first::address, ns3::Ipv6Address::GetLoopback(), m_addresses, NS_LOG_FUNCTION, and NS_LOG_WARN.

+ Here is the call graph for this function:

void ns3::Ipv6Interface::Send ( Ptr< Packet p,
Ipv6Address  dest 
)

Send a packet through this interface.

Parameters
ppacket to send
destnext hop address of packet.
Note
This method will eventually call the private SendTo method which must be implemented by subclasses.
Todo:
additional checks needed here (such as whether multicast goes to loopback)?

Definition at line 359 of file ipv6-interface.cc.

References GetDevice(), ns3::Object::GetObject(), ns3::Ipv6Address::IsMulticast(), IsUp(), m_addresses, m_device, m_ndCache, m_node, NS_ASSERT, NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, ns3::NetDevice::PACKET_HOST, and ns3::Ipv6L3Protocol::PROT_NUMBER.

Referenced by ns3::Icmpv6L4Protocol::DoDAD(), ns3::Icmpv6L4Protocol::HandleNA(), ns3::Icmpv6L4Protocol::HandleNS(), and ns3::Icmpv6L4Protocol::ReceiveLLA().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Ipv6Interface::SetBaseReachableTime ( uint16_t  baseReachableTime)

Set the base reachable time.

Parameters
baseReachableTimethe value to set

Definition at line 442 of file ipv6-interface.cc.

References m_baseReachableTime, and NS_LOG_FUNCTION.

void ns3::Ipv6Interface::SetCurHopLimit ( uint8_t  curHopLimit)

Set the current hop limit.

Parameters
curHopLimitthe value to set

Definition at line 430 of file ipv6-interface.cc.

References m_curHopLimit, and NS_LOG_FUNCTION.

void ns3::Ipv6Interface::SetDevice ( Ptr< NetDevice device)

Set the NetDevice.

Parameters
deviceNetDevice

Definition at line 136 of file ipv6-interface.cc.

References DoSetup(), m_device, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

void ns3::Ipv6Interface::SetDown ( void  )

Disable this interface.

Definition at line 184 of file ipv6-interface.cc.

References ns3::NdiscCache::Flush(), m_addresses, m_ifup, m_ndCache, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::Ipv6L3Protocol::SetDown().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::Ipv6Interface::SetForwarding ( bool  forward)

Set forwarding enabled or not.

Parameters
forwardforwarding state

Definition at line 198 of file ipv6-interface.cc.

References m_forwarding, and NS_LOG_FUNCTION.

Referenced by ns3::Ipv6L3Protocol::SetForwarding().

+ Here is the caller graph for this function:

void ns3::Ipv6Interface::SetMetric ( uint16_t  metric)

Set the metric.

Parameters
metricconfigured routing metric (cost) of this interface

Definition at line 149 of file ipv6-interface.cc.

References m_metric, and NS_LOG_FUNCTION.

Referenced by ns3::Ipv6L3Protocol::SetMetric().

+ Here is the caller graph for this function:

void ns3::Ipv6Interface::SetNode ( Ptr< Node node)

Set node associated with interface.

Parameters
nodenode

Definition at line 129 of file ipv6-interface.cc.

References DoSetup(), m_node, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

void ns3::Ipv6Interface::SetNsDadUid ( Ipv6Address  address,
uint32_t  uid 
)

Update NS DAD packet UID of an interface address.

Parameters
addressIPv6 address
uidpacket UID

Definition at line 493 of file ipv6-interface.cc.

References first::address, m_addresses, and NS_LOG_FUNCTION.

Referenced by ns3::Icmpv6L4Protocol::DoDAD().

+ Here is the caller graph for this function:

void ns3::Ipv6Interface::SetReachableTime ( uint16_t  reachableTime)

Set the reachable time.

Parameters
reachableTimevalue to set

Definition at line 454 of file ipv6-interface.cc.

References m_reachableTime, and NS_LOG_FUNCTION.

void ns3::Ipv6Interface::SetRetransTimer ( uint16_t  retransTimer)

Set the retransmission timer.

Parameters
retransTimervalue to set

Definition at line 466 of file ipv6-interface.cc.

References m_retransTimer, and NS_LOG_FUNCTION.

void ns3::Ipv6Interface::SetState ( Ipv6Address  address,
Ipv6InterfaceAddress::State_e  state 
)

Update state of an interface address.

Parameters
addressIPv6 address
statenew state

Definition at line 478 of file ipv6-interface.cc.

References first::address, m_addresses, and NS_LOG_FUNCTION.

Referenced by ns3::Icmpv6L4Protocol::FunctionDadTimeout(), and ns3::Icmpv6L4Protocol::HandleNA().

+ Here is the caller graph for this function:

void ns3::Ipv6Interface::SetUp ( void  )

Enable this interface.

Definition at line 173 of file ipv6-interface.cc.

References m_ifup, and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::Ipv6L3Protocol::SetUp().

+ Here is the caller graph for this function:

Member Data Documentation

Ipv6InterfaceAddressList ns3::Ipv6Interface::m_addresses
private

The addresses assigned to this interface.

Definition at line 283 of file ipv6-interface.h.

Referenced by AddAddress(), GetAddress(), GetAddressMatchingDestination(), GetLinkLocalAddress(), GetNAddresses(), RemoveAddress(), Send(), SetDown(), SetNsDadUid(), and SetState().

uint16_t ns3::Ipv6Interface::m_baseReachableTime
private

Base value used for computing the random reachable time value (in millisecond).

Definition at line 323 of file ipv6-interface.h.

Referenced by GetBaseReachableTime(), and SetBaseReachableTime().

uint8_t ns3::Ipv6Interface::m_curHopLimit
private

Current hop limit.

Definition at line 318 of file ipv6-interface.h.

Referenced by GetCurHopLimit(), and SetCurHopLimit().

Ptr<NetDevice> ns3::Ipv6Interface::m_device
private

NetDevice associated with this interface.

Definition at line 308 of file ipv6-interface.h.

Referenced by DoDispose(), DoSetup(), GetDevice(), Send(), and SetDevice().

bool ns3::Ipv6Interface::m_forwarding
private

Forwarding state.

Definition at line 293 of file ipv6-interface.h.

Referenced by IsForwarding(), and SetForwarding().

bool ns3::Ipv6Interface::m_ifup
private

The state of this interface.

Definition at line 288 of file ipv6-interface.h.

Referenced by IsDown(), IsUp(), SetDown(), and SetUp().

uint16_t ns3::Ipv6Interface::m_metric
private

The metric.

Definition at line 298 of file ipv6-interface.h.

Referenced by GetMetric(), and SetMetric().

Ptr<NdiscCache> ns3::Ipv6Interface::m_ndCache
private

Neighbor cache.

Definition at line 313 of file ipv6-interface.h.

Referenced by DoDispose(), DoSetup(), Send(), and SetDown().

Ptr<Node> ns3::Ipv6Interface::m_node
private

Node associated with this interface.

Definition at line 303 of file ipv6-interface.h.

Referenced by AddAddress(), DoDispose(), DoSetup(), Send(), and SetNode().

uint16_t ns3::Ipv6Interface::m_reachableTime
private

Reachable time (in millisecond).

The time a neighbor is considered reachable after receiving a reachability confirmation.

Definition at line 329 of file ipv6-interface.h.

Referenced by GetReachableTime(), and SetReachableTime().

uint16_t ns3::Ipv6Interface::m_retransTimer
private

Retransmission timer (in millisecond).

Time between retransmission of NS.

Definition at line 335 of file ipv6-interface.h.

Referenced by GetRetransTimer(), and SetRetransTimer().


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