Implement the Ipv4 layer. More...

#include <ipv4-l3-protocol.h>

Inheritance diagram for ns3::Ipv4L3Protocol:

Collaboration diagram for ns3::Ipv4L3Protocol:

Classes
class	Fragments
	A Set of Fragment belonging to the same packet (src, dst, identification and proto) More...

Public Types
enum	DropReason { DROP_TTL_EXPIRED = 1, DROP_NO_ROUTE, DROP_BAD_CHECKSUM, DROP_INTERFACE_DOWN, DROP_ROUTE_ERROR, DROP_FRAGMENT_TIMEOUT }
	Reason why a packet has been dropped. More...

Public Member Functions
	Ipv4L3Protocol ()

virtual	~Ipv4L3Protocol ()

bool	AddAddress (uint32_t i, Ipv4InterfaceAddress address)

uint32_t	AddInterface (Ptr< NetDevice > device)

Ptr< Socket >	CreateRawSocket (void)
	Creates a raw socket. More...

void	DeleteRawSocket (Ptr< Socket > socket)
	Deletes a particular raw socket. More...

Ipv4InterfaceAddress	GetAddress (uint32_t interfaceIndex, uint32_t addressIndex) const
	Because addresses can be removed, the addressIndex is not guaranteed to be static across calls to this method. More...

Ptr< Ipv4Interface >	GetInterface (uint32_t i) const
	Get an interface. More...

int32_t	GetInterfaceForAddress (Ipv4Address addr) const
	Return the interface number of the interface that has been assigned the specified IP address. More...

int32_t	GetInterfaceForDevice (Ptr< const NetDevice > device) const

int32_t	GetInterfaceForPrefix (Ipv4Address addr, Ipv4Mask mask) const
	Return the interface number of first interface found that has an Ipv4 address within the prefix specified by the input address and mask parameters. More...

uint16_t	GetMetric (uint32_t i) const

uint16_t	GetMtu (uint32_t i) const

uint32_t	GetNAddresses (uint32_t interface) const

Ptr< NetDevice >	GetNetDevice (uint32_t i)

uint32_t	GetNInterfaces (void) const

virtual Ptr< IpL4Protocol >	GetProtocol (int protocolNumber) const

Ptr< Ipv4RoutingProtocol >	GetRoutingProtocol (void) const
	Get the routing protocol to be used by this Ipv4 stack. More...

void	Insert (Ptr< IpL4Protocol > protocol)

bool	IsDestinationAddress (Ipv4Address address, uint32_t iif) const
	Determine whether address and interface corresponding to received packet can be accepted for local delivery. More...

bool	IsForwarding (uint32_t i) const

bool	IsUnicast (Ipv4Address ad) const
	Check if an IPv4 address is unicast according to the node. More...

bool	IsUp (uint32_t i) const

void	Receive (Ptr< NetDevice > device, Ptr< const Packet > p, uint16_t protocol, const Address &from, const Address &to, NetDevice::PacketType packetType)
	Lower layer calls this method after calling L3Demux::Lookup The ARP subclass needs to know from which NetDevice this packet is coming to: More...

void	Remove (Ptr< IpL4Protocol > protocol)

bool	RemoveAddress (uint32_t interfaceIndex, uint32_t addressIndex)
	Remove the address at addressIndex on named interface. More...

bool	RemoveAddress (uint32_t interface, Ipv4Address address)
	Remove the given address on named Ipv4 interface. More...

Ipv4Address	SelectSourceAddress (Ptr< const NetDevice > device, Ipv4Address dst, Ipv4InterfaceAddress::InterfaceAddressScope_e scope)
	Return the first primary source address with scope less than or equal to the requested scope, to use in sending a packet to destination dst out of the specified device. More...

void	Send (Ptr< Packet > packet, Ipv4Address source, Ipv4Address destination, uint8_t protocol, Ptr< Ipv4Route > route)

void	SendWithHeader (Ptr< Packet > packet, Ipv4Header ipHeader, Ptr< Ipv4Route > route)

void	SetDefaultTtl (uint8_t ttl)

void	SetDown (uint32_t i)

void	SetForwarding (uint32_t i, bool val)

void	SetMetric (uint32_t i, uint16_t metric)

void	SetNode (Ptr< Node > node)
	Set node associated with this stack. More...

void	SetRoutingProtocol (Ptr< Ipv4RoutingProtocol > routingProtocol)
	Register a new routing protocol to be used by this Ipv4 stack. More...

void	SetUp (uint32_t i)

Public Member Functions inherited from ns3::Ipv4
	Ipv4 ()

virtual	~Ipv4 ()

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...

SimpleRefCount &	operator= (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 (void)
	Get the type ID. More...

Static Public Member Functions inherited from ns3::Ipv4
static TypeId	GetTypeId (void)
	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...

Static Public Attributes
static const uint16_t	PROT_NUMBER = 0x0800
	Protocol number (0x0800) More...

Static Public Attributes inherited from ns3::Ipv4
static const uint32_t	IF_ANY = 0xffffffff
	interface wildcard, meaning any interface More...

Protected Member Functions
virtual void	DoDispose (void)
	This method is called by Object::Dispose or by the object's destructor, whichever comes first. More...

virtual void	NotifyNewAggregate ()
	This function will 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. 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...

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::vector< Ptr < Ipv4Interface > >	Ipv4InterfaceList
	Container of the IPv4 Interfaces. More...

typedef std::list< Ptr < IpL4Protocol > >	L4List_t
	Container of the IPv4 L4 instances. More...

typedef std::map< std::pair < uint64_t, uint32_t >, Ptr < Fragments > >	MapFragments_t
	Container of fragments, stored as pairs(src+dst addr, src+dst port) / fragment. More...

typedef std::map< std::pair < uint64_t, uint32_t > , EventId >	MapFragmentsTimers_t
	Container of fragment timeout event, stored as pairs(src+dst addr, src+dst port) / EventId. More...

typedef std::list< Ptr < Ipv4RawSocketImpl > >	SocketList
	Container of the IPv4 Raw Sockets. More...

Private Member Functions
	Ipv4L3Protocol (const Ipv4L3Protocol &)
	Copy constructor. More...

uint32_t	AddIpv4Interface (Ptr< Ipv4Interface > interface)
	Add an IPv4 interface to the stack. More...

Ipv4Header	BuildHeader (Ipv4Address source, Ipv4Address destination, uint8_t protocol, uint16_t payloadSize, uint8_t ttl, uint8_t tos, bool mayFragment)
	Construct an IPv4 header. More...

void	DoFragmentation (Ptr< Packet > packet, uint32_t outIfaceMtu, std::list< Ptr< Packet > > &listFragments)
	Fragment a packet. More...

Ptr< Icmpv4L4Protocol >	GetIcmp (void) const
	Get ICMPv4 protocol. More...

virtual bool	GetIpForward (void) const
	Get the IP forwarding state. More...

virtual bool	GetWeakEsModel (void) const
	Get the Weak Es Model status. More...

void	HandleFragmentsTimeout (std::pair< uint64_t, uint32_t > key, Ipv4Header &ipHeader, uint32_t iif)
	Process the timeout for packet fragments. More...

void	IpForward (Ptr< Ipv4Route > rtentry, Ptr< const Packet > p, const Ipv4Header &header)
	Forward a packet. More...

void	IpMulticastForward (Ptr< Ipv4MulticastRoute > mrtentry, Ptr< const Packet > p, const Ipv4Header &header)
	Forward a multicast packet. More...

bool	IsUnicast (Ipv4Address ad, Ipv4Mask interfaceMask) const
	Check if an IPv4 address is unicast. More...

void	LocalDeliver (Ptr< const Packet > p, Ipv4Header const &ip, uint32_t iif)
	Deliver a packet. More...

Ipv4L3Protocol &	operator= (const Ipv4L3Protocol &)
	Copy constructor. More...

bool	ProcessFragment (Ptr< Packet > &packet, Ipv4Header &ipHeader, uint32_t iif)
	Process a packet fragment. More...

void	RouteInputError (Ptr< const Packet > p, const Ipv4Header &ipHeader, Socket::SocketErrno sockErrno)
	Fallback when no route is found. More...

void	SendRealOut (Ptr< Ipv4Route > route, Ptr< Packet > packet, Ipv4Header const &ipHeader)
	Send packet with route. More...

virtual void	SetIpForward (bool forward)
	Set or unset the IP forwarding state. More...

void	SetupLoopback (void)
	Setup loopback interface. More...

virtual void	SetWeakEsModel (bool model)
	Set or unset the Weak Es Model. More...

Private Attributes
uint8_t	m_defaultTos
	Default TOS. More...

uint8_t	m_defaultTtl
	Default TTL. More...

TracedCallback< const Ipv4Header &, Ptr< const Packet >, DropReason, Ptr < Ipv4 >, uint32_t >	m_dropTrace
	Trace of dropped packets. More...

Time	m_fragmentExpirationTimeout
	Expiration timeout. More...

MapFragments_t	m_fragments
	Fragmented packets. More...

MapFragmentsTimers_t	m_fragmentsTimers
	Expiration events. More...

std::map< uint8_t, uint16_t >	m_identification
	Identification (for each protocol) More...

Ipv4InterfaceList	m_interfaces
	List of IPv4 interfaces. More...

bool	m_ipForward
	Forwarding packets (i.e. More...

TracedCallback< const Ipv4Header &, Ptr< const Packet >, uint32_t >	m_localDeliverTrace
	Trace of locally delivered packets. More...

Ptr< Node >	m_node
	Node attached to stack. More...

L4List_t	m_protocols
	List of transport protocol. More...

Ptr< Ipv4RoutingProtocol >	m_routingProtocol
	Routing protocol associated with the stack. More...

TracedCallback< Ptr< const Packet >, Ptr< Ipv4 > , uint32_t >	m_rxTrace
	Trace of received packets. More...

TracedCallback< const Ipv4Header &, Ptr< const Packet >, uint32_t >	m_sendOutgoingTrace
	Trace of sent packets. More...

SocketList	m_sockets
	List of IPv4 raw sockets. More...

TracedCallback< Ptr< const Packet >, Ptr< Ipv4 > , uint32_t >	m_txTrace
	Trace of transmitted packets. More...

TracedCallback< const Ipv4Header &, Ptr< const Packet >, uint32_t >	m_unicastForwardTrace
	Trace of unicast forwarded packets. More...

bool	m_weakEsModel
	Weak ES model state. More...

Friends
class	::Ipv4L3ProtocolTestCase

Detailed Description

Implement the Ipv4 layer.

This is the actual implementation of IP. It contains APIs to send and receive packets at the IP layer, as well as APIs for IP routing.

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 Ipv4Header already serialized into the packet. In contrast, the Drop, SendOutgoing, UnicastForward, and LocalDeliver trace sources are slightly higher-level and pass around the Ipv4Header as an explicit parameter and not as part of the packet.

IP fragmentation and reassembly is handled at this level. At the moment the fragmentation does not handle IP option headers, and in particular the ones that shall not be fragmented. Moreover, the actual implementation does not mimic exactly the Linux kernel. Hence it is not possible, for instance, to test a fragmentation attack.

Config Paths

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

/NodeList/[i]/$ns3::Ipv4L3Protocol

Attributes

DefaultTos: The TOS value set by default on all outgoing packets generated on this node.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 0:255
- Initial value: 0
- Flags: construct write read
DefaultTtl: The TTL value set by default on all outgoing packets generated on this node.
- Set with class: ns3::UintegerValue
- Underlying type: uint8_t 0:255
- Initial value: 64
- Flags: construct write read
FragmentExpirationTimeout: When this timeout expires, the fragments will be cleared from the buffer.
- Set with class: ns3::TimeValue
- Underlying type: Time –9223372036854775808.0ns:+9223372036854775807.0ns
- Initial value: +30000000000.0ns
- Flags: construct write read
InterfaceList: The set of Ipv4 interfaces associated to this Ipv4 stack.
- Set with class: ns3::ObjectPtrContainerValue
- Underlying type: ns3::Ptr< ns3::Ipv4Interface>
- Flags: read

Attributes defined in parent class ns3::Ipv4

IpForward: Globally enable or disable IP forwarding for all current and future Ipv4 devices.
- Set with class: BooleanValue
- Underlying type: bool
- Initial value: true
- Flags: construct write read
WeakEsModel: RFC1122 term for whether host accepts datagram with a dest. address on another interface
- Set with class: BooleanValue
- Underlying type: bool
- Initial value: true
- Flags: construct write read

TraceSources

Tx: Send ipv4 packet to outgoing interface.
Rx: Receive ipv4 packet from incoming interface.
Drop: Drop ipv4 packet
SendOutgoing: A newly-generated packet by this node is about to be queued for transmission
UnicastForward: A unicast IPv4 packet was received by this node and is being forwarded to another node
LocalDeliver: An IPv4 packet was received by/for this node, and it is being forward up the stack

Definition at line 79 of file ipv4-l3-protocol.h.

Member Typedef Documentation

typedef std::vector<Ptr<Ipv4Interface> > ns3::Ipv4L3Protocol::Ipv4InterfaceList

private

Container of the IPv4 Interfaces.

Definition at line 395 of file ipv4-l3-protocol.h.

typedef std::list<Ptr<IpL4Protocol> > ns3::Ipv4L3Protocol::L4List_t

private

Container of the IPv4 L4 instances.

Definition at line 403 of file ipv4-l3-protocol.h.

typedef std::map< std::pair<uint64_t, uint32_t>, Ptr<Fragments> > ns3::Ipv4L3Protocol::MapFragments_t

private

Container of fragments, stored as pairs(src+dst addr, src+dst port) / fragment.

Definition at line 491 of file ipv4-l3-protocol.h.

typedef std::map< std::pair<uint64_t, uint32_t>, EventId > ns3::Ipv4L3Protocol::MapFragmentsTimers_t

private

Container of fragment timeout event, stored as pairs(src+dst addr, src+dst port) / EventId.

Definition at line 493 of file ipv4-l3-protocol.h.

typedef std::list<Ptr<Ipv4RawSocketImpl> > ns3::Ipv4L3Protocol::SocketList

private

Container of the IPv4 Raw Sockets.

Definition at line 399 of file ipv4-l3-protocol.h.

Member Enumeration Documentation

enum ns3::Ipv4L3Protocol::DropReason

Reason why a packet has been dropped.

Enumerator
DROP_TTL_EXPIRED	Packet TTL has expired.
DROP_NO_ROUTE	No route to host.
DROP_BAD_CHECKSUM	Bad checksum.
DROP_INTERFACE_DOWN	Interface is down so can not send packet.
DROP_ROUTE_ERROR	Route error.
DROP_FRAGMENT_TIMEOUT	Fragment timeout exceeded.

Definition at line 96 of file ipv4-l3-protocol.h.

Constructor & Destructor Documentation

ns3::Ipv4L3Protocol::Ipv4L3Protocol ( )

Definition at line 92 of file ipv4-l3-protocol.cc.

References NS_LOG_FUNCTION.

ns3::Ipv4L3Protocol::~Ipv4L3Protocol ( )

virtual

Definition at line 97 of file ipv4-l3-protocol.cc.

References NS_LOG_FUNCTION.

ns3::Ipv4L3Protocol::Ipv4L3Protocol ( const Ipv4L3Protocol & )

private

Copy constructor.

Defined but not implemented to avoid misuse

Member Function Documentation

bool ns3::Ipv4L3Protocol::AddAddress	(	uint32_t	interface,
		Ipv4InterfaceAddress	address
	)

virtual

Parameters

interface	Interface number of an Ipv4 interface
address	Ipv4InterfaceAddress address to associate with the underlying Ipv4 interface

Returns: true if the operation succeeded

Implements ns3::Ipv4.

Definition at line 969 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Interface::AddAddress(), m_routingProtocol, and NS_LOG_FUNCTION.

Here is the call graph for this function:

uint32_t ns3::Ipv4L3Protocol::AddInterface ( Ptr< NetDevice > device )

virtual

Parameters

device device to add to the list of Ipv4 interfaces which can be used as output interfaces during packet forwarding.

Returns: the index of the Ipv4 interface added.

Once a device has been added, it can never be removed: if you want to disable it, you can invoke Ipv4::SetDown which will make sure that it is never used during packet forwarding.

Implements ns3::Ipv4.

Definition at line 278 of file ipv4-l3-protocol.cc.

References AddIpv4Interface(), ns3::CreateObject(), m_ipForward, m_node, ns3::MakeCallback(), NS_LOG_FUNCTION, ns3::PeekPointer(), ns3::ArpL3Protocol::PROT_NUMBER, PROT_NUMBER, ns3::ArpL3Protocol::Receive(), Receive(), and ns3::Node::RegisterProtocolHandler().

Here is the call graph for this function:

uint32_t ns3::Ipv4L3Protocol::AddIpv4Interface ( Ptr< Ipv4Interface > interface )

private

Add an IPv4 interface to the stack.

Parameters

interface interface to add

Returns: index of newly added interface

Definition at line 296 of file ipv4-l3-protocol.cc.

References m_interfaces, and NS_LOG_FUNCTION.

Referenced by AddInterface(), and SetupLoopback().

Here is the caller graph for this function:

Ipv4Header ns3::Ipv4L3Protocol::BuildHeader	(	Ipv4Address	source,
		Ipv4Address	destination,
		uint8_t	protocol,
		uint16_t	payloadSize,
		uint8_t	ttl,
		uint8_t	tos,
		bool	mayFragment
	)

private

Construct an IPv4 header.

Parameters

source	source IPv4 address
destination	destination IPv4 address
protocol	L4 protocol
payloadSize	payload size
ttl	Time to Live
tos	Type of Service
mayFragment	true if the packet can be fragmented

Returns: newly created IPv4 header

Definition at line 721 of file ipv4-l3-protocol.cc.

References ns3::Node::ChecksumEnabled(), ns3::Ipv4Header::EnableChecksum(), m_identification, NS_LOG_FUNCTION, ns3::Ipv4Header::SetDestination(), ns3::Ipv4Header::SetDontFragment(), ns3::Ipv4Header::SetIdentification(), ns3::Ipv4Header::SetMayFragment(), ns3::Ipv4Header::SetPayloadSize(), ns3::Ipv4Header::SetProtocol(), ns3::Ipv4Header::SetSource(), ns3::Ipv4Header::SetTos(), and ns3::Ipv4Header::SetTtl().

Referenced by Send().

Here is the call graph for this function:

Here is the caller graph for this function:

Ptr< Socket > ns3::Ipv4L3Protocol::CreateRawSocket ( void )

virtual

Creates a raw socket.

Returns: a smart pointer to the instantiated raw socket

Implements ns3::Ipv4.

Definition at line 138 of file ipv4-l3-protocol.cc.

References m_node, m_sockets, NS_LOG_FUNCTION, and ns3::Ipv4RawSocketImpl::SetNode().

Here is the call graph for this function:

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

virtual

Deletes a particular raw socket.

Parameters

socket Smart pointer to the raw socket to be deleted

Implements ns3::Ipv4.

Definition at line 147 of file ipv4-l3-protocol.cc.

References m_sockets, and NS_LOG_FUNCTION.

void ns3::Ipv4L3Protocol::DoDispose ( void )

protectedvirtual

This method is called by Object::Dispose or by the object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overriden version of this method and chain up to their parent's implementation once they are done. i.e., for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose method.

It is safe to call GetObject from within this method.

Reimplemented from ns3::Object.

Definition at line 198 of file ipv4-l3-protocol.cc.

References ns3::Object::DoDispose(), m_fragments, m_fragmentsTimers, m_interfaces, m_node, m_protocols, m_routingProtocol, m_sockets, and NS_LOG_FUNCTION.

Here is the call graph for this function:

void ns3::Ipv4L3Protocol::DoFragmentation	(	Ptr< Packet >	packet,
		uint32_t	outIfaceMtu,
		std::list< Ptr< Packet > > &	listFragments
	)

private

Fragment a packet.

Parameters

packet	the packet
outIfaceMtu	the MTU of the interface
listFragments	the list of fragments

Definition at line 1225 of file ipv4-l3-protocol.cc.

References ns3::Packet::AddHeader(), ns3::Node::ChecksumEnabled(), ns3::Packet::Copy(), ns3::Packet::CreateFragment(), ns3::Ipv4Header::EnableChecksum(), ns3::Ipv4Header::GetFragmentOffset(), ns3::Ipv4Header::GetSerializedSize(), ns3::Packet::GetSize(), ns3::Ipv4Header::IsLastFragment(), NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, ns3::Packet::Print(), ns3::Packet::RemoveHeader(), ns3::Ipv4Header::SetFragmentOffset(), ns3::Ipv4Header::SetLastFragment(), ns3::Ipv4Header::SetMoreFragments(), and ns3::Ipv4Header::SetPayloadSize().

Referenced by SendRealOut().

Here is the call graph for this function:

Here is the caller graph for this function:

Ipv4InterfaceAddress ns3::Ipv4L3Protocol::GetAddress	(	uint32_t	interface,
		uint32_t	addressIndex
	)		const

virtual

Because addresses can be removed, the addressIndex is not guaranteed to be static across calls to this method.

Parameters

interface	Interface number of an Ipv4 interface
addressIndex	index of Ipv4InterfaceAddress

Returns: the Ipv4InterfaceAddress associated to the interface and addressIndex

Implements ns3::Ipv4.

Definition at line 982 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Interface::GetAddress(), and NS_LOG_FUNCTION.

Referenced by IsDestinationAddress(), IsUnicast(), LocalDeliver(), SelectSourceAddress(), and Send().

Here is the call graph for this function:

Here is the caller graph for this function:

Ptr< Icmpv4L4Protocol > ns3::Ipv4L3Protocol::GetIcmp ( void ) const

private

Get ICMPv4 protocol.

Returns: Icmpv4L4Protocol pointer

Definition at line 526 of file ipv4-l3-protocol.cc.

References ns3::Object::GetObject(), GetProtocol(), ns3::Icmpv4L4Protocol::GetStaticProtocolNumber(), and NS_LOG_FUNCTION.

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

Here is the call graph for this function:

Here is the caller graph for this function:

Ptr< Ipv4Interface > ns3::Ipv4L3Protocol::GetInterface ( uint32_t i ) const

Get an interface.

Parameters

i	interface index

Returns: IPv4 interface pointer

Definition at line 305 of file ipv4-l3-protocol.cc.

References m_interfaces, and NS_LOG_FUNCTION.

Referenced by EpcS1uUlTestCase::DoRun(), GetNAddresses(), GetNetDevice(), LocalDeliver(), and SendRealOut().

Here is the caller graph for this function:

int32_t ns3::Ipv4L3Protocol::GetInterfaceForAddress ( Ipv4Address address ) const

virtual

Return the interface number of the interface that has been assigned the specified IP address.

Parameters

address The IP address being searched for

Returns: The interface number of the Ipv4 interface with the given address or -1 if not found.

Each IP interface has one or more IP addresses associated with it. This method searches the list of interfaces for one that holds a particular address. This call takes an IP address as a parameter and returns the interface number of the first interface that has been assigned that address, or -1 if not found. There must be an exact match; this method will not match broadcast or multicast addresses.

Implements ns3::Ipv4.

Definition at line 323 of file ipv4-l3-protocol.cc.

References first::address, m_interfaces, and NS_LOG_FUNCTION.

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

virtual

Parameters

device The NetDevice for an Ipv4Interface

Returns: The interface number of an Ipv4 interface or -1 if not found.

Implements ns3::Ipv4.

Definition at line 368 of file ipv4-l3-protocol.cc.

References m_interfaces, and NS_LOG_FUNCTION.

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

Here is the caller graph for this function:

int32_t ns3::Ipv4L3Protocol::GetInterfaceForPrefix	(	Ipv4Address	address,
		Ipv4Mask	mask
	)		const

virtual

Return the interface number of first interface found that has an Ipv4 address within the prefix specified by the input address and mask parameters.

Parameters

address	The IP address assigned to the interface of interest.
mask	The IP prefix to use in the mask

Returns: The interface number of the Ipv4 interface with the given address or -1 if not found.

Each IP interface has one or more IP addresses associated with it. This method searches the list of interfaces for the first one found that holds an address that is included within the prefix formed by the input address and mask parameters. The value -1 is returned if no match is found.

Implements ns3::Ipv4.

Definition at line 345 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Address::CombineMask(), m_interfaces, and NS_LOG_FUNCTION.

Here is the call graph for this function:

bool ns3::Ipv4L3Protocol::GetIpForward ( void ) const

privatevirtual

Get the IP forwarding state.

Returns: true if IP is in forwarding state

Implements ns3::Ipv4.

Definition at line 1196 of file ipv4-l3-protocol.cc.

References m_ipForward, and NS_LOG_FUNCTION.

uint16_t ns3::Ipv4L3Protocol::GetMetric ( uint32_t interface ) const

virtual

Parameters

interface The interface number of an Ipv4 interface

Returns: routing metric (cost) associated to the underlying Ipv4 interface

Implements ns3::Ipv4.

Definition at line 1099 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Interface::GetMetric(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

uint16_t ns3::Ipv4L3Protocol::GetMtu ( uint32_t interface ) const

virtual

Parameters

interface Interface number of Ipv4 interface

Returns: the Maximum Transmission Unit (in bytes) associated to the underlying Ipv4 interface

Implements ns3::Ipv4.

Definition at line 1107 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Interface::GetDevice(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

uint32_t ns3::Ipv4L3Protocol::GetNAddresses ( uint32_t interface ) const

virtual

Parameters

interface Interface number of an Ipv4 interface

Returns: the number of Ipv4InterfaceAddress entries for the interface.

Implements ns3::Ipv4.

Definition at line 990 of file ipv4-l3-protocol.cc.

References GetInterface(), ns3::Ipv4Interface::GetNAddresses(), and NS_LOG_FUNCTION.

Referenced by IsDestinationAddress(), IsUnicast(), LocalDeliver(), SelectSourceAddress(), and Send().

Here is the call graph for this function:

Here is the caller graph for this function:

Ptr< NetDevice > ns3::Ipv4L3Protocol::GetNetDevice ( uint32_t interface )

virtual

Parameters

interface The interface number of an Ipv4 interface.

Returns: The NetDevice associated with the Ipv4 interface number.

Implements ns3::Ipv4.

Definition at line 1178 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Interface::GetDevice(), GetInterface(), and NS_LOG_FUNCTION.

Referenced by IpMulticastForward().

Here is the call graph for this function:

Here is the caller graph for this function:

uint32_t ns3::Ipv4L3Protocol::GetNInterfaces ( void ) const

virtual

Returns: the number of interfaces added by the user.

Implements ns3::Ipv4.

Definition at line 316 of file ipv4-l3-protocol.cc.

References m_interfaces, and NS_LOG_FUNCTION.

Referenced by IsDestinationAddress(), IsUnicast(), and SelectSourceAddress().

Here is the caller graph for this function:

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

virtual

Parameters

protocolNumber number of protocol to lookup in this L4 Demux

Returns: a matching L4 Protocol

This method is typically called by lower layers to forward packets up the stack to the right protocol.

Implements ns3::Ipv4.

Definition at line 109 of file ipv4-l3-protocol.cc.

References m_protocols, and NS_LOG_FUNCTION.

Referenced by GetIcmp(), and LocalDeliver().

Here is the caller graph for this function:

Ptr< Ipv4RoutingProtocol > ns3::Ipv4L3Protocol::GetRoutingProtocol ( void ) const

virtual

Get the routing protocol to be used by this Ipv4 stack.

Returns: smart pointer to Ipv4RoutingProtocol object, or null pointer if none

Implements ns3::Ipv4.

Definition at line 191 of file ipv4-l3-protocol.cc.

References m_routingProtocol, and NS_LOG_FUNCTION.

TypeId ns3::Ipv4L3Protocol::GetTypeId ( void )

static

Get the type ID.

Returns: the object TypeId

Definition at line 52 of file ipv4-l3-protocol.cc.

References m_defaultTos, m_defaultTtl, m_dropTrace, m_fragmentExpirationTimeout, m_interfaces, m_localDeliverTrace, m_rxTrace, m_sendOutgoingTrace, m_txTrace, m_unicastForwardTrace, ns3::MakeObjectVectorAccessor(), ns3::MakeTimeChecker(), ns3::MakeTraceSourceAccessor(), and ns3::TypeId::SetParent().

Here is the call graph for this function:

bool ns3::Ipv4L3Protocol::GetWeakEsModel ( void ) const

privatevirtual

Get the Weak Es Model status.

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

Returns: true for Weak Es Model activated

Implements ns3::Ipv4.

Definition at line 1210 of file ipv4-l3-protocol.cc.

References m_weakEsModel, and NS_LOG_FUNCTION.

Referenced by IsDestinationAddress().

Here is the caller graph for this function:

void ns3::Ipv4L3Protocol::HandleFragmentsTimeout	(	std::pair< uint64_t, uint32_t >	key,
		Ipv4Header &	ipHeader,
		uint32_t	iif
	)

private

Process the timeout for packet fragments.

Parameters

key	representing the packet fragments
ipHeader	the IP header of the original packet
iif	Input Interface

Definition at line 1506 of file ipv4-l3-protocol.cc.

References DROP_FRAGMENT_TIMEOUT, GetIcmp(), ns3::Object::GetObject(), ns3::Packet::GetSize(), m_dropTrace, m_fragments, m_fragmentsTimers, m_node, and NS_LOG_FUNCTION.

Referenced by ProcessFragment().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::Ipv4L3Protocol::Insert ( Ptr< IpL4Protocol > protocol )

virtual

Parameters

protocol a template for the protocol to add to this L4 Demux.

Returns: the L4Protocol effectively added.

Invoke Copy on the input template to get a copy of the input protocol which can be used on the Node on which this L4 Demux is running. The new L4Protocol is registered internally as a working L4 Protocol and returned from this method. The caller does not get ownership of the returned pointer.

Implements ns3::Ipv4.

Definition at line 103 of file ipv4-l3-protocol.cc.

References m_protocols, and NS_LOG_FUNCTION.

void ns3::Ipv4L3Protocol::IpForward	(	Ptr< Ipv4Route >	rtentry,
		Ptr< const Packet >	p,
		const Ipv4Header &	header
	)

private

Forward a packet.

Parameters

rtentry	route
p	packet to forward
header	IPv4 header to add to the packet

Definition at line 878 of file ipv4-l3-protocol.cc.

References ns3::Packet::Copy(), DROP_TTL_EXPIRED, GetIcmp(), ns3::Node::GetId(), GetInterfaceForDevice(), ns3::Object::GetObject(), m_dropTrace, m_node, m_unicastForwardTrace, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, ns3::Icmpv4L4Protocol::PROT_NUMBER, and SendRealOut().

Referenced by Receive().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::Ipv4L3Protocol::IpMulticastForward	(	Ptr< Ipv4MulticastRoute >	mrtentry,
		Ptr< const Packet >	p,
		const Ipv4Header &	header
	)

private

Forward a multicast packet.

Parameters

mrtentry	route
p	packet to forward
header	IPv6 header to add to the packet

Definition at line 843 of file ipv4-l3-protocol.cc.

References ns3::Packet::Copy(), DROP_TTL_EXPIRED, ns3::Ipv4Address::GetAny(), ns3::Ipv4Header::GetDestination(), ns3::Node::GetId(), GetNetDevice(), ns3::Object::GetObject(), ns3::Ipv4Header::GetSource(), ns3::Ipv4Header::GetTtl(), m_dropTrace, m_node, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, SendRealOut(), ns3::Ipv4Route::SetDestination(), ns3::Ipv4Route::SetGateway(), ns3::Ipv4Route::SetOutputDevice(), ns3::Ipv4Route::SetSource(), and ns3::Ipv4Header::SetTtl().

Referenced by Receive().

Here is the call graph for this function:

Here is the caller graph for this function:

bool ns3::Ipv4L3Protocol::IsDestinationAddress	(	Ipv4Address	address,
		uint32_t	iif
	)		const

virtual

Determine whether address and interface corresponding to received packet can be accepted for local delivery.

Parameters

address	The IP address being considered
iif	The incoming Ipv4 interface index

Returns: true if the address is associated with the interface index

This method can be used to determine whether a received packet has an acceptable address for local delivery on the host. The address may be a unicast, multicast, or broadcast address. This method will return true if address is an exact match of a unicast address on one of the host's interfaces (see below), if address corresponds to a multicast group that the host has joined (and the incoming device is acceptable), or if address corresponds to a broadcast address.

If the Ipv4 attribute WeakEsModel is true, the unicast address may match any of the Ipv4 addresses on any interface. If the attribute is false, the address must match one assigned to the incoming device.

Implements ns3::Ipv4.

Definition at line 387 of file ipv4-l3-protocol.cc.

References GetAddress(), ns3::Ipv4InterfaceAddress::GetBroadcast(), ns3::Ipv4InterfaceAddress::GetLocal(), GetNAddresses(), GetNInterfaces(), GetWeakEsModel(), ns3::Ipv4Address::IsBroadcast(), ns3::Ipv4Address::IsMulticast(), NS_LOG_FUNCTION, and NS_LOG_LOGIC.

Here is the call graph for this function:

bool ns3::Ipv4L3Protocol::IsForwarding ( uint32_t interface ) const

virtual

Parameters

interface Interface number of Ipv4 interface

Returns: true if IP forwarding enabled for input datagrams on this device

Implements ns3::Ipv4.

Definition at line 1161 of file ipv4-l3-protocol.cc.

References NS_LOG_FUNCTION, and NS_LOG_LOGIC.

bool ns3::Ipv4L3Protocol::IsUnicast ( Ipv4Address ad ) const

Check if an IPv4 address is unicast according to the node.

This function checks all the node's interfaces and the respective subnet masks. An address is considered unicast if it's not broadcast, subnet-broadcast or multicast.

Parameters

ad address

Returns: true if the address is unicast

Definition at line 541 of file ipv4-l3-protocol.cc.

References GetAddress(), ns3::Ipv4InterfaceAddress::GetBroadcast(), GetNAddresses(), GetNInterfaces(), ns3::Ipv4Address::IsBroadcast(), ns3::Ipv4Address::IsMulticast(), NS_LOG_FUNCTION, and NS_LOG_LOGIC.

Here is the call graph for this function:

bool ns3::Ipv4L3Protocol::IsUnicast	(	Ipv4Address	ad,
		Ipv4Mask	interfaceMask
	)		const

private

Check if an IPv4 address is unicast.

Parameters

ad	address
interfaceMask	the network mask

Returns: true if the address is unicast

Definition at line 570 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Address::IsMulticast(), ns3::Ipv4Address::IsSubnetDirectedBroadcast(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

bool ns3::Ipv4L3Protocol::IsUp ( uint32_t interface ) const

virtual

Parameters

interface Interface number of Ipv4 interface

Returns: true if the underlying interface is in the "up" state, false otherwise.

Implements ns3::Ipv4.

Definition at line 1115 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Interface::IsUp(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

void ns3::Ipv4L3Protocol::LocalDeliver	(	Ptr< const Packet >	p,
		Ipv4Header const &	ip,
		uint32_t	iif
	)

private

Deliver a packet.

Parameters

p	packet delivered
ip	IPv4 header
iif	input interface packet was received

Definition at line 906 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Address::CombineMask(), ns3::Packet::Copy(), GetAddress(), ns3::Ipv4Header::GetDestination(), ns3::Ipv4Header::GetFragmentOffset(), GetIcmp(), GetInterface(), ns3::Ipv4InterfaceAddress::GetLocal(), ns3::Ipv4InterfaceAddress::GetMask(), GetNAddresses(), GetProtocol(), ns3::Ipv4Header::GetProtocol(), ns3::Ipv4Header::GetSerializedSize(), ns3::Packet::GetSize(), ns3::Ipv4Address::IsBroadcast(), ns3::Ipv4Header::IsLastFragment(), ns3::Ipv4Address::IsMulticast(), ns3::Ipv4Address::IsSubnetDirectedBroadcast(), m_localDeliverTrace, NS_LOG_FUNCTION, NS_LOG_LOGIC, ProcessFragment(), ns3::IpL4Protocol::Receive(), ns3::IpL4Protocol::RX_CSUM_FAILED, ns3::IpL4Protocol::RX_ENDPOINT_CLOSED, ns3::IpL4Protocol::RX_ENDPOINT_UNREACH, ns3::IpL4Protocol::RX_OK, ns3::Ipv4Header::SetFragmentOffset(), and ns3::Ipv4Header::SetPayloadSize().

Referenced by Receive().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::Ipv4L3Protocol::NotifyNewAggregate ( void )

protectedvirtual

This function will 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 165 of file ipv4-l3-protocol.cc.

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

Here is the call graph for this function:

Ipv4L3Protocol& ns3::Ipv4L3Protocol::operator= ( const Ipv4L3Protocol & )

private

Copy constructor.

Defined but not implemented to avoid misuse

Returns: the copied object

bool ns3::Ipv4L3Protocol::ProcessFragment	(	Ptr< Packet > &	packet,
		Ipv4Header &	ipHeader,
		uint32_t	iif
	)

private

Process a packet fragment.

Parameters

packet	the packet
ipHeader	the IP header
iif	Input Interface

Returns: true is the fragment completed the packet

Definition at line 1318 of file ipv4-l3-protocol.cc.

References ns3::Ipv4L3Protocol::Fragments::AddFragment(), ns3::Packet::Copy(), ns3::Ipv4Address::Get(), ns3::Ipv4Header::GetDestination(), ns3::Ipv4Header::GetFragmentOffset(), ns3::Ipv4Header::GetIdentification(), ns3::Ipv4L3Protocol::Fragments::GetPacket(), ns3::Ipv4Header::GetProtocol(), ns3::Packet::GetSize(), ns3::Ipv4Header::GetSource(), HandleFragmentsTimeout(), ns3::Ipv4L3Protocol::Fragments::IsEntire(), ns3::Ipv4Header::IsLastFragment(), m_fragmentExpirationTimeout, m_fragments, m_fragmentsTimers, ns3::Simulator::Now(), NS_LOG_FUNCTION, NS_LOG_LOGIC, and ns3::Simulator::Schedule().

Referenced by LocalDeliver().

Here is the call graph for this function:

Here is the caller graph for this function:

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

Lower layer calls this method after calling L3Demux::Lookup The ARP subclass needs to know from which NetDevice this packet is coming to:

implement a per-NetDevice ARP cache
send back arp replies on the right device
Parameters

device network device

p the packet

protocol protocol value

from address of the correspondant

to address of the destination

packetType type of the packet

Definition at line 450 of file ipv4-l3-protocol.cc.

References ns3::Node::ChecksumEnabled(), ns3::Packet::Copy(), DROP_BAD_CHECKSUM, DROP_INTERFACE_DOWN, DROP_NO_ROUTE, ns3::Ipv4Header::EnableChecksum(), ns3::Ipv4RawSocketImpl::ForwardUp(), ns3::Ipv4Interface::GetDevice(), ns3::Node::GetId(), ns3::Object::GetObject(), ns3::Ipv4Header::GetPayloadSize(), IpForward(), IpMulticastForward(), ns3::Ipv4Header::IsChecksumOk(), ns3::Ipv4Interface::IsUp(), LocalDeliver(), m_dropTrace, m_interfaces, m_node, m_routingProtocol, m_rxTrace, m_sockets, ns3::MakeCallback(), NS_ASSERT_MSG, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, and RouteInputError().

Referenced by AddInterface(), and SetupLoopback().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::Ipv4L3Protocol::Remove ( Ptr< IpL4Protocol > protocol )

Parameters

protocol protocol to remove from this demux.

The input value to this method should be the value returned from the Ipv4L4Protocol::Insert method.

Definition at line 122 of file ipv4-l3-protocol.cc.

References m_protocols, and NS_LOG_FUNCTION.

bool ns3::Ipv4L3Protocol::RemoveAddress	(	uint32_t	interface,
		uint32_t	addressIndex
	)

virtual

Remove the address at addressIndex on named interface.

The addressIndex for all higher indices will decrement by one after this method is called; so, for example, to remove 5 addresses from an interface i, one could call RemoveAddress (i, 0); 5 times.

Parameters

interface	Interface number of an Ipv4 interface
addressIndex	index of Ipv4InterfaceAddress to remove

Returns: true if the operation succeeded

Implements ns3::Ipv4.

Definition at line 998 of file ipv4-l3-protocol.cc.

References first::address, m_routingProtocol, and NS_LOG_FUNCTION.

bool ns3::Ipv4L3Protocol::RemoveAddress	(	uint32_t	interface,
		Ipv4Address	address
	)

virtual

Remove the given address on named Ipv4 interface.

Parameters

interface	Interface number of an Ipv4 interface
address	The address to remove

Returns: true if the operation succeeded

Implements ns3::Ipv4.

Definition at line 1015 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Address::GetLoopback(), m_routingProtocol, NS_LOG_FUNCTION, and NS_LOG_WARN.

Here is the call graph for this function:

void ns3::Ipv4L3Protocol::RouteInputError	(	Ptr< const Packet >	p,
		const Ipv4Header &	ipHeader,
		Socket::SocketErrno	sockErrno
	)

private

Fallback when no route is found.

Parameters

p	packet
ipHeader	IPv4 header
sockErrno	error number

Definition at line 1217 of file ipv4-l3-protocol.cc.

References DROP_ROUTE_ERROR, ns3::Object::GetObject(), m_dropTrace, m_node, NS_LOG_FUNCTION, and NS_LOG_LOGIC.

Referenced by Receive().

Here is the call graph for this function:

Here is the caller graph for this function:

Ipv4Address ns3::Ipv4L3Protocol::SelectSourceAddress	(	Ptr< const NetDevice >	device,
		Ipv4Address	dst,
		Ipv4InterfaceAddress::InterfaceAddressScope_e	scope
	)

virtual

Return the first primary source address with scope less than or equal to the requested scope, to use in sending a packet to destination dst out of the specified device.

This method mirrors the behavior of Linux inet_select_addr() and is provided because interfaces may have multiple IP addresses configured on them with different scopes, and with a primary and secondary status. Secondary addresses are never returned.

See also: Ipv4InterfaceAddress

If a non-zero device pointer is provided, the method first tries to return a primary address that is configured on that device, and whose subnet matches that of dst and whose scope is less than or equal to the requested scope. If a primary address does not match the subnet of dst but otherwise matches the scope, it is returned. If no such address on the device is found, the other devices are searched in order of their interface index, but not considering dst as a factor in the search. Because a loopback interface is typically the first one configured on a node, it will be the first alternate device to be tried. Addresses scoped at LINK scope are not returned in this phase.

If no device pointer is provided, the same logic as above applies, only that there is no preferred device that is consulted first. This means that if the device pointer is null, input parameter dst will be ignored.

If there are no possible addresses to return, a warning log message is issued and the all-zeroes address is returned.

Parameters

device	output NetDevice (optionally provided, only to constrain the search)
dst	Destination address to match, if device is provided
scope	Scope of returned address must be less than or equal to this

Returns: the first primary Ipv4Address that meets the search criteria

Implements ns3::Ipv4.

Definition at line 1038 of file ipv4-l3-protocol.cc.

References ns3::Ipv4Address::CombineMask(), GetAddress(), GetInterfaceForDevice(), ns3::Ipv4InterfaceAddress::GetLocal(), ns3::Ipv4InterfaceAddress::GetMask(), GetNAddresses(), GetNInterfaces(), ns3::Ipv4InterfaceAddress::GetScope(), ns3::Ipv4InterfaceAddress::IsSecondary(), ns3::Ipv4InterfaceAddress::LINK, NS_ASSERT_MSG, NS_LOG_FUNCTION, and NS_LOG_WARN.

Here is the call graph for this function:

void ns3::Ipv4L3Protocol::Send	(	Ptr< Packet >	packet,
		Ipv4Address	source,
		Ipv4Address	destination,
		uint8_t	protocol,
		Ptr< Ipv4Route >	route
	)

virtual

Parameters

packet	packet to send
source	source address of packet
destination	address of packet
protocol	number of packet
route	route entry

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

Implements ns3::Ipv4.

Definition at line 590 of file ipv4-l3-protocol.cc.

References ns3::Packet::AddHeader(), BuildHeader(), ns3::Ipv4Address::CombineMask(), ns3::Packet::Copy(), DROP_NO_ROUTE, GetAddress(), ns3::Ipv4Interface::GetDevice(), ns3::Ipv4Route::GetGateway(), GetInterfaceForDevice(), ns3::Ipv4InterfaceAddress::GetLocal(), ns3::Ipv4InterfaceAddress::GetMask(), GetNAddresses(), ns3::Object::GetObject(), ns3::Packet::GetSize(), ns3::SocketIpTosTag::GetTos(), ns3::SocketIpTtlTag::GetTtl(), ns3::Ipv4Address::IsBroadcast(), ns3::Ipv4Address::IsLocalMulticast(), ns3::Ipv4Address::IsSubnetDirectedBroadcast(), m_defaultTos, m_defaultTtl, m_dropTrace, m_interfaces, m_node, m_routingProtocol, m_sendOutgoingTrace, m_txTrace, NS_ASSERT, NS_FATAL_ERROR, NS_LOG_ERROR, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, ns3::Packet::RemovePacketTag(), ns3::Ipv4Interface::Send(), and SendRealOut().

Referenced by ns3::NscTcpL4Protocol::NotifyNewAggregate(), and ns3::dsr::DsrRouting::NotifyNewAggregate().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::Ipv4L3Protocol::SendRealOut	(	Ptr< Ipv4Route >	route,
		Ptr< Packet >	packet,
		Ipv4Header const &	ipHeader
	)

private

Send packet with route.

Parameters

route	route
packet	packet to send
ipHeader	IPv4 header to add to the packet

Definition at line 762 of file ipv4-l3-protocol.cc.

References ns3::Packet::AddHeader(), DoFragmentation(), DROP_INTERFACE_DOWN, DROP_NO_ROUTE, ns3::Ipv4Header::GetDestination(), ns3::Ipv4Route::GetGateway(), GetInterface(), ns3::Object::GetObject(), ns3::Ipv4Route::GetOutputDevice(), ns3::Packet::GetSize(), ns3::Ipv4Address::IsEqual(), list, m_dropTrace, m_node, m_txTrace, NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_LOGIC, NS_LOG_WARN, and ns3::Packet::RemoveHeader().

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

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::Ipv4L3Protocol::SendWithHeader	(	Ptr< Packet >	packet,
		Ipv4Header	ipHeader,
		Ptr< Ipv4Route >	route
	)

virtual

Parameters

packet	packet to send
ipHeader	IP Header
route	route entry

Higher-level layers call this method to send a packet with IPv4 Header (Intend to be used with IpHeaderInclude attribute.)

Implements ns3::Ipv4.

Definition at line 577 of file ipv4-l3-protocol.cc.

References ns3::Node::ChecksumEnabled(), ns3::Ipv4Header::EnableChecksum(), NS_LOG_FUNCTION, and SendRealOut().

Here is the call graph for this function:

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

Parameters

ttl	default ttl to use

When we need to send an ipv4 packet, we use this default ttl value.

Definition at line 271 of file ipv4-l3-protocol.cc.

References m_defaultTtl, and NS_LOG_FUNCTION.

void ns3::Ipv4L3Protocol::SetDown ( uint32_t interface )

virtual

Parameters

interface Interface number of Ipv4 interface

Set the interface into the "down" state. In this state, it is ignored during Ipv4 forwarding.

Implements ns3::Ipv4.

Definition at line 1148 of file ipv4-l3-protocol.cc.

References m_routingProtocol, NS_LOG_FUNCTION, and ns3::Ipv4Interface::SetDown().

Here is the call graph for this function:

void ns3::Ipv4L3Protocol::SetForwarding	(	uint32_t	interface,
		bool	val
	)

virtual

Parameters

interface	Interface number of Ipv4 interface
val	Value to set the forwarding flag

If set to true, IP forwarding is enabled for input datagrams on this device

Implements ns3::Ipv4.

Definition at line 1170 of file ipv4-l3-protocol.cc.

References NS_LOG_FUNCTION, and ns3::Ipv4Interface::SetForwarding().

Here is the call graph for this function:

void ns3::Ipv4L3Protocol::SetIpForward ( bool forward )

privatevirtual

Set or unset the IP forwarding state.

Parameters

forward the forwarding state

Implements ns3::Ipv4.

Definition at line 1185 of file ipv4-l3-protocol.cc.

References m_interfaces, m_ipForward, and NS_LOG_FUNCTION.

void ns3::Ipv4L3Protocol::SetMetric	(	uint32_t	interface,
		uint16_t	metric
	)

virtual

Parameters

interface	The interface number of an Ipv4 interface
metric	routing metric (cost) associated to the underlying Ipv4 interface

Implements ns3::Ipv4.

Definition at line 1091 of file ipv4-l3-protocol.cc.

References NS_LOG_FUNCTION, and ns3::Ipv4Interface::SetMetric().

Here is the call graph for this function:

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

Set node associated with this stack.

Parameters

node	node to set

Definition at line 129 of file ipv4-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:

void ns3::Ipv4L3Protocol::SetRoutingProtocol ( Ptr< Ipv4RoutingProtocol > routingProtocol )

virtual

Register a new routing protocol to be used by this Ipv4 stack.

This call will replace any routing protocol that has been previously registered. If you want to add multiple routing protocols, you must add them to a Ipv4ListRoutingProtocol directly.

Parameters

routingProtocol smart pointer to Ipv4RoutingProtocol object

Implements ns3::Ipv4.

Definition at line 182 of file ipv4-l3-protocol.cc.

References m_routingProtocol, and NS_LOG_FUNCTION.

Referenced by AddInternetStack(), anonymous_namespace{ipv4-packet-info-tag-test-suite.cc}::AddInternetStack(), CreateDualStackNode(), and TcpTestCase::CreateInternetNode().

Here is the caller graph for this function: