ns3::Mac48Address Class Reference

an EUI-48 address More...

#include "mac48-address.h"

Collaboration diagram for ns3::Mac48Address:

Public Types
typedef void(*	TracedCallback) (Mac48Address value)
	TracedCallback signature for Mac48Address. More...

Public Member Functions
	Mac48Address ()
	Mac48Address (const char *str)
Address	ConvertTo () const
void	CopyFrom (const uint8_t buffer[6])
void	CopyTo (uint8_t buffer[6]) const
bool	IsBroadcast () const
bool	IsGroup () const
	operator Address () const

Static Public Member Functions
static Mac48Address	Allocate ()
	Allocate a new Mac48Address. More...
static Mac48Address	ConvertFrom (const Address &address)
static Mac48Address	GetBroadcast ()
static Mac48Address	GetMulticast (Ipv4Address address)
static Mac48Address	GetMulticast (Ipv6Address address)
	Get multicast address from IPv6 address. More...
static Mac48Address	GetMulticast6Prefix ()
	Get the multicast prefix for IPv6 (33:33:00:00:00:00). More...
static Mac48Address	GetMulticastPrefix ()
static bool	IsMatchingType (const Address &address)
static void	ResetAllocationIndex ()
	Reset the Mac48Address allocation index. More...

Static Private Member Functions
static uint8_t	GetType ()
	Return the Type of address. More...

Private Attributes
uint8_t	m_address [6]
	address value More...

Static Private Attributes
static uint64_t	m_allocationIndex = 0
	Address allocation index. More...

Friends
bool	operator!= (const Mac48Address &a, const Mac48Address &b)
	Not equal to operator. More...
bool	operator< (const Mac48Address &a, const Mac48Address &b)
	Less than operator. More...
std::ostream &	operator<< (std::ostream &os, const Mac48Address &address)
	Stream insertion operator. More...
bool	operator== (const Mac48Address &a, const Mac48Address &b)
	Equal to operator. More...
std::istream &	operator>> (std::istream &is, Mac48Address &address)
	Stream extraction operator. More...

Detailed Description

an EUI-48 address

This class can contain 48 bit IEEE addresses.

See also

Mac48Address Attribute

Definition at line 45 of file mac48-address.h.

Member Typedef Documentation

TracedCallback

typedef void(* ns3::Mac48Address::TracedCallback) (Mac48Address value)

TracedCallback signature for Mac48Address.

Parameters

[in]

value

Current value of the Mac48Address

Definition at line 161 of file mac48-address.h.

Constructor & Destructor Documentation

Mac48Address() [1/2]

ns3::Mac48Address::Mac48Address

(

)

Definition at line 69 of file mac48-address.cc.

References m_address, and NS_LOG_FUNCTION.

Referenced by GetBroadcast(), GetMulticast6Prefix(), and GetMulticastPrefix().

Here is the caller graph for this function:

Mac48Address() [2/2]

ns3::Mac48Address::Mac48Address

(

const char *

str

)

Parameters

str	a string representing the new Mac48Address

The format of the string is "xx:xx:xx:xx:xx:xx"

Definition at line 75 of file mac48-address.cc.

References ASCII_a, ASCII_COLON, ASCII_ZERO, ns3::AsciiToLowCase(), m_address, NS_ASSERT, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Member Function Documentation

Allocate()

Mac48Address ns3::Mac48Address::Allocate ( )

static

Allocate a new Mac48Address.

Returns

newly allocated mac48Address

Definition at line 151 of file mac48-address.cc.

References first::address, m_allocationIndex, NS_LOG_FUNCTION_NOARGS, ResetAllocationIndex(), and ns3::Simulator::ScheduleDestroy().

Referenced by ns3::NoBackhaulEpcHelper::NoBackhaulEpcHelper(), ns3::TapFdNetDeviceHelper::TapFdNetDeviceHelper(), AddSimpleNetDevice(), BuildSimpleTopology(), ns3::WifiMacHelper::Create(), ns3::MeshHelper::CreateInterface(), ns3::WaveHelper::Install(), ns3::AdhocAlohaNoackIdealPhyHelper::Install(), ns3::WimaxHelper::Install(), ns3::PointToPointHelper::Install(), ns3::FdNetDeviceHelper::InstallPriv(), ns3::CsmaHelper::InstallPriv(), ns3::SimpleNetDeviceHelper::InstallPriv(), ns3::LteSimpleHelper::InstallSingleEnbDevice(), and ns3::LteSimpleHelper::InstallSingleUeDevice().

Here is the call graph for this function:

Here is the caller graph for this function:

ConvertFrom()

Mac48Address ns3::Mac48Address::ConvertFrom ( const Address &  address )

static

Parameters

address

a polymorphic address

Returns

a new Mac48Address from the polymorphic address

This function performs a type check and asserts if the type of the input address is not compatible with an Mac48Address.

Definition at line 141 of file mac48-address.cc.

References first::address, GetType(), m_address, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by ns3::BridgeNetDevice::AddBridgePort(), ns3::MeshPointDevice::AddInterface(), AddSimpleNetDevice(), ContextToMac(), ns3::TapBridge::CreateTap(), ns3::TapBridge::ForwardToBridgedDevice(), ns3::dot11s::HwmpProtocol::Install(), ns3::dot11s::PeerManagementProtocol::Install(), ns3::flame::FlameProtocol::Install(), ns3::aodv::Neighbors::LookupMacAddress(), ns3::dsr::DsrRouteCache::LookupMacAddress(), ns3::Ipv6Address::MakeAutoconfiguredAddress(), ns3::Ipv6Address::MakeAutoconfiguredLinkLocalAddress(), ns3::Ipv6AddressHelper::NewAddress(), ns3::dsr::DsrRouting::PromiscReceive(), ns3::WifiMac::Receive(), ns3::StaWifiMac::Receive(), ns3::TapBridge::ReceiveFromBridgedDevice(), ns3::BridgeNetDevice::ReceiveFromDevice(), ns3::MeshPointDevice::ReceiveFromDevice(), ns3::GtpTunnelApp::RecvFromTunnelSocket(), ns3::MeshHelper::Report(), ns3::LoopbackNetDevice::Send(), ns3::MeshPointDevice::Send(), ns3::WaveNetDevice::Send(), ns3::WifiNetDevice::Send(), ns3::WimaxNetDevice::Send(), ns3::BridgeNetDevice::SendFrom(), ns3::CsmaNetDevice::SendFrom(), ns3::FdNetDevice::SendFrom(), ns3::LoopbackNetDevice::SendFrom(), ns3::MeshPointDevice::SendFrom(), ns3::SimpleNetDevice::SendFrom(), ns3::AlohaNoackNetDevice::SendFrom(), ns3::WifiNetDevice::SendFrom(), ns3::WimaxNetDevice::SendFrom(), ns3::WaveNetDevice::SendX(), ns3::MeshPointDevice::SetAddress(), ns3::BridgeNetDevice::SetAddress(), ns3::CsmaNetDevice::SetAddress(), ns3::FdNetDevice::SetAddress(), ns3::LoopbackNetDevice::SetAddress(), ns3::LrWpanNetDevice::SetAddress(), ns3::SimpleNetDevice::SetAddress(), ns3::PointToPointNetDevice::SetAddress(), ns3::AlohaNoackNetDevice::SetAddress(), ns3::TapBridge::SetAddress(), ns3::WaveNetDevice::SetAddress(), ns3::WifiNetDevice::SetAddress(), and ns3::WimaxNetDevice::SetAddress().

Here is the call graph for this function:

Here is the caller graph for this function:

ConvertTo()

Address ns3::Mac48Address::ConvertTo

(

)

const

Returns

a new Address instance

Convert an instance of this class to a polymorphic Address instance.

Definition at line 134 of file mac48-address.cc.

References GetType(), m_address, and NS_LOG_FUNCTION.

Here is the call graph for this function:

CopyFrom()

void ns3::Mac48Address::CopyFrom

(

const uint8_t

buffer[6]

)

Parameters

buffer

address in network order

Copy the input address to our internal buffer.

Definition at line 108 of file mac48-address.cc.

References m_address, and NS_LOG_FUNCTION.

Referenced by ns3::LrWpanNetDevice::BuildPseudoMacAddress(), ns3::TapBridge::CreateTap(), ns3::dot11s::HwmpTag::Deserialize(), ns3::flame::FlameTag::Deserialize(), ns3::SimpleTag::Deserialize(), GetMulticast(), ns3::TunnelController::HandleArpPacketIn(), QosController::HandleArpPacketIn(), QosController::HandleConnectionRequest(), and ns3::ReadFrom().

Here is the caller graph for this function:

CopyTo()

void ns3::Mac48Address::CopyTo

(

uint8_t

buffer[6]

)

const

Parameters

buffer

address in network order

Copy the internal address to the input buffer.

Definition at line 115 of file mac48-address.cc.

References m_address, and NS_LOG_FUNCTION.

Referenced by SwitchFlowTableTestCase::DoRun(), GetMulticast(), ns3::Ipv6Address::MakeAutoconfiguredAddress(), ns3::Ipv6Address::MakeAutoconfiguredLinkLocalAddress(), ns3::dot11s::HwmpTag::Serialize(), ns3::flame::FlameTag::Serialize(), ns3::SimpleTag::Serialize(), ns3::LrWpanNetDevice::SetAddress(), and ns3::WriteTo().

Here is the caller graph for this function:

GetBroadcast()

Mac48Address ns3::Mac48Address::GetBroadcast ( )

static

Returns

the broadcast address

Definition at line 201 of file mac48-address.cc.

References Mac48Address(), and NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::NoBackhaulEpcHelper::AddEnb(), ns3::dot11s::PeerLink::ConfirmAccept(), ns3::dot11s::PeerLink::ConfirmReject(), ns3::MeshWifiBeacon::CreateHeader(), ns3::dot11s::HwmpRtable::DeleteProactivePath(), ns3::dot11s::HwmpProtocolMac::ForwardPerr(), ns3::dot11s::HwmpProtocol::ForwardUnicast(), ns3::LteNetDevice::GetBroadcast(), ns3::MockNetDevice::GetBroadcast(), ns3::WaveNetDevice::GetBroadcast(), ns3::WifiNetDevice::GetBroadcast(), ns3::WimaxNetDevice::GetBroadcast(), ns3::dot11s::HwmpProtocol::GetBroadcastReceivers(), ns3::dot11s::HwmpProtocol::GetPreqReceivers(), ns3::MultiUserScheduler::GetTriggerFrame(), ns3::flame::FlameProtocol::HandleDataFrame(), IsBroadcast(), ns3::dot11s::HwmpRtable::LookupResult::IsValid(), ns3::flame::FlameRtable::LookupResult::IsValid(), ns3::dot11s::IePreq::MayAddAddress(), ns3::dot11s::PeerLink::OpenAccept(), ns3::dot11s::PeerLink::OpenReject(), ns3::dot11s::HwmpProtocol::ProactivePathResolved(), ns3::dot11s::HwmpProtocol::ReactivePathResolved(), ns3::MeshWifiInterfaceMac::Receive(), ns3::flame::FlameProtocolMac::Receive(), ns3::dot11s::PeerManagementProtocol::ReceiveBeacon(), ns3::dot11s::HwmpProtocolMac::ReceiveData(), ns3::dot11s::HwmpProtocol::ReceivePrep(), ns3::dot11s::HwmpProtocol::ReceivePreq(), ns3::flame::FlameProtocol::RemoveRoutingStuff(), ns3::dot11s::HwmpProtocol::RequestRoute(), ns3::flame::FlameProtocol::RequestRoute(), ns3::dot11s::HwmpProtocol::RetryPathDiscovery(), ns3::QosFrameExchangeManager::SendCfEndIfNeeded(), ns3::MeshWifiInterfaceMac::SendManagementFrame(), ns3::HeFrameExchangeManager::SendMuRts(), ns3::ApWifiMac::SendOneBeacon(), WaveNetDeviceExample::SendOneWsmpPacket(), ns3::dot11s::HwmpProtocol::SendProactivePreq(), ns3::StaWifiMac::SendProbeRequest(), WaveNetDeviceExample::SendWsaExample(), ns3::dot11s::PeerLink::StateMachine(), and ns3::flame::FlameProtocolMac::UpdateOutcomingFrame().

Here is the call graph for this function:

Here is the caller graph for this function:

GetMulticast() [1/2]

Mac48Address ns3::Mac48Address::GetMulticast ( Ipv4Address  address )

static

Parameters

address

base IPv4 address

Returns

a multicast address

Definition at line 225 of file mac48-address.cc.

References CopyFrom(), CopyTo(), GetMulticastPrefix(), NS_LOG_FUNCTION, and ns3::Ipv4Address::Serialize().

Referenced by ns3::LteNetDevice::GetMulticast(), ns3::AlohaNoackNetDevice::GetMulticast(), ns3::BridgeNetDevice::GetMulticast(), ns3::CsmaNetDevice::GetMulticast(), ns3::FdNetDevice::GetMulticast(), ns3::LoopbackNetDevice::GetMulticast(), ns3::MeshPointDevice::GetMulticast(), ns3::SimpleNetDevice::GetMulticast(), ns3::MockNetDevice::GetMulticast(), ns3::TapBridge::GetMulticast(), ns3::WaveNetDevice::GetMulticast(), ns3::WifiNetDevice::GetMulticast(), and ns3::WimaxNetDevice::GetMulticast().

Here is the call graph for this function:

Here is the caller graph for this function:

GetMulticast() [2/2]

Mac48Address ns3::Mac48Address::GetMulticast ( Ipv6Address  address )

static

Get multicast address from IPv6 address.

Parameters

address

base IPv6 address

Returns

a multicast address

Definition at line 263 of file mac48-address.cc.

References CopyFrom(), CopyTo(), GetMulticast6Prefix(), NS_LOG_FUNCTION, and ns3::Ipv6Address::Serialize().

Here is the call graph for this function:

GetMulticast6Prefix()

Mac48Address ns3::Mac48Address::GetMulticast6Prefix ( )

static

Get the multicast prefix for IPv6 (33:33:00:00:00:00).

Returns

a multicast address.

Definition at line 217 of file mac48-address.cc.

References Mac48Address(), and NS_LOG_FUNCTION_NOARGS.

Referenced by GetMulticast().

Here is the call graph for this function:

Here is the caller graph for this function:

GetMulticastPrefix()

Mac48Address ns3::Mac48Address::GetMulticastPrefix ( )

static

Returns

the multicast prefix (01:00:5e:00:00:00).

Definition at line 209 of file mac48-address.cc.

References Mac48Address(), and NS_LOG_FUNCTION_NOARGS.

Referenced by GetMulticast().

Here is the call graph for this function:

Here is the caller graph for this function:

GetType()

uint8_t ns3::Mac48Address::GetType ( )

staticprivate

Return the Type of address.

Returns

type of address

Definition at line 179 of file mac48-address.cc.

References NS_LOG_FUNCTION_NOARGS, ns3::Address::Register(), and check-style-clang-format::type.

Referenced by ConvertFrom(), ConvertTo(), and IsMatchingType().

Here is the call graph for this function:

Here is the caller graph for this function:

IsBroadcast()

bool ns3::Mac48Address::IsBroadcast

(

)

const

Returns

true if this is a broadcast address, false otherwise.

Definition at line 187 of file mac48-address.cc.

References GetBroadcast(), and NS_LOG_FUNCTION.

Referenced by MeshTest::CreateNodes(), ns3::TapBridge::CreateTap(), ns3::MeshPointDevice::DoSend(), ns3::FdNetDevice::ForwardUp(), ns3::WaveNetDevice::ForwardUp(), ns3::WifiNetDevice::ForwardUp(), ns3::MpduAggregator::GetNextAmpdu(), ns3::QosTxop::GetNextMpdu(), ns3::AlohaNoackNetDevice::NotifyReceptionEndOk(), ns3::QosTxop::PeekNextMpdu(), ns3::ApWifiMac::Receive(), ns3::CsmaNetDevice::Receive(), ns3::LoopbackNetDevice::Receive(), ns3::SimpleNetDevice::Receive(), ns3::HeFrameExchangeManager::ReceiveMpdu(), and ns3::LoopbackNetDevice::SendFrom().

Here is the call graph for this function:

Here is the caller graph for this function:

IsGroup()

bool ns3::Mac48Address::IsGroup

(

)

const

Returns

true if the group bit is set, false otherwise.

Definition at line 194 of file mac48-address.cc.

References m_address, and NS_LOG_FUNCTION.

Referenced by ns3::dot11s::AirtimeLinkMetricCalculator::CalculateMetric(), ns3::ApWifiMac::CanForwardPacketsTo(), MultiLinkOperationsTestBase::CheckAddresses(), ns3::ApWifiMac::ForwardDown(), ns3::FdNetDevice::ForwardUp(), ns3::WaveNetDevice::ForwardUp(), ns3::WifiNetDevice::ForwardUp(), ns3::WifiRemoteStationManager::GetAckTxVector(), ns3::WifiRemoteStationManager::GetAssociationId(), ns3::WifiRemoteStationManager::GetBlockAckTxVector(), ns3::WifiRemoteStationManager::GetCtsTxVector(), ns3::WifiRemoteStationManager::GetDataTxVector(), ns3::MacTxMiddle::GetNextSequenceNumberFor(), ns3::WifiMacQueueContainer::GetQueueId(), ns3::MacRxMiddle::Lookup(), ns3::AlohaNoackNetDevice::NotifyReceptionEndOk(), ns3::WifiMacQueue::PeekByTidAndAddress(), ns3::MacTxMiddle::PeekNextSequenceNumberFor(), ns3::MacRxMiddle::Receive(), ns3::OcbWifiMac::Receive(), ns3::ApWifiMac::Receive(), ns3::StaWifiMac::Receive(), ns3::FrameExchangeManager::Receive(), ns3::CsmaNetDevice::Receive(), ns3::LoopbackNetDevice::Receive(), ns3::SimpleNetDevice::Receive(), ns3::MeshPointDevice::ReceiveFromDevice(), ns3::WifiRemoteStationManager::ReportDataOk(), ns3::WifiRemoteStationManager::ReportFinalRtsFailed(), ns3::WifiRemoteStationManager::ReportRtsFailed(), ns3::WifiRemoteStationManager::ReportRtsOk(), ns3::BridgeNetDevice::SendFrom(), ns3::VsaManager::SendVsa(), ns3::MacTxMiddle::SetSequenceNumberFor(), ns3::HtFrameExchangeManager::StartFrameExchange(), ns3::WifiDefaultAckManager::TryAddMpdu(), and ns3::dot11s::PeerManagementProtocolMac::UpdateOutcomingFrame().

Here is the caller graph for this function:

IsMatchingType()

bool ns3::Mac48Address::IsMatchingType ( const Address &  address )

static

Parameters

address

address to test

Returns

true if the address matches, false otherwise.

Definition at line 122 of file mac48-address.cc.

References first::address, GetType(), and NS_LOG_FUNCTION.

Referenced by ns3::BridgeNetDevice::AddBridgePort(), ns3::MeshPointDevice::AddInterface(), ns3::SixLowPanNetDevice::DoSend(), ns3::SixLowPanNetDevice::Get16MacFrom48Mac(), ns3::MockNetDevice::GetBroadcast(), ns3::MockNetDevice::GetMulticast(), ns3::Ipv6Address::MakeAutoconfiguredAddress(), ns3::Ipv6Address::MakeAutoconfiguredLinkLocalAddress(), ns3::Ipv6AddressHelper::NewAddress(), ns3::SixLowPanNetDevice::ReceiveFromDevice(), ns3::LrWpanNetDevice::Send(), ns3::WifiNetDevice::Send(), ns3::WifiNetDevice::SendFrom(), ns3::LrWpanNetDevice::SetAddress(), and ns3::TapBridge::SetBridgedNetDevice().

Here is the call graph for this function:

Here is the caller graph for this function:

operator Address()

ns3::Mac48Address::operator Address

(

)

const

Returns

a new Address instance

Convert an instance of this class to a polymorphic Address instance.

Definition at line 128 of file mac48-address.cc.

ResetAllocationIndex()

void ns3::Mac48Address::ResetAllocationIndex ( )

static

Reset the Mac48Address allocation index.

This function resets (to zero) the global integer that is used for unique address allocation. It is automatically called whenever

SimulatorDestroy ();

is called. It may also be optionally called by user code if there is a need to force a reset of this allocation index.

Definition at line 172 of file mac48-address.cc.

References m_allocationIndex, and NS_LOG_FUNCTION_NOARGS.

Referenced by Allocate().

Here is the caller graph for this function:

Friends And Related Function Documentation

operator!=

bool operator!= ( const Mac48Address &  a, const Mac48Address &  b  )

friend

Not equal to operator.

Parameters

a	the first operand
b	the first operand

Returns

true if the operands are not equal

Definition at line 228 of file mac48-address.h.

operator<

bool operator< ( const Mac48Address &  a, const Mac48Address &  b  )

friend

Less than operator.

Parameters

a	the first operand
b	the first operand

Returns

true if the operand a is less than operand b

Definition at line 233 of file mac48-address.h.

operator<<

std::ostream& operator<< ( std::ostream &  os, const Mac48Address &  address  )

friend

Stream insertion operator.

Parameters

os	the stream
address	the address

Returns

a reference to the stream

Definition at line 285 of file mac48-address.cc.

operator==

bool operator== ( const Mac48Address &  a, const Mac48Address &  b  )

friend

Equal to operator.

Parameters

a	the first operand
b	the first operand

Returns

true if the operands are equal

Definition at line 222 of file mac48-address.h.

operator>>

std::istream& operator>> ( std::istream &  is, Mac48Address &  address  )

friend

Stream extraction operator.

Parameters

is	the stream
address	the address

Returns

a reference to the stream

Definition at line 305 of file mac48-address.cc.

Member Data Documentation

m_address

uint8_t ns3::Mac48Address::m_address[6]

private

address value

Definition at line 216 of file mac48-address.h.

Referenced by Mac48Address(), ConvertFrom(), ConvertTo(), CopyFrom(), CopyTo(), and IsGroup().

m_allocationIndex

uint64_t ns3::Mac48Address::m_allocationIndex = 0

staticprivate

Address allocation index.

Definition at line 215 of file mac48-address.h.

Referenced by Allocate(), and ResetAllocationIndex().

---

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

• src/network/utils/mac48-address.h
• src/network/utils/mac48-address.cc