NS3 Ipv4AddressHelper类API说明

文件位置:
/src/internet/helper/ipv4-address-helper.h

一个帮助类,在脚本中进行简单的IPv4地址分配时使生活更容易。

这个类是一个非常简单的IPv4地址生成器。 你可以把它想象成一个简单的局部数字递增器。 它没有概念IP地址是全局地址空间的一部分。 如果你有一个复杂的地址分配情况,你可能想看看Ipv4AddressGenerator,它确认IP地址和网络号码生成是全局问题的一部分。 Ipv4AddressHelper是一个简单的类,使简单的问题容易处理。

我们调用全局地址生成器来确保没有生成重复地址。

    Ipv4AddressHelper ()

构造一个帮助类,以便在脚本中进行简单的IPv4地址分配时更容易。


    Ipv4AddressHelper (Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")

构造一个帮助类,以便在脚本中进行简单的IPv4地址分配时更容易。
此版本在构造函数中设置基址和掩码


Ipv4InterfaceContainer  Assign (const NetDeviceContainer &c)

根据当前网络前缀和地址基础,为容器中指定的网络设备分配IP地址。

地址助手根据给定的网络号和初始IP地址分配IP地址。为了分离网络号和IP地址部分,给SetBase一个初始值和一个网络掩 码。该掩码的一个位定义了前缀类别,帮助器将从该前缀类别分配新的网络号。在SetBase方法的基本参数中,在对应于掩码中的位置为1的位中提供网络号的初始值。对于IP地址计数器的初始值也被提供在对应于掩模中的位置为0。

此方法为容器中的每个网络设备获取新地址。对于容器中的每个网络设备,帮助器找到关联的节点并查找与网络设备相对应的Ipv4接口。然后将接口中的Ipv4Address和掩码设置为适当的值。如果地址溢出了由SetBase方法中的网络掩码为它们分配的位数,则系统将NS_ASSERT和halt。


Ipv4Address     NewAddress (void)

增加用于分配IP地址的IP地址计数器。

地址助手根据给定的网络号和初始IP地址分配IP地址。 为了分离网络号和IP地址部分,给SetBase一个初始网络号值,网络掩码和初始地址基。

此方法增加IP地址计数器。 进行检查以确保返回的地址不会溢出在SetBase中分配给IP地址的位数(地址位数由不是“1”的掩码位数定义)。

例如,如果网络号设置为192.168.0.0,在SetBase中的掩码为255.255.255.0和基地址为0.0.0.3,则下一次调用NewAddress将返回192.168.1.3。 NewAddress方法具有后递增语义。 以下NewAddress将返回192.168.0.4等,直到第253次调用由于地址溢出而被断言。


Ipv4Address     NewNetwork (void)

增加网络号并将IP地址计数器重置为SetBase方法中提供的基本值。

地址助手根据给定的网络号和初始IP地址分配IP地址。为了分离网络号和IP地址部分,给SetBase一个初始网络号值,网络掩码和初始地址基。

此方法会递增网络编号,并将IP地址计数器重置为使用的最后一个基本值。例如,如果网络号设置为192.168.0.0,在SetBase调用中的掩码为255.255.255.0和基地址为0.0.0.3;对NewNetwork的呼叫将增加网络号计数器,导致网络号增加为192.168.1.0,192.168.2.0等。在每个网络号增加之后,IP地址计数器被重置为在SetBase中指定的初始值。在这种情况下,这将是0.0.0.3。因此如果您在导致网络号为192.168.2.0的增量后调用NewAddress,NewAddress返回的分配地址将为192.168.2.3,192.168.2.4等。


void    SetBase (Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")

设置基本网络号,网络掩码和基本地址。

地址助手基于给定的网络号和掩码组合以及初始IP地址来分配IP地址。

例如,如果要使用初始网络号为192.168.1(对应于255.255.255.0的掩码)的/ 24前缀,并且您希望从192.168.1.3开始分配该网络中的IP地址,则 会调用

SetBase(“192.168.1.0”,“255.255.255.0”,“0.0.0.3”);

如果你不关心初始地址,它默认为“0.0.0.1”,在这种情况下你可以简单地使用,

SetBase(“192.168.1.0”,“255.255.255.0”);

并且生成的第一个地址将为192.168.1.1。


私有方法:

uint32_t ns3::Ipv4AddressHelper::NumAddressBits     (   uint32_t    maskbits    )   const

返回给定网络掩码的地址位(hostpart)的数量。


PS:

从这个类中,我们可以看出,这个类实现了IP地址的自动分配。但是这种自动分配是按序递增分配,
如果

SetBase(“192.168.1.0”,“255.255.255.0”,“0.0.0.3”);

则,对于设备分配的地址依次是192.168.1.3,192.168.1.4,192.168.1.5,...

如果

SetBase(“192.168.1.0”,“255.255.255.0”);

则,对于设备分配的地址依次是192.168.1.1,192.168.1.2,192.168.1.3,...

按照上面的设置,如果在代码中给设备分配了不属于上面的地址,则导致的问题是IP地址不匹配。
有可能在Socket中的一些设置无效。

可参考代码/examples/80211rtscts/wifi-ap-test.cc

你可能感兴趣的:(NS3 Ipv4AddressHelper类API说明)