A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
ns3::Ipv6L3Protocol Class Reference

IPv6 layer implementation. More...

#include "ipv6-l3-protocol.h"

+ Inheritance diagram for ns3::Ipv6L3Protocol:
+ Collaboration diagram for ns3::Ipv6L3Protocol:

Public Types

enum  DropReason {
  DROP_TTL_EXPIRED = 1 , DROP_NO_ROUTE , DROP_INTERFACE_DOWN , DROP_ROUTE_ERROR ,
  DROP_UNKNOWN_PROTOCOL , DROP_UNKNOWN_OPTION , DROP_MALFORMED_HEADER , DROP_FRAGMENT_TIMEOUT
}
 Reason why a packet has been dropped. More...
 
typedef void(* DropTracedCallback) (const Ipv6Header &header, Ptr< const Packet > packet, DropReason reason, Ptr< Ipv6 > ipv6, uint32_t interface)
 TracedCallback signature for packet drop events.
 
typedef void(* SentTracedCallback) (const Ipv6Header &header, Ptr< const Packet > packet, uint32_t interface)
 TracedCallback signature for packet sent, forwarded or local-delivered events.
 
typedef void(* TxRxTracedCallback) (Ptr< const Packet > packet, Ptr< Ipv6 > ipv6, uint32_t interface)
 TracedCallback signature for packet transmission or reception events.
 

Public Member Functions

 Ipv6L3Protocol ()
 Constructor.
 
 Ipv6L3Protocol (const Ipv6L3Protocol &)=delete
 
 ~Ipv6L3Protocol () override
 Destructor.
 
bool AddAddress (uint32_t i, Ipv6InterfaceAddress address, bool addOnLinkRoute=true) override
 Add an address on interface.
 
void AddAutoconfiguredAddress (uint32_t interface, Ipv6Address network, Ipv6Prefix mask, uint8_t flags, uint32_t validTime, uint32_t preferredTime, Ipv6Address defaultRouter=Ipv6Address::GetZero())
 Add an autoconfigured address with RA information.
 
uint32_t AddInterface (Ptr< NetDevice > device) override
 Add IPv6 interface for a device.
 
void AddMulticastAddress (Ipv6Address address)
 Adds a multicast address to the list of addresses to pass to local deliver.
 
void AddMulticastAddress (Ipv6Address address, uint32_t interface)
 Adds a multicast address to the list of addresses to pass to local deliver.
 
Ptr< SocketCreateRawSocket ()
 Create raw IPv6 socket.
 
void DeleteRawSocket (Ptr< Socket > socket)
 Remove raw IPv6 socket.
 
Ipv6InterfaceAddress GetAddress (uint32_t interfaceIndex, uint32_t addressIndex) const override
 Get an address.
 
Ptr< Icmpv6L4ProtocolGetIcmpv6 () const
 Get ICMPv6 protocol.
 
Ptr< Ipv6InterfaceGetInterface (uint32_t i) const
 Get an interface.
 
int32_t GetInterfaceForAddress (Ipv6Address addr) const override
 Get interface index which has specified IPv6 address.
 
int32_t GetInterfaceForDevice (Ptr< const NetDevice > device) const override
 Get interface index which is on a specified net device.
 
int32_t GetInterfaceForPrefix (Ipv6Address addr, Ipv6Prefix mask) const override
 Get interface index which match specified address/prefix.
 
uint16_t GetMetric (uint32_t i) const override
 Get metric for an interface.
 
uint16_t GetMtu (uint32_t i) const override
 Get MTU for an interface.
 
uint32_t GetNAddresses (uint32_t interface) const override
 Get number of address for an interface.
 
Ptr< NetDeviceGetNetDevice (uint32_t i) override
 Get device by index.
 
uint32_t GetNInterfaces () const override
 Get current number of interface on this stack.
 
Ptr< IpL4ProtocolGetProtocol (int protocolNumber) const override
 Get L4 protocol by protocol number.
 
Ptr< IpL4ProtocolGetProtocol (int protocolNumber, int32_t interfaceIndex) const override
 Get L4 protocol by protocol number for the specified interface.
 
Ptr< Ipv6RoutingProtocolGetRoutingProtocol () const override
 Get current routing protocol used.
 
void Insert (Ptr< IpL4Protocol > protocol) override
 Add a L4 protocol.
 
void Insert (Ptr< IpL4Protocol > protocol, uint32_t interfaceIndex) override
 Add a L4 protocol to a specific interface.
 
bool IsForwarding (uint32_t i) const override
 Is interface allows forwarding ?
 
bool IsRegisteredMulticastAddress (Ipv6Address address) const
 Checks if the address has been registered.
 
bool IsRegisteredMulticastAddress (Ipv6Address address, uint32_t interface) const
 Checks if the address has been registered for a specific interface.
 
bool IsUp (uint32_t i) const override
 Is specified interface up ?
 
Ipv6L3Protocoloperator= (const Ipv6L3Protocol &)=delete
 
bool ReachabilityHint (uint32_t ipInterfaceIndex, Ipv6Address address)
 Provides reachability hint for Neighbor Cache Entries from L4-L7 protocols.
 
void Receive (Ptr< NetDevice > device, Ptr< const Packet > p, uint16_t protocol, const Address &from, const Address &to, NetDevice::PacketType packetType)
 Receive method when a packet arrive in the stack.
 
void RegisterExtensions () override
 Register the IPv6 Extensions.
 
void RegisterOptions () override
 Register the IPv6 Options.
 
void Remove (Ptr< IpL4Protocol > protocol) override
 Remove a L4 protocol.
 
void Remove (Ptr< IpL4Protocol > protocol, uint32_t interfaceIndex) override
 Remove a L4 protocol from a specific interface.
 
bool RemoveAddress (uint32_t interfaceIndex, Ipv6Address address) override
 Remove a specified Ipv6 address from an interface.
 
bool RemoveAddress (uint32_t interfaceIndex, uint32_t addressIndex) override
 Remove an address from an interface.
 
void RemoveAutoconfiguredAddress (uint32_t interface, Ipv6Address network, Ipv6Prefix mask, Ipv6Address defaultRouter)
 Remove an autoconfigured address.
 
void RemoveMulticastAddress (Ipv6Address address)
 Removes a multicast address from the list of addresses to pass to local deliver.
 
void RemoveMulticastAddress (Ipv6Address address, uint32_t interface)
 Removes a multicast address from the list of addresses to pass to local deliver.
 
virtual void ReportDrop (Ipv6Header ipHeader, Ptr< Packet > p, DropReason dropReason)
 Report a packet drop.
 
void Send (Ptr< Packet > packet, Ipv6Address source, Ipv6Address destination, uint8_t protocol, Ptr< Ipv6Route > route) override
 Higher-level layers call this method to send a packet down the stack to the MAC and PHY layers.
 
void SetDefaultTclass (uint8_t tclass)
 Set the default TCLASS.
 
void SetDefaultTtl (uint8_t ttl)
 Set the default TTL.
 
void SetDown (uint32_t i) override
 set an interface down.
 
void SetForwarding (uint32_t i, bool val) override
 Enable or disable forwarding on interface.
 
void SetMetric (uint32_t i, uint16_t metric) override
 Set metric for an interface.
 
void SetNode (Ptr< Node > node)
 Set node associated with this stack.
 
void SetPmtu (Ipv6Address dst, uint32_t pmtu) override
 Set the Path MTU for the specified IPv6 destination address.
 
void SetRoutingProtocol (Ptr< Ipv6RoutingProtocol > routingProtocol) override
 Set routing protocol for this stack.
 
void SetUp (uint32_t i) override
 Set an interface up.
 
Ipv6Address SourceAddressSelection (uint32_t interface, Ipv6Address dest) override
 Choose the source address to use with destination address.
 
- Public Member Functions inherited from ns3::Ipv6
 Ipv6 ()
 Constructor.
 
 ~Ipv6 () override
 Destructor.
 
- Public Member Functions inherited from ns3::Object
 Object ()
 Constructor.
 
 ~Object () override
 Destructor.
 
void AggregateObject (Ptr< Object > other)
 Aggregate two Objects together.
 
void Dispose ()
 Dispose of this Object.
 
AggregateIterator GetAggregateIterator () const
 Get an iterator to the Objects aggregated to this one.
 
TypeId GetInstanceTypeId () const override
 Get the most derived TypeId for this Object.
 
template<typename T >
Ptr< T > GetObject () const
 Get a pointer to the requested aggregated Object.
 
template<>
Ptr< ObjectGetObject () const
 Specialization of () for objects of type ns3::Object.
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 Get a pointer to the requested aggregated Object by TypeId.
 
template<>
Ptr< ObjectGetObject (TypeId tid) const
 Specialization of (TypeId tid) for objects of type ns3::Object.
 
void Initialize ()
 Invoke DoInitialize on all Objects aggregated to this one.
 
bool IsInitialized () const
 Check if the object has been initialized.
 
void UnidirectionalAggregateObject (Ptr< Object > other)
 Aggregate an Object to another Object.
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Default constructor.
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor.
 
uint32_t GetReferenceCount () const
 Get the reference count of the object.
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment operator.
 
void Ref () const
 Increment the reference count.
 
void Unref () const
 Decrement the reference count.
 
- Public Member Functions inherited from ns3::ObjectBase
virtual ~ObjectBase ()
 Virtual destructor.
 
void GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const
 Get the value of an attribute, raising fatal errors if unsuccessful.
 
bool GetAttributeFailSafe (std::string name, AttributeValue &value) const
 Get the value of an attribute without raising errors.
 
void SetAttribute (std::string name, const AttributeValue &value)
 Set a single attribute, raising fatal errors if unsuccessful.
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 Set a single attribute without raising errors.
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 Connect a TraceSource to a Callback with a context.
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 Connect a TraceSource to a Callback without a context.
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected with a context.
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 Disconnect from a TraceSource a Callback previously connected without a context.
 

Static Public Member Functions

static TypeId GetTypeId ()
 Get the type ID of this class.
 
- Static Public Member Functions inherited from ns3::Ipv6
static TypeId GetTypeId ()
 Get the type ID.
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId ()
 Register this type.
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId ()
 Get the type ID.
 

Static Public Attributes

static const uint16_t PROT_NUMBER = 0x86DD
 The protocol number for IPv6 (0x86DD).
 
- Static Public Attributes inherited from ns3::Ipv6
static const uint32_t IF_ANY = 0xffffffff
 Any interface magic number.
 

Protected Member Functions

void DoDispose () override
 Dispose object.
 
void NotifyNewAggregate () override
 Notify other components connected to the node that a new stack member is now connected.
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 Copy an Object.
 
virtual void DoInitialize ()
 Initialize() implementation.
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 Complete construction of ObjectBase; invoked by derived classes.
 
virtual void NotifyConstructionCompleted ()
 Notifier called once the ObjectBase is fully constructed.
 

Private Types

typedef std::list< Ptr< Ipv6AutoconfiguredPrefix > > Ipv6AutoconfiguredPrefixList
 Container of the IPv6 Autoconfigured addresses.
 
typedef std::list< Ptr< Ipv6AutoconfiguredPrefix > >::iterator Ipv6AutoconfiguredPrefixListI
 Iterator of the container of the IPv6 Autoconfigured addresses.
 
typedef std::vector< Ptr< Ipv6Interface > > Ipv6InterfaceList
 Container of the IPv6 Interfaces.
 
typedef std::map< Ptr< const NetDevice >, uint32_tIpv6InterfaceReverseContainer
 Container of NetDevices registered to IPv6 and their interface indexes.
 
typedef std::map< Ipv6RegisteredMulticastAddressKey_t, uint32_tIpv6RegisteredMulticastAddress_t
 Container of the IPv6 multicast addresses.
 
typedef std::map< Ipv6RegisteredMulticastAddressKey_t, uint32_t >::const_iterator Ipv6RegisteredMulticastAddressCIter_t
 Container Const Iterator of the IPv6 multicast addresses.
 
typedef std::map< Ipv6RegisteredMulticastAddressKey_t, uint32_t >::iterator Ipv6RegisteredMulticastAddressIter_t
 Container Iterator of the IPv6 multicast addresses.
 
typedef std::pair< Ipv6Address, uint64_t > Ipv6RegisteredMulticastAddressKey_t
 IPv6 multicast addresses / interface key.
 
typedef std::map< Ipv6Address, uint32_tIpv6RegisteredMulticastAddressNoInterface_t
 Container of the IPv6 multicast addresses.
 
typedef std::map< Ipv6Address, uint32_t >::const_iterator Ipv6RegisteredMulticastAddressNoInterfaceCIter_t
 Container Const Iterator of the IPv6 multicast addresses.
 
typedef std::map< Ipv6Address, uint32_t >::iterator Ipv6RegisteredMulticastAddressNoInterfaceIter_t
 Container Iterator of the IPv6 multicast addresses.
 
typedef std::map< L4ListKey_t, Ptr< IpL4Protocol > > L4List_t
 Container of the IPv6 L4 instances.
 
typedef std::pair< int, int32_tL4ListKey_t
 Container of the IPv6 L4 keys: protocol number, interface index.
 
typedef std::list< Ptr< Ipv6RawSocketImpl > > SocketList
 Container of the IPv6 Raw Sockets.
 

Private Member Functions

uint32_t AddIpv6Interface (Ptr< Ipv6Interface > interface)
 Add an IPv6 interface to the stack.
 
Ipv6Header BuildHeader (Ipv6Address src, Ipv6Address dst, uint8_t protocol, uint16_t payloadSize, uint8_t hopLimit, uint8_t tclass)
 Construct an IPv6 header.
 
void CallTxTrace (const Ipv6Header &ipHeader, Ptr< Packet > packet, Ptr< Ipv6 > ipv6, uint32_t interface)
 Make a copy of the packet, add the header and invoke the TX trace callback.
 
bool GetIpForward () const override
 Get IPv6 forwarding state.
 
bool GetMtuDiscover () const override
 Get IPv6 MTU discover state.
 
virtual bool GetSendIcmpv6Redirect () const
 Get the ICMPv6 Redirect sending state.
 
bool GetStrongEndSystemModel () const override
 Get the Strong End System Model status.
 
void IpForward (Ptr< const NetDevice > idev, Ptr< Ipv6Route > rtentry, Ptr< const Packet > p, const Ipv6Header &header)
 Forward a packet.
 
void IpMulticastForward (Ptr< const NetDevice > idev, Ptr< Ipv6MulticastRoute > mrtentry, Ptr< const Packet > p, const Ipv6Header &header)
 Forward a multicast packet.
 
void LocalDeliver (Ptr< const Packet > p, const Ipv6Header &ip, uint32_t iif)
 Deliver a packet.
 
void RouteInputError (Ptr< const Packet > p, const Ipv6Header &ipHeader, Socket::SocketErrno sockErrno)
 Fallback when no route is found.
 
void SendRealOut (Ptr< Ipv6Route > route, Ptr< Packet > packet, const Ipv6Header &ipHeader)
 Send packet with route.
 
void SetIpForward (bool forward) override
 Set IPv6 forwarding state.
 
void SetMtuDiscover (bool mtuDiscover) override
 Set IPv6 MTU discover state.
 
virtual void SetSendIcmpv6Redirect (bool sendIcmpv6Redirect)
 Set the ICMPv6 Redirect sending state.
 
void SetStrongEndSystemModel (bool model) override
 Set or unset the Strong End System Model.
 
void SetupLoopback ()
 Setup loopback interface.
 

Private Attributes

uint8_t m_defaultTclass
 Default TCLASS for outgoing packets.
 
uint8_t m_defaultTtl
 Default TTL for outgoing packets.
 
TracedCallback< const Ipv6Header &, Ptr< const Packet >, DropReason, Ptr< Ipv6 >, uint32_tm_dropTrace
 Callback to trace drop packets.
 
Ipv6RoutingProtocol::ErrorCallback m_ecb
 Error callback.
 
Ipv6InterfaceList m_interfaces
 List of IPv6 interfaces.
 
bool m_ipForward
 Forwarding packets (i.e.
 
Ipv6RoutingProtocol::LocalDeliverCallback m_lcb
 Local delivery callback.
 
TracedCallback< const Ipv6Header &, Ptr< const Packet >, uint32_tm_localDeliverTrace
 Trace of locally delivered packets.
 
Ipv6RoutingProtocol::MulticastForwardCallback m_mcb
 Multicast forward callback.
 
bool m_mtuDiscover
 MTU Discover (i.e.
 
Ipv6RegisteredMulticastAddress_t m_multicastAddresses
 List of multicast IP addresses of interest, divided per interface.
 
Ipv6RegisteredMulticastAddressNoInterface_t m_multicastAddressesNoInterface
 List of multicast IP addresses of interest for all the interfaces.
 
uint32_t m_nInterfaces
 Number of IPv6 interfaces managed by the stack.
 
Ptr< Nodem_node
 Node attached to stack.
 
Ptr< Ipv6PmtuCachem_pmtuCache
 Path MTU Cache.
 
Ipv6AutoconfiguredPrefixList m_prefixes
 List of IPv6 prefix received from RA.
 
L4List_t m_protocols
 List of transport protocol.
 
Ipv6InterfaceReverseContainer m_reverseInterfacesContainer
 Container of NetDevice / Interface index associations.
 
Ptr< Ipv6RoutingProtocolm_routingProtocol
 Routing protocol.
 
TracedCallback< Ptr< const Packet >, Ptr< Ipv6 >, uint32_tm_rxTrace
 Callback to trace RX (reception) packets.
 
bool m_sendIcmpv6Redirect
 Allow ICMPv6 Redirect sending state.
 
TracedCallback< const Ipv6Header &, Ptr< const Packet >, uint32_tm_sendOutgoingTrace
 Trace of sent packets.
 
SocketList m_sockets
 List of IPv6 raw sockets.
 
bool m_strongEndSystemModel
 Rejects packets directed to an interface with wrong address (RFC 1222 ).
 
TracedCallback< Ptr< const Packet >, Ptr< Ipv6 >, uint32_tm_txTrace
 Callback to trace TX (transmission) packets.
 
Ipv6RoutingProtocol::UnicastForwardCallback m_ucb
 Unicast forward callback.
 
TracedCallback< const Ipv6Header &, Ptr< const Packet >, uint32_tm_unicastForwardTrace
 Trace of unicast forwarded packets.
 

Friends

class ::Ipv6L3ProtocolTestCase
 Ipv6L3ProtocolTestCase test case.
 

Related Symbols

(Note that these are not member symbols.)

class Ipv6ExtensionLooseRouting
 Ipv6ExtensionLooseRouting.
 

Additional Inherited Members

Detailed Description

IPv6 layer implementation.

This class contains two distinct groups of trace sources. The trace sources 'Rx' and 'Tx' are called, respectively, immediately after receiving from the NetDevice and immediately before sending to a NetDevice for transmitting a packet. These are low level trace sources that include the Ipv6Header already serialized into the packet. In contrast, the Drop, SendOutgoing, UnicastForward, and LocalDeliver trace sources are slightly higher-level and pass around the Ipv6Header as an explicit parameter and not as part of the packet.

Definition at line 52 of file ipv6-l3-protocol.h.

Member Typedef Documentation

◆ DropTracedCallback

typedef void(* ns3::Ipv6L3Protocol::DropTracedCallback) (const Ipv6Header &header, Ptr< const Packet > packet, DropReason reason, Ptr< Ipv6 > ipv6, uint32_t interface)

TracedCallback signature for packet drop events.

Parameters
[in]headerthe Ipv6Header.
[in]packetthe packet.
[in]reasonthe reason the packet was dropped.
[in]ipv6the Ipv6 protocol
[in]interfacethe IP-level interface index
Deprecated
The non-const Ptr<Ipv6> argument is deprecated and will be changed to Ptr<const Ipv6> in a future release.

Definition at line 414 of file ipv6-l3-protocol.h.

◆ Ipv6AutoconfiguredPrefixList

Container of the IPv6 Autoconfigured addresses.

Definition at line 535 of file ipv6-l3-protocol.h.

◆ Ipv6AutoconfiguredPrefixListI

Iterator of the container of the IPv6 Autoconfigured addresses.

Definition at line 540 of file ipv6-l3-protocol.h.

◆ Ipv6InterfaceList

Container of the IPv6 Interfaces.

Definition at line 510 of file ipv6-l3-protocol.h.

◆ Ipv6InterfaceReverseContainer

Container of NetDevices registered to IPv6 and their interface indexes.

Definition at line 515 of file ipv6-l3-protocol.h.

◆ Ipv6RegisteredMulticastAddress_t

Container of the IPv6 multicast addresses.

Definition at line 791 of file ipv6-l3-protocol.h.

◆ Ipv6RegisteredMulticastAddressCIter_t

Container Const Iterator of the IPv6 multicast addresses.

Definition at line 803 of file ipv6-l3-protocol.h.

◆ Ipv6RegisteredMulticastAddressIter_t

Container Iterator of the IPv6 multicast addresses.

Definition at line 797 of file ipv6-l3-protocol.h.

◆ Ipv6RegisteredMulticastAddressKey_t

IPv6 multicast addresses / interface key.

Definition at line 785 of file ipv6-l3-protocol.h.

◆ Ipv6RegisteredMulticastAddressNoInterface_t

Container of the IPv6 multicast addresses.

Definition at line 808 of file ipv6-l3-protocol.h.

◆ Ipv6RegisteredMulticastAddressNoInterfaceCIter_t

Container Const Iterator of the IPv6 multicast addresses.

Definition at line 820 of file ipv6-l3-protocol.h.

◆ Ipv6RegisteredMulticastAddressNoInterfaceIter_t

Container Iterator of the IPv6 multicast addresses.

Definition at line 814 of file ipv6-l3-protocol.h.

◆ L4List_t

Container of the IPv6 L4 instances.

Definition at line 530 of file ipv6-l3-protocol.h.

◆ L4ListKey_t

typedef std::pair<int, int32_t> ns3::Ipv6L3Protocol::L4ListKey_t
private

Container of the IPv6 L4 keys: protocol number, interface index.

Definition at line 525 of file ipv6-l3-protocol.h.

◆ SentTracedCallback

typedef void(* ns3::Ipv6L3Protocol::SentTracedCallback) (const Ipv6Header &header, Ptr< const Packet > packet, uint32_t interface)

TracedCallback signature for packet sent, forwarded or local-delivered events.

Parameters
[in]headerthe Ipv6Header.
[in]packetthe packet.
[in]interfacethe IP-level interface index

Definition at line 384 of file ipv6-l3-protocol.h.

◆ SocketList

Container of the IPv6 Raw Sockets.

Definition at line 520 of file ipv6-l3-protocol.h.

◆ TxRxTracedCallback

typedef void(* ns3::Ipv6L3Protocol::TxRxTracedCallback) (Ptr< const Packet > packet, Ptr< Ipv6 > ipv6, uint32_t interface)

TracedCallback signature for packet transmission or reception events.

Parameters
[in]packetthe packet.
[in]ipv6the Ipv6 protocol
[in]interfacethe IP-level interface index
Deprecated
The non-const Ptr<Ipv6> argument is deprecated and will be changed to Ptr<const Ipv6> in a future release.

Definition at line 398 of file ipv6-l3-protocol.h.

Member Enumeration Documentation

◆ DropReason

Reason why a packet has been dropped.

Enumerator
DROP_TTL_EXPIRED 

Packet TTL has expired.

DROP_NO_ROUTE 

No route to host.

DROP_INTERFACE_DOWN 

Interface is down so can not send packet.

DROP_ROUTE_ERROR 

Route error.

DROP_UNKNOWN_PROTOCOL 

Unknown L4 protocol.

DROP_UNKNOWN_OPTION 

Unknown option.

DROP_MALFORMED_HEADER 

Malformed header.

DROP_FRAGMENT_TIMEOUT 

Fragment timeout.

Definition at line 70 of file ipv6-l3-protocol.h.

Constructor & Destructor Documentation

◆ Ipv6L3Protocol() [1/2]

ns3::Ipv6L3Protocol::Ipv6L3Protocol ( )

Constructor.

Definition at line 111 of file ipv6-l3-protocol.cc.

References ns3::Object::AggregateObject(), ns3::CreateObject(), IpForward(), IpMulticastForward(), LocalDeliver(), m_ecb, m_lcb, m_mcb, m_pmtuCache, m_ucb, ns3::MakeCallback(), NS_LOG_FUNCTION, and RouteInputError().

+ Here is the call graph for this function:

◆ ~Ipv6L3Protocol()

ns3::Ipv6L3Protocol::~Ipv6L3Protocol ( )
override

Destructor.

Definition at line 125 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION.

◆ Ipv6L3Protocol() [2/2]

ns3::Ipv6L3Protocol::Ipv6L3Protocol ( const Ipv6L3Protocol & )
delete

Member Function Documentation

◆ AddAddress()

bool ns3::Ipv6L3Protocol::AddAddress ( uint32_t i,
Ipv6InterfaceAddress address,
bool addOnLinkRoute = true )
overridevirtual

Add an address on interface.

Parameters
iinterface index
addressaddress to add
addOnLinkRouteadd on-link route to the network (default true)
Returns
true if the operation succeeded

Implements ns3::Ipv6.

Definition at line 415 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION.

Referenced by AddAutoconfiguredAddress().

+ Here is the caller graph for this function:

◆ AddAutoconfiguredAddress()

void ns3::Ipv6L3Protocol::AddAutoconfiguredAddress ( uint32_t interface,
Ipv6Address network,
Ipv6Prefix mask,
uint8_t flags,
uint32_t validTime,
uint32_t preferredTime,
Ipv6Address defaultRouter = Ipv6Address::GetZero() )

Add an autoconfigured address with RA information.

Parameters
interfaceinterface index
networknetwork prefix
masknetwork mask
flagsflags of the prefix information option (home agent, ...)
validTimevalid time of the prefix
preferredTimepreferred time of the prefix
defaultRouterdefault router address

Definition at line 301 of file ipv6-l3-protocol.cc.

References AddAddress(), ns3::Icmpv6OptionPrefixInformation::AUTADDRCONF, ns3::CreateObject(), ns3::Ipv6Address::GetAny(), ns3::Ipv6Interface::GetDevice(), GetInterface(), GetRoutingProtocol(), ns3::Ipv6Address::IsAny(), m_node, m_prefixes, m_routingProtocol, ns3::Ipv6Address::MakeAutoconfiguredAddress(), NS_LOG_FUNCTION, NS_LOG_INFO, and ns3::Icmpv6OptionPrefixInformation::ONLINK.

+ Here is the call graph for this function:

◆ AddInterface()

uint32_t ns3::Ipv6L3Protocol::AddInterface ( Ptr< NetDevice > device)
overridevirtual

Add IPv6 interface for a device.

Parameters
devicenet device
Returns
interface index

Implements ns3::Ipv6.

Definition at line 187 of file ipv6-l3-protocol.cc.

References AddIpv6Interface(), ns3::CreateObject(), ns3::Object::GetObject(), m_ipForward, m_node, ns3::MakeCallback(), NS_ASSERT, NS_LOG_FUNCTION, PROT_NUMBER, Receive(), ns3::TrafficControlLayer::Receive(), and ns3::Node::RegisterProtocolHandler().

+ Here is the call graph for this function:

◆ AddIpv6Interface()

uint32_t ns3::Ipv6L3Protocol::AddIpv6Interface ( Ptr< Ipv6Interface > interface)
private

Add an IPv6 interface to the stack.

Parameters
interfaceinterface to add
Returns
index of newly added interface

Definition at line 212 of file ipv6-l3-protocol.cc.

References m_interfaces, m_nInterfaces, m_reverseInterfacesContainer, and NS_LOG_FUNCTION.

Referenced by AddInterface(), and SetupLoopback().

+ Here is the caller graph for this function:

◆ AddMulticastAddress() [1/2]

void ns3::Ipv6L3Protocol::AddMulticastAddress ( Ipv6Address address)

Adds a multicast address to the list of addresses to pass to local deliver.

Parameters
addressthe address.

Definition at line 1695 of file ipv6-l3-protocol.cc.

References m_multicastAddressesNoInterface, NS_LOG_FUNCTION, and NS_LOG_WARN.

◆ AddMulticastAddress() [2/2]

void ns3::Ipv6L3Protocol::AddMulticastAddress ( Ipv6Address address,
uint32_t interface )

Adds a multicast address to the list of addresses to pass to local deliver.

Parameters
addressthe address.
interfacethe incoming interface.

Definition at line 1680 of file ipv6-l3-protocol.cc.

References m_multicastAddresses, NS_LOG_FUNCTION, and NS_LOG_WARN.

◆ BuildHeader()

Ipv6Header ns3::Ipv6L3Protocol::BuildHeader ( Ipv6Address src,
Ipv6Address dst,
uint8_t protocol,
uint16_t payloadSize,
uint8_t hopLimit,
uint8_t tclass )
private

Construct an IPv6 header.

Parameters
srcsource IPv6 address
dstdestination IPv6 address
protocolL4 protocol
payloadSizepayload size
hopLimitHop limit
tclassTclass
Returns
newly created IPv6 header

Definition at line 1586 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION, ns3::Ipv6Header::SetDestination(), ns3::Ipv6Header::SetHopLimit(), ns3::Ipv6Header::SetNextHeader(), ns3::Ipv6Header::SetPayloadLength(), ns3::Ipv6Header::SetSource(), and ns3::Ipv6Header::SetTrafficClass().

Referenced by Send().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ CallTxTrace()

void ns3::Ipv6L3Protocol::CallTxTrace ( const Ipv6Header & ipHeader,
Ptr< Packet > packet,
Ptr< Ipv6 > ipv6,
uint32_t interface )
private

Make a copy of the packet, add the header and invoke the TX trace callback.

Parameters
ipHeaderthe IP header that will be added to the packet
packetthe packet
ipv6the Ipv6 protocol
interfacethe IP-level interface index

Note: If the TracedCallback API ever is extended, we could consider to check for connected functions before adding the header

Definition at line 1159 of file ipv6-l3-protocol.cc.

References m_txTrace.

◆ CreateRawSocket()

Ptr< Socket > ns3::Ipv6L3Protocol::CreateRawSocket ( )

Create raw IPv6 socket.

Returns
newly raw socket

Definition at line 849 of file ipv6-l3-protocol.cc.

References ns3::CreateObject(), m_node, m_sockets, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ DeleteRawSocket()

void ns3::Ipv6L3Protocol::DeleteRawSocket ( Ptr< Socket > socket)

Remove raw IPv6 socket.

Parameters
socketsocket to remove

Definition at line 859 of file ipv6-l3-protocol.cc.

References m_sockets, and NS_LOG_FUNCTION.

◆ DoDispose()

void ns3::Ipv6L3Protocol::DoDispose ( )
overrideprotectedvirtual

Dispose object.

Reimplemented from ns3::Object.

Definition at line 131 of file ipv6-l3-protocol.cc.

References ns3::Object::DoDispose(), m_interfaces, m_node, m_pmtuCache, m_prefixes, m_protocols, m_reverseInterfacesContainer, m_routingProtocol, m_sockets, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ GetAddress()

Ipv6InterfaceAddress ns3::Ipv6L3Protocol::GetAddress ( uint32_t interfaceIndex,
uint32_t addressIndex ) const
overridevirtual

Get an address.

Parameters
interfaceIndexinterface index
addressIndexaddress index on the interface
Returns
Ipv6InterfaceAddress or assert if not found

Implements ns3::Ipv6.

Definition at line 447 of file ipv6-l3-protocol.cc.

Referenced by UanExperiment::SendPackets(), and SourceAddressSelection().

+ Here is the caller graph for this function:

◆ GetIcmpv6()

Ptr< Icmpv6L4Protocol > ns3::Ipv6L3Protocol::GetIcmpv6 ( ) const

Get ICMPv6 protocol.

Returns
Icmpv6L4Protocol pointer

Definition at line 874 of file ipv6-l3-protocol.cc.

References GetProtocol(), and ns3::Icmpv6L4Protocol::GetStaticProtocolNumber().

Referenced by IpForward(), LocalDeliver(), and RouteInputError().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ GetInterface()

Ptr< Ipv6Interface > ns3::Ipv6L3Protocol::GetInterface ( uint32_t i) const

Get an interface.

Parameters
iinterface index
Returns
IPv6 interface pointer

Definition at line 224 of file ipv6-l3-protocol.cc.

References m_interfaces.

Referenced by AddAutoconfiguredAddress(), GetNetDevice(), IpForward(), LocalDeliver(), and RemoveAutoconfiguredAddress().

+ Here is the caller graph for this function:

◆ GetInterfaceForAddress()

int32_t ns3::Ipv6L3Protocol::GetInterfaceForAddress ( Ipv6Address addr) const
overridevirtual

Get interface index which has specified IPv6 address.

Parameters
addrIPv6 address
Returns
interface index or -1 if not found

Implements ns3::Ipv6.

Definition at line 240 of file ipv6-l3-protocol.cc.

References m_interfaces.

Referenced by Send().

+ Here is the caller graph for this function:

◆ GetInterfaceForDevice()

int32_t ns3::Ipv6L3Protocol::GetInterfaceForDevice ( Ptr< const NetDevice > device) const
overridevirtual

Get interface index which is on a specified net device.

Parameters
devicenet device
Returns
the interface index

Implements ns3::Ipv6.

Definition at line 289 of file ipv6-l3-protocol.cc.

References m_reverseInterfacesContainer.

Referenced by IpForward(), Receive(), and Send().

+ Here is the caller graph for this function:

◆ GetInterfaceForPrefix()

int32_t ns3::Ipv6L3Protocol::GetInterfaceForPrefix ( Ipv6Address addr,
Ipv6Prefix mask ) const
overridevirtual

Get interface index which match specified address/prefix.

Parameters
addrIPv6 address
maskIPv6 prefix (mask)
Returns
interface index or -1 if not found

Implements ns3::Ipv6.

Definition at line 262 of file ipv6-l3-protocol.cc.

References m_interfaces.

◆ GetIpForward()

bool ns3::Ipv6L3Protocol::GetIpForward ( ) const
overrideprivatevirtual

Get IPv6 forwarding state.

Returns
forwarding state (enabled or not)

Implements ns3::Ipv6.

Definition at line 696 of file ipv6-l3-protocol.cc.

References m_ipForward.

◆ GetMetric()

uint16_t ns3::Ipv6L3Protocol::GetMetric ( uint32_t i) const
overridevirtual

Get metric for an interface.

Parameters
iindex
Returns
metric

Implements ns3::Ipv6.

Definition at line 503 of file ipv6-l3-protocol.cc.

◆ GetMtu()

uint16_t ns3::Ipv6L3Protocol::GetMtu ( uint32_t i) const
overridevirtual

Get MTU for an interface.

Parameters
iindex
Returns
MTU

Implements ns3::Ipv6.

Definition at line 510 of file ipv6-l3-protocol.cc.

References IPV6_MIN_MTU, and m_mtuDiscover.

◆ GetMtuDiscover()

bool ns3::Ipv6L3Protocol::GetMtuDiscover ( ) const
overrideprivatevirtual

Get IPv6 MTU discover state.

Returns
MTU discover state (enabled or not)

Implements ns3::Ipv6.

Definition at line 709 of file ipv6-l3-protocol.cc.

References m_mtuDiscover.

◆ GetNAddresses()

uint32_t ns3::Ipv6L3Protocol::GetNAddresses ( uint32_t interface) const
overridevirtual

Get number of address for an interface.

Parameters
interfaceinterface index
Returns
number of address

Implements ns3::Ipv6.

Definition at line 440 of file ipv6-l3-protocol.cc.

Referenced by SourceAddressSelection().

+ Here is the caller graph for this function:

◆ GetNetDevice()

Ptr< NetDevice > ns3::Ipv6L3Protocol::GetNetDevice ( uint32_t i)
overridevirtual

Get device by index.

Parameters
idevice index on this stack
Returns
NetDevice pointer

Implements ns3::Ipv6.

Definition at line 283 of file ipv6-l3-protocol.cc.

References ns3::Ipv6Interface::GetDevice(), and GetInterface().

Referenced by IpMulticastForward(), and Send().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ GetNInterfaces()

uint32_t ns3::Ipv6L3Protocol::GetNInterfaces ( ) const
overridevirtual

Get current number of interface on this stack.

Returns
number of interface registered

Implements ns3::Ipv6.

Definition at line 234 of file ipv6-l3-protocol.cc.

References m_nInterfaces.

◆ GetProtocol() [1/2]

Ptr< IpL4Protocol > ns3::Ipv6L3Protocol::GetProtocol ( int protocolNumber) const
overridevirtual

Get L4 protocol by protocol number.

Parameters
protocolNumberprotocol number
Returns
corresponding IpL4Protocol or 0 if not found

Implements ns3::Ipv6.

Definition at line 819 of file ipv6-l3-protocol.cc.

References GetProtocol().

Referenced by GetIcmpv6(), GetProtocol(), and LocalDeliver().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ GetProtocol() [2/2]

Ptr< IpL4Protocol > ns3::Ipv6L3Protocol::GetProtocol ( int protocolNumber,
int32_t interfaceIndex ) const
overridevirtual

Get L4 protocol by protocol number for the specified interface.

Parameters
protocolNumberprotocol number
interfaceIndexinterface index, -1 means "any" interface.
Returns
corresponding IpL4Protocol or 0 if not found

Implements ns3::Ipv6.

Definition at line 825 of file ipv6-l3-protocol.cc.

References m_protocols.

◆ GetRoutingProtocol()

Ptr< Ipv6RoutingProtocol > ns3::Ipv6L3Protocol::GetRoutingProtocol ( ) const
overridevirtual

Get current routing protocol used.

Returns
routing protocol

Implements ns3::Ipv6.

Definition at line 181 of file ipv6-l3-protocol.cc.

References m_routingProtocol.

Referenced by AddAutoconfiguredAddress(), and RemoveAutoconfiguredAddress().

+ Here is the caller graph for this function:

◆ GetSendIcmpv6Redirect()

bool ns3::Ipv6L3Protocol::GetSendIcmpv6Redirect ( ) const
privatevirtual

Get the ICMPv6 Redirect sending state.

Returns
ICMPv6 Redirect sending state (enabled or not)

Definition at line 722 of file ipv6-l3-protocol.cc.

References m_sendIcmpv6Redirect.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ GetStrongEndSystemModel()

bool ns3::Ipv6L3Protocol::GetStrongEndSystemModel ( ) const
overrideprivatevirtual

Get the Strong End System Model status.

RFC1122 term for whether host rejects datagram with a dest. address on another interface

Returns
true for Strong End System Model activated

Implements ns3::Ipv6.

Definition at line 1808 of file ipv6-l3-protocol.cc.

References m_strongEndSystemModel.

◆ GetTypeId()

TypeId ns3::Ipv6L3Protocol::GetTypeId ( )
static

◆ Insert() [1/2]

void ns3::Ipv6L3Protocol::Insert ( Ptr< IpL4Protocol > protocol)
overridevirtual

Add a L4 protocol.

Parameters
protocolL4 protocol

Implements ns3::Ipv6.

Definition at line 756 of file ipv6-l3-protocol.cc.

References m_protocols, NS_LOG_FUNCTION, and NS_LOG_WARN.

◆ Insert() [2/2]

void ns3::Ipv6L3Protocol::Insert ( Ptr< IpL4Protocol > protocol,
uint32_t interfaceIndex )
overridevirtual

Add a L4 protocol to a specific interface.

This may be called multiple times for multiple interfaces for the same protocol. To insert for all interfaces, use the separate Insert (Ptr<IpL4Protocol> protocol) method.

Setting a protocol on a specific interface will overwrite the previously bound protocol.

Parameters
protocolL4 protocol.
interfaceIndexinterface index.

Implements ns3::Ipv6.

Definition at line 768 of file ipv6-l3-protocol.cc.

References m_protocols, NS_LOG_FUNCTION, and NS_LOG_WARN.

◆ IpForward()

void ns3::Ipv6L3Protocol::IpForward ( Ptr< const NetDevice > idev,
Ptr< Ipv6Route > rtentry,
Ptr< const Packet > p,
const Ipv6Header & header )
private

Forward a packet.

Parameters
idevPointer to ingress network device
rtentryroute
ppacket to forward
headerIPv6 header to add to the packet

Definition at line 1304 of file ipv6-l3-protocol.cc.

References DROP_ROUTE_ERROR, DROP_TTL_EXPIRED, ns3::Ipv6InterfaceAddress::GetAddress(), ns3::Ipv6Header::GetDestination(), ns3::Ipv6Header::GetHopLimit(), GetIcmpv6(), ns3::Node::GetId(), GetInterface(), GetInterfaceForDevice(), ns3::Ipv6Interface::GetLinkLocalAddress(), ns3::Ipv6Header::GetSource(), ns3::Icmpv6Header::ICMPV6_HOPLIMIT, ns3::Ipv6Address::IsAny(), ns3::Ipv6Address::IsDocumentation(), ns3::Ipv6Address::IsLinkLocal(), ns3::Ipv6Address::IsMulticast(), m_dropTrace, m_node, m_sendIcmpv6Redirect, m_unicastForwardTrace, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, SendRealOut(), and ns3::Ipv6Header::SetHopLimit().

Referenced by Ipv6L3Protocol().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ IpMulticastForward()

void ns3::Ipv6L3Protocol::IpMulticastForward ( Ptr< const NetDevice > idev,
Ptr< Ipv6MulticastRoute > mrtentry,
Ptr< const Packet > p,
const Ipv6Header & header )
private

Forward a multicast packet.

Parameters
idevPointer to ingress network device
mrtentryroute
ppacket to forward
headerIPv6 header to add to the packet

Definition at line 1397 of file ipv6-l3-protocol.cc.

References ns3::Create(), DROP_TTL_EXPIRED, ns3::Ipv6Address::GetAny(), ns3::Ipv6Header::GetDestination(), ns3::Ipv6Header::GetHopLimit(), ns3::Node::GetId(), GetNetDevice(), ns3::Ipv6Header::GetSource(), m_dropTrace, m_node, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, SendRealOut(), and ns3::Ipv6Header::SetHopLimit().

Referenced by Ipv6L3Protocol().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ IsForwarding()

bool ns3::Ipv6L3Protocol::IsForwarding ( uint32_t i) const
overridevirtual

Is interface allows forwarding ?

Parameters
iinterface index
Returns
true if the interface is forwarding

Implements ns3::Ipv6.

Definition at line 620 of file ipv6-l3-protocol.cc.

References NS_LOG_LOGIC.

◆ IsRegisteredMulticastAddress() [1/2]

bool ns3::Ipv6L3Protocol::IsRegisteredMulticastAddress ( Ipv6Address address) const

Checks if the address has been registered.

Parameters
addressthe address.
Returns
true if the address is registered.

Definition at line 1744 of file ipv6-l3-protocol.cc.

References m_multicastAddressesNoInterface.

◆ IsRegisteredMulticastAddress() [2/2]

bool ns3::Ipv6L3Protocol::IsRegisteredMulticastAddress ( Ipv6Address address,
uint32_t interface ) const

Checks if the address has been registered for a specific interface.

Parameters
addressthe address.
interfacethe incoming interface.
Returns
true if the address is registered.

Definition at line 1735 of file ipv6-l3-protocol.cc.

References m_multicastAddresses.

◆ IsUp()

bool ns3::Ipv6L3Protocol::IsUp ( uint32_t i) const
overridevirtual

Is specified interface up ?

Parameters
iinterface index
Returns
true if the interface is up

Implements ns3::Ipv6.

Definition at line 530 of file ipv6-l3-protocol.cc.

◆ LocalDeliver()

void ns3::Ipv6L3Protocol::LocalDeliver ( Ptr< const Packet > p,
const Ipv6Header & ip,
uint32_t iif )
private

Deliver a packet.

Parameters
ppacket delivered
ipIPv6 header
iifinput interface packet was received

Definition at line 1431 of file ipv6-l3-protocol.cc.

References DROP_UNKNOWN_PROTOCOL, ns3::Ipv6Header::GetDestination(), GetIcmpv6(), GetInterface(), ns3::Ipv6Header::GetNextHeader(), ns3::Object::GetObject(), GetProtocol(), ns3::Ipv6Header::GetSerializedSize(), ns3::Ipv6Header::GetSource(), ns3::Icmpv6Header::ICMPV6_PORT_UNREACHABLE, ns3::Icmpv6Header::ICMPV6_UNKNOWN_NEXT_HEADER, ns3::Ipv6Header::IPV6_EXT_FRAGMENTATION, ns3::Ipv6Header::IPV6_EXT_HOP_BY_HOP, ns3::Ipv6Address::IsMulticast(), m_dropTrace, m_localDeliverTrace, m_node, NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, ns3::IpL4Protocol::RX_CSUM_FAILED, ns3::IpL4Protocol::RX_ENDPOINT_CLOSED, ns3::IpL4Protocol::RX_ENDPOINT_UNREACH, ns3::IpL4Protocol::RX_OK, ns3::Ipv6Header::SetNextHeader(), and ns3::Ipv6Header::SetPayloadLength().

Referenced by Ipv6L3Protocol().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ NotifyNewAggregate()

void ns3::Ipv6L3Protocol::NotifyNewAggregate ( )
overrideprotectedvirtual

Notify other components connected to the node that a new stack member is now connected.

This will be used to notify Layer 3 protocol of layer 4 protocol stack to connect them together.

Reimplemented from ns3::Object.

Definition at line 728 of file ipv6-l3-protocol.cc.

References ns3::Object::GetObject(), m_node, ns3::Object::NotifyNewAggregate(), NS_LOG_FUNCTION, and SetNode().

+ Here is the call graph for this function:

◆ operator=()

Ipv6L3Protocol & ns3::Ipv6L3Protocol::operator= ( const Ipv6L3Protocol & )
delete

◆ ReachabilityHint()

bool ns3::Ipv6L3Protocol::ReachabilityHint ( uint32_t ipInterfaceIndex,
Ipv6Address address )

Provides reachability hint for Neighbor Cache Entries from L4-L7 protocols.

This function shall be called by L4-L7 protocols when an address is confirmed to be reachable (i.e., at least a packet send and a reply received). The net effect is to extend the NCE reachability time if the NCE is in REACHABLE state, and to mark the NCE as REACHABLE if it is in STALE, PROBE, or DELAY states. NCEs in INCOMPLETE state are not changed.

Note that the IP interface index might not be the same as the NetDevice index. The correct way to check the IP interface index is by using Ipv6::GetInterfaceForDevice ().

Parameters
ipInterfaceIndexIP interface index
addressreachable address
Returns
true if the NCE has been successfully updated.

Definition at line 1752 of file ipv6-l3-protocol.cc.

References ns3::NdiscCache::Entry::ClearWaitingPacket(), ns3::NdiscCache::Entry::GetMacAddress(), ns3::NdiscCache::Entry::IsAutoGenerated(), ns3::NdiscCache::Entry::IsIncomplete(), ns3::NdiscCache::Entry::IsPermanent(), ns3::NdiscCache::Entry::IsProbe(), ns3::NdiscCache::Entry::IsReachable(), m_interfaces, ns3::NdiscCache::Entry::MarkReachable(), ns3::NdiscCache::Entry::StartReachableTimer(), and ns3::NdiscCache::Entry::UpdateReachableTimer().

+ Here is the call graph for this function:

◆ Receive()

void ns3::Ipv6L3Protocol::Receive ( Ptr< NetDevice > device,
Ptr< const Packet > p,
uint16_t protocol,
const Address & from,
const Address & to,
NetDevice::PacketType packetType )

Receive method when a packet arrive in the stack.

This method removes IPv6 header and forward up to L4 protocol.

Parameters
devicenetwork device
pthe packet
protocolnext header value
fromaddress of the correspondent
toaddress of the destination
packetTypetype of the packet

Definition at line 991 of file ipv6-l3-protocol.cc.

References ns3::Ipv6InterfaceAddress::GetAddress(), ns3::Ipv6Header::GetDestination(), ns3::Node::GetId(), GetInterfaceForDevice(), ns3::Ipv6Header::GetNextHeader(), ns3::Ipv6Header::GetPayloadLength(), ns3::Ipv6Header::GetSource(), ns3::Ipv6Address::IsAllNodesMulticast(), ns3::Ipv6Address::IsAllRoutersMulticast(), ns3::Ipv6Address::IsMulticast(), m_node, NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, and ns3::NdiscCache::Entry::UpdateReachableTimer().

Referenced by AddInterface(), and SetupLoopback().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ RegisterExtensions()

void ns3::Ipv6L3Protocol::RegisterExtensions ( )
overridevirtual

Register the IPv6 Extensions.

Does nothing if the Extensions have been already registered.

Implements ns3::Ipv6.

Definition at line 1607 of file ipv6-l3-protocol.cc.

References ns3::Object::AggregateObject(), ns3::CreateObject(), ns3::Object::GetObject(), and m_node.

+ Here is the call graph for this function:

◆ RegisterOptions()

void ns3::Ipv6L3Protocol::RegisterOptions ( )
overridevirtual

Register the IPv6 Options.

Does nothing if the Options have been already registered.

Implements ns3::Ipv6.

Definition at line 1647 of file ipv6-l3-protocol.cc.

References ns3::Object::AggregateObject(), ns3::CreateObject(), ns3::Object::GetObject(), and m_node.

+ Here is the call graph for this function:

◆ Remove() [1/2]

void ns3::Ipv6L3Protocol::Remove ( Ptr< IpL4Protocol > protocol)
overridevirtual

Remove a L4 protocol.

Parameters
protocolL4 protocol to remove.

Implements ns3::Ipv6.

Definition at line 782 of file ipv6-l3-protocol.cc.

References m_protocols, NS_LOG_FUNCTION, and NS_LOG_WARN.

◆ Remove() [2/2]

void ns3::Ipv6L3Protocol::Remove ( Ptr< IpL4Protocol > protocol,
uint32_t interfaceIndex )
overridevirtual

Remove a L4 protocol from a specific interface.

Parameters
protocolL4 protocol to remove.
interfaceIndexinterface index.

Implements ns3::Ipv6.

Definition at line 800 of file ipv6-l3-protocol.cc.

References m_protocols, NS_LOG_FUNCTION, and NS_LOG_WARN.

◆ RemoveAddress() [1/2]

bool ns3::Ipv6L3Protocol::RemoveAddress ( uint32_t interfaceIndex,
Ipv6Address address )
overridevirtual

Remove a specified Ipv6 address from an interface.

Parameters
interfaceIndexinterface index
addressIpv6Address to be removed from the interface
Returns
true if the operation succeeded

Implements ns3::Ipv6.

Definition at line 472 of file ipv6-l3-protocol.cc.

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

+ Here is the call graph for this function:

◆ RemoveAddress() [2/2]

bool ns3::Ipv6L3Protocol::RemoveAddress ( uint32_t interfaceIndex,
uint32_t addressIndex )
overridevirtual

Remove an address from an interface.

Parameters
interfaceIndexinterface index
addressIndexaddress index on the interface
Returns
true if the operation succeeded

Implements ns3::Ipv6.

Definition at line 454 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION.

Referenced by RemoveAutoconfiguredAddress().

+ Here is the caller graph for this function:

◆ RemoveAutoconfiguredAddress()

void ns3::Ipv6L3Protocol::RemoveAutoconfiguredAddress ( uint32_t interface,
Ipv6Address network,
Ipv6Prefix mask,
Ipv6Address defaultRouter )

Remove an autoconfigured address.

Typically it is used when an autoconfigured address expires.

Parameters
interfaceinterface index
networknetwork prefix
masknetwork mask
defaultRoutergateway

Definition at line 375 of file ipv6-l3-protocol.cc.

References ns3::Ipv6Address::GetAny(), GetInterface(), GetRoutingProtocol(), m_prefixes, ns3::Ipv6Address::MakeAutoconfiguredAddress(), NS_LOG_FUNCTION, and RemoveAddress().

+ Here is the call graph for this function:

◆ RemoveMulticastAddress() [1/2]

void ns3::Ipv6L3Protocol::RemoveMulticastAddress ( Ipv6Address address)

Removes a multicast address from the list of addresses to pass to local deliver.

Parameters
addressthe address.

Definition at line 1723 of file ipv6-l3-protocol.cc.

References m_multicastAddressesNoInterface, and NS_LOG_FUNCTION.

◆ RemoveMulticastAddress() [2/2]

void ns3::Ipv6L3Protocol::RemoveMulticastAddress ( Ipv6Address address,
uint32_t interface )

Removes a multicast address from the list of addresses to pass to local deliver.

Parameters
addressthe address.
interfacethe incoming interface.

Definition at line 1709 of file ipv6-l3-protocol.cc.

References m_multicastAddresses, and NS_LOG_FUNCTION.

◆ ReportDrop()

void ns3::Ipv6L3Protocol::ReportDrop ( Ipv6Header ipHeader,
Ptr< Packet > p,
DropReason dropReason )
virtual

Report a packet drop.

This function is used by Fragment Timeout handling to signal a fragment drop.

Parameters
ipHeaderthe IPv6 header of dropped packet
pthe packet (if available)
dropReasonthe drop reason

Definition at line 1674 of file ipv6-l3-protocol.cc.

References m_dropTrace.

◆ RouteInputError()

void ns3::Ipv6L3Protocol::RouteInputError ( Ptr< const Packet > p,
const Ipv6Header & ipHeader,
Socket::SocketErrno sockErrno )
private

Fallback when no route is found.

Parameters
ppacket
ipHeaderIPv6 header
sockErrnoerror number

Definition at line 1565 of file ipv6-l3-protocol.cc.

References DROP_ROUTE_ERROR, ns3::Ipv6Header::GetDestination(), GetIcmpv6(), ns3::Ipv6Header::GetSource(), ns3::Icmpv6Header::ICMPV6_NO_ROUTE, ns3::Ipv6Address::IsMulticast(), m_dropTrace, NS_LOG_FUNCTION, and NS_LOG_LOGIC.

Referenced by Ipv6L3Protocol().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ Send()

void ns3::Ipv6L3Protocol::Send ( Ptr< Packet > packet,
Ipv6Address source,
Ipv6Address destination,
uint8_t protocol,
Ptr< Ipv6Route > route )
overridevirtual

Higher-level layers call this method to send a packet down the stack to the MAC and PHY layers.

All PMTU values are stored at this level, so packet size calculations should be done mathematically at higher levels.

Parameters
packetpacket to send
sourcesource address of packet
destinationaddress of packet
protocolnumber of packet
routeroute to take

Implements ns3::Ipv6.

Definition at line 903 of file ipv6-l3-protocol.cc.

References BuildHeader(), DROP_NO_ROUTE, ns3::SocketIpv6HopLimitTag::GetHopLimit(), GetInterfaceForAddress(), GetInterfaceForDevice(), GetNetDevice(), ns3::SocketIpv6TclassTag::GetTclass(), ns3::Ipv6Address::GetZero(), ns3::Ipv6Address::IsLinkLocal(), ns3::Ipv6Address::IsLinkLocalMulticast(), m_defaultTclass, m_defaultTtl, m_dropTrace, m_routingProtocol, m_sendOutgoingTrace, NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, and SendRealOut().

+ Here is the call graph for this function:

◆ SendRealOut()

void ns3::Ipv6L3Protocol::SendRealOut ( Ptr< Ipv6Route > route,
Ptr< Packet > packet,
const Ipv6Header & ipHeader )
private

Send packet with route.

Parameters
routeroute
packetpacket to send
ipHeaderIPv6 header to add to the packet

Definition at line 1173 of file ipv6-l3-protocol.cc.

References ns3::Ipv6Header::GetDestination(), ns3::Ipv6Header::GetSerializedSize(), ns3::Ipv6Header::GetSource(), NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_LOGIC, and ns3::PeekPointer().

Referenced by IpForward(), IpMulticastForward(), and Send().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ SetDefaultTclass()

void ns3::Ipv6L3Protocol::SetDefaultTclass ( uint8_t tclass)

Set the default TCLASS.

Parameters
tclassTCLASS to set

Definition at line 896 of file ipv6-l3-protocol.cc.

References m_defaultTclass, and NS_LOG_FUNCTION.

◆ SetDefaultTtl()

void ns3::Ipv6L3Protocol::SetDefaultTtl ( uint8_t ttl)

Set the default TTL.

Parameters
ttlTTL to set

Definition at line 889 of file ipv6-l3-protocol.cc.

References m_defaultTtl, and NS_LOG_FUNCTION.

◆ SetDown()

void ns3::Ipv6L3Protocol::SetDown ( uint32_t i)
overridevirtual

set an interface down.

Parameters
iinterface index

Implements ns3::Ipv6.

Definition at line 565 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION.

◆ SetForwarding()

void ns3::Ipv6L3Protocol::SetForwarding ( uint32_t i,
bool val )
overridevirtual

Enable or disable forwarding on interface.

Parameters
iinterface index
valtrue = enable forwarding, false = disable

Implements ns3::Ipv6.

Definition at line 629 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION.

◆ SetIpForward()

void ns3::Ipv6L3Protocol::SetIpForward ( bool forward)
overrideprivatevirtual

Set IPv6 forwarding state.

Parameters
forwardIPv6 forwarding enabled or not

Implements ns3::Ipv6.

Definition at line 684 of file ipv6-l3-protocol.cc.

References m_interfaces, m_ipForward, and NS_LOG_FUNCTION.

◆ SetMetric()

void ns3::Ipv6L3Protocol::SetMetric ( uint32_t i,
uint16_t metric )
overridevirtual

Set metric for an interface.

Parameters
iindex
metric

Implements ns3::Ipv6.

Definition at line 495 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION.

◆ SetMtuDiscover()

void ns3::Ipv6L3Protocol::SetMtuDiscover ( bool mtuDiscover)
overrideprivatevirtual

Set IPv6 MTU discover state.

Parameters
mtuDiscoverIPv6 MTU discover enabled or not

Implements ns3::Ipv6.

Definition at line 702 of file ipv6-l3-protocol.cc.

References m_mtuDiscover, and NS_LOG_FUNCTION.

◆ SetNode()

void ns3::Ipv6L3Protocol::SetNode ( Ptr< Node > node)

Set node associated with this stack.

Parameters
nodenode to set

Definition at line 747 of file ipv6-l3-protocol.cc.

References m_node, NS_LOG_FUNCTION, and SetupLoopback().

Referenced by NotifyNewAggregate().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ SetPmtu()

void ns3::Ipv6L3Protocol::SetPmtu ( Ipv6Address dst,
uint32_t pmtu )
overridevirtual

Set the Path MTU for the specified IPv6 destination address.

Parameters
dstIpv6 destination address
pmtuthe Path MTU

Implements ns3::Ipv6.

Definition at line 523 of file ipv6-l3-protocol.cc.

References m_pmtuCache, and NS_LOG_FUNCTION.

◆ SetRoutingProtocol()

void ns3::Ipv6L3Protocol::SetRoutingProtocol ( Ptr< Ipv6RoutingProtocol > routingProtocol)
overridevirtual

Set routing protocol for this stack.

Parameters
routingProtocolIPv6 routing protocol to set

Implements ns3::Ipv6.

Definition at line 173 of file ipv6-l3-protocol.cc.

References m_routingProtocol, and NS_LOG_FUNCTION.

◆ SetSendIcmpv6Redirect()

void ns3::Ipv6L3Protocol::SetSendIcmpv6Redirect ( bool sendIcmpv6Redirect)
privatevirtual

Set the ICMPv6 Redirect sending state.

Parameters
sendIcmpv6RedirectICMPv6 Redirect sending enabled or not

Definition at line 715 of file ipv6-l3-protocol.cc.

References m_sendIcmpv6Redirect, and NS_LOG_FUNCTION.

Referenced by GetTypeId().

+ Here is the caller graph for this function:

◆ SetStrongEndSystemModel()

void ns3::Ipv6L3Protocol::SetStrongEndSystemModel ( bool model)
overrideprivatevirtual

Set or unset the Strong End System Model.

RFC1122 term for whether host rejects datagram with a dest. address on another interface

Parameters
modeltrue for Strong End System Model

Implements ns3::Ipv6.

Definition at line 1801 of file ipv6-l3-protocol.cc.

References m_strongEndSystemModel, and NS_LOG_FUNCTION.

◆ SetUp()

void ns3::Ipv6L3Protocol::SetUp ( uint32_t i)
overridevirtual

Set an interface up.

Parameters
iinterface index

Implements ns3::Ipv6.

Definition at line 537 of file ipv6-l3-protocol.cc.

References NS_LOG_FUNCTION, and NS_LOG_LOGIC.

◆ SetupLoopback()

void ns3::Ipv6L3Protocol::SetupLoopback ( )
private

Setup loopback interface.

Definition at line 579 of file ipv6-l3-protocol.cc.

References ns3::Node::AddDevice(), AddIpv6Interface(), ns3::CreateObject(), ns3::DynamicCast(), ns3::Node::GetDevice(), ns3::Ipv6Address::GetLoopback(), ns3::Node::GetNDevices(), ns3::Object::GetObject(), m_node, m_routingProtocol, ns3::MakeCallback(), NS_LOG_FUNCTION, PROT_NUMBER, and Receive().

Referenced by SetNode().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ SourceAddressSelection()

Ipv6Address ns3::Ipv6L3Protocol::SourceAddressSelection ( uint32_t interface,
Ipv6Address dest )
overridevirtual

Choose the source address to use with destination address.

Parameters
interfaceinterface index
destIPv6 destination address
Returns
IPv6 source address to use

Implements ns3::Ipv6.

Definition at line 637 of file ipv6-l3-protocol.cc.

References GetAddress(), ns3::Ipv6Address::GetLoopback(), GetNAddresses(), ns3::Ipv6InterfaceAddress::GLOBAL, ns3::Ipv6Address::IsAny(), ns3::Ipv6Address::IsLinkLocal(), ns3::Ipv6Address::IsLinkLocalMulticast(), ns3::Ipv6Address::IsLocalhost(), ns3::Ipv6InterfaceAddress::LINKLOCAL, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

Friends And Related Symbol Documentation

◆ ::Ipv6L3ProtocolTestCase

friend class ::Ipv6L3ProtocolTestCase
friend

Ipv6L3ProtocolTestCase test case.

Definition at line 500 of file ipv6-l3-protocol.h.

◆ Ipv6ExtensionLooseRouting

friend class Ipv6ExtensionLooseRouting
friend

Ipv6ExtensionLooseRouting.

Definition at line 505 of file ipv6-l3-protocol.h.

Member Data Documentation

◆ m_defaultTclass

uint8_t ns3::Ipv6L3Protocol::m_defaultTclass
private

Default TCLASS for outgoing packets.

Definition at line 755 of file ipv6-l3-protocol.h.

Referenced by GetTypeId(), Send(), and SetDefaultTclass().

◆ m_defaultTtl

uint8_t ns3::Ipv6L3Protocol::m_defaultTtl
private

Default TTL for outgoing packets.

Definition at line 750 of file ipv6-l3-protocol.h.

Referenced by GetTypeId(), Send(), and SetDefaultTtl().

◆ m_dropTrace

TracedCallback<const Ipv6Header&, Ptr<const Packet>, DropReason, Ptr<Ipv6>, uint32_t> ns3::Ipv6L3Protocol::m_dropTrace
private

Callback to trace drop packets.

Deprecated
The non-const Ptr<Ipv6> argument is deprecated and will be changed to Ptr<const Ipv6> in a future release.

Definition at line 580 of file ipv6-l3-protocol.h.

Referenced by GetTypeId(), IpForward(), IpMulticastForward(), LocalDeliver(), ReportDrop(), RouteInputError(), and Send().

◆ m_ecb

Ipv6RoutingProtocol::ErrorCallback ns3::Ipv6L3Protocol::m_ecb
private

Error callback.

Definition at line 835 of file ipv6-l3-protocol.h.

Referenced by Ipv6L3Protocol().

◆ m_interfaces

Ipv6InterfaceList ns3::Ipv6L3Protocol::m_interfaces
private

◆ m_ipForward

bool ns3::Ipv6L3Protocol::m_ipForward
private

Forwarding packets (i.e.

router mode) state.

Definition at line 715 of file ipv6-l3-protocol.h.

Referenced by AddInterface(), GetIpForward(), and SetIpForward().

◆ m_lcb

Ipv6RoutingProtocol::LocalDeliverCallback ns3::Ipv6L3Protocol::m_lcb
private

Local delivery callback.

Definition at line 834 of file ipv6-l3-protocol.h.

Referenced by Ipv6L3Protocol().

◆ m_localDeliverTrace

TracedCallback<const Ipv6Header&, Ptr<const Packet>, uint32_t> ns3::Ipv6L3Protocol::m_localDeliverTrace
private

Trace of locally delivered packets.

Definition at line 587 of file ipv6-l3-protocol.h.

Referenced by GetTypeId(), and LocalDeliver().

◆ m_mcb

Ipv6RoutingProtocol::MulticastForwardCallback ns3::Ipv6L3Protocol::m_mcb
private

Multicast forward callback.

Definition at line 833 of file ipv6-l3-protocol.h.

Referenced by Ipv6L3Protocol().

◆ m_mtuDiscover

bool ns3::Ipv6L3Protocol::m_mtuDiscover
private

MTU Discover (i.e.

Path MTU) state.

Definition at line 720 of file ipv6-l3-protocol.h.

Referenced by GetMtu(), GetMtuDiscover(), and SetMtuDiscover().

◆ m_multicastAddresses

Ipv6RegisteredMulticastAddress_t ns3::Ipv6L3Protocol::m_multicastAddresses
private

List of multicast IP addresses of interest, divided per interface.

Definition at line 825 of file ipv6-l3-protocol.h.

Referenced by AddMulticastAddress(), IsRegisteredMulticastAddress(), and RemoveMulticastAddress().

◆ m_multicastAddressesNoInterface

Ipv6RegisteredMulticastAddressNoInterface_t ns3::Ipv6L3Protocol::m_multicastAddressesNoInterface
private

List of multicast IP addresses of interest for all the interfaces.

Definition at line 830 of file ipv6-l3-protocol.h.

Referenced by AddMulticastAddress(), IsRegisteredMulticastAddress(), and RemoveMulticastAddress().

◆ m_nInterfaces

uint32_t ns3::Ipv6L3Protocol::m_nInterfaces
private

Number of IPv6 interfaces managed by the stack.

Definition at line 745 of file ipv6-l3-protocol.h.

Referenced by AddIpv6Interface(), and GetNInterfaces().

◆ m_node

◆ m_pmtuCache

Ptr<Ipv6PmtuCache> ns3::Ipv6L3Protocol::m_pmtuCache
private

Path MTU Cache.

Definition at line 725 of file ipv6-l3-protocol.h.

Referenced by Ipv6L3Protocol(), DoDispose(), and SetPmtu().

◆ m_prefixes

Ipv6AutoconfiguredPrefixList ns3::Ipv6L3Protocol::m_prefixes
private

List of IPv6 prefix received from RA.

Definition at line 775 of file ipv6-l3-protocol.h.

Referenced by AddAutoconfiguredAddress(), DoDispose(), and RemoveAutoconfiguredAddress().

◆ m_protocols

L4List_t ns3::Ipv6L3Protocol::m_protocols
private

List of transport protocol.

Definition at line 730 of file ipv6-l3-protocol.h.

Referenced by DoDispose(), GetProtocol(), Insert(), Insert(), Remove(), and Remove().

◆ m_reverseInterfacesContainer

Ipv6InterfaceReverseContainer ns3::Ipv6L3Protocol::m_reverseInterfacesContainer
private

Container of NetDevice / Interface index associations.

Definition at line 740 of file ipv6-l3-protocol.h.

Referenced by AddIpv6Interface(), DoDispose(), and GetInterfaceForDevice().

◆ m_routingProtocol

Ptr<Ipv6RoutingProtocol> ns3::Ipv6L3Protocol::m_routingProtocol
private

◆ m_rxTrace

TracedCallback<Ptr<const Packet>, Ptr<Ipv6>, uint32_t> ns3::Ipv6L3Protocol::m_rxTrace
private

Callback to trace RX (reception) packets.

Deprecated
The non-const Ptr<Ipv6> argument is deprecated and will be changed to Ptr<const Ipv6> in a future release.

Definition at line 571 of file ipv6-l3-protocol.h.

Referenced by GetTypeId().

◆ m_sendIcmpv6Redirect

bool ns3::Ipv6L3Protocol::m_sendIcmpv6Redirect
private

Allow ICMPv6 Redirect sending state.

Definition at line 780 of file ipv6-l3-protocol.h.

Referenced by GetSendIcmpv6Redirect(), IpForward(), and SetSendIcmpv6Redirect().

◆ m_sendOutgoingTrace

TracedCallback<const Ipv6Header&, Ptr<const Packet>, uint32_t> ns3::Ipv6L3Protocol::m_sendOutgoingTrace
private

Trace of sent packets.

Definition at line 583 of file ipv6-l3-protocol.h.

Referenced by GetTypeId(), and Send().

◆ m_sockets

SocketList ns3::Ipv6L3Protocol::m_sockets
private

List of IPv6 raw sockets.

Definition at line 770 of file ipv6-l3-protocol.h.

Referenced by CreateRawSocket(), DeleteRawSocket(), and DoDispose().

◆ m_strongEndSystemModel

bool ns3::Ipv6L3Protocol::m_strongEndSystemModel
private

Rejects packets directed to an interface with wrong address (RFC 1222 ).

Definition at line 760 of file ipv6-l3-protocol.h.

Referenced by GetStrongEndSystemModel(), and SetStrongEndSystemModel().

◆ m_txTrace

TracedCallback<Ptr<const Packet>, Ptr<Ipv6>, uint32_t> ns3::Ipv6L3Protocol::m_txTrace
private

Callback to trace TX (transmission) packets.

Deprecated
The non-const Ptr<Ipv6> argument is deprecated and will be changed to Ptr<const Ipv6> in a future release.

Definition at line 563 of file ipv6-l3-protocol.h.

Referenced by CallTxTrace(), and GetTypeId().

◆ m_ucb

Ipv6RoutingProtocol::UnicastForwardCallback ns3::Ipv6L3Protocol::m_ucb
private

Unicast forward callback.

Definition at line 832 of file ipv6-l3-protocol.h.

Referenced by Ipv6L3Protocol().

◆ m_unicastForwardTrace

TracedCallback<const Ipv6Header&, Ptr<const Packet>, uint32_t> ns3::Ipv6L3Protocol::m_unicastForwardTrace
private

Trace of unicast forwarded packets.

Definition at line 585 of file ipv6-l3-protocol.h.

Referenced by GetTypeId(), and IpForward().

◆ PROT_NUMBER


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