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

Describes an IPv6 prefix. More...

#include "ipv6-address.h"

+ Collaboration diagram for ns3::Ipv6Prefix:

Public Member Functions

 Ipv6Prefix ()
 Default constructor.
 
 Ipv6Prefix (const char *prefix)
 Constructs an Ipv6Prefix by using the input string.
 
 Ipv6Prefix (const char *prefix, uint8_t prefixLength)
 Constructs an Ipv6Prefix by using the input string.
 
 Ipv6Prefix (const Ipv6Prefix &prefix)
 Copy constructor.
 
 Ipv6Prefix (const Ipv6Prefix *prefix)
 Copy constructor.
 
 Ipv6Prefix (uint8_t prefix)
 Constructs an Ipv6Prefix by using the input number of bits.
 
 Ipv6Prefix (uint8_t prefix[16])
 Constructs an Ipv6Prefix by using the input 16 bytes.
 
 Ipv6Prefix (uint8_t prefix[16], uint8_t prefixLength)
 Constructs an Ipv6Prefix by using the input 16 bytes.
 
 ~Ipv6Prefix ()
 Destructor.
 
Ipv6Address ConvertToIpv6Address () const
 Convert the Prefix into an IPv6 Address.
 
void GetBytes (uint8_t buf[16]) const
 Get the bytes corresponding to the prefix.
 
uint8_t GetMinimumPrefixLength () const
 Get the minimum prefix length, i.e., 128 - the length of the largest sequence trailing zeroes.
 
uint8_t GetPrefixLength () const
 Get prefix length.
 
bool IsMatch (Ipv6Address a, Ipv6Address b) const
 If the Address match the type.
 
void Print (std::ostream &os) const
 Print this address to the given output stream.
 
void SetPrefixLength (uint8_t prefixLength)
 Set prefix length.
 

Static Public Member Functions

static Ipv6Prefix GetLoopback ()
 Get the loopback prefix ( /128).
 
static Ipv6Prefix GetOnes ()
 Get the "all-1" IPv6 mask (ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff).
 
static Ipv6Prefix GetZero ()
 Get the zero prefix ( /0).
 

Private Attributes

uint8_t m_prefix [16]
 The prefix representation.
 
uint8_t m_prefixLength
 The prefix length.
 

Friends

bool operator!= (const Ipv6Prefix &a, const Ipv6Prefix &b)
 Not equal to operator.
 
bool operator== (const Ipv6Prefix &a, const Ipv6Prefix &b)
 Equal to operator.
 

Detailed Description

Describes an IPv6 prefix.

It is just a bitmask like Ipv4Mask.

See also
Ipv6Address
Ipv6Prefix Attribute

Definition at line 454 of file ipv6-address.h.

Constructor & Destructor Documentation

◆ Ipv6Prefix() [1/8]

ns3::Ipv6Prefix::Ipv6Prefix ( )

Default constructor.

Definition at line 790 of file ipv6-address.cc.

References m_prefix, m_prefixLength, and NS_LOG_FUNCTION.

◆ Ipv6Prefix() [2/8]

ns3::Ipv6Prefix::Ipv6Prefix ( uint8_t  prefix[16])

Constructs an Ipv6Prefix by using the input 16 bytes.

The prefix length is calculated as the minimum prefix length, i.e., 2001:db8:cafe:: will have a 47 bit prefix length.

Parameters
prefixthe 128-bit prefix

Definition at line 807 of file ipv6-address.cc.

References GetMinimumPrefixLength(), m_prefix, m_prefixLength, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Ipv6Prefix() [3/8]

ns3::Ipv6Prefix::Ipv6Prefix ( const char *  prefix)

Constructs an Ipv6Prefix by using the input string.

The prefix length is calculated as the minimum prefix length, i.e., 2001:db8:cafe:: will have a 47 bit prefix length.

Parameters
prefixthe 128-bit prefix

Definition at line 797 of file ipv6-address.cc.

References GetMinimumPrefixLength(), m_prefix, m_prefixLength, NS_ABORT_MSG, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Ipv6Prefix() [4/8]

ns3::Ipv6Prefix::Ipv6Prefix ( uint8_t  prefix[16],
uint8_t  prefixLength 
)

Constructs an Ipv6Prefix by using the input 16 bytes.

Parameters
prefixthe 128-bit prefix
prefixLengththe prefix length

Definition at line 829 of file ipv6-address.cc.

References GetMinimumPrefixLength(), m_prefix, m_prefixLength, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Ipv6Prefix() [5/8]

ns3::Ipv6Prefix::Ipv6Prefix ( const char *  prefix,
uint8_t  prefixLength 
)

Constructs an Ipv6Prefix by using the input string.

Parameters
prefixthe 128-bit prefix
prefixLengththe prefix length

Definition at line 814 of file ipv6-address.cc.

References GetMinimumPrefixLength(), m_prefix, m_prefixLength, NS_ABORT_MSG, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Ipv6Prefix() [6/8]

ns3::Ipv6Prefix::Ipv6Prefix ( uint8_t  prefix)

Constructs an Ipv6Prefix by using the input number of bits.

Parameters
prefixnumber of bits of the prefix (0 - 128)
Note
A valid number of bits is between 0 and 128).

Definition at line 842 of file ipv6-address.cc.

References m_prefix, m_prefixLength, NS_ASSERT, and NS_LOG_FUNCTION.

◆ Ipv6Prefix() [7/8]

ns3::Ipv6Prefix::Ipv6Prefix ( const Ipv6Prefix prefix)

Copy constructor.

Parameters
prefixIpv6Prefix object

Definition at line 878 of file ipv6-address.cc.

References m_prefix, and m_prefixLength.

◆ Ipv6Prefix() [8/8]

ns3::Ipv6Prefix::Ipv6Prefix ( const Ipv6Prefix prefix)

Copy constructor.

Parameters
prefixIpv6Prefix pointer

Definition at line 884 of file ipv6-address.cc.

References m_prefix, and m_prefixLength.

◆ ~Ipv6Prefix()

ns3::Ipv6Prefix::~Ipv6Prefix ( )

Destructor.

Definition at line 890 of file ipv6-address.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ ConvertToIpv6Address()

Ipv6Address ns3::Ipv6Prefix::ConvertToIpv6Address ( ) const

Convert the Prefix into an IPv6 Address.

Returns
an IPv6 address representing the prefix

Definition at line 958 of file ipv6-address.cc.

References m_prefix.

◆ GetBytes()

void ns3::Ipv6Prefix::GetBytes ( uint8_t  buf[16]) const

Get the bytes corresponding to the prefix.

Parameters
bufbuffer to store the data

Definition at line 951 of file ipv6-address.cc.

References m_prefix, and NS_LOG_FUNCTION.

Referenced by ns3::SixLowPanNetDevice::FindMulticastCompressionContext(), ns3::Ipv6AddressGeneratorImpl::Init(), and ns3::Ipv6AddressGeneratorImpl::PrefixToIndex().

+ Here is the caller graph for this function:

◆ GetLoopback()

Ipv6Prefix ns3::Ipv6Prefix::GetLoopback ( )
static

Get the loopback prefix ( /128).

Returns
a Ipv6Prefix corresponding to loopback prefix

Definition at line 927 of file ipv6-address.cc.

References NS_LOG_FUNCTION_NOARGS.

◆ GetMinimumPrefixLength()

uint8_t ns3::Ipv6Prefix::GetMinimumPrefixLength ( ) const

Get the minimum prefix length, i.e., 128 - the length of the largest sequence trailing zeroes.

Returns
minimum prefix length

Definition at line 982 of file ipv6-address.cc.

References m_prefix, and NS_LOG_FUNCTION.

Referenced by Ipv6Prefix().

+ Here is the caller graph for this function:

◆ GetOnes()

Ipv6Prefix ns3::Ipv6Prefix::GetOnes ( )
static

Get the "all-1" IPv6 mask (ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff).

Returns
/128 Ipv6Prefix representation

Definition at line 935 of file ipv6-address.cc.

References NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::Ipv6StaticRouting::AddHostRouteTo(), ns3::Ipv6RoutingTableEntry::CreateHostRouteTo(), and ns3::Ipv6RoutingTableEntry::IsHost().

+ Here is the caller graph for this function:

◆ GetPrefixLength()

◆ GetZero()

Ipv6Prefix ns3::Ipv6Prefix::GetZero ( )
static

Get the zero prefix ( /0).

Returns
an Ipv6Prefix

Definition at line 943 of file ipv6-address.cc.

References NS_LOG_FUNCTION_NOARGS.

Referenced by ns3::RipNg::AddDefaultRouteTo(), ns3::RipNg::DoSendRouteUpdate(), ns3::RipNg::HandleRequests(), and ns3::Ipv6StaticRouting::SetDefaultRoute().

+ Here is the caller graph for this function:

◆ IsMatch()

bool ns3::Ipv6Prefix::IsMatch ( Ipv6Address  a,
Ipv6Address  b 
) const

If the Address match the type.

Parameters
aa first address
ba second address
Returns
true if the type match, false otherwise

Definition at line 897 of file ipv6-address.cc.

References ns3::Ipv6Address::GetBytes(), m_prefix, and NS_LOG_FUNCTION.

Referenced by ns3::Ipv6Interface::GetAddressMatchingDestination(), ns3::Ipv6StaticRouting::HasNetworkDest(), ns3::RipNg::Lookup(), and ns3::Ipv6StaticRouting::LookupStatic().

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

◆ Print()

void ns3::Ipv6Prefix::Print ( std::ostream &  os) const

Print this address to the given output stream.

The print format is in the typical "2001:660:4701::1".

Parameters
osthe output stream to which this Ipv6Address is printed

Definition at line 919 of file ipv6-address.cc.

References GetPrefixLength(), and NS_LOG_FUNCTION.

Referenced by ns3::operator<<().

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

◆ SetPrefixLength()

void ns3::Ipv6Prefix::SetPrefixLength ( uint8_t  prefixLength)

Set prefix length.

Parameters
prefixLengththe prefix length

Definition at line 975 of file ipv6-address.cc.

References m_prefixLength, and NS_LOG_FUNCTION.

Friends And Related Function Documentation

◆ operator!=

bool operator!= ( const Ipv6Prefix a,
const Ipv6Prefix b 
)
friend

Not equal to operator.

Parameters
athe first operand
bthe first operand
Returns
true if the operands are not equal

Definition at line 679 of file ipv6-address.h.

◆ operator==

bool operator== ( const Ipv6Prefix a,
const Ipv6Prefix b 
)
friend

Equal to operator.

Parameters
athe first operand
bthe first operand
Returns
true if the operands are equal

Definition at line 673 of file ipv6-address.h.

Member Data Documentation

◆ m_prefix

uint8_t ns3::Ipv6Prefix::m_prefix[16]
private

The prefix representation.

Definition at line 589 of file ipv6-address.h.

Referenced by Ipv6Prefix(), ConvertToIpv6Address(), GetBytes(), GetMinimumPrefixLength(), and IsMatch().

◆ m_prefixLength

uint8_t ns3::Ipv6Prefix::m_prefixLength
private

The prefix length.

Definition at line 594 of file ipv6-address.h.

Referenced by Ipv6Prefix(), GetPrefixLength(), and SetPrefixLength().


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