author Tom Henderson <>
Thu, 16 Aug 2018 20:02:07 -0700
changeset 13439 0b151774c67d
parent 13418 82d130348a36
permissions -rw-r--r--
Added tag ns-3.28.1 for changeset 74427745bfc1
     1 <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
     2 <html>
     3 <head>
     4    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
     5    <title>ns-3 Change Log</title>
     6 </head>
     7 <body>
     9 <h1>
    10 ns-3: API and model change history</h1>
    11 <!--
    12 This ChangeLog is updated in the reverse order 
    13 with the most recent changes coming first.  Date format:  DD-MM-YYYY
    14 -->
    15 <p>
    16 ns-3 is an evolving system and there will be API or behavioral changes
    17 from time to time.   Users who try to use scripts or models across
    18 versions of ns-3 may encounter problems at compile time, run time, or
    19 may see the simulation output change.  </p>
    20 <p>
    21 We have adopted the development policy that we are going to try to ease
    22 the impact of these changes on users by documenting these changes in a
    23 single place (this file), and not by providing a temporary or permanent
    24 backward-compatibility software layer.  </p>
    25 <p>
    26 A related file is the RELEASE_NOTES file in the top level directory.
    27 This file complements RELEASE_NOTES by focusing on API and behavioral
    28 changes that users upgrading from one release to the next may encounter.
    29 RELEASE_NOTES attempts to comprehensively list all of the changes
    30 that were made.  There is generally some overlap in the information 
    31 contained in RELEASE_NOTES and this file.  </p>
    32 <p>
    33 The goal is that users who encounter a problem when trying to use older
    34 code with newer code should be able to consult this file to find
    35 guidance as to how to fix the problem.  For instance, if a method name
    36 or signature has changed, it should be stated what the new replacement
    37 name is. </p>
    38 <p>
    39 Note that users who upgrade the simulator across versions, or who work
    40 directly out of the development tree, may find that simulation output
    41 changes even when the compilation doesn't break, such as when a
    42 simulator default value is changed.  Therefore, it is good practice for
    43 _anyone_ using code across multiple ns-3 releases to consult this file,
    44 as well as the RELEASE_NOTES, to understand what has changed over time.
    45 </p>
    46 <p>
    47 This file is a best-effort approach to solving this issue; we will do
    48 our best but can guarantee that there will be things that fall through
    49 the cracks, unfortunately.  If you, as a user, can suggest improvements
    50 to this file based on your experience, please contribute a patch or drop
    51 us a note on ns-developers mailing list.</p>
    53 <hr>
    54 <h1>Changes from ns-3.28 to ns-3.28.1</h1>
    55 <h2>Changes to build system:</h2>
    56 <ul>
    57   <li>The '--no32bit-scan' argument is removed from Waf apiscan; generation of ILP32 bindings is now automated from the LP64 bindings.</li>
    58   <li> When using on newer compilers, new warnings may trigger build failures.
    59 The --disable-werror flag can be passed to Waf at configuration time to turn
    60 off the Werror behavior.</li>
    61 </ul>
    63 <hr>
    64 <h1>Changes from ns-3.27 to ns-3.28</h1>
    65 <h2>New API:</h2>
    66 <ul>
    67   <li> When deserializing Packet contents, <b>Header::Deserialize (Buffer::Iterator start)</b> and <b>Trailer::Deserialize (Buffer::Iterator start)</b> can not successfully deserialize variable-length headers and trailers.  New variants of these methods that also include an 'end' parameter are now provided.</li>
    68   <li> Ipv[4,6]AddressGenerator can now check if an address is allocated (<b>Ipv[4,6]AddressGenerator::IsAddressAllocated</b>) or a network has some allocated address (<b>Ipv[4,6]AddressGenerator::IsNetworkAllocated</b>).</li>
    69   <li> LTE UEs can now use IPv6 to send and receive traffic.</li>
    70   <li> UAN module now supports an IP stack.</li>
    71   <li> Class <b>TcpSocketBase</b> trace source <i>CongestionWindowInflated</i> shows the values with the in-recovery inflation and the post-recovery deflation.
    72   <li> Added a FIFO queue disc (FifoQueueDisc) and the Token Bucket Filter (TbfQueueDisc).</li>
    73 </ul>
    74 <h2>Changes to existing API:</h2>
    75 <ul>
    76   <li> Class <b>LrWpanMac</b> now supports extended addressing mode. Both <b>McpsDataRequest</b> and <b>PdDataIndication</b> methods will now use extended addressing if <b>McpsDataRequestParams::m_srcAddrMode</b> or <b>McpsDataRequestParams::m_dstAddrMode</b> are set to <b>EXT_ADDR</b>.</li>
    77   <li> Class <b>LteUeNetDevice</b> MAC address is now a 64-bit address and can be set during construction.</li>
    78   <li> Class <b>TcpSocketBase</b> trace source <i>CongestionWindow</i> shows the values without the in-recovery inflation and the post-recovery deflation; the old behavior has been moved to the new trace source <i>CongestionWindowInflated</i>.
    79 </ul>
    80 <h2>Changes to build system:</h2>
    81 <ul>
    82   <li> The C++ standard used during compilation (default std=c++11) can be now be changed via the CXXFLAGS variable.</li>
    83 </ul>
    84 <h2>Changed behavior:</h2>
    85 <ul>
    86   <li>The Mode, MaxPackets and MaxBytes attributes of the Queue class have been deprecated in favor of the MaxSize attribute. Old attributes can still be used, but using them will be no longer possible in one of the next releases. The methods to get/set the old attributes will be removed as well.</li>
    87   <li>The attributes of the QueueDisc subclasses that separately determine the mode and the limit of the QueueDisc have been deprecated in favor of the single MaxSize attribute.</li>
    88   <li>The GetQueueSize method of some QueueDisc subclasses (e.g., RED) has been removed and replaced by the GetCurrentSize method of the QueueDisc base class.</li>
    89   <li>All Wi-Fi management frames are now transmitted using the lowest basic rate.</li>
    90   <li>The Wi-Fi spectrum model now takes into account adjacent channels through OFDM transmit spectrum masks.</li>
    91   <li> The CsmaNetDevice::PhyTxBeginTrace will trace all attempts to transmit, even those that result in drops. Previously, eventual channel drops were excluded from this trace.</l>
    92   <li>The TCP congestion window trace now does not report on window inflation during fast recovery phase because it is no longer internally maintained as an inflated value (a separate trace called CongestionWindowInflated can be used to recover the old trace behavior).</li>
    93 </ul>
    95 <hr>
    96 <h1>Changes from ns-3.26 to ns-3.27</h1>
    97 <h2>New API:</h2>
    98 <ul>
    99 <li>Added <code>Vector{2,3}D.GetLength ()</code>.</li>
   100 <li>Overloaded <code>operator+</code> and <code>operator-</code> for <code>Vector{2,3}D</code>.</li>
   101 <li>Added iterator version of WifiHelper::Install() to install Wi-Fi devices on range of nodes.</li>
   102 <li>Added a new attribute in TcpSocketBase to track the advertised window.</li>
   103 <li>Included the model of <b>TCP Ledbat</b>.</li>
   104 <li>Included the TCP SACK-based loss recovery algorithm outlined in RFC 6675.</li>
   105 <li>Added <b>TCP SACK</b> and the <b>SACK emulation</b>. Added an Attribute to TcpSocketBase class,
   106     called "Sack", to enable or disable the SACK option usage.</li>
   107 <li>In 'src/wifi', several changes were made to enable partial <b>802.11ax</b> High Effiency (HE) support:
   108     <ul>
   109       <li>A new standard value has been added that enables the new 11ax data rates.</li>
   110       <li>A new 11ax preamble has been added.</li>
   111       <li>A new attribute was added to configure the guard interval duration for High Efficiency (HE) PHY entities. This attribute can be set using the YansWifiPhyHelper.</li>
   112       <li>A new information element has been added:  HeCapabilities. This information element is added to the MAC frame header if the node is a HE node. This HeCapabilites information element is used to advertise the HE capabilites of the node to other nodes in the network.</li>
   113     </ul>
   114 </li>
   115 <li> A new class were added for the RRPAA WiFi rate control mechanism.</li>
   116 <li>Included carrier aggregation feature in LTE module</li>
   117     <ul>
   118       <li>LTE model is extended to support carrier aggregation feature according to 3GPP Release 10, for up to 5 component 
   119       carriers. </li>
   120       <li>InstallSingleEnbDevice and InstalSingeUeDevice functions of LteHelper are now constructing LteEnbDevice and LteUeDevice 
   121       according to CA architecture. Each device, UE and eNodeB contains an instance of component carrier manager, and may 
   122       have several component carrier instances.</li>
   123       <li>SAP interfaces are extended to include CA message exchange funtionality.</li>
   124       <li>RRC connection procedure is extended to allow RRC connection reconfiguration for the configuration of the secondary carriers.</li>
   125       <li>RRC measurement reporting is extended to allow measurement reporting from the secondary carriers.</li>
   126       <li>LTE traces are extended to include component carrier id.</li>
   127     </ul>
   128 </li>
   129 <li>Function <b>PrintRoutingTable</b> has been extended to add an optional Time::Units
   130     parameter to specify the time units used on the report.  The new parameter is
   131     optional and if not specified defaults to the previous behavior (Time::S).
   132 </li>
   133 <li><b>TxopTrace</b>: new trace source exported by EdcaTxopN.</li>
   134 <li>A <b>GetDscpCounts</b> method is added to <b>Ipv4FlowClassifier</b> and <b>Ipv6FlowClassifier</b>
   135     which returns a vector of pairs (dscp,count), each of which indicates how many packets with the
   136     associated dscp value have been classified for a given flow.
   137 </li>
   138 <li>MqQueueDisc, a multi-queue aware queue disc modelled after the mq qdisc in Linux, has been introduced.
   139 </li>
   140 <li>Two new methods, <b>QueueDisc::DropBeforeEnqueue()</b> and <b>QueueDisc::DropAfterDequeue()</b> have
   141     been introduced to replace <b>QueueDisc::Drop()</b>. These new methods require the caller to specify the
   142     reason why a packet was dropped. Correspondingly, two new trace sources ("DropBeforeEnqueue" and
   143     "DropAfterDequeue") have been added to the QueueDisc class, providing both the items that were dropped
   144     and the reason why they were dropped. 
   145 </li>
   146 <li>Added <b>QueueDisc::GetStats()</b> which returns detailed statistics about the operations of
   147     a queue disc. Statistics can be accessed through the member variables of the returned object and
   148     by calling the <b>GetNDroppedPackets()</b>, <b>GetNDroppedBytes()</b>, <b>GetNMarkedPackets()</b> and <b>GetNMarkedBytes()</b> methods on the returned object. Such methods return the number of packets/bytes
   149     dropped/marked for the specified reason (passed as argument). Consequently:
   150     <ul>
   151       <li>A number of methods of the QueueDisc class have been removed: <b>GetTotalReceivedPackets()</b>,
   152       <b>GetTotalReceivedBytes()</b>, <b>GetTotalDroppedPackets()</b>, <b>GetTotalDroppedBytes()</b>,
   153       <b>GetTotalRequeuedPackets()</b>, <b>GetTotalRequeuedBytes()</b>.</li>
   154       <li>The <b>Stats</b> struct and the <b>GetStats()</b> method of <b>RedQueueDisc</b> and <b>PieQueueDisc</b> have been removed and replaced by those of the QueueDisc base class.</li>
   155       <li>The <b>GetDropOverLimit</b> and <b>GetDropCount</b> methods of <b>CoDelQueueDisc</b> have been removed.
   156       The values they returned can be obtained by calling, respectively,
   157       GetStats ().GetNDroppedPackets (CoDelQueueDisc::OVERLIMIT_DROP) and
   158       GetStats ().GetNDroppedPackets (CoDelQueueDisc::TARGET_EXCEEDED_DROP). The "DropCount" trace of
   159       <b>CoDelQueueDisc</b> has been removed as well. Packets dropped because the target is exceeded can
   160       be obtained through the new "DropAfterDequeue" trace of the QueueDisc class.</li>
   161     </ul>
   162 </li>
   163 <li> The new <b>QueueDisc::Mark()</b> method has been introduced to allow subclasses to request to mark a packet.
   164      The  caller must specify the reason why the packet must be marked. Correspondingly, a new trace source ("Mark")
   165      has been added to the QueueDisc class, providing both the items that were marked and the reason why they
   166      were marked.
   167 </li>
   168 <li>A new trace source, <b>SojournTime</b>, is exported by the QueueDisc base class to provide the
   169     sojourn time of every packet dequeued from a queue disc. This has been made possible by adding a
   170     timestamp to QueueDiscItem objects, which can be set/get through the new <b>GetTimeStamp()</b> and
   171     <b>SetTimeStamp()</b> methods of the QueueDiscItem class. The <b>CoDel</b> queue disc now makes use of such feature of the base class, hence its Sojourn trace source and the CoDelTimestampTag class
   172     have been removed.
   173 </li>
   174 </ul>
   175 <h2>Changes to existing API:</h2>
   176 <ul>
   177 <li><b>ParetoRandomVariable</b> "Mean" attribute has been deprecated, 
   178     the "Scale" Attribute have to be used instead.
   179     Changing the Mean attribute has no more an effect on the distribution.
   180     See the documentation for the relationship between Mean, Scale and Shape. 
   181 </li>
   182 <li>The default logging timestamp precision has been changed from 6 digits
   183     to 9 digits, with a fixed format to ensure that 9 digits to the right of
   184     the decimal point are always printed.  Previously, default C++ iostream
   185     precision and formatting was used.
   186 </li>
   187 <li>Abstract base class <b>WifiChannel</b> has been removed. As a result, a Channel type instead of a WifiChannel type
   188 is now exported by WifiNetDevice.</li>
   189 <li> The <b>GetPacketSize</b> method of <b>QueueItem</b> has been renamed <b>GetSize</b>
   190 </li>
   191 <li> The <b>DequeueAll</b> method of <b>Queue</b> has been renamed <b>Flush</b>
   192 </li>
   193 <li>The attributes <b>WifiPhy::TxAntennas</b> and <b>WifiPhy::RxAntennas</b>,
   194     and the related accessor methods, were replaced by <b>WifiPhy::MaxSupportedTxSpatialStreams</b>
   195     and <b>WifiPhy::MaxSupportedRxSpatialStreams</b>. A new attribute <b>WifiPhy::Antennas</b>
   196     was added to allow users to define the number of physical antennas on the device.
   197 </li>
   198 <li>Sockets do not receive anymore broadcast packets, unless they are bound to an "Any" address (
   199     or to a subnet-directed broadcast packet (e.g., x.y.z.0 for a /24 noterok).
   200     As in Linux, the following rules are now enforced:
   201     <ul>
   202     <li> A socket bound to will receive everything.</li>
   203     <li> A socket bound to x.y.z.0/24 will receive subnet-directed broadcast (x.y.z.255) and unicast packets.</li>
   204     <li> A socket bound to x.y.z.w will only receive unicast packets.</li>
   205     </ul> 
   206     <b>Previously, a socket bound to an unicast address received also subnet-directed broadcast packets. 
   207     This is not anymore possible</b>.
   208 </li>
   209 <li>You can now Bind as many socket as you want to an address/port, provided that they are bound to different NetDevices.
   210     Moreover, BindToNetDevice does not anymore call Bind. In other terms, Bind and BindToNetDevice can be called
   211     in any order.
   212     However, it is suggested to use BindToNetDevice <i>before</i> Bind in order to avoid conflicts.
   213 </li>
   214 </ul>
   215 <h2>Changes to build system:</h2>
   216 <ul>
   217 <li> The API scanning process for Python bindings now relies on CastXML, and only 64-bit scans are presently supported (Linux 64-bit systems).  Generation of 32-bit scans is documented in the Python chapter of the ns-3 manual.
   218 </li>
   219 <li> Modules can now be located in the 'contrib/' directory in addition to 'src/'
   220 </li>
   221 <li> Behavior for running Python programs was aligned with that of C++ programs; the list of modules built is no longer printed out.
   222 </li>
   223 </ul>
   224 <h2>Changed behavior:</h2>
   225 <ul>
   226 <li><b>MultiModelSpectrumChannel</b> does not call StartRx for receivers that
   227     operate on subbands orthogonal to transmitter subbands. Models that depend
   228     on receiving signals with zero power spectral density from orthogonal bands
   229     may change their behavior.
   230     See <a href=>bug 2467</a>
   231     for discussion.
   232 </li>
   233 <li><b>Packet Tag objects</b> are no longer constrained to fit within 21 
   234     bytes; a maximum size is no longer enforced.
   235 </li>
   236   <li> The default value of the <b>TxGain</b> and <b>RxGain</b> attributes in WifiPhy was changed from 1 dB to 0 dB.
   237   </li>
   238   <li> The reported SNR by WifiPhy::MonitorSnifferRx did not include the RxNoiseFigure, but now does; see <a href=>bug 2783</a> for discussion.
   239   </li>
   240 <li><b>Queue</b> has been redesigned as a template class object, where the type parameter
   241     specifies the type of items to be stored in the queue. As a consequence:
   242     <ul>
   243       <li>Being a subclass of Queue, <b>DropTailQueue</b> is a template class as well.
   244       <li>Network devices such as SimpleNetDevice, PointToPointNetDevice and CsmaNetDevice
   245       use a queue of type Queue&lt;Packet&gt; to store the packets to transmit. The SetQueue
   246       method of their helpers, however, can still be invoked as, e.g.,
   247       SetQueue ("ns3::DropTailQueue") instead of, e.g., SetQueue
   248       ("ns3::DropTailQueue&lt;Packet&gt;").</li>
   249       <li>The attributes <b>Mode</b>, <b>MaxPackets</b> and <b>MaxBytes</b> are now
   250       defined by the QueueBase class (which Queue is derived from).</li>
   251     </ul>
   252 </li>
   253 <li>Queue discs that can operate both in packet mode and byte mode (Red, CoDel, Pie) define their own
   254     enum QueueDiscMode instead of using QueueBase::QueueMode.
   255 </li>
   256 <li>The CoDel, PIE and RED queue discs require that the size of the internal queue is the same as
   257     the queue disc limit (previously, it was allowed to be greater than or equal).
   258 </li>
   259   <li> The default value of the <b>EnableBeaconJitter</b> attribute in ApWifiMac was changed from false to true.
   260   </li>
   261   <li> The NormalClose() callback of a TcpSocket object used to fire upon leaving TIME_WAIT state (2*MSL after FINs have been exchanged).  It now fires upon entering TIME_WAIT state.  Timing of the callback for the other path to state CLOSED (through LAST_ACK) has not been changed.
   262   </li>
   263 </ul>
   265 <hr>
   266 <h1>Changes from ns-3.25 to ns-3.26</h1>
   267 <h2>New API:</h2>
   268 <ul>
   269 <li>A <b>SocketPriorityTag</b> is introduced to carry the packet priority. Such a tag
   270     is added to packets by sockets that support this mechanism (UdpSocketImpl,
   271     TcpSocketBase and PacketSocket). The base class Socket has a new SetPriority
   272     method to set the socket priority. When the IPv4 protocol is used, the
   273     priority is set based on the ToS. See the Socket options section of the
   274     Network model for more information.
   275 </li>
   276 <li>A <b>WifiNetDevice::SelectQueue</b> method has been added to determine the user
   277     priority of an MSDU. This method is called by the traffic control layer before
   278     enqueuing a packet in the queue disc, if a queue disc is installed on
   279     the outgoing device, or passing a packet to the device, otherwise. The
   280     user priority is set to the three most significant bits of the DS field
   281     (TOS field in case of IPv4 and Traffic Class field in case of IPv6). The
   282     packet priority carried by the SocketPriorityTag is set to the user priority.
   283 </li>
   284 <li>The <b>PfifoFastQueueDisc</b> classifies packets into bands based on their priority.
   285     See the pfifo_fast queue disc section of the Traffic Control Layer model
   286     for more information.
   287 </li>
   288 <li>A new class <b>SpectrumWifiPhy</b> has been introduced that makes use of the 
   289     Spectrum module.  Its functionality and API is currently very similar to that 
   290     of the YansWifiPhy, especially because it reuses the same InterferenceHelper 
   291     and ErrorModel classes (for this release).  Some example programs in the 
   292     'examples/wireless/' directory, such as '', 
   293     illustrate how the SpectrumWifiPhy class can be substituted for the default 
   294     YansWifiPhy PHY model.
   295 </li>
   296 <li>We have added support for generating traces for the
   297     <a href="">DES Metrics</a> project.
   298     These can be enabled by adding <tt>--enable-des-metrics</tt> at configuration;
   299     you must also use <tt>CommandLine</tt> in your script.  See the API docs
   300     for class <b>DesMetrics</b> for more details.
   301 </li>
   302 <li> The traffic control module now includes the <b>FQ-CoDel</b> and <b>PIE</b> queue disc 
   303     models, and behavior corresponding to Linux <b>Byte Queue Limits (BQL)</b>.
   304 </li>
   305 <li> Several new TCP congestion control variants were introduced, including
   306     <b>TCP Vegas, Scalable, Veno, Illinois, Bic, YeAH, and H-TCP</b> 
   307     congestion control algorithms.
   308 </li>
   309 </ul>
   310 <h2>Changes to existing API:</h2>
   311 <ul>
   312 <li><b>SocketAddressTag</b> was a long-standing approach to approximate the POSIX
   313     socket recvfrom behavior (i.e., to know the source address of a packet) 
   314     without actually calling RecvFrom.  Experience with this revealed that
   315     this option was difficult to use with tunnels (the new tag has to 
   316     replace the old one).  Moreover, there is no real need 
   317     to create a new API when there is a an existing one (i.e., RecvFrom).
   318     As a consequence, SocketAddressTag has been completely removed from ns-3.
   319     Users can use RecvFrom (for UDP), GetPeerName (for TCP), or similar. 
   320 </li>
   321 <li><b>InetSockAddress</b> can now store a ToS value, which can be set through its
   322     SetTos method. The Bind and Connect methods of UDP (UdpSocketImpl) and
   323     TCP (TcpSocketBase) sockets set the socket ToS value to the value provided
   324     through the address input parameter (of type InetSockAddress). See the
   325     Socket options section of the Network model for more information.
   326 </li>
   327 <li>The <b>QosTag</b> is removed as it has been superseded by the SocketPriorityTag.</li>
   328 <li>The <b>Ipv4L3Protocol::DefaultTos</b> attribute is removed.</li>
   329 <li>The attributes <b>YansWifiPhy::Frequency, YansWifiPhy::ChannelNumber, and 
   330     YansWifiPhy::ChannelWidth</b>, and the related accessor methods, were moved to 
   331     base class WifiPhy.  YansWifiPhy::GetChannelFrequencyMhz() was deleted.  
   332     A new method WifiPhy::DefineChannelNumber () was added to allow users to 
   333     define relationships between channel number, standard, frequency, and channel width.
   334 </li>
   335 <li>The class <b>WifiSpectrumValueHelper</b> has been refactored; previously it 
   336     was an abstract base class supporting the WifiSpectrumValue5MhzFactory spectrum 
   337     model.  It now contains various static member methods supporting the creation 
   338     of power spectral densities with the granularity of a Wi-Fi OFDM subcarrier 
   339     bandwidth.  The class <b>WifiSpectrumValue5MhzFactory</b> and its API remain but 
   340     it is not subclassed.
   341  </li>
   342 <li>A new Wifi method <b>InterferenceHelper::AddForeignSignal</b> has been introduced to 
   343     support use of the SpectrumWifiPhy (so that non-Wi-Fi signals may be handled 
   344     as noise power).
   345 </li>
   346 <li>A new Wifi attribute <b>Dcf::TxopLimit</b> has been introduced to add support for 802.11e TXOP.
   347 </li>
   348 </ul>
   349 <h2>Changes to build system:</h2>
   350 <ul>
   351   <li> A new waf build option, <tt>--check-config</tt>, was added to allow users to print the current configuration summary, as appears at the end of ./waf configure.  See bug 2459 for discussion.</li>
   352   <li> The <tt>configure</tt> summary is now sorted, to make it easier to check the status of optional features.</li>
   353 </ul>
   354 <h2>Changed behavior:</h2>
   355 This section is for behavioral changes to the models that were not due to a bug fix.
   356 <ul>
   357   <li>The relationship between Wi-Fi channel number, frequency, channel width, 
   358       and Wi-Fi standard has been revised (see bug 2412).  Previously, ChannelNumber 
   359       and Frequency were attributes of class YansWifiPhy, and the frequency was 
   360       defined as the start of the band.  Now, Frequency has been redefined to be 
   361       the center frequency of the channel, and the underlying device relies on 
   362       the pair of frequency and channel width to control behavior; the channel 
   363       number and Wi-Fi standard are used as attributes to configure frequency 
   364       and channel width.  The wifi module documentation discusses this change 
   365       and the new behavior.
   366   </li>
   367   <li>AODV now honors the TTL in RREQ/RREP and it uses a method 
   368       compliant with <a href="">RFC 3561</a>.      The node search radius is increased progressively. This could increase 
   369       slightly the node search time, but it also decreases the network 
   370       congestion.
   371   </li>
   372 </ul>
   374 <hr>
   375 <h1>Changes from ns-3.24 to ns-3.25</h1>
   376 <h2>New API:</h2>
   377 <ul>
   378   <li> In 'src/internet/test', a new environment is created to test TCP properties.</li>
   379   <li> The 'src/traffic-control' module has been added, with new API for adding and configuring queue discs and packet filters.</li>
   380   <li> Related to traffic control, a new interface has been added to the
   381 NetDevice to provide a queue interface to access device queue state and
   382 register callbacks used for flow control.</li>
   383   <li> In 'src/wifi', a new rate control (MinstrelHT) has been added for
   384 802.11n/ac modes.</li>
   385   <li> In 'src/wifi', a new helper (WifiMacHelper) is added and is a merged helper from all previously existing MAC helpers (NqosWifiMacHelper, QosWifiMacHelper, HtWifiMacHelper and VhtWifiMacHelper).</li>
   386   <li> It is now possible to use RIPv2 in IPv4 network simulations.</li>
   387 </ul>
   388 <h2>Changes to existing API:</h2>
   389 <ul>
   390   <li>TCP-related changes:
   391     <ul>
   392       <li>Classes TcpRfc793, TcpTahoe, and TcpReno were removed.</li>
   393       <li>The 'TcpNewReno' log component was effectively replaced by 'TcpCongestionOps'
   394       <li>TCP Hybla and HighSpeed have been added.</li>
   395       <li>Added the concept of Congestion State Machine inside TcpSocketBase.</li>
   396       <li>Merged Fast Recovery and Fast Retransmit inside TcpSocketBase.</li>
   397       <li>Some member variables have been moved from TcpSocketBase inside TcpSocketState. Attributes are not touched.</li>
   398       <li>Congestion control splitted from TcpSocketBase as subclass of TcpCongestionOps.</li>
   399       <li>Added Rx and Tx callbacks on TcpSocketBase.</li>
   400       <li>Added BytesInFlight trace source on TcpSocketBase. The trace is updated when the implementation requests the value.</li>
   401       <li>Added attributes about the number of connection and data retransmission attempts.</li>
   402     </ul>
   403   </li>
   404   <li> ns-3 is now capable of serializing SLL (a.k.a. cooked) headers.
   405        This is used in DCE to allow the generation of pcap directly readable by wireshark.
   406   </li>
   407   <li> In the WifiHelper class in the wifi module, Default has been declared deprecated. This is now immediately handled by the constructor of the class.</li>
   408   <li> The API for configuring 802.11n/ac aggregation has been modified to be more user friendly. As any MAC layer attributes, aggregation parameters can now also be configured through WifiMacHelper::SetType. </li>
   409   <li> The class Queue and subclasses derived from it have been changed in two ways:
   410   <ul>
   411     <li>Queues no longer enqueue simple Packets but instead enqueue QueueItem objects, which include Packet but possibly other information such as headers.</li>
   412     <li>The attributes governing the mode of operation (packets or bytes) and the maximum size have been moved to base class Queue.</li>
   413   </ul>
   414   </li>
   415   <li> Users of advanced queues (RED, CoDel) who have been using them directly in the NetDevice will need to adjust to the following changes:
   416     <ul>
   417       <li> RED and CoDel are no longer specializations of the Queue classe, but are now specializations of the new QueueDisc class. This means that RED and CoDel can now be installed in the context of the new Traffic Control layer instead of as queues in (some) NetDevices. The reason for such a change is to make the ns-3 stack much more similar to that of real operating systems (Linux has been taken as a reference).  Queuing disciplines such as RED and CoDel can now be tested with all the NetDevices, including WifiNetDevices. </li>
   418       <li> NetDevices still use queues to buffer packets. The only subclass of Queue currently available for this purpose is DropTailQueue. If one wants to approximate the old behavior, one needs to set the DropTailQueue MaxPackets attribute to very low values, e.g., 1.</li>
   419       <li> The Traffic Control layer features a mechanism by which packets dropped by the NetDevice are requeued in the queue disc (more precisely: if NetDevice::Send returns false, the packet is requeued), so that they are retransmitted later. This means that the MAC drop traces may include packets that have not been actually lost, because they have been dropped by the device, requeued by the traffic control layer and successfully retransmitted. To get the correct number of packets that have been actually lost, one has to subtract the number of packets requeued from the number of packets dropped as reported by the MAC drop trace. </li>
   420     </ul>
   421   </li>
   422 </ul>
   423 <h2>Changes to build system:</h2>
   424 <ul>
   425   <li> Waf was upgraded to 1.8.19</li>
   426   <li> A new waf build option, --check-profile, was added to allow users to check the currently active build profile.  It is discussed in bug 2202 in the tracker.</li>
   427 </ul>
   428 <h2>Changed behavior:</h2>
   429 This section is for behavioral changes to the models that were not due to a bug fix.
   430 <ul>
   431   <li>TCP behavioral changes:
   432     <ul>
   433       <li>TCP closes connection after a number of failed segment retries,
   434         rather than trying indefinitely. The maximum number of retries, for both SYN
   435         attempts and data attempts, is controlled by attributes.</li>
   436       <li>Congestion algorithms not compliant with Fast Retransmit
   437         and Fast Recovery (TCP 793, Reno, Tahoe) have been removed.</li>
   438     </ul>
   439   </li>
   440   <li> 802.11n/ac MPDU aggregation is now enabled by default for both AC_BE and AC_VI.</li>
   441   <li> The introduction of the traffic control layer leads to some additional buffering by default in the stack; when a device queue fills up, additional packets become enqueued at the traffic control layer.</li>
   442 </ul>
   444 <hr>
   445 <h1>Changes from ns-3.23 to ns-3.24</h1>
   446 <h2>New API:</h2>
   447 <ul>
   448   <li>In 'src/wifi', several changes were made to enable partial 802.11ac support:
   449     <ul>
   450       <li>A new helper (VhtWifiMacHelper) was added to set up a Very high throughput (VHT) MAC entity.</li>
   451       <li>A new standard value has been added that enables the new 11ac data rates.</li>
   452       <li>A new 11ac preamble has been added.</li>
   453       <li>A new information element has been added:  VhtCapabilities. This information element is added to the MAC frame header if the node is a VHT node. This VhtCapabilites information element is used to advertise the VHT capabilites of the node to other nodes in the network.</li>
   454     </ul>
   455   </li>
   456   <li>The ArpCache API was extended to allow the manual removal of ArpCache entries and the addition of permanent (static) entries for IPv4.
   457   </li>
   458   <li> The SimpleChannel in the 'network' module now allows per-NetDevice blacklists, in order to do hidden terminal testcases.
   459   </li>
   460 </ul>
   461 <h2>Changes to existing API:</h2>
   462 <ul>
   463   <li> The signatures on several TcpHeader methods were changed to take const arguments.</li>
   464   <li> class TcpL4Protocol replaces Send() methods with SendPacket(), and adds new methods to AddSocket() and RemoveSocket() from a node.  Also, a new PacketReceived() method was introduced to get the TCP header of an incoming packet and check its checksum.</li>
   465   <li> The CongestionWindow and SlowStartThreshold trace sources have been moved from the TCP subclasses such as NewReno, Reno, Tahoe, and Westwood to the TcpSocketBase class.</li>
   466   <li> The WifiMode object has been refactored:
   467     <ul>
   468       <li>11n data rates are now renamed according to their MCS value. E.g. OfdmRate65MbpsBW20MHz has been renamed into HtMcs7. 11ac data rates have been defined according to this new renaming.</li>
   469       <li>HtWifiMacHelper and VhtWifiMacHelper provide a helper to convert a MCS value into a data rate value.</li>
   470       <li>The channel width is no longer tied to the wifimode. It is now included in the TXVECTOR.</li>
   471       <li>The physical bitrate is no longer tied to the wifimode. It is computed based on the selected wifimode and on the TXVECTOR parameters (channel width, guard interval and number of spatial streams).</li>
   472     </ul>
   473   </li>
   474 </ul>
   475 <h2>Changes to build system:</h2>
   476 <ul>
   477   <li> Waf was upgraded to 1.8.12</li>
   478   <li> Waf scripts and test runner program were made compatible with Python 3</li>
   479 </ul>
   480 <h2>Changed behavior:</h2>
   481 This section is for behavioral changes to the models that were not due to a bug fix.
   482 <ul>
   483 </ul>
   485 <hr>
   486 <h1>Changes from ns-3.22 to ns-3.23</h1>
   487 <h2>New API:</h2>
   488 <ul>
   489   <li> The mobility module includes a GeographicPositions class used to
   490 convert geographic to cartesian coordinates, and to generate randomly
   491 distributed geographic coordinates.
   492   </li>
   493   <li>  The spectrum module includes new TvSpectrumTransmitter classes and helpers to create television transmitter(s) that transmit PSD spectrums customized by attributes such as modulation type, power, antenna type, channel frequency, etc.
   494   </li>
   495 </ul>
   496 <h2>Changes to existing API:</h2>
   497 <ul>
   498   <li> In LteSpectrumPhy, LtePhyTxEndCallback and the corresponding methods have been removed, since they were unused.
   499   </li>
   500   <li> In the DataRate class in the network module, CalculateTxTime has been declared deprecated.  CalculateBytesTxTime and CalculateBitsTxTime are to be used instead.  The return value is a Time, instead of a double.
   501   </li>
   502   <li> In the Wi-Fi InterferenceHelper, the interference event now takes the WifiTxVector as an input parameter, instead of the WifiMode.  A similar change was made to the WifiPhy::RxOkCallback signature.
   503   </li>
   504 </ul>
   505 <h2>Changes to build system:</h2>
   506 <ul>
   507   <li> None </li>
   508 </ul>
   509 <h2>Changed behavior:</h2>
   510 This section is for behavioral changes to the models that were not due to a bug fix.
   511 <ul>
   512   <li> In Wi-Fi, HT stations (802.11n) now support two-level aggregation. The InterferenceHelper now distinguishes between the PLCP and regular payload reception, for higher fidelity modeling.  ACKs are now sent using legacy rates and preambles.  Acces points now establish BSSBasicRateSet for control frame transmissions.  PLCP header and PLCP payload reception have been decoupled to improve PHY layer modeling accuracy.  RTS/CTS with A-MPDU is now fully supported.  
   513   </li>
   514   <li> The mesh module was made more compliant to the IEEE 802.11s-2012 standard and packet traces are now parseable by Wireshark.  
   515   </li>
   516 </ul>
   518 <hr>
   519 <h1>Changes from ns-3.21 to ns-3.22</h1>
   520 <h2>New API:</h2>
   521 <ul>
   522   <li> New classes were added for the PARF and APARF WiFi power and rate control mechanisms. 
   523   </li>
   524   <li> Support for WiFi 802.11n MPDU aggregation has been added.
   525   </li>
   526   <li> Additional support for modeling of vehicular WiFi networks has been added, including the channel-access coordination feature of IEEE 1609.4.  In addition, a Basic Safety Message (BSM) packet generator and related statistics-gathering classes have been added to the wave module. 
   527   </li>
   528   <li> A complete LTE release bearer procedure is now implemented which can be invoked by calling the new helper method LteHelper::DeActivateDedicatedEpsBearer ().
   529   </li>
   530   <li> It is now possible to print the Neighbor Cache (ARP and NDISC) by using
   531        the RoutingProtocolHelper
   532   </li>
   533   <li> A TimeProbe class has been added to the data collection framework in 
   534        the stats module, enabling TracedValues emitting values of type 
   535        ns3::Time to be handled by the framework.
   536   </li>
   537   <li> A new attribute 'ClockGranularity' was added to the TcpSocketBase class,
   538 to control modeling of RTO calculation.
   539   </li>
   540 </ul>
   542 <h2>Changes to existing API:</h2>
   543 <ul>
   544   <li> Several deprecated classes and class methods were removed, including EmuNetDevice, RandomVariable and derived classes, Packet::PeekData(), Ipv6AddressHelper::NewNetwork(Ipv6Address, Ipv6Prefix), Ipv6InterfaceContainer::SetRouter(), Ipv4Route::GetOutputTtl(), TestCase::AddTestCase(TestCase*), and TestCase::GetErrorStatus().
   545   </li>
   546   <li> Print methods involving routing tables and neighbor caches, in classes Ipv4RoutingHelper and Ipv6RoutingHelper, were converted to static methods.
   547   </li>  
   548   <li>PointerValue attribute types in class UanChannel (NoiseModel), UanPhyGen (PerModel and SinrModel), UanPhyDual (PerModelPhy1, PerModelPhy2, SinrModelPhy1, and SinrModelPhy2), and SimpleNetDevice (TxQueue), were changed from PointerValue type to StringValue type, making them configurable via the Config subsystem. 
   549   </li>
   550   <li> WifiPhy::CalculateTxDuration() and WifiPhy::GetPayloadDurationMicroSeconds () now take an additional frequency parameter.
   551   </li>
   552   <li> The attribute 'Recievers' in class YansWifiPhy was misspelled, so
   553        this has been corrected to 'Receivers'.
   554   </li>
   555   <li> We have now documented the callback function signatures
   556        for all TracedSources, using an extra (fourth) argument to
   557        TypeId::AddTraceSource to pass the fully-qualified name
   558        of the signature typedef.  To ensure that future TraceSources
   559        are similarly documented, the three argument version of 
   560        AddTraceSource has been deprecated.
   561   </li>	
   562   <li> The "MinRTO" attribute of the RttEstimator class was moved to the TcpSocketBase class.  The "Gain" attribute of the RttMeanDeviation class was replaced 
   563 by new "Alpha" and "Beta" attributes.  
   564   </li>	
   565   <li> Attributes of the TcpTxBuffer and TcpRxBuffer class are now accessible through the TcpSocketBase class.
   566   </li>	
   567   <li> The LrWpanHelper class has a new constructor allowing users to configure a MultiModelSpectrumChannel as an option, and also provides Set/Get API to allow users to access the underlying channel object. 
   568   </li>
   569 </ul>
   571 <h2>Changes to build system:</h2>
   572 <ul>
   573   <li> waf was upgraded to version 1.7.16
   574   </li>
   575 </ul>
   577 <h2>Changed behavior:</h2>
   578 This section is for behavioral changes to the models that were not due to a bug fix.
   579 <ul>
   580   <li> The default value of the `Speed` attribute of ConstantSpeedPropagationDelayModel was changed from 300,000,000 m/s to 299,792,458 m/s (speed of light in a vacuum), causing propagation delays using this model to vary slightly.
   581   </li>
   582   <li> The LrWpanHelper object was previously instantiating only a LogDistancePropagationLossModel on a SingleModelSpectrumChannel, but no PropagationDelayModel.  The constructor now adds by default a ConstantSpeedPropagationDelayModel.
   583   </li>
   584   <li> The Nix-vector routing implementation now uses a lazy flush mechanism,
   585        which dramatically speeds up the creation of large topologies.
   586   </li>
   587 </ul>
   589 <hr>
   590 <h1>Changes from ns-3.20 to ns-3.21</h1>
   591 <h2>New API:</h2>
   592 <ul>
   593   <li> New "const double& SpectrumValue:: operator[] (size_t index) const".
   594   </li>
   595   <li> A new TraceSource has been added to TCP sockets: SlowStartThreshold.
   596   </li>
   597   <li> New method CommmandLine::AddValue (name, attibutePath) to provide a
   598        shorthand argument "name" for the Attribute "path".  This also has
   599        the effect of including the help string for the Attribute in the
   600        Usage message.
   601   </li>
   602   <li> The GSoC 2014 project in the LTE module has brought some additional APIs:
   603     <ul>
   604       <li>a new abstract class LteFfrAlgorithm, which every future
   605           implementation of frequency reuse algorithm should inherit from</li>
   606       <li>a new SAPs: one between MAC Scheduler and FrAlgorithm, one between
   607 	  RRC and FrAlgorithm</li>
   608       <li>new attribute to enable Uplink Power Control in LteUePhy</li>
   609       <li>new LteUePowerControl class, an implementation of Uplink Power Control, which is 
   610           configurable by attributes. ReferenceSignalPower is sent by eNB in SIB2. 
   611           Uplink Power Control in Closed Loop Accumulative Mode is enabled by default</li>
   612       <li>seven different Frequency Reuse Algorithms (each has its own attributes): </li>
   613         <ul>
   614           <li>LteFrNoOpAlgorithm</li>
   615           <li>LteFrHardAlgorithm</li>
   616           <li>LteFrStrictAlgorithm</li>
   617           <li>LteFrSoftAlgorithm</li>
   618           <li>LteFfrSoftAlgorithm</li>
   619           <li>LteFfrEnhancedAlgorithm</li>
   620           <li>LteFfrDistributedAlgorithm</li>
   621         </ul>
   622       <li>attribute in LteFfrAlgorithm to set FrCellTypeId which is used in automatic 
   623           Frequency Reuse algorithm configuration</li>
   624       <li>LteHelper has been updated with new methods related to frequency reuse algorithm: 
   625           SetFfrAlgorithmType and SetFfrAlgorithmAttribute</li>
   626     </ul>
   627   </li>
   628   <li> A new SimpleNetDeviceHelper can now be used to install SimpleNetDevices.
   629   </li>
   630   <li> New PacketSocketServer and PacketSocketClient apps, meant to be used in tests.
   631   </li>
   632   <li> Tcp Timestamps and Window Scale options have been added and are enabled by default (controllable by attribute).
   633   </li>
   634   <li> A new CoDel queue model has been added to the 'internet' module.  
   635   </li>
   636   <li> New test macros NS_TEST_ASSERT_MSG_GT_OR_EQ() and NS_TEST_EXPECT_MSG_GT_OR_EQ() have been added.
   637   </li>
   638 </ul>
   640 <h2>Changes to existing API:</h2>
   641 <ul>
   642   <li> "Icmpv6L4Protocol::ForgeEchoRequest" is now returning a packet with the proper IPv6 header.
   643   </li>
   644   <li> The TCP socket Attribute "SlowStartThreshold" has been renamed "InitialSlowStartThreshold" to
   645        clarify that the effect is only on the initial value.
   646   </li>
   647   <li> all schedulers were updated to interact with FR entity via FFR-SAP. Only PF, PSS, CQA, 
   648        FD-TBFQ, TD-TBFQ schedulers supports Frequency Reuse functionality. In the beginning 
   649        of scheduling process, schedulers ask FR entity for avaiable RBGs and then ask if UE 
   650        can be scheduled on RB</li>
   651   <li> eNB RRC interacts with FFR entity via RRC-FFR SAP</li>
   652   <li> new DL-CQI generation approach was implemented. Now DL-CQI is computed from control channel as signal
   653        and data channel (if received) as interference. New attribute in LteHelper was added to specify 
   654        DL-CQI generation approach. New approach is default one in LteHelper </li>
   655   <li> RadioEnvironmentMap can be generated for Data or Control channel and for specified RbId;
   656        Data or Control channel and RbId can be configured by new attributes in RadioEnvironmentMapHelper </li>
   657   <li> lte-sinr-chunk-processor refactored to lte-chunk-processor. Removed all lte-xxx-chunk-processor 
   658        implementations</li>
   659   <li> BindToNetDevice affects also sockets using IPv6.</li>
   660   <li> BindToNetDevice now calls implicitly Bind (). To bind a socket to a NetDevice and to a specific address,
   661        the correct sequence is Bind (address) - BindToNetDevice (device). The opposite will raise an error.</li>
   662 </ul>
   664 <h2>Changes to build system:</h2>
   665 <ul>
   666 <li> None for this release. </li>
   667 </ul>
   669 <h2>Changed behavior:</h2>
   670 <ul>
   671 <li> Behavior will be changed due to the list of bugs fixed (listed in RELEASE_NOTES); users are requested to review that list as well.
   672 </ul>
   674 <hr>
   675 <h1>Changes from ns-3.19 to ns-3.20</h1>
   676 <h2>New API:</h2>
   677 <ul>
   678   <li> Models have been added for low-rate, wireless personal area networks
   679 (LR-WPAN) as specified by IEEE standard 802.15.4 (2006).  The current 
   680 emphasis is on the unslotted mode of 802.15.4 operation for use in Zigbee, 
   681 and the scope is limited to enabling a single mode (CSMA/CA) with basic 
   682 data transfer capabilities. Association with PAN coordinators is not yet 
   683 supported, nor the use of extended addressing. Interference is modeled as 
   684 AWGN but this is currently not thoroughly tested.  The NetDevice Tx queue 
   685 is not limited, i.e., packets are never dropped due to queue becoming full. 
   686 They may be dropped due to excessive transmission retries or channel access 
   687 failure.  </li>
   688   <li> A new IPv6 routing protocol has been added: RIPng. This protocol is
   689   an Interior Gateway Protocol and it is available in the Internet module. </li>
   690   <li> A new LTE MAC downlink scheduling algorithm named Channel and QoS 
   691   Aware (CQA) Scheduler is provided by the new "ns3::CqaFfMacScheduler" object.
   692   </li>
   693   <li> Units may be attached to Time objects, to facilitate specific output
   694   formats (see Time::As()) </li>
   695   <li> FlowMonitor "SerializeToXml" functions are now directly available
   696   from the helper.  </li>
   697   <li> Access to OLSR's HNA table has been enabled </li>
   698 </ul>
   700 <h2>Changes to existing API:</h2>
   701 <ul>
   702   <li> The SixLowPan model can now use uncompressed IPv6 headers. An option to
   703   define the minimum compressed packet size has been added.  </li>
   704   <li> MinDistance wsa replaced by MinLoss in FriisPropagationLossModel, to
   705   better handle conditions outside of the assumed far field region. </li>
   706   <li> In the DSR model, the attribute DsrOptionRerrHeader::ErrorType" has
   707   been removed. </li>
   708 </ul>
   710 <h2>Changes to build system:</h2>
   711 <ul>
   712   <li> Python 3.3 is now supported for Python bindings for ns-3.  Python 3.3 
   713   support for API scanning is not supported.  Python 3.2 is not supported.</li>
   714   <li>  Enable selection of high precision int64x64_t implementation
   715   at configure time, for debugging purposes.</li>
   716   <li> Optimized builds are now enabling signed overflow optimization 
   717   (-fstrict-overflow) and for gcc 4.8.2 and greater, also warning for cases 
   718   where an optimizization may occur due to compiler assumption that 
   719   overflow will not occur. </li>
   720 </ul>
   722 <h2>Changed behavior:</h2>
   723 <ul>
   724   <li> The Internet FlowMonitor can now track IPv6 packets.  </li>
   725   <li> Ipv6Extension::m_dropTrace has been removed. Ipv6L3Protocol::m_dropTrace
   726   is now fired when appropriate.  </li>
   727   <li> IPv4 identification field value is now dependent on the protocol 
   728   field.  </li>
   729   <li> Point-to-point trace sources now contain PPP headers </li>
   730 </ul>
   732 <hr>
   733 <h1>Changes from ns-3.18.1 to ns-3.19</h1>
   735 <h2>New API:</h2>
   736 <ul>
   737   <li> A new wifi extension for vehicular simulation support is available in the
   738     src/wave directory.  The current code represents an interim capability to 
   739     realize an IEEE 802.11p-compliant device, but without the WAVE extensions 
   740     (which are planned for a later patch).  The WaveNetDevice modelled herein 
   741     enforces that a WAVE-compliant physical layer (at 5.9 GHz) is selected, and 
   742     does not require any association between devices (similar to an adhoc WiFi 
   743     MAC), but is otherwise similar (at this time) to a WifiNetDevice.  WAVE 
   744     capabililties of switching between control and service channels, or using 
   745     multiple radios, are not yet modelled.
   746   </li>
   747   <li>New SixLowPanNetDevice class providing a shim between 
   748     IPv6 and real NetDevices. The new module implements 6LoWPAN:
   749     "Transmission of IPv6 Packets over IEEE 802.15.4 Networks" (see
   750     <a href="">RFC 4944</a> and
   751     <a href="">RFC 6262</a>), 
   752     resulting in a heavy header compression for IPv6 packets.
   753     The module is intended to be used on 802.15.4 NetDevices, but
   754     it can be used over other NetDevices. See the manual for
   755     further discussion.
   756   </li>
   757   <li> LteHelper has been updated with some new APIs:
   758     <ul>
   759       <li>new overloaded Attach methods to enable UE to automatically determine
   760           the eNodeB to attach to (using initial cell selection);</li>
   761       <li>new methods related to handover algorithm: SetHandoverAlgorithmType
   762           and SetHandoverAlgorithmAttribute;</li>
   763       <li>a new attribute AnrEnabled to activate/deactivate Automatic Neighbour
   764           Relation (ANR) function; and</li>
   765       <li>a new method SetUeDeviceAttribute for configuring LteUeNetDevice.</li>
   766     </ul>
   767   </li>
   768   <li> The GSoC 2013 project in the LTE module has brought some additional APIs:
   769     <ul>
   770       <li>a new abstract class LteHandoverAlgorithm, which every future
   771           implementation of automatic handover trigger should inherit from;</li>
   772       <li>new classes LteHandoverAlgorithm and LteAnr as sub-modules of
   773           LteEnbNetDevice class; both interfacing with the LteEnbRrc sub-module
   774           through Handover Management SAP and ANR SAP;</li>
   775       <li>new attributes in LteEnbNetDevice and LteUeNetDevice classes related
   776           to Closed Subscriber Group (CSG) functionality in initial cell
   777           selection;</li>
   778       <li>new attributes in LteEnbRrc for configuring UE measurements' filtering
   779           coefficient (i.e., quantity configuration);</li>
   780       <li>a new public method AddUeMeasReportConfig in LteEnbRrc for setting up
   781           custom UE measurements' reporting configuration; measurement reports
   782           can then be captured from the RecvMeasurementReport trace source;
   783           and</li>
   784       <li>new trace sources in LteUeRrc to capture more events, such as System
   785           Information messages (MIB, SIB1, SIB2), initial cell selection, random
   786           access, and handover.</li>
   787     </ul>
   788   </li>
   789   <li>A new parallel scheduling algorithm based on null messages, a common 
   790   parallel DES scheduling algorithm, has been added.  The null message 
   791   scheduler has better scaling properties when running on some scenarios
   792   with large numbers of nodes since it does not require a global 
   793   communication.
   794   </li>
   795 </ul>
   797 <h2>Changes to existing API:</h2>
   798 <ul>
   799     <li> It is now possible to use Ipv6PacketInfoTag from UDP applications in the
   800       same way as with Ipv4PacketInfoTag. See Doxygen for current limitations in
   801   	  using Ipv[4,6]PacketInfoTag to set IP properties.</li>
   802     <li>A change is introduced for the usage of the EpcHelper
   803       class. Previously, the EpcHelper class included both the API
   804       definition and its (only) implementation; as such, users would
   805       instantiate and use the EpcHelper class directly in their
   806       simulation programs. From now on,
   807       EpcHelper is just the base class defining the API, and the
   808       implementation has been moved to derived classes; as such,
   809       users are now expected to use one of the derived classes in
   810       their simulation program. The implementation previously
   811       provided by the EpcHelper class has been moved to the new
   812       derived class PointToPointEpcHelper.</li>
   813   <li> The automatic handover trigger and ANR functions in LTE module have been
   814     moved from LteEnbRrc class to separate classes. As a result, the related
   815     attributes, e.g., ServingCellHandoverThreshold, NeighbourCellHandoverOffset,
   816     EventA2Threshold, and EventA4Threshold have been removed from LteEnbRrc
   817     class. The equivalent attributes are now in A2A4RsrqHandoverAlgorithm and
   818     LteAnr classes.</li>
   819   <li> Master Information Block (MIB) and System Information Block Type 1 (SIB1)
   820     are now transmitted as LTE control messages, so they are no longer part of
   821     RRC protocol.</li>
   822   <li> UE RRC state model in LTE module has been considerably modified and is
   823     not backward compatible with the previous state model.</li>
   824   <li> Additional time units (Year, Day, Hour, Minute) were added to the time
   825   value class that represents simulation time; the largest unit prior to 
   826   this addition was Second.
   827   </li>
   828   <li> SimpleNetDevice and SimpleChannel are not so simple anymore. SimpleNetDevice can be now a
   829        Broadcast or PointToPoint NetDevice, it can have a limited bandwidth and it uses an output
   830        queue.       
   831   </li>
   832 </ul>
   834 <h2>Changes to build system:</h2>
   836 <h2>Changed behavior:</h2>
   837 <ul>
   838   <li> For the TapBridge device, in UseLocal mode there is a MAC learning function. TapBridge has been waiting for the first packet received from tap interface to set the address of the bridged device to the source address of the first packet. This has caused problems with WiFi.  The new behavior is that after connection to the tap interface, ns-3 learns the MAC address of that interface with a system call and immediately sets the address of the bridged device to the learned one.  See <a href="">bug 1777</a> for more details.</li>
   839   <li> TapBridge device now correctly implements IsLinkUp() method.</li>
   840   <li> IPv6 addresses and routing tables are printed like in Linux "route -A inet6" command.</li>
   841   <li> A change in Ipv[4,6]Interface enforces the correct behaviour of IP 
   842     when a device do not support the minimum MTU requirements.
   843     This is set to 68 and 1280 octects respectively.  IP simulations that
   844     may have run over devices with smaller MTUs than 68 or 1280, respectively,
   845     will no longer be able to use such devices.</li>
   846 </ul>
   848 <hr>
   849 <h1>Changes from ns-3.18 to ns-3.18.1</h1>
   850 <h2>New API:</h2>
   851 <ul>
   852   <li> It is now possible to randomize the time of the first beacon from an
   853   access point.  Use an attribute "EnableBeaconJitter" to enable/disable
   854   this feature.
   855   </li>
   856   <li> A new FixedRoomPositionAllocator helper class is available; it
   857   allows one to generate a random position uniformly distributed in the
   858   volume of a chosen room inside a chosen building.
   859   </li>
   860 </ul>
   862 <h2>Changes to existing API:</h2>
   863 <ul>
   864   <li> Logging wildcards:  allow "***" as synonym for "*=**" to turn on all logging.
   865   </li>
   866   <li> The log component list ("NS_LOG=print-list") is now printed alphabetically.
   867   </li>
   868   <li> Some deprecated IEEE 802.11p code has been removed from the wifi module
   869   </li>
   870 </ul>
   872 <h2>Changes to build system:</h2>
   873 <ul>
   874   <li> The Python API scanning system (./waf --apiscan) has been fixed (bug 1622)
   875   </li> 
   876   <li> Waf has been upgraded from 1.7.11 to 1.7.13
   877   </li> 
   878 </ul>
   880 <h2>Changed behavior:</h2>
   881 <ul>
   882   <li> Wifi simulations have additional jitter on AP beaconing (see above) and some bug fixes have been applied to wifi module (see RELEASE_NOTES)
   883   </li> 
   884 </ul>
   886 <hr>
   887 <h1>Changes from ns-3.17 to ns-3.18</h1>
   889 <h2>New API:</h2>
   890 <ul>
   891   <li>New features have been added to the LTE module:
   892   <ul>
   893     <li>PHY support for UE measurements (RSRP and RSRQ)</li>
   894     <li>RRC support for UE measurements (configuration, execution, reporting)</li>
   895     <li>Automatic Handover trigger based on RRC UE measurement reports</li>
   896   </ul>
   897   <li>Data collection components have been added in the 'src/stats' module.
   898       Data collection includes a Probe class that attaches to ns-3 trace
   899       sources to filter their output, and two Aggregator classes for 
   900       marshaling probed data into text files or gnuplot plots.  The ns-3
   901       tutorial has been extended to illustrate basic functionality. </li>
   902   <li>In 'src/wifi', several changes were made to enable partial 802.11n support:
   903     <ul>
   904       <li>A new helper (HtWifiMacHelper) was added to set up a High Throughput (HT) MAC entity</li>
   905       <li>New attributes were added to help the user setup a High Throughput (HT) PHY entity. These attributes can be set using the YansWifiPhyHelper</li>
   906       <li>A new standard value has been added that enables the new 11n data rates.</li>
   907       <li>New 11n preambles has been added (Mixed format and greenfield). To be able to change Tx duration according to the preamble used, a new class TxVector has been added to carry the transmission parameters (mode, preamble, stbc,..).  Several functions have been updated to allow the passage of TxVector instead of WifiMode in MacLow, WifiRemoteStationManager, WifiPhy, YansWifiPhy,.. </li>
   908       <li>A new information element has been added:  HTCapabilities. This information element is added to the MAC frame header if the node is an HT node. This HTCapabilites information element is used to advertise the HT capabilites of the node to other nodes in the network</li>
   909     </ul>
   910   <li>InternetStackHelper has two new functions:<tt>SetIpv4ArpJitter (bool enable)</tt>
   911       and <tt>SetIpv6NsRsJitter (bool enable)</tt> to enable/disable
   912       the random jitter on the tranmission of IPv4 ARP Request and IPv6 NS/RS. </li>
   913   <li>Bounds on valid time inputs for time attributes can now be enabled.  
   914       See <tt></tt> for an example.</li>
   915   <li>New generic hash function interface provided in the simulation core.  
   916       Two hash functions are provided: murmur3 (default), and the venerable 
   917       FNV1a.  See the Hash Functions section in the ns-3 manual.</li>
   918   <li>New Mac16Address has been added. It can be used with IPv6 to make
   919       an Autoconfigured address.</li>
   920   <li>Mac64Address support has been extended. It can now be used with 
   921       IPv6 to make an Autoconfigured address.</li>
   922   <li>IPv6 can now detect and use Path-MTU. See 
   923       <tt>examples/ipv6/</tt> for an example.</li>
   924   <li>Radvd application has a new Helper. See the updated 
   925       <tt>examples/ipv6/</tt> for an example.</li>
   926 </ul>
   928 <h2>Changes to existing API:</h2>
   929 <ul>
   930   <li> The Ipv6InterfaceContainer functions to set a node in forwarding state (i.e., a router) 
   931   and to install a default router in a group of nodes have been extensively changed.
   932   The old function <tt>void Ipv6InterfaceContainer::SetRouter (uint32_t i, bool router)</tt>
   933   is now DEPRECATED.
   934   </li>
   935   <li> The documentation's IPv6 addresses (2001:db8::/32, RFC 3849) are now
   936   dropped by routers.
   937   </li>
   938   <li> The 'src/tools' module has been removed, and most files migrated to
   939   'src/stats'.  For users of these programs (the statistics-processing 
   940   in average.h, or the gnuplot support), the main change is likely to be
   941   replacing the inclusion of "tools-module.h" with "stats-module.h".
   942   Users of the event garbage collector, previously in tools, will now 
   943   include it from the core module.
   944   </li>
   945   <li> The Ipv6 UnicastForwardCallback and  MulticastForwardCallback 
   946   have a new parameter, the NetDevice the packet has been received from.
   947   Existing Ipv6RoutingProtocols should update their RouteInput function
   948   accordingly, e.g., from <tt>ucb (rtentry, p, header);</tt> to <tt>ucb (idev, rtentry, p, header);</tt>
   949   </li>
   950   <li> The previous buildings module relied on a specific MobilityModel called
   951     BuildingsMobilityModel, which supported buildings but only allowed
   952     static positions. This mobility model has been removed. Now, the
   953     Buildings module instead relies on a new class called
   954     MobilityBuildingInfo which can be aggregated to any MobilityModel. This
   955     allows having moving nodes in presence of buildings with any of
   956     the existing MobilityModels. 
   957   </li>
   958   <li>All functions in WifiRemoteStationManager named GetXxxMode have been changed to GetXxxTxVector </li>
   959 </ul>
   961 <h2>Changes to build system:</h2>
   962 <ul>
   963   <li> Make references to bug id's in doxygen comments with
   964     <tt>\bugid{num}</tt>, where <tt>num</tt> is the bug id number.  This
   965     form will generate a link to the bug in the bug database.
   966   </li>
   967 </ul>
   969 <h2>Changed behavior:</h2>
   970 <ul>
   971   <li> Now it is possible to request printing command line arguments to the
   972 desired output stream using PrintHelp or operator &lt;&lt;
   973 <pre>
   974   CommandLine cmd;
   975   cmd.Parse (argc, argv);
   976 ...
   978   std::cerr << cmd;
   979 </pre>
   980 or
   981 <pre>
   982   cmd.PrintHelp (std::cerr);
   983 </pre>
   984   </li>
   985   <li>Command line boolean arguments specified with no integer value (e.g. <tt>"--boolArg"</tt>) will toggle the value from the default, instead of always setting the value to true.
   986   </li>
   987   <li>IPv4's ARP Request and IPv6's NS/RS are now transmitted with a random delay.
   988       The delay is, by default, a uniform random variable in time between 0 and 10ms.
   989       This is aimed at preventing reception errors due to collisions during wifi broadcasts when the sending behavior is synchronized (e.g. due to applications starting at the same time on several different nodes).
   990       This behaviour can be modified by using ArpL3Protocol's 
   991       <tt>RequestJitter</tt> and Icmpv6L4Protocol's <tt>SolicitationJitter</tt>
   992       attributes or by using the new InternetStackHelper functions.
   993   </li>
   994   <li>AODV Hellos are disabled by default. The performance with Hellos enabled and disabled are almost identical. With Hellos enabled, AODV will suppress hellos from transmission, if any recent broadcast such as RREQ was transmitted. The attribute <tt>ns3::aodv::RoutingProtocol::EnableHello</tt> can be used to enable/disable Hellos.
   995 </ul>
   997 <hr>
   998 <h1>Changes from ns-3.16 to ns-3.17</h1>
  1000 <h2>New API:</h2>
  1001 <ul>
  1002   <li>New TCP Westwood and Westwood+ models
  1003   <li>New FdNetDevice class providing a special NetDevice that is able to read
  1004       and write traffic from a file descriptor.  Three helpers are provided
  1005       to associate the file descriptor with different underlying devices:  
  1006     <ul> 
  1007     <li> EmuFdNetDeviceHelper (to associate the |ns3| device with a physical 
  1008          device in the host machine).  This helper is intended to
  1009          eventually replace the EmuNetDevice in src/emu. </li>
  1010     <li> TapFdNetDeviceHelper (to associate the ns-3 device with the file 
  1011          descriptor from a tap device in the host machine) </li>
  1012     <li> PlanteLabFdNetDeviceHelper (to automate the creation of tap devices 
  1013          in PlanetLab nodes, enabling |ns3| simulations that can send and 
  1014          receive traffic though the Internet using PlanetLab resource.</li>
  1015     </ul> 
  1016   </li>
  1017   <li>In Ipv4ClickRouting, the following APIs were added:
  1018     <ul>
  1019       <li>Ipv4ClickRouting::SetDefines(), accessible through ClickInternetStackHelper::SetDefines(), for the user to set Click defines from the ns-3 simulation file.</li>
  1020       <li>SIMCLICK_GET_RANDOM_INT click-to-simulator command for ns-3 to drive Click's random number generation.</li>
  1021     </ul>
  1022   </li>  
  1023   <li>LTE module
  1024     <ul>
  1025       <li> New user-visible LTE API
  1026       <ul>
  1027         <li>Two new methods have been added to LteHelper to enable the X2-based handover functionality: AddX2Interface, which setups the X2 interface between two eNBs, and HandoverRequest, which is  a convenience method that schedules an explicit handover event to be executed at a given point in the simulation. </li>
  1028         <li>the new LteHelper method EnablePhyTraces can now be used to enable the new PHY traces</li>
  1029       </ul>
  1030       </li> 
  1031       <li> New internal LTE API 
  1032       <ul>
  1033         <li>New LTE control message classes DlHarqFeedbackLteControlMessage, 
  1034          RachPreambleLteControlMessage, RarLteControlMessage, MibLteControlMessage</li>
  1035         <li>New class UeManager
  1036         <li>New LteRadioBearerInfo subclasses LteSignalingRadioBearerInfo, 
  1037          LteDataRadioBearerInfo</li>
  1038         <li>New LteSinrChunkProcessor subclasses LteRsReceivedPowerChunkProcessor, 
  1039          LteInterferencePowerChunkProcessor</li>
  1040       </ul>
  1041       </li>
  1042     </ul>
  1043   </li>
  1044   <li>New DSR API
  1045   <ul>
  1046     <li>Added PassiveBuffer class to save maintenance packet entry for passive acknowledgment option</li>
  1047     <li>Added FindSourceEntry function in RreqTable class to keep track of route request entry received from same source node</li>
  1048     <li>Added NotifyDataReciept function in DsrRouting class to notify the data receipt of the next hop from link layer.  This is used for the link layer acknowledgment.</li>
  1049   </ul>
  1050   </li>
  1051   <li>New Tag, PacketSocketTag, to carry the destination address of a packet and the packet type</li>
  1052   <li>New Tag, DeviceNameTag, to carry the ns3 device name from where a packet is coming</li>
  1053   <li>New Error Model, BurstError model, to determine which bursts of packets are errored corresponding to an underlying distribution, burst rate, and burst size</li>
  1054 </ul>
  1056 <h2>Changes to existing API:</h2>
  1057 <ul>
  1058   <li>ns3::Object and subclasses DoStart has been renamed to DoInitialize</li>
  1059   <li>ns3::Object and subclasses Start has been renamed to Initialize</li>
  1060   <li>EnergySource StartDeviceModels renamed to InitializeDeviceModels</li>
  1061   <li>A typo was fixed in an LTE variable name. The variable ns3::AllocationRetentionPriority::preemprionVulnerability was changed to preemptionVulnerability.</li>
  1062   <li>Changes in TestCase API
  1063   <ul>
  1064     <li>TestCase has new enumeration TestDuration containing QUICK, EXTENSIVE, TAKES_FOREVER</li>
  1065     <li>TestCase constructor now requires TestDuration, old constructor marked deprecated</li>
  1066  </ul>
  1067  </li>
  1068   <li>Changes in LTE API
  1069   <ul>
  1070     <li> User-visible LTE API 
  1071     <ul>
  1072       <li>The previous LteHelper method ActivateEpsBearer has been now replaced by two alternative methods: ActivateDataRadioBearer (to be used when the EPC model is not used) and ActivateDedicatedEpsBearer (to be used when the EPC model is used). In the case where the EPC model is used, the default EPS bearer is not automatically activated without the need for a specific method to be called.</li>
  1073     </ul>
  1074     </li> 
  1075     <li> Internal LTE API 
  1076     <ul>
  1077       <li>EpcHelper added methods AddUe, AddX2Interface.  Method AddEnb now requires a cellId.  Signature of ActivateEpsBearer changed to void ActivateEpsBearer (Ptr<NetDevice> ueLteDevice, uint64_t imsi, Ptr<EpcTft> tft, EpsBearer bearer)</li>
  1078       <li>LteHelper added methods EnableDlPhyTraces, EnableUlPhyTraces, EnableDlTxPhyTraces, EnableUlTxPhyTraces, EnableDlRxPhyTraces, EnableUlRxPhyTraces</li>
  1079       <li>LteHelper removed methods EnableDlRlcTraces, EnableUlRlcTraces, EnableDlPdcpTraces, EnableUlPdcpTraces</li>
  1080       <li>RadioBearerStatsCalculator added methods (Set/Get)StartTime, (Set/Get)Epoch, RescheduleEndEpoch, EndEpoch</li>
  1081       <li>RadioBearerStatsCalculator removed methods StartEpoch, CheckEpoch</li>
  1082       <li>RadioBearerStatsCalculator methods UlTxPdu, DlRxPdu now require a cellId</li>
  1083       <li>EpcEnbApplication constructor now requires Ipv4Addresses enbS1uAddress and sgwS1uAddress as well as cellId</li>
  1084       <li>EpcEnbApplication added methods SetS1SapUser, GetS1SapProvider, SetS1apSapMme and GetS1apSapEnb</li>
  1085       <li>EpcEnbApplication removed method ErabSetupRequest</li> 
  1086       <li>EpcSgwPgwApplication added methods SetS11SapMme, GetS11SapSgw, AddEnb, AddUe, SetUeAddress</li>
  1087       <li>lte-common.h new structs PhyTransmissionStatParameters and PhyReceptionStatParameters used in TracedCallbacks</li>
  1088       <li>LteControlMessage new message types DL_HARQ, RACH_PREAMBLE, RAR, MIB</li>
  1089       <li>LteEnbCmacSapProvider new methods RemoveUe, GetRachConfig, AllocateNcRaPreamble, AllocateTemporaryCellRnti</li>
  1090       <li>LteEnbPhy new methods GetLteEnbCphySapProvider, SetLteEnbCphySapUser, GetDlSpectrumPhy, GetUlSpectrumPhy, CreateSrsReport</li>
  1091       <li>LteEnbPhy methods DoSendMacPdu, DoSetTransmissionMode, DoSetSrsConfigurationIndex, DoGetMacChTtiDelay, DoSendLteControlMessage, AddUePhy, DeleteUePhy made private</li>
  1092       <li>LteEnbPhySapProvider removed methods SetBandwidth, SetTransmissionMode, SetSrsConfigurationIndex, SetCellId</li>
  1093       <li>LteEnbPhySapUser added methods ReceiveRachPreamble, UlInfoListElementHarqFeeback, DlInfoListElementHarqFeeback</li>
  1094       <li>LtePdcp added methods (Set/Get)Status</li>
  1095       <li>LtePdcp DoTransmitRrcPdu renamed DoTransmitPdcpSdu</li>
  1096       <li>LteUeRrc new enum State.  New methods SetLteUeCphySapProvider, GetLteUeCphySapUser, SetLteUeRrcSapUser, GetLteUeRrcSapProvider, GetState, GetDlEarfcn, GetDlBandwidth, GetUlBandwidth, GetCellId, SetUseRlcSm .  GetRnti made const.</li> 
  1097       <li>LteUeRrc removed methods ReleaseRadioBearer, GetLcIdVector, SetForwardUpCallback, DoRrcConfigurationUpdateInd</li>
  1098       <li>LtePdcpSapProvider struct TransmitRrcPduParameters renamed TransmitPdcpSduParameters.  Method TransmitRrcPdu renamed TransmitPdcpSdu </li>
  1099       <li>LtePdcpSapUser struct ReceiveRrcPduParameters renamed ReceivePdcpSduParameters.  Method ReceiveRrcPdu renamed TransmitPdcpSdu</li>
  1100       <li>LtePdcpSpecificLtePdcpSapProvider method TransmitRrcPdu renamed TransmitPdcpSdu</li>
  1101       <li>LtePdcpSpecificLtePdcpSapUser method ReceiveRrcPdu  renamed ReceivePdcpSdu. Method ReceiveRrcPdu renamed ReceivePdcpSdu</li>
  1102       <li>LtePhy removed methods DoSetBandwidth and DoSetEarfcn</li>
  1103       <li>LtePhy added methods ReportInterference and ReportRsReceivedPower</li>
  1104       <li>LteSpectrumPhy added methods SetHarqPhyModule, Reset, SetLtePhyDlHarqFeedbackCallback, SetLtePhyUlHarqFeedbackCallback,  AddRsPowerChunkProcessor, AddInterferenceChunkProcessor</li>
  1105       <li>LteUeCphySapProvider removed methods ConfigureRach, StartContentionBasedRandomAccessProcedure, StartNonContentionBasedRandomAccessProcedure</li>
  1106       <li>LteUeMac added method AssignStreams</li>
  1107       <li>LteUeNetDevice methods GetMac, GetRrc, GetImsi  made const</li>
  1108       <li>LteUeNetDevice new method GetNas</li>
  1109       <li>LteUePhy new methods GetLteUeCphySapProvider, SetLteUeCphySapUser, GetDlSpectrumPhy, GetUlSpectrumPhy, ReportInterference, ReportRsReceivedPower, ReceiveLteDlHarqFeedback</li>
  1110       <li>LteUePhy DoSendMacPdu, DoSendLteControlMessage, DoSetTransmissionMode, DoSetSrsConfigurationIndex made private</li>
  1111       <li>LteUePhySapProvider removed methods SetBandwidth, SetTransmissionMode, SetSrsConfigurationIndex</li>
  1112       <li>LteUePhySapProvider added method SendRachPreamble</li>  
  1113     </ul>
  1114    </li>    
  1115   </ul>
  1116   <li>AnimationInterface method EnableIpv4RouteTracking returns reference to calling AnimationInterface object</li>
  1117   <li>To make the API more uniform across the various
  1118   PropagationLossModel classes, the Set/GetLambda methods of the
  1119   FriisPropagationLossModel and TwoRayGroundPropagationLossModel
  1120   classes have been changed to Set/GetFrequency, and now a Frequency
  1121   attribute is exported which replaces the pre-existing Lambda
  1122   attribute. Any previous user code setting a value for Lambda should
  1123   be changed to set instead a value of Frequency = C / Lambda, with C
  1124   = 299792458.0. </li>
  1125 </ul>
  1126 <h2>Changes to build system:</h2>
  1127 <ul>
  1128   <li>Waf shipped with ns-3 has been upgraded to version 1.7.10 and custom
  1129   pkg-config generator has been replaced by Waf's builtin tool.
  1130   </li>
  1131 </ul>
  1133 <h2>Changed behavior:</h2>
  1134 <ul>
  1135   <li>DSR link layer notification has changed.  The model originally used 
  1136   "TxErrHeader" in Ptr<WifiMac> to indicate the transmission
  1137   error of a specific packet in link layer; however, it was not working
  1138   correctly.  The model now uses a different path to implement
  1139   the link layer notification mechanism; specifically, looking into the 
  1140   trace file to find packet receive events.  If the model finds one 
  1141   receive event for the data packet, it is used as the indicator for 
  1142   successful data delivery.</li>
  1143 </ul>
  1145 <hr>
  1146 <h1>Changes from ns-3.15 to ns-3.16</h1>
  1148 <h2>New API:</h2>
  1149 <ul>
  1150 <li>In the Socket class, the following functions were added: 
  1151  <ul>
  1152   <li>(Set/Get)IpTos - sets IP Type of Service field in the IP headers.</li>
  1153   <li>(Set/Is)IpRecvTos - tells the socket to pass information about IP ToS up the stack (by adding SocketIpTosTag to the packet).</li>
  1154   <li>(Set/Get)IpTtl - sets IP Time to live field in the IP headers.</li>
  1155   <li>(Set/Is)RecvIpTtl - tells the socket to pass information about IP TTL up the stack (by adding SocketIpTtlTag to the packet).</li>
  1156   <li>(Set/Is)Ipv6Tclass - sets Traffic Class field in the IPv6 headers.</li>
  1157   <li>(Set/Is)Ipv6RecvTclass - tells the socket to pass information about IPv6 TCLASS up the stack (by adding SocketIpv6TclassTag to the packet).</li>
  1158   <li>(Set/Get)Ipv6HopLimit - sets Hop Limit field in the IPv6 headers.</li>
  1159   <li>(Set/Is)Ipv6RecvHopLimit - tells the socket to pass information about IPv6 HOPLIMIT up the stack (by adding SocketIpv6HoplimitTag to the packet).</li>
  1160  </ul>  
  1161 A user can call these functions to set/get the corresponding socket option. See examples/socket/ and examples/socket/ for examples.
  1162 </ul>
  1164 <h2>Changes to existing API:</h2>
  1165 <ul>
  1166 <li>In the MobilityHelper class, the functions EnableAscii () and EnableAsciiAll () were changed to use output stream wrappers rather than standard C++ ostreams. The purpose of this change was to make them behave analogously to other helpers in ns-3 that generate ascii traces.  Now, the file stream that is open in MobilityHelper is closed nicely upon asserts and program exits.</li>
  1167 </ul>
  1169 <h2>Changes to build system:</h2>
  1170 <ul>
  1171 <li>It's now possible to use distcc when building ns-3. See tutorial for details.</li>
  1172 </ul>
  1174 <h2>Changed behavior:</h2>
  1175 <ul>
  1176 <li>Sending a packet through Ipv4RawSocket now supports checksum in the Ipv4Header. It is still not possible to manually put in arbitrary checksum as the checksum is automatically calculated at Ipv4L3Protocol. The user has to enable checksum globally for this to work. Simply calling Ipv4Header::EnableChecksum() for a single Ipv4Header will not work.</li>
  1177 <li>Now MultiModelSpectrumChannel allows a SpectrumPhy instance to change SpectrumModel at runtime by issuing a call to MultiModelSpectrumChannel::AddRx (). Previously, MultiModelSpectrumChannel required each SpectrumPhy instance to stick with the same SpectrumModel for the whole simulation. 
  1178 </li>
  1179 </ul>
  1181 <hr>
  1182 <h1>Changes from ns-3.14 to ns-3.15</h1>
  1184 <h2>New API:</h2>
  1185 <ul>
  1186 <li>A RandomVariableStreamHelper has been introduced to assist with 
  1187 using the Config subsystem path names to assign fixed stream numbers
  1188 to RandomVariableStream objects.</li>
  1189 </ul>
  1191 <h2>Changes to existing API:</h2>
  1192 <ul>
  1193 <li>Derived classes of RandomVariable (i.e. the random variable 
  1194 implementations) have been ported to a new RandomVariableStream base class.
  1195 <li>For a given distribution DistributionVariable (such as UniformVariable),
  1196 the new class name is DistributionRandomVariable (such as 
  1197 UniformRandomVariable). </li>
  1198 <li>The new implementations are also derived from class ns3::Object and 
  1199 are handled using the ns-3 smart pointer (Ptr) class.  </li>
  1200 <li>The new variable classes also have a new attributed called "Stream"
  1201 which allows them to be assigned to a fix stream index when assigned
  1202 to the underlying pseudo-random stream of numbers.</li>
  1203 </li>
  1204 </ul>
  1206 <h2>Changes to build system:</h2>
  1207 <ul>
  1208 <li></li>
  1209 </ul>
  1211 <h2>Changed behavior:</h2>
  1212 <ul>
  1213 <li>Programs using random variables or models that include random variables 
  1214 may exhibit changed output for a given run number or seed, due to a possible 
  1215 change in the order in which random variables are assigned to underlying 
  1216 pseudo-random sequences.  Consult the manual for more information regarding 
  1217 this.</li>
  1218 </ul>
  1220 <hr>
  1221 <h1>Changes from ns-3.13 to ns-3.14</h1>
  1223 <h2>New API:</h2>
  1224 <ul>
  1225 <li>The new class AntennaModel provides an API for modeling the radiation pattern of antennas.
  1226 </li>
  1227 <li>The new buildings module introduces an API (classes, helpers, etc)
  1228   to model the presence of buildings in a wireless network topology. 
  1229 </li>
  1230 <li>The LENA project's implementation of the LTE Mac Scheduler Interface Specification
  1231    standardized by the Small Cell Forum (formerly Femto Forum) is now available for
  1232   use with the LTE module.
  1233 </li>
  1234 </ul>
  1236 <h2>Changes to existing API:</h2>
  1237 <ul>
  1238 <li> The Ipv6RawSocketImpl "IcmpFilter" attribute has been removed. Six 
  1239 new member functions have been added to enable the same functionality.
  1240 </li>
  1241 <li> IPv6 support for TCP and UDP has been implemented.  Socket functions
  1242 that take an address [e.g. Send (), Connect (), Bind ()] can accept an
  1243 ns3::Ipv6Address or a ns3::Address in addition to taking an ns3::Ipv4Address.
  1244 (Note that the ns3::Address must contain a ns3::Ipv6Address or a ns3::Ipv4Address,
  1245 otherwise these functions will return an error).
  1246 Internally, the socket now stores the remote address as a type "ns3::Address"
  1247 instead of a type "ns3::Ipv4Address".  The IPv6 Routing Header extension is not
  1248 currently supported in ns3 and will not be reflected in the TCP and UDP checksum
  1249 calculations per RFC 2460.  Also note that UDP checksums for IPv6 packets are
  1250 required per RFC, but remain optional and disabled by default in ns3 (in the
  1251 interest of performance).
  1252 </li>
  1253 <li>
  1254 When calling Bind () on a socket without an address, the behavior remains the
  1255 same: it will bind to the IPv4 "any" address (  In order to Bind () to
  1256 the IPv6 "any" address in a similar fashion, use "Bind6 ()".
  1257 </li>
  1258 <li>
  1259 The prototype for the RxCallback function in the Ipv6EndPoint was changed.
  1260 It now includes the destination IPv6 address of the end point which was
  1261 needed for TCP.  This lead to a small change in the UDP and ICMPv6 L4
  1262 protocols as well.
  1263 </li>
  1264 <li>
  1265 Ipv6RoutingHelper can now print the IPv6 Routing Tables at specific 
  1266 intervals or time. Exactly like Ipv4RoutingHelper do.
  1267 </li>
  1268 <li>
  1269 New "SendIcmpv6Redirect" attribute (and getter/setter functions) to 
  1270 Ipv6L3Protocol. The behavior is similar to Linux's conf "send_redirects", 
  1271 i.e., enable/disable the ICMPv6 Redirect sending.
  1272 </li>
  1273 <li> The SpectrumPhy abstract class now has a new method
  1274 <pre>virtual Ptr&#60;AntennaModel&#62; GetRxAntenna () = 0;</pre>
  1275 that all derived classes need to implement in order to integrate properly with the newly added antenna model. In addition, a new member variable "Ptr&#60;AntennaModel&#62; txAntenna" has been added to SpectrumSignalParameters in order to allow derived SpectrumPhy classes to provide information about the antenna model used for the transmission of a waveform.
  1276 </li>
  1277 <li> The Ns2CalendarScheduler event scheduler has been removed.
  1278 </li>
  1279 <li>
  1280 ErrorUnit enum has been moved into RateErrorModel class, and symbols EU_BIT, EU_BYTE and EU_PKT have been renamed to RateErrorModel::ERROR_UNIT_BIT, RateErrorModel::ERROR_UNIT_BYTE and RateErrorModel::ERROR_UNIT_PACKET. RateErrorModel class attribute "ErrorUnit" values have also been renamed for consistency, and are now "ERROR_UNIT_BIT", "ERROR_UNIT_BYTE", "ERROR_UNIT_PACKET".
  1281 </li>
  1282 <li>
  1283 QueueMode enum from DropTailQueue and RedQueue classes has been unified and moved to Queueu class. Symbols DropTailQueue::PACKETS and DropTailQueue::BYTES are now named Queue::QUEUE_MODE_PACKETS and DropTailQueue::QUEUE_MODE_BYTES. In addition, DropTailQueue and RedQueue class attributes "Mode" have been renamed for consistency from "Packets" and "Bytes" to "QUEUE_MODE_PACKETS" and "QUEUE_MODE_BYTES".
  1284 </li>
  1285 <li>
  1286 The API of the LTE module has undergone a significant redesign with
  1287 the merge of the code from the LENA project. The new API is not
  1288 backwards compatible with the previous version of the LTE module.
  1289 </li>
  1290 <li> The Ipv6AddressHelper API has been aligned with the Ipv4AddressHelper API. 
  1291 The helper can be set with a call to Ipv6AddressHelper::SetBase 
  1292 (Ipv6Address network, Ipv6Prefix prefix) instead of NewNetwork
  1293 (Ipv6Address network, Ipv6Prefix prefix).  A new NewAddress (void) method
  1294 has been added.  Typical usage will involve calls to SetBase (), NewNetwork (),
  1295 and NewAddress (), as in class Ipv4AddressHelper. 
  1296 </li>
  1297 </ul>
  1299 <h2>Changes to build system:</h2>
  1300 <ul>
  1301 <li> The following files are removed:
  1302 <pre>
  1303   src/internet/model/
  1304   src/internet/model/ipv4-l4-protocol.h
  1305   src/internet/model/
  1306   src/internet/model/ipv6-l4-protocol.h
  1307 </pre>
  1308 and replaced with:
  1309 <pre>
  1310   src/internet/model/
  1311   src/internet/model/ip-l4-protocol.h
  1312 </pre>
  1313 </li>
  1314 </ul>
  1315 <h2>Changed behavior:</h2>
  1316 <ul>
  1317 <li> Dual-stacked IPv6 sockets are implemented.  An IPv6 socket can accept
  1318 an IPv4 connection, returning the senders address as an IPv4-mapped address
  1319 (IPV6_V6ONLY socket option is not implemented).
  1320 </li>
  1321 <li>
  1322 The following examples/application/helpers were modified to support IPv6:
  1323 <pre>
  1324 csma-layout/examples/csma-star [*]
  1325 netanim/examples/star-animation [*]
  1326 point-to-point-layout/model/
  1327 point-to-point-layout/model/
  1328 point-to-point-layout/model/
  1329 examples/udp/udp-echo [*]
  1330 examples/udp-client-server/udp-client-server [*]
  1331 examples/udp-client-server/udp-trace-client-server [*]
  1332 applications/helper/udp-echo-helper
  1333 applications/model/udp-client
  1334 applications/model/udp-echo-client
  1335 applications/model/udp-echo-server
  1336 applications/model/udp-server
  1337 applications/model/udp-trace-client
  1339 [*]  Added '--useIpv6' flag to switch between IPv4 and IPv6
  1340 </pre>
  1341 </li>
  1342 </ul>
  1344 <hr>
  1345 <h1>Changes from ns-3.12 to ns-3.13</h1>
  1347 <h2>Changes to build system:</h2>
  1348 <ul>
  1349 <li> The underlying version of waf used by ns-3 was upgraded to 1.6.7.  
  1350 This has a few changes for users and developers:
  1351 <ul>
  1352 <li> by default, "build" no longer has a subdirectory debug or optimized.  
  1353 To get different build directories for different build types, you can use 
  1354 the waf configure -o <argument> option, e.g.:
  1355 <pre>
  1356   ./waf configure -o shared
  1357   ./waf configure --enable-static -o static
  1358 </pre>
  1359 </li>
  1360 <li> (for developers) the ns3headers taskgen needs to be created with a 
  1361 features parameter name:
  1362 <pre>
  1363   -  headers = bld.new_task_gen('ns3header')
  1364   +  headers = bld.new_task_gen(features=['ns3header'])
  1365 </pre>
  1366 <li> no longer need to edit src/wscript to add a module, just create your 
  1367 module directory inside src and ns-3 will pick it up
  1368 <li> In WAF 1.6, adding -Dxxx options is done via the DEFINES env. var.
  1369 instead of CXXDEFINES
  1370 <li> waf env values are always lists now, e.g. env['PYTHON'] returns
  1371 ['/usr/bin/python'], so you may need to add [0] to the value in some places
  1372 </ul> 
  1373 </ul>
  1375 <h2>New API:</h2>
  1376 <ul>
  1377 <li> In the mobility module, there is a new MobilityModel::GetRelativeSpeed() method returning the relative speed of two objects. </li>
  1378 <li> A new Ipv6AddressGenerator class was added to generate sequential
  1379 addresses from a provided base prefix and interfaceId.  It also will detect
  1380 duplicate address assigments. </li> 
  1381 </ul>
  1383 <h2>Changes to existing API:</h2>
  1384 <ul>
  1385 <li> In the spectrum module, the parameters to SpectrumChannel::StartTx () and SpectrumPhy::StartRx () methods are now passed using the new struct SpectrumSignalParameters. This new struct supports inheritance, hence it allows technology-specific PHY implementations to provide technology-specific parameters in SpectrumChannel::StartTx() and SpectrumPhy::StartRx(), while at the same time keeping a set of technology-independent parameters common across all spectrum-enabled PHY implementations (i.e., the duration and the power spectral density which are needed for interference calculation). Additionally, the SpectrumType class has been removed, since now the type of a spectrum signal can be inferred by doing a dynamic cast on SpectrumSignalParameters. See the <A href="" >Spectrum API change discussion on ns-developers</A> for the motivation behind this API change.
  1386 </li>
  1388 <li> The WifiPhyStandard enumerators for specifying half- and quarter-channel 
  1389 width standards has had a change in capitalization:
  1390 <ul>
  1391 <li> WIFI_PHY_STANDARD_80211_10Mhz was changed to WIFI_PHY_STANDARD_80211_10MHZ
  1392 <li> WIFI_PHY_STANDARD_80211_5Mhz was changed to WIFI_PHY_STANDARD_80211_5MHZ
  1393 </ul>
  1394 <li> In the SpectrumPhy base class, the methods to get/set the
  1395   MobilityModel and the NetDevice were previously working with
  1396   opaque Ptr&#60;Object&#62;. Now all these methods have been
  1397   changed so that they work with Ptr&#60;NetDevice&#62;
  1398   and Ptr&#60;MobilityModel&#62; as appropriate. See <A href="">Bug 1271</A> on
  1399   bugzilla for the motivation.
  1400 </li>
  1401 </ul>
  1403 <h2>Changed behavior:</h2>
  1404 <ul>
  1405 <li> TCP bug fixes
  1406 <ul> 
  1407 <li> Connection retries count is a separate variable with the retries limit, so cloned sockets can reset the count
  1408 <li> Fix bug on RTO that may halt the data flow
  1409 <li> Make TCP endpoints always holds the accurate address:port info
  1410 <li> RST packet is sent on closed sockets
  1411 <li> Fix congestion window sizing problem upon partial ACK in TcpNewReno
  1412 <li> Acknowledgement is sent, rather than staying silent, upon arrival of unacceptable packets
  1413 <li> Advance TcpSocketBase::m_nextTxSequence after RTO
  1414 </ul>
  1415 <li> TCP enhancements
  1416 <ul>
  1417 <li> Latest RTT value now stored in variable TcpSocketBase::m_lastRtt
  1418 <li> The list variable TcpL4Protocol::m_sockets now always holds all the created, running TcpSocketBase objects
  1419 <li> Maximum announced window size now an attribute, ns3::TcpSocketBase::MaxWindowSize
  1420 <li> TcpHeader now recognizes ECE and CWR flags (c.f. RFC3168)
  1421 <li> Added TCP option handling call in TcpSocketBase for future extension
  1422 <li> Data out of range (i.e. outsize acceptable range of receive window) now computed on bytes, not packets
  1423 <li> TCP moves from time-wait state to closed state after twice the time specified by attribute ns3:TcpSocketBase::MaxSegLifeTime
  1424 <li> TcpNewReno supports limited transmit (RFC3042) if asserting boolean attribute ns3::TcpNewReno::LimitedTransmit
  1425 <li> Nagle's algorithm supported. Default off, turn on by calling TcpSocket::SetTcpNoDelay(true)
  1426 </ul>
  1427 </ul>
  1429 <hr>
  1430 <h1>Changes from ns-3.11 to ns-3.12</h1>
  1432 <h2>Changes to build system:</h2>
  1433 <ul>
  1434 </ul>
  1436 <h2>New API:</h2>
  1437 <ul>
  1438 <li> New method, RegularWifiMac::SetPromisc (void), to set the interface
  1439 to promiscuous mode.
  1440 </ul>
  1442 <h2>Changes to existing API:</h2>
  1443 <ul>
  1444 <li> The spelling of the attribute 'IntialCellVoltage' from LiIonEnergySource 
  1445 was corrected to 'InitialCellVoltage'; this will affect existing users who 
  1446 were using the attribute with the misspelling.
  1447 <li> Two trace sources in class WifiPhy have had their names changed:
  1448 <ul> 
  1449 <li> 'PromiscSnifferRx' is now 'MonitorSnifferRx'
  1450 <li> 'PromiscSnifferTx' is now 'MonitorSnifferTx'
  1451 </ul>
  1452 </ul>
  1454 <h2>Changed behavior:</h2>
  1455 <ul>
  1456 <li> IPv4 fragmentation is now supported.
  1457 </ul>
  1459 <hr>
  1460 <h1>Changes from ns-3.10 to ns-3.11</h1>
  1462 <h2>Changes to build system:</h2>
  1463 <ul>
  1464 <li><b>Examples and tests are no longer built by default in ns-3</b>
  1465 <p>
  1466 You can now make examples and tests be built in ns-3 in two ways.
  1467 <ol>
  1468 <li> Using when ns-3 is built for the first time:
  1469 <pre>
  1470     ./ --enable-examples --enable-tests
  1471 </pre>
  1472 <li> Using waf once ns-3 has been built:
  1473 <pre>
  1474     ./waf configure --enable-examples --enable-tests
  1475 </pre>
  1476 </ol>
  1477 </p></li>
  1478 <li><b> Subsets of modules can be enabled using the ns-3 configuration file</b>
  1479 <p>A new configuration file, .ns3rc, has been added to ns-3 that
  1480 specifies the modules that should be enabled during the ns-3 build.
  1481 See the documentation for details.
  1482 </p></li>
  1483 </ul>
  1485 <h2>New API:</h2>
  1486 <ul>
  1487 <li><b>int64x64_t</b>
  1488 <p>The <b>int64x64_t</b> type implements all the C++ arithmetic operators to behave like one of the
  1489 C++ native types. It is a 64.64 integer type which means that it is a 128bit integer type with
  1490 64 bits of fractional precision. The existing <b>Time</b> type is now automatically convertible to
  1491 <b>int64x64_t</b> to allow arbitrarily complex arithmetic operations on the content of <b>Time</b>
  1492 objects. The implementation of <b>int64x64_t</b> is based on the previously-existing
  1493 <b>HighPrecision</b> type and supercedes it.
  1494 </p></li>
  1495 </ul>
  1497 <h2>Changes to existing API:</h2>
  1498 <ul>
  1499 <li><b>Wifi TX duration calculation moved from InterferenceHelper to WifiPhy</b>
  1500 <p>The following static methods have been moved from the InterferenceHelper class to the WifiPhy class:
  1501    <pre>
  1502 static Time CalculateTxDuration (uint32_t size, WifiMode payloadMode, enum WifiPreamble preamble);
  1503 static WifiMode GetPlcpHeaderMode (WifiMode payloadMode, WifiPreamble preamble);
  1504 static uint32_t GetPlcpHeaderDurationMicroSeconds (WifiMode payloadMode, WifiPreamble preamble);
  1505 static uint32_t GetPlcpPreambleDurationMicroSeconds (WifiMode payloadMode, WifiPreamble preamble);
  1506 static uint32_t GetPayloadDurationMicroSeconds (uint32_t size, WifiMode payloadMode);
  1507 </pre>
  1508 </p></li>
  1509 <li><b>Test cases no longer return a boolean value</b>
  1510 <p>Unit test case DoRun() functions no longer return a bool value.  Now, they don't return a value at all.  The motivation for this change was to disallow users from merely returning "true" from a test case to force an error to be recorded.  Instead, test case macros should be used.
  1511 </p></li>
  1512 <li><b>PhyMac renamed to GenericPhy</b>
  1513 <p>The PhyMac interface previously defined in phy-mac.h has been
  1514   renamed to GenericPhy interface and moved to a new file
  1515   generic-phy.h. The related variables and methods have been renamed accordingly. 
  1516 </p></li>
  1517 <li><b>Scalar</b>
  1518 <p>The Scalar type has been removed. Typical code such as:
  1519 <pre>
  1520 Time tmp = ...;
  1521 Time result = tmp * Scalar (5);
  1522 </pre>
  1523 Can now be rewritten as:
  1524 <pre>
  1525 Time tmp = ...;
  1526 Time result = Time (tmp * 5);
  1527 </pre>
  1528 </p>
  1529 </li>
  1530 <li><b>Multicast GetOutputTtl() commands</b>
  1531 <p> As part of bug 1047 rework to enable multicast routes on nodes with
  1532 more than 16 interfaces, the methods Ipv4MulticastRoute::GetOutputTtl () 
  1533 and Ipv6MulticastRoute::GetOutputTtl () have been modified to return
  1534 a std::map of interface IDs and TTLs for the route.
  1535 </p>
  1536 </li>
  1537 </ul>
  1539 <h2>Changed behavior:</h2>
  1540 <ul>
  1541   <li> If the data inside the TCP buffer is less than the available window, TCP tries to ask for more data to the application, in the hope of filling the usable transmission window. In some cases, this change allows sending bigger packets than the previous versions, optimizing the transmission.</li>
  1542   <li> In TCP, the ACK is now processed before invoking any routine that deals with the segment sending, except in case of retransmissions.</li>
  1543 </ul>
  1545 <hr>
  1546 <h1>Changes from ns-3.9 to ns-3.10</h1>
  1548 <h2>Changes to build system:</h2>
  1549 <ul>
  1550 <li><b>Regression tests are no longer run using waf</b>
  1551 <p>All regression testing is now being done in  As a result, a 
  1552 separate reference trace repository is no longer needed to perform 
  1553 regression tests.  Tests that require comparison against known good traces
  1554 can still be run from  The --regression option for waf has been
  1555 removed.  However, the "-r" option to has been kept to 
  1556 allow users to fetch older revisions of ns-3 that contain these traces.
  1557 </p>
  1558 <li><b>Documentation converted to Sphinx</b>
  1559 <p> Project documentation (manual, tutorial, and testing) have been
  1560 converted to Sphinx from the GNU Texinfo markup format.</p>
  1561 </ul>
  1563 <h2>New API:</h2>
  1564 <ul>
  1565 <li><b>Pyviz visualizer</b>  
  1566 <p>A Python-based visualizer called pyviz is now integrated with ns-3.
  1567 For Python simulations, there is an API to start the visualizer.  You
  1568 have to import the visualizer module, and call visualizer.start()
  1569 instead of ns3.Simulator.Run().  For C++ simulations, there is no API.
  1570 For C++ simulations (but also works for Python ones) you need to set
  1571 the GlobalValue SimulatorImplementationType to
  1572 "ns3::VisualSimulatorImpl".  This can be set from the command-line,
  1573 for example (add the
  1574 <tt>--SimulatorImplementationType=ns3::VisualSimulatorImpl</tt>
  1575 option), or via the waf option <tt>--visualizer</tt>, in addition to
  1576 the usual <tt>--run</tt> option to run programs.
  1577 </p></li>
  1579 <li><b>WaypointMobility attributes</b>
  1580 <p>Two attributes were added to WaypointMobility model:  LazyNotify and
  1581 InitialPositionIs Waypoint.  See RELEASE_NOTES for details.  </p> </li>
  1583 <li><b>802.11g rates for ERP-OFDM added</b>
  1584 <p>New WifiModes of the form ErpOfdmRatexxMbps, where xx is the rate
  1585 in Mbps (6, 9, 12, 18, 24, 36, 48, 54), are available for 802.11g.  
  1586 More details are in the RELEASE_NOTES.  </p> </li>
  1588 <li><b>Socket::GetSocketType ()</b>
  1589 <p>This is analogous to getsockopt(SO_TYPE). ipv4-raw-socket, ipv6-raw-socket,
  1590   and packet-socket return NS3_SOCK_RAW. tcp-socket and nsc-tcp-socket return
  1591   NS3_SOCK_STREAM. udp-socket returns NS3_SOCK_DGRAM.</p></li>
  1593 <li><b>BulkSendApplication</b>
  1594 <p>Sends data as fast as possible up to MaxBytes or unlimited if MaxBytes is 
  1595 zero.  Think OnOff, but without the "off" and without the variable data rate. 
  1596 This application only works with NS3_SOCK_STREAM and NS3_SOCK_SEQPACKET sockets, 
  1597 for example TCP sockets and not UDP sockets. A helper class exists to 
  1598 facilitate creating BulkSendApplications. The API for the helper class 
  1599 is similar to existing application helper classes, for example, OnOff.
  1600 </p></li>
  1602 <li><b>Rakhmatov Vrudhula non-linear battery model</b>
  1603 <p>New class and helper for this battery model. </p></li>
  1605 <li><b>Print IPv4 routing tables</b>
  1606 <p>New class methods and helpers for printing IPv4 routing tables
  1607 to an output stream. </p></li>
  1609 <li><b>Destination-Sequenced Distance Vector (DSDV) routing protocol</b>
  1610 <p>Derives from Ipv4RoutingProtocol and contains a DsdvHelper class. </p></li>
  1612 <li><b>3GPP Long Term Evolution (LTE) models</b>
  1613 <p>More details are in the RELEASE_NOTES. </p></li>
  1615 </ul>
  1617 <h2>Changes to existing API:</h2>
  1618 <ul>
  1619 <li><b>Consolidation of Wi-Fi MAC high functionality</b>
  1620 <p>Wi-Fi MAC high classes have been reorganised in attempt to
  1621 consolidate shared functionality into a single class. This new class
  1622 is RegularWifiMac, and it derives from the abstract WifiMac, and is
  1623 parent of AdhocWifiMac, StaWifiMac, ApWifiMac, and
  1624 MeshWifiInterfaceMac. The QoS and non-QoS class variants are no
  1625 longer, with a RegularWifiMac attribute "QosSupported" allowing
  1626 selection between these two modes of operation. QosWifiMacHelper and
  1627 NqosWifiMacHelper continue to work as previously, with a
  1628 behind-the-scenes manipulation of the 'afore-mentioned attribute.
  1629 </p></li>
  1631 <li><b>New TCP architecture</b>
  1632 <p>TcpSocketImpl was replaced by a new base class TcpSocketBase and
  1633 several subclasses implementing different congestion control.  From 
  1634 a user-level API perspective, the main change is that a new attribute
  1635 "SocketType" is available in TcpL4Protocol, to which a TypeIdValue
  1636 of a specific Tcp variant can be passed.  In the same class, the attribute 
  1637 "RttEstimatorFactory" was also renamed "RttEstimatorType" since it now
  1638 takes a TypeIdValue instead of an ObjectFactoryValue.  In most cases, 
  1639 however, no change to existing user programs should be needed.
  1640 </p></li>
  1641 </ul>
  1643 <h2>Changed behavior:</h2>
  1644 <ul>
  1645 <li><b>EmuNetDevice uses DIX instead of LLC encapsulation by default</b>
  1646 <p>bug 984 in ns-3 tracker:  real devices don't usually understand LLC/SNAP
  1647 so the default of DIX makes more sense.
  1648 </p></li>
  1649 <li><b>TCP defaults to NewReno congestion control</b>
  1650 <p>As part of the TCP socket refactoring, a new TCP implementation provides
  1651 slightly different behavior than the previous TcpSocketImpl that provided
  1652 only fast retransmit.  The default behavior now is NewReno which provides
  1653 fast retransmit and fast recovery with window inflation during recovery.
  1654 </p></li>
  1655 </ul>
  1657 <hr>
  1658 <h1>Changes from ns-3.8 to ns-3.9</h1>
  1660 <h2>Changes to build system:</h2>
  1662 <h2>New API:</h2>
  1663 <ul>
  1664 <li><b>Wifi set block ack threshold:</b> Two methods for setting block ack
  1665 parameters for a specific access class: 
  1666 <pre>
  1667 void QosWifiMacHelper::SetBlockAckThresholdForAc (enum AccessClass accessClass, uint8_t threshold);
  1668 void QosWifiMacHelper::SetBlockAckInactivityTimeoutForAc (enum AccessClass accessClass, uint16_t timeout);
  1669 </pre>
  1670 </li>
  1671 <li><b>Receive List Error Model:</b>  Another basic error model that allows
  1672 the user to specify a list of received packets that should be errored.  The
  1673 list corresponds not to the packet UID but to the sequence of received
  1674 packets as observed by the error model.   See src/common/error-model.h
  1675 </li>
  1676 <li><b>Respond to interface events:</b> New attribute for Ipv4GlobalRouting,
  1677 "RespondToInterfaceEvents", which when enabled, will cause global routes
  1678 to be recomputed upon any interface or address notification event from IPv4.
  1679 </li>
  1680 <li><b>Generic sequence number:</b> New generic sequence number class to 
  1681 easily handle comparison, subtraction, etc. for sequence numbers.  
  1682 To use it you need to supply two fundamental types as template parameters: 
  1683 NUMERIC_TYPE and SIGNED_TYPE.  For instance, <tt>SequenceNumber&lt;uint32_t, int32_t&gt;</tt> 
  1684 gives you a 32-bit sequence number, while <tt>SequenceNumber&lt;uint16_t, int16_t&gt;</tt> 
  1685 is a 16-bit one.  For your convenience, these are typedef'ed as 
  1686 <tt>SequenceNumber32</tt> and <tt>SequenceNumber16</tt>, respectively.
  1687 </li>
  1689 <li><b>Broadcast socket option:</b> New Socket
  1690 methods <tt>SetAllowBroadcast</tt> and <tt>GetAllowBroadcast</tt> add
  1691 to NS-3 <tt>Socket</tt>'s the equivalent to the POSIX SO_BROADCAST
  1692 socket option (setsockopt/getsockopt).  Starting from this NS-3
  1693 version, IPv4 sockets do not allow us to send packets to broadcast
  1694 destinations by default; SetAllowBroadcast must be called beforehand
  1695 if we wish to send broadcast packets.
  1696 </li>
  1698 <li><b>Deliver of packet ancillary information to sockets:</b> A method to deliver ancillary information 
  1699 to the socket interface (fixed in bug 671):  <pre>void Socket::SetRecvPktInfo (bool flag);</pre>
  1701 </ul>
  1703 <h2>Changes to existing API:</h2>
  1705 <ul>
  1706 <li><b>Changes to construction and naming of Wi-Fi transmit rates:</b>
  1707 A reorganisation of the construction of Wi-Fi transmit rates has been
  1708 undertaken with the aim of simplifying the task of supporting further
  1709 IEEE 802.11 PHYs. This work has been completed under the auspices of
  1710 Bug 871.
  1712 From the viewpoint of simulation scripts not part of the ns-3
  1713 distribution, the key change is that WifiMode names of the form
  1714 wifi<em>x</em>-<em>n</em>mbs are now invalid. Names now take the
  1715 form <em>Cccc</em>Rate<em>n</em>Mbps[BW<em>b</em>MHz],
  1716 where <em>n</em> is the root bitrate in megabits-per-second as before
  1717 (with only significant figures included, and an underscore replacing
  1718 any decimal point), and <em>Cccc</em> is a representation of the
  1719 Modulation Class as defined in Table 9-2 of IEEE
  1720 Std. 802.11-2007. Currently-supported options for <em>Cccc</em>
  1721 are <em>Ofdm</em> and <em>Dsss</em>. For modulation classes where
  1722 optional reduced-bandwidth transmission is possible, this is captured
  1723 in the final part of the form above, with <em>b</em> specifying the
  1724 nominal signal bandwidth in megahertz. </li>
  1726 <li><b>Consolidation of classes support Wi-Fi Information Elements:</b>
  1727 When the <em>mesh</em> module was introduced it added a class
  1728 hierarchy for modelling of the various Information Elements that were
  1729 required. In this release, this class hierarchy has extended by moving
  1730 the base classes (WifiInformationElement and
  1731 WifiInformationElementVector) into the <em>wifi</em> module. This
  1732 change is intended to ease the addition of support for modelling of
  1733 further Wi-Fi functionality. </li>
  1735 <li><b>Changed for {Ipv4,Ipv6}PacketInfoTag delivery:</b> In order to
  1736 deliver ancillary information to the socket interface (fixed in bug 671),
  1737 <em>Ipv4PacketInfoTag</em> and <em>Ipv6PacketInfoTag</em> are implemented. 
  1738 For the delivery of this information, the following changes are made into 
  1739 existing class.
  1741 In Ipv4EndPoint class,
  1742 <pre>
  1743 -  void SetRxCallback (Callback&lt;void,Ptr&lt;Packet&gt;, Ipv4Address, Ipv4Address, uint16_t&gt; callback);
  1744 +  void SetRxCallback (Callback&lt;void,Ptr&lt;Packet&gt;, Ipv4Header, uint16_t, Ptr&lt;Ipv4Interface&gt; &gt; callback);
  1746 -  void ForwardUp (Ptr&lt;Packet&gt; p, Ipv4Address saddr, Ipv4Address daddr, uint16_t sport);
  1747 +  void ForwardUp (Ptr&lt;Packet&gt; p, const Ipv4Header& header, uint16_t sport, 
  1748 +                  Ptr&lt;Ipv4Interface&gt; incomingInterface);
  1749 </pre>
  1750 In Ipv4L4Protocol class,
  1751 <pre>
  1752    virtual enum RxStatus Receive(Ptr&lt;Packet&gt; p, 
  1753 -                                Ipv4Address const &source,
  1754 -                                Ipv4Address const &destination,
  1755 +                                Ipv4Header const &header,
  1756                                  Ptr&lt;Ipv4Interface&gt; incomingInterface) = 0;
  1757 </pre>
  1758 <pre>
  1759 -Ipv4RawSocketImpl::ForwardUp (Ptr&lt;const Packet&gt; p, Ipv4Header ipHeader, Ptr&lt;NetDevice&gt; device)
  1760 +Ipv4RawSocketImpl::ForwardUp (Ptr&lt;const Packet&gt; p, Ipv4Header ipHeader, Ptr&lt;Ipv4Interface&gt; incomingInterface)
  1762 -NscTcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t port)
  1763 +NscTcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Header header, uint16_t port,
  1764 +                             Ptr&lt;Ipv4Interface&gt; incomingInterface)
  1766 -TcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t port)
  1767 +TcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Header header, uint16_t port,
  1768 +                          Ptr&lt;Ipv4Interface&gt; incomingInterface)
  1770 -UdpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t port)
  1771 +UdpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Header header, uint16_t port,
  1772 +                          Ptr&lt;Ipv4Interface&gt; incomingInterface)
  1774 </pre>
  1776 </li>
  1777 <li>The method OutputStreamWrapper::SetStream (std::ostream *ostream) was removed.</li>
  1778 )
  1779 </ul>
  1781 <h2>Changed behavior:</h2>
  1782 <ul>
  1783 <li><b>Queue trace behavior during Enqueue changed:</b> The behavior of the
  1784 Enqueue trace source has been changed to be more intuitive and to agree with
  1785 documentation.  Enqueue and Drop events in src/node/ are now mutually
  1786 exclusive.  In the past, the meaning of an Enqueue event was that the Queue
  1787 Enqueue operation was being attempted; and this could be followed by a Drop
  1788 event if the Queue was full.  The new behavior is such that a packet is either
  1789 Enqueue'd successfully or Drop'ped.
  1791 <li><b>Drop trace logged for Ipv4/6 forwarding failure:</b> Fixed bug 861; this 
  1792 will add ascii traces (drops) in Ipv4 and Ipv6 traces for forwarding failures
  1794 <li><b>Changed default WiFi error rate model for OFDM modulation types:</b> 
  1795 Adopted more conservative ErrorRateModel for OFDM modulation types (a/g).
  1796 This will require 4 to 5 more dB of received power to get similar results
  1797 as before, so users may observe a reduced WiFi range when using the defaults.
  1798 See tracker issue 944 for more details.
  1799 </ul>
  1801 <hr>
  1802 <h1>Changes from ns-3.7 to ns-3.8</h1>
  1804 <h2>Changes to build system:</h2>
  1806 <h2>New API:</h2>
  1808 <ul>
  1809 <li><b>Matrix propagation loss model:</b> This radio propagation model uses a two-dimensional matrix
  1810 of path loss indexed by source and destination nodes.
  1812 <li><b>WiMAX net device</b>: The developed WiMAX model attempts to provide an accurate MAC and
  1813 PHY level implementation of the 802.16 specification with the Point-to-Multipoint (PMP) mode and the WirelessMAN-OFDM 
  1814 PHY layer. By adding WimaxNetDevice objects to ns-3 nodes, one can create models of
  1815 802.16-based networks. The source code for the WiMAX models lives in the directory src/devices/wimax.
  1816 The model is mainly composed of three layers:
  1817 <ul>
  1818 <li>The convergence sublayer (CS)
  1819 <li>The MAC Common Part Sublayer (MAC-CPS)
  1820 <li>The Physical layer
  1821 </ul>
  1822 The main way that users who write simulation scripts will typically
  1823 interact with the Wimax models is through the helper API and through
  1824 the publicly visible attributes of the model.
  1825 The helper API is defined in src/helper/wimax-helper.{cc,h}.
  1826 Three examples containing some code that shows how to setup a 802.16 network are located under examples/wimax/ 
  1828 <li><b>MPI Interface for distributed simulation:</b> Enables access
  1829 to necessary MPI information such as MPI rank and size.
  1831 <li><b>Point-to-point remote channel:</b> Enables point-to-point 
  1832 connection between net-devices on different simulators, for use 
  1833 with distributed simulation.
  1835 <li><b>GetSystemId in simulator:</b> For use with distributed 
  1836 simulation, GetSystemId returns zero by non-distributed 
  1837 simulators.  For the distributed simulator, it returns the 
  1838 MPI rank.
  1840 <li><b>Enhancements to src/core/</b> New Zeta random variable generator. The Zeta random 
  1841 distribution is tightly related to the Zipf distribution (already in ns-3.7). See the documentation, 
  1842 especially because sometimes the Zeta distribution is called Zipf and viceversa. Here we conform to the 
  1843 Wikipedia naming convention, i.e., Zipf is bounded while Zeta isn't. 
  1845 <li><b>Two-ray ground propagation loss model:</b> Calculates the crossover distance under which Friis is used. The antenna 
  1846 height is set to the nodes z coordinate, but can be added to using the model parameter SetHeightAboveZ, which 
  1847 will affect ALL stations
  1849 <li><b>Pareto random variable</b> has two new constructors to specify scale and shape:
  1850 <pre>
  1851 ParetoVariable (std::pair<double, double> params);
  1852 ParetoVariable (std::pair<double, double> params, double b);
  1853 </pre>
  1854 </ul>
  1856 <h2>Changes to existing API:</h2>
  1857 <ul>
  1858 <li><b>Tracing Helpers</b>: The organization of helpers for both pcap and ascii
  1859 tracing, in devices and protocols, has been reworked.  Instead of each device 
  1860 and protocol helper re-implementing trace enable methods, classes have been 
  1861 developed to implement user-level tracing in a consistent way; and device and 
  1862 protocol helpers use those classes to provide tracing functionality.<br>
  1863 In addition to consistent operation across all helpers, the object name service
  1864 has been integrated into the trace file naming scheme.<br>
  1865 The internet stack helper has been extensively massaged to make it easier to 
  1866 manage traces originating from protocols.  It used to be the case that there 
  1867 was essentially no opportunity to filter tracing on interfaces, and resulting
  1868 trace file names collided with those created by devices.  File names are now
  1869 disambiguated and one can enable traces on a protocol/interface basis analogously
  1870 to the node/device granularity of device-based helpers.<br>
  1871 The primary user-visible results of this change are that trace-related functions
  1872 have been changed from static functions to method calls; and a new object has
  1873 been developed to hold streams for ascii traces.<br>
  1874 New functionality is present for ascii traces.  It is now possible to create
  1875 multiple ascii trace files automatically just as was possible for pcap trace 
  1876 files.<br>
  1877 The implementation of the helper code has been designed also to provide 
  1878 functionality to make it easier for sophisticated users to hook traces of 
  1879 various kinds and write results to (file) streams.
  1880 Before:
  1881 <pre>
  1882   CsmaHelper::EnablePcapAll ();
  1884   std::ofstream ascii;
  1885 ("", std::ios_base::binary | std::ios_base::out);
  1886   CsmaHelper::EnableAsciiAll (ascii);
  1888   InternetStackHelper::EnableAsciiAll (ascii);
  1889 </pre>
  1890 After:
  1891 <pre>
  1892   CsmaHelper csmaHelper;
  1893   InternetStackHelper stack;
  1894   csmaHelper.EnablePcapAll ();
  1896   AsciiTraceHelper ascii;
  1897   csma.EnableAsciiAll (ascii.CreateFileStream (""));
  1899   stack.EnableAsciiIpv4All (stream);
  1900 </pre>
  1903 <li><b>Serialization and Deserialization</b> in buffer, nix-vector, 
  1904 packet-metadata, and packet has been modified to use raw character 
  1905 buffers, rather than the Buffer class
  1906 <pre>
  1907 + uint32_t Buffer::GetSerializedSize (void) const;
  1908 + uint32_t Buffer::Serialize (uint8_t* buffer, uint32_t maxSize) const;
  1909 + uint32_t Buffer::Deserialize (uint8_t* buffer, uint32_t size); 
  1911 - void NixVector::Serialize (Buffer::Iterator i, uint32_t size) const;
  1912 + uint32_t NixVector::Serialize (uint32_t* buffer, uint32_t maxSize) const;
  1913 - uint32_t NixVector::Deserialize (Buffer::Iterator i);
  1914 + uint32_t NixVector::Deserialize (uint32_t* buffer, uint32_t size);
  1916 - void PacketMetadata::Serialize (Buffer::Iterator i, uint32_t size) const;
  1917 + uint32_t PacketMetadata::Serialize (uint8_t* buffer, uint32_t maxSize) const;
  1918 - uint32_t PacketMetadata::Deserialize (Buffer::Iterator i);
  1919 + uint32_t PacketMetadata::Deserialize (uint8_t* buffer, uint32_t size);
  1921 + uint32_t Packet::GetSerializedSize (void) const;
  1922 - Buffer Packet::Serialize (void) const;
  1923 + uint32_t Packet::Serialize (uint8_t* buffer, uint32_t maxSize) const;
  1924 - void Packet::Deserialize (Buffer buffer);
  1925 + Packet::Packet (uint8_t const*buffer, uint32_t size, bool magic);
  1926 </pre>
  1927 <li><b>PacketMetadata uid</b> has been changed to a 64-bit value. The 
  1928 lower 32 bits give the uid, while the upper 32-bits give the MPI rank 
  1929 for distributed simulations. For non-distributed simulations, the 
  1930 upper 32 bits are simply zero.
  1931 <pre>
  1932 - inline PacketMetadata (uint32_t uid, uint32_t size);
  1933 + inline PacketMetadata (uint64_t uid, uint32_t size);
  1934 - uint32_t GetUid (void) const;
  1935 + uint64_t GetUid (void) const;
  1936 - PacketMetadata::PacketMetadata (uint32_t uid, uint32_t size);
  1937 + PacketMetadata::PacketMetadata (uint64_t uid, uint32_t size); 
  1939 - uint32_t Packet::GetUid (void) const;
  1940 + uint64_t Packet::GetUid (void) const;
  1941 </pre>
  1943 <li><b>Moved propagation models</b> from src/devices/wifi to src/common
  1945 <li><b>Moved Mtu attribute from base class NetDevice</b> This attribute is
  1946 now found in all NetDevice subclasses.  
  1947 </ul>
  1949 <h2>Changed behavior:</h2>
  1950 <ul>
  1952 </ul>
  1954 <hr>
  1955 <h1>Changes from ns-3.6 to ns-3.7</h1>
  1958 <h2>Changes to build system:</h2>
  1960 <h2>New API:</h2>
  1962 <ul>
  1963 <li><b>Equal-cost multipath for global routing:</b> Enables quagga's
  1964 equal cost multipath for Ipv4GlobalRouting, and adds an attribute that
  1965 can enable it with random packet distribution policy across equal cost routes.
  1966 <li><b>Binding sockets to devices:</b> A method analogous to a SO_BINDTODEVICE
  1967 socket option has been introduced to class Socket:  <pre>virtual void Socket::BindToNetDevice (Ptr&lt;NetDevice&gt; netdevice);</pre>
  1968 <li><b>Simulator event contexts</b>: The Simulator API now keeps track of a per-event
  1969 'context' (a 32bit integer which, by convention identifies a node by its id). Simulator::GetContext
  1970 returns the context of the currently-executing event while Simulator::ScheduleWithContext creates an
  1971 event with a context different from the execution context of the caller. This API is used
  1972 by the ns-3 logging system to report the execution context of each log line.
  1973 <li><b>Object::DoStart</b>: Users who need to complete their object setup at the start of a simulation
  1974 can override this virtual method, perform their adhoc setup, and then, must chain up to their parent.
  1975 <li><b>Ad hoc On-Demand Distance Vector (AODV)</b> routing model, 
  1976 <a href=>RFC 3561</a> </li>
  1977 <li><b>Ipv4::IsDestinationAddress (Ipv4Address address, uint32_t iif)</b> Method added to support checks of whether a destination address should be accepted 
  1978 as one of the host's own addresses.  RFC 1122 Strong/Weak end system behavior can be changed with a new attribute (WeakEsModel) in class Ipv4.  </li>
  1980 <li><b>Net-anim interface</b>: Provides an interface to net-anim, a network animator for point-to-point 
  1981 links in ns-3.  The interface generates a custom trace file for use with the NetAnim program.</li>
  1983 <li><b>Topology Helpers</b>: New topology helpers have been introduced including PointToPointStarHelper, 
  1984 PointToPointDumbbellHelper, PointToPointGridHelper, and CsmaStarHelper.</li>
  1986 <li><b>IPv6 extensions support</b>: Provides API to add IPv6 extensions and options. Two examples (fragmentation
  1987 and loose routing) are available.</li>
  1988 </ul>
  1990 <h2>Changes to existing API:</h2>
  1991 <ul>
  1992 <li><b>Ipv4RoutingProtocol::RouteOutput</b> no longer takes an outgoing 
  1993 interface index but instead takes an outgoing device pointer; this affects all
  1994 subclasses of Ipv4RoutingProtocol.
  1995 <pre>
  1996 -  virtual Ptr&lt;Ipv4Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv4Header &header, uint32_t oif, Socket::SocketErrno &sockerr) = 0;
  1997 +  virtual Ptr&lt;Ipv4Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv4Header &header, Ptr&lt;NetDevice&gt; oif, Socket::SocketErrno &sockerr) = 0;
  1998 </pre>
  1999 <li><b>Ipv6RoutingProtocol::RouteOutput</b> no longer takes an outgoing 
  2000 interface index but instead takes an outgoing device pointer; this affects all
  2001 subclasses of Ipv6RoutingProtocol.
  2002 <pre>
  2003 -  virtual Ptr&lt;Ipv6Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv6Header &header, uint32_t oif, Socket::SocketErrno &sockerr) = 0;
  2004 +  virtual Ptr&lt;Ipv6Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv6Header &header, Ptr&lt;NetDevice&gt; oif, Socket::SocketErrno &sockerr) = 0;
  2005 </pre>
  2006 <li><b>Application::Start</b> and <b>Application::Stop</b> have been renamed to
  2007 <b>Application::SetStartTime</b> and <b>Application::SetStopTime</b>.
  2008 <li><b>Channel::Send</b>: this method does not really exist but each subclass of the Channel
  2009 base class must implement a similar method which sends a packet from a node to another node.
  2010 Users must now use Simulator::ScheduleWithContext instead of Simulator::Schedule to schedule
  2011 the reception event on a remote node.<br>
  2012 For example, before:
  2013 <pre>
  2014 void
  2015 SimpleChannel::Send (Ptr&lt;Packet&gt; p, uint16_t protocol, 
  2016          Mac48Address to, Mac48Address from,
  2017          Ptr&lt;SimpleNetDevice&gt; sender)
  2018 {
  2019   for (std::vector&lt;Ptr&lt;SimpleNetDevice&gt; &gt;::const_iterator i = m_devices.begin (); i != m_devices.end (); ++i)
  2020     {
  2021       Ptr&lt;SimpleNetDevice&gt; tmp = *i;
  2022       if (tmp == sender)
  2023   {
  2024     continue;
  2025   }
  2026       Simulator::ScheduleNow (&SimpleNetDevice::Receive, tmp, p->Copy (), protocol, to, from);
  2027     }
  2028 }
  2029 </pre>
  2030 After:
  2031 <pre>
  2032 void
  2033 SimpleChannel::Send (Ptr&lt;Packet&gt; p, uint16_t protocol, 
  2034          Mac48Address to, Mac48Address from,
  2035          Ptr&lt;SimpleNetDevice&gt; sender)
  2036 {
  2037   for (std::vector&lt;Ptr&lt;SimpleNetDevice&gt; &gt;::const_iterator i = m_devices.begin (); i != m_devices.end (); ++i)
  2038     {
  2039       Ptr&lt;SimpleNetDevice&gt; tmp = *i;
  2040       if (tmp == sender)
  2041   {
  2042     continue;
  2043   }
  2044       Simulator::ScheduleWithContext (tmp->GetNode ()->GetId (), Seconds (0),
  2045                                       &SimpleNetDevice::Receive, tmp, p->Copy (), protocol, to, from);
  2046     }
  2047 }
  2048 </pre>
  2050 <li><b>Simulator::SetScheduler</b>: this method now takes an ObjectFactory
  2051 instead of an object pointer directly. Existing callers can trivially be
  2052 updated to use this new method.<br>
  2053 Before:
  2054 <pre>
  2055 Ptr&lt;Scheduler&gt; sched = CreateObject&lt;ListScheduler&gt; ();
  2056 Simulator::SetScheduler (sched);
  2057 </pre>
  2058 After:
  2059 <pre>
  2060 ObjectFactory sched;
  2061 sched.SetTypeId ("ns3::ListScheduler");
  2062 Simulator::SetScheduler (sched);
  2063 </pre>
  2065 <li> Extensions to IPv4 <b>Ping</b> application: verbose output and the ability to configure different ping 
  2066 sizes and time intervals (via new attributes)
  2068 <li><b>Topology Helpers</b>: Previously, topology helpers such as a point-to-point star existed in the 
  2069 PointToPointHelper class in the form of a method (ex: PointToPointHelper::InstallStar).  These topology 
  2070 helpers have been pulled out of the specific helper classes and created as separate classes.  Several 
  2071 different topology helper classes now exist including PointToPointStarHelper, PointToPointGridHelper, 
  2072 PointToPointDumbbellHelper, and CsmaStarHelper.  For example, a user wishes to create a 
  2073 point-to-point star network:<br>
  2074 Before:
  2075 <pre>
  2076 NodeContainer hubNode;
  2077 NodeContainer spokeNodes;
  2078 hubNode.Create (1);
  2079 Ptr&lt;Node&gt; hub = hubNode.Get (0);
  2080 spokeNodes.Create (nNodes - 1);
  2082 PointToPointHelper pointToPoint;
  2083 pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));
  2084 pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));
  2085 NetDeviceContainer hubDevices, spokeDevices;
  2086 pointToPoint.InstallStar (hubNode.Get (0), spokeNodes, hubDevices, spokeDevices);
  2087 </pre>
  2088 After:
  2089 <pre>
  2090 PointToPointHelper pointToPoint;
  2091 pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));
  2092 pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));
  2093 PointToPointStarHelper star (nSpokes, pointToPoint);
  2094 </pre>
  2096 </li>
  2098 </ul>
  2100 <h2>Changed behavior:</h2>
  2101 <ul>
  2102 <li> Changed default value of YansWifiPhy::EnergyDetectionThreshold from
  2103 -140.0 dBm to -96.0 dBm.  Changed default value of 
  2104 YansWifiPhy::CcaModelThreshold from -140.0 dBm to -99.0 dBm.  Rationale
  2105 can be found <a href=""> 
  2106 here</a>.
  2107 </li>
  2108 <li> Default TTL of IPv4 broadcast datagrams changed from 1 to 64.</li>
  2109 <li> Changed DcfManager::UpdateBackoff (): using flooring instead of rounding in calculation of remaining slots. <a href="">
  2110   See bug 695.</a></li>
  2111 </ul>
  2114 <hr>
  2115 <h1>Changes from ns-3.5 to ns-3.6</h1>
  2117 <h2>Changes to build system:</h2>
  2118 <ul>
  2119 <li><b>A new test framework is provided with ns-3.6 that primarilay runs outside waf</b>
  2120 <p>"./waf check" now runs the new unit tests of the core part of ns-3.6.  
  2121 In order to run the complete test package, use "./" which is 
  2122 documented in a new manual -- find it in ./doc/testing.  "./waf check"
  2123 no longer generates the introspected Doxygen.  Now use "./waf doxygen"
  2124 to do this and generate the Doxygen documentation in one step.
  2125 </p>
  2126 </ul>
  2128 <h2>New API:</h2>
  2129 <ul>
  2130 <li><b>Longest prefix match, support for metrics, for Ipv4StaticRouting and Ipv6StaticRouting</b>
  2131 <p>When performing route lookup, first match for longest prefix, and then
  2132 based on metrics (default metric = 0).  If metrics are equal, most recent
  2133 addition is picked.  Extends API for support of metrics but preserves
  2134 backward compatibility.  One small change is that the default route
  2135 is no longer stored as index 0 route in the host route table so 
  2136 GetDefaultRoute () must be used.
  2137 </p>
  2138 </li>
  2139 <li><b>Route injection for global routing</b>
  2140 <p>Add ability to inject and withdraw routes to Ipv4GlobalRouting.  This
  2141 allows a user to insert a route and have it redistributed like an OSPF
  2142 external LSA to the rest of the topology.
  2143 </p>
  2144 </li>
  2146 <li><b>Athstats</b>
  2147 <p>New classes AthstatsWifiTraceSink and AthstatsHelper.
  2148 </p>
  2149 </li>
  2150 <li><b>WifiRemoteStationManager </b>
  2151 <p>New trace sources exported by WifiRemoteStationManager: MacTxRtsFailed, MacTxDataFailed, MacTxFinalRtsFailed and MacTxFinalDataFailed.
  2152 </p>
  2153 </li>
  2155 <li><b> IPv6 additions</b>
  2156 <p> Add an IPv6 protocol and ICMPv6 capability.
  2157 <ul>
  2158 <li> new classes Ipv6, Ipv6Interface, Ipv6L3Protocol, Ipv6L4Protocol
  2159 <li> Ipv6RawSocket (no UDP or TCP capability yet)
  2160 <li> a set of classes to implement Icmpv6, including neighbor discovery,
  2161 router solicitation, DAD
  2162 <li> new applications Ping6 and Radvd
  2163 <li> routing objects Ipv6Route and Ipv6MulticastRoute
  2164 <li> routing protocols Ipv6ListRouting and Ipv6StaticRouting
  2165 <li> examples:,,,,
  2166 </ul>
  2167 </p>
  2168 </li> 
  2170 <li><b>Wireless Mesh Networking models</b>
  2171 <ul>
  2172 <p>
  2173 <li> General multi-interface mesh stack infrastructure (devices/mesh module).
  2174 <li> IEEE 802.11s (Draft 3.0) model including Peering Management Protocol and HWMP.
  2175 <li> Forwarding Layer for Meshing (FLAME) protocol.
  2176 </ul>
  2177 </p>
  2178 </li>
  2180 <li><b>802.11 enhancements</b>
  2181 <p>
  2182 <ul>
  2183 <li> 10MHz and 5MHz channel width supported by 802.11a model (Ramon Bauza and Kirill Andreev).
  2184 </ul>
  2185 <ul>
  2186 <li> Channel switching support. YansWifiPhy can now switch among different channels (Ramon Bauza and Pavel Boyko).
  2187 </ul>
  2188 </p>
  2189 </li>
  2191 <li><b> Nix-vector Routing</b>
  2192 <p> Add nix-vector routing protocol
  2193 <ul>
  2194 <li> new helper class Ipv4NixVectorHelper
  2195 </ul>
  2196 <ul>
  2197 <li> examples:,
  2198 </ul> 
  2199 </p>
  2200 </li>
  2202 <li><b>New Test Framework</b>
  2203 <p> Add TestCase, TestSuite classes
  2204 <ul>
  2205 <li> examples: src/core/, src/core/, src/test/ns3tcp/
  2206 </ul> 
  2207 </p>
  2208 </li>
  2210 </ul>
  2212 <h2>Changes to existing API:</h2>
  2213 <ul>
  2214 <li><b>InterferenceHelper</b>
  2215 <p>The method InterferenceHelper::CalculateTxDuration (uint32_t size, WifiMode payloadMode, WifiPreamble preamble) has been made static, so that the frame duration depends only on the characteristics of the frame (i.e., the function parameters) and not on the particular standard which is used by the receiving PHY. This makes it now possible to correctly calculate the duration of incoming frames in scenarios in which devices using different PHY configurations coexist in the same channel (e.g., a BSS using short preamble and another BSS using long preamble). </p>
  2216 <p> The following member methods have been added to InterferenceHelper:</p>
  2217 <pre>
  2218   static WifiMode GetPlcpHeaderMode (WifiMode, WifiPreamble);
  2219   static uint32_t GetPlcpHeaderDurationMicroSeconds (WifiMode, WifiPreamble);
  2220   static uint32_t GetPlcpPreambleDurationMicroSeconds (WifiMode, WifiPreamble);
  2221   static uint32_t GetPayloadDurationMicroSeconds (size, WifiMode); </pre>
  2222 <p> The following member methods have been removed from InterferenceHelper:</p>
  2223 <pre>
  2224   void Configure80211aParameters (void);
  2225   void Configure80211bParameters (void);
  2226   void Configure80211_10MhzParameters (void);
  2227   void Configure80211_5MhzParameters (void);</pre>
  2228 </li>
  2229 <li><b>WifiMode</b>
  2230 <p>WifiMode now has a WifiPhyStandard attribute which identifies the standard the WifiMode belongs to. To properly set this attribute when creating a new WifiMode, it is now required to explicitly pass a WifiPhyStandard parameter to all WifiModeFactory::CreateXXXX() methods. The WifiPhyStandard value of an existing WifiMode can be retrieved using the new method WifiMode::GetStandard().</p>
  2231 </li>
  2232 <li><b>NetDevice</b>
  2233 <p>In order to have multiple link change callback in NetDevice (i.e. to flush ARP and IPv6 neighbor discovery caches), the following member method has been renamed:</p>
  2234 <pre>
  2235 - virtual void SetLinkChangeCallback (Callback&lt;void&gt; callback);
  2236 + virtual void AddLinkChangeCallback (Callback&lt;void&gt; callback);</pre>
  2237 Now each NetDevice subclasses have a TracedCallback&lt;&gt; object (list of callbacks) instead of Callback&lt;void&gt; ones.
  2238 </li>
  2239 </ul>
  2241 <hr>
  2242 <h1>Changes from ns-3.4 to ns-3.5</h1>
  2244 <h2>Changes to build system:</h2>
  2245 <ul>
  2246 </ul>
  2248 <h2>New API:</h2>
  2250 <ul>
  2251 <li><b>YansWifiPhyHelper supporting radiotap and prism PCAP output</b>
  2252 <p>The newly supported pcap formats can be adopted by calling the following new method of YansWifiPhyHelper:</p>
  2253 <pre>
  2254  +  void SetPcapFormat (enum PcapFormat format);
  2255 </pre>
  2256 where format is one of PCAP_FORMAT_80211_RADIOTAP, PCAP_FORMAT_80211_PRISM or  PCAP_FORMAT_80211. By default, PCAP_FORMAT_80211 is used, so the default PCAP format is the same as before.</p>
  2257 </li>
  2259 <li> <b>attributes for class Ipv4</b>
  2260 <p> class Ipv4 now contains attributes in; the first one
  2261 is called "IpForward" that will enable/disable Ipv4 forwarding.  
  2262 </li>
  2264 <li> <b>packet tags</b>
  2265 <p>class Packet now contains AddPacketTag, RemovePacketTag and PeekPacketTag 
  2266 which can be used to attach a tag to a packet, as opposed to the old 
  2267 AddTag method which attached a tag to a set of bytes. The main 
  2268 semantic difference is in how these tags behave in the presence of 
  2269 fragmentation and reassembly.
  2270 </li>
  2272 </ul>
  2274 <h2>Changes to existing API:</h2>
  2275 <ul>
  2277 <li><b>Ipv4Interface::GetMtu () deleted</b>
  2278   <p>The Ipv4Interface API is private to internet-stack module; this method
  2279 was just a pass-through to GetDevice ()-&gt;GetMtu ().
  2280   </p>
  2281 </li>
  2283 <li><b>GlobalRouteManager::PopulateRoutingTables () and RecomputeRoutingTables () are deprecated </b>
  2284   <p>This API has been moved to the helper API and the above functions will
  2285 be removed in ns-3.6.  The new API is:
  2286 <pre>
  2287 Ipv4GlobalRoutingHelper::PopulateRoutingTables ();
  2288 Ipv4GlobalRoutingHelper::RecomputeRoutingTables ();
  2289 </pre>
  2290 Additionally, these low-level functions in GlobalRouteManager are now public,
  2291 allowing more API flexibility at the low level ns-3 API:
  2292 <pre>
  2293 GlobalRouteManager::DeleteGlobalRoutes ();
  2294 GlobalRouteManager::BuildGlobalRoutingDatabase ();
  2295 GlobalRouteManager::InitializeRoutes ();
  2296 </pre>
  2297   </p>
  2298 </li>
  2300 <li><b>CalcChecksum attribute changes</b>
  2301   <p>Four IPv4 CalcChecksum attributes (which enable the computation of 
  2302 checksums that are disabled by default) have been collapsed into one global 
  2303 value in class Node.  These four calls: 
  2304 <pre>
  2305 Config::SetDefault ("ns3::Ipv4L3Protocol::CalcChecksum", BooleanValue (true)); 
  2306 Config::SetDefault ("ns3::Icmpv4L4Protocol::CalcChecksum", BooleanValue (true));
  2307 Config::SetDefault ("ns3::TcpL4Protocol::CalcChecksum", BooleanValue (true));
  2308 Config::SetDefault ("ns3::UdpL4Protocol::CalcChecksum", BooleanValue (true));
  2309 </pre>
  2310 are replaced by one call to:
  2311 <pre>
  2312 GlobalValue::Bind ("ChecksumEnabled", BooleanValue (true));
  2313 </pre>
  2314   </p>
  2315 </li>
  2317 <li><b>CreateObject changes</b>
  2318   <p>CreateObject is now able to construct objects with a non-default constructor.
  2319    If you used to pass attribute lists to CreateObject, you must now use CreateObjectWithAttributes.
  2320   </p>
  2321 </li>
  2323 <li> <b>packet byte tags renaming</b>
  2324   <ul>
  2325   <li>Packet::AddTag to Packet::AddByteTag</li>
  2326   <li>Packet::FindFirstMatchingTag to Packet::FindFirstMatchingByteTag</li>
  2327   <li>Packet::RemoveAllTags to Packet::RemoveAllByteTags</li>
  2328   <li>Packet::PrintTags to Packet::PrintByteTags</li>
  2329   <li>Packet::GetTagIterator to Packet::GetByteTagIterator</li>
  2330   </ul>
  2331 </li>
  2333 <li><b>YansWifiPhyHelper::EnablePcap* methods not static any more</b>
  2334 <p>To accommodate the possibility of configuring the PCAP format used for wifi promiscuous mode traces, several methods of YansWifiPhyHelper had to be made non-static:
  2335 <pre>
  2336 -  static void EnablePcap (std::string filename, uint32_t nodeid, uint32_t deviceid);
  2337 +         void EnablePcap (std::string filename, uint32_t nodeid, uint32_t deviceid);
  2338 -  static void EnablePcap (std::string filename, Ptr&lt;NetDevice&gt; nd);
  2339 +         void EnablePcap (std::string filename, Ptr&lt;NetDevice&gt; nd);
  2340 -  static void EnablePcap (std::string filename, std::string ndName);
  2341 +         void EnablePcap (std::string filename, std::string ndName);
  2342 -  static void EnablePcap (std::string filename, NetDeviceContainer d);
  2343 +         void EnablePcap (std::string filename, NetDeviceContainer d);
  2344 -  static void EnablePcap (std::string filename, NodeContainer n);
  2345 +         void EnablePcap (std::string filename, NodeContainer n);
  2346 -  static void EnablePcapAll (std::string filename);
  2347 +         void EnablePcapAll (std::string filename);
  2348 </pre>
  2349 </p>
  2350 </li>
  2352 <li><b>Wifi Promisc Sniff interface modified </b>
  2353 <p> 
  2354 To accommodate support for the radiotap and prism headers in PCAP traces, the interface for promiscuos mode sniff in the wifi device was changed. The new implementation was heavily inspired by the way the madwifi driver handles monitor mode. A distinction between TX and RX events is introduced, to account for the fact that different information is to be put in the radiotap/prism header (e.g., RSSI and noise make sense only for RX packets). The following are the relevant modifications to the WifiPhy class:
  2355 <pre>
  2356 -  void NotifyPromiscSniff (Ptr&lt;const Packet&gt; packet);
  2357 +  void NotifyPromiscSniffRx (Ptr&lt;const Packet&gt; packet, uint16_t channelFreqMhz, uint32_t rate, bool isShortPreamble, double signalDbm, double noiseDbm);
  2358 +  void NotifyPromiscSniffTx (Ptr&lt;const Packet&gt; packet, uint16_t channelFreqMhz, uint32_t rate, bool isShortPreamble);
  2359 -  TracedCallback&lt;Ptr&lt;const Packet&gt; &gt; m_phyPromiscSnifferTrace;
  2360 +  TracedCallback&lt;Ptr&lt;const Packet&gt;, uint16_t, uint32_t, bool, double, double&gt; m_phyPromiscSniffRxTrace;
  2361 +  TracedCallback&lt;Ptr&lt;const Packet&gt;, uint16_t, uint32_t, bool&gt; m_phyPromiscSniffTxTrace;
  2362 </pre>
  2363 The above mentioned callbacks are expected to be used to call the following method to write Wifi PCAP traces in promiscuous mode:
  2364 <pre>
  2365 +  void WriteWifiMonitorPacket(Ptr&lt;const Packet&gt; packet, uint16_t channelFreqMhz, uint32_t rate, bool isShortPreamble, bool isTx, double signalDbm, double noiseDbm);
  2366 </pre>
  2367 In the above method, the isTx parameter is to be used to differentiate between TX and RX packets. For an example of how to implement these callbacks, see the implementation of PcapSniffTxEvent and PcapSniffRxEvent in src/helper/
  2368 </p>
  2369 </li>
  2371 <li><b> Routing decoupled from class Ipv4</b>
  2372 <p> All calls of the form "Ipv4::AddHostRouteTo ()" etc. (i.e. to 
  2373 add static routes, both unicast and multicast) have been moved to a new 
  2374 class Ipv4StaticRouting.  In addition, class Ipv4 now holds only
  2375 one possible routing protocol; the previous way to add routing protocols
  2376 (by ordered list of priority) has been moved to a new class Ipv4ListRouting.
  2377 Class Ipv4 has a new minimal routing API (just to set and get the routing
  2378 protocol):
  2379 <pre>
  2380 -  virtual void AddRoutingProtocol (Ptr&lt;Ipv4RoutingProtocol&gt; routingProtocol, int16_t priority) = 0;
  2381 +  virtual void SetRoutingProtocol (Ptr&lt;Ipv4RoutingProtocol&gt; routingProtocol) = 0;
  2382 +  virtual Ptr&lt;Ipv4RoutingProtocol&gt; GetRoutingProtocol (void) const = 0;
  2383 </pre>
  2384 </li>
  2386 <li><b> class Ipv4RoutingProtocol is refactored</b>
  2387 <p> The abstract base class Ipv4RoutingProtocol has been refactored to
  2388 align with corresponding Linux Ipv4 routing architecture, and has been
  2389 moved from ipv4.h to a new file ipv4-routing-protocol.h.  The new
  2390 methods (RouteOutput () and RouteInput ()) are aligned with Linux 
  2391 ip_route_output() and ip_route_input().  However,
  2392 the general nature of these calls (synchronous routing lookup for
  2393 locally originated packets, and an asynchronous, callback-based lookup
  2394 for forwarded packets) is still the same.
  2395 <pre>
  2396 -  typedef Callback&lt;void, bool, const Ipv4Route&amp;, Ptr&lt;Packet&gt;, const Ipv4Header&amp;&gt; RouteReplyCallback;
  2397 +  typedef Callback&lt;void, Ptr&lt;Ipv4Route&gt;, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;&gt; UnicastForwardCallback;
  2398 +  typedef Callback&lt;void, Ptr&lt;Ipv4MulticastRoute&gt;, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;&gt; MulticastForwardCallback;
  2399 +  typedef Callback&lt;void, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;, uint32_t &gt; LocalDeliverCallback;
  2400 +  typedef Callback&lt;void, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;&gt; ErrorCallback;
  2401 -  virtual bool RequestInterface (Ipv4Address destination, uint32_t&amp; interface) = 0;
  2402 +  virtual Ptr&lt;Ipv4Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv4Header &amp;header, uint32_t oif, Socket::SocketErrno &amp;errno) = 0;
  2403 -  virtual bool RequestRoute (uint32_t interface,
  2404 -                            const Ipv4Header &amp;ipHeader,
  2405 -                            Ptr&lt;Packet&gt; packet,
  2406 -                            RouteReplyCallback routeReply) = 0;
  2407 +  virtual bool RouteInput  (Ptr&lt;const Packet&gt; p, const Ipv4Header &amp;header, Ptr&lt;const NetDevice&gt; idev,
  2408 +                             UnicastForwardCallback ucb, MulticastForwardCallback mcb,
  2409 +                             LocalDeliverCallback lcb, ErrorCallback ecb) = 0;
  2410 </pre>
  2412 </li>
  2413 <li><b> previous class Ipv4Route, Ipv4MulticastRoute renamed; new classes with
  2414 those same names added</b>
  2415 <p> The previous class Ipv4Route and Ipv4MulticastRoute are used by 
  2416 Ipv4StaticRouting and Ipv4GlobalRouting to record internal routing table
  2417 entries, so they were renamed to class Ipv4RoutingTableEntry and
  2418 Ipv4MulticastRoutingTableEntry, respectively.  In their place, new
  2419 class Ipv4Route and class Ipv4MulticastRoute have been added.  These
  2420 are reference-counted objects that are analogous to Linux struct
  2421 rtable and struct mfc_cache, respectively, to achieve better compatibility
  2422 with Linux routing architecture in the future.  
  2424 <li><b> class Ipv4 address-to-interface mapping functions changed</b>
  2425 <p>  There was some general cleanup of functions that involve mappings
  2426 from Ipv4Address to either NetDevice or Ipv4 interface index.  
  2427 <pre>
  2428 -  virtual uint32_t FindInterfaceForAddr (Ipv4Address addr) const = 0;
  2429 -  virtual uint32_t FindInterfaceForAddr (Ipv4Address addr, Ipv4Mask mask) const = 0;
  2430 +  virtual int32_t GetInterfaceForAddress (Ipv4Address address) const = 0;
  2431 +  virtual int32_t GetInterfaceForPrefix (Ipv4Address address, Ipv4Mask mask) const = 0;
  2432 -  virtual int32_t FindInterfaceForDevice(Ptr&lt;NetDevice&gt; nd) const = 0;
  2433 +  virtual int32_t GetInterfaceForDevice (Ptr&lt;const NetDevice&gt; device) const = 0;
  2434 -  virtual Ipv4Address GetSourceAddress (Ipv4Address destination) const = 0;
  2435 -  virtual bool GetInterfaceForDestination (Ipv4Address dest,
  2436 -  virtual uint32_t GetInterfaceByAddress (Ipv4Address addr, Ipv4Mask mask = Ipv4Mask(""));
  2437 </pre>
  2439 <li><b> class Ipv4 multicast join API deleted</b>
  2440 <p> The following methods are not really used in present form since IGMP
  2441 is not being generated, so they have been removed (planned to be replaced
  2442 by multicast socket-based calls in the future):
  2444 <pre>
  2445 - virtual void JoinMulticastGroup (Ipv4Address origin, Ipv4Address group) = 0;
  2446 - virtual void LeaveMulticastGroup (Ipv4Address origin, Ipv4Address group) = 0;
  2447 </pre>
  2450 <li><b>Deconflict NetDevice::ifIndex and Ipv4::ifIndex (bug 85).</b>
  2451 <p>All function parameters named "ifIndex" that refer 
  2452 to an Ipv4 interface are instead named "interface".
  2453 <pre>
  2454 - static const uint32_t Ipv4RoutingProtocol::IF_INDEX_ANY = 0xffffffff;
  2455 + static const uint32_t Ipv4RoutingProtocol::INTERFACE_ANY = 0xffffffff;
  2457 - bool Ipv4RoutingProtocol::RequestIfIndex (Ipv4Address destination, uint32_t&amp; ifIndex);
  2458 + bool Ipv4RoutingProtocol::RequestInterface (Ipv4Address destination, uint32_t&amp; interface);
  2459 (N.B. this particular function is planned to be renamed to RouteOutput() in the
  2460 proposed IPv4 routing refactoring)
  2462 - uint32_t Ipv4::GetIfIndexByAddress (Ipv4Address addr, Ipv4Mask mask);
  2463 + int_32t Ipv4::GetInterfaceForAddress (Ipv4Address address, Ipv4Mask mask) const;
  2465 - bool Ipv4::GetIfIndexForDestination (Ipv4Address dest, uint32_t &amp;ifIndex) const;
  2466 + bool Ipv4::GetInterfaceForDestination (Ipv4Address dest, uint32_t &amp;interface) const;
  2467 (N.B. this function is not needed in the proposed Ipv4 routing refactoring)
  2468 </pre>
  2471 <li><b>Allow multiple IPv4 addresses to be assigned to an interface (bug 188)</b>
  2472   <ul>
  2473   <li> Add class Ipv4InterfaceAddress:  
  2474   This is a new class to resemble Linux's struct in_ifaddr.  It holds IP addressing information, including mask,
  2475   broadcast address, scope, whether primary or secondary, etc.
  2476   <pre>
  2477 +  virtual uint32_t AddAddress (uint32_t interface, Ipv4InterfaceAddress address) = 0;
  2478 +  virtual Ipv4InterfaceAddress GetAddress (uint32_t interface, uint32_t addressIndex) const = 0;
  2479 +  virtual uint32_t GetNAddresses (uint32_t interface) const = 0;
  2480   </pre>
  2481   <li>Regarding legacy API usage, typically where you once did the following,
  2482   using the public Ipv4 class interface (e.g.):
  2483   <pre>
  2484   ipv4A-&gt;SetAddress (ifIndexA, Ipv4Address (""));
  2485   ipv4A-&gt;SetNetworkMask (ifIndexA, Ipv4Mask (""));
  2486   </pre>
  2487   you now do:
  2488   <pre>
  2489   Ipv4InterfaceAddress ipv4IfAddrA = Ipv4InterfaceAddress (Ipv4Address (""), Ipv4Mask (""));
  2490   ipv4A-&gt;AddAddress (ifIndexA, ipv4IfAddrA);
  2491   </pre>
  2492   <li> At the helper API level, one often gets an address from an interface
  2493   container.  We preserve the legacy GetAddress (uint32_t i) but it
  2494   is documented that this will return only the first (address index 0)
  2495   address on the interface, if there are multiple such addresses. 
  2496   We provide also an overloaded variant for the multi-address case: 
  2498   <pre>
  2499 Ipv4Address Ipv4InterfaceContainer::GetAddress (uint32_t i)
  2500 + Ipv4Address Ipv4InterfaceContainer::GetAddress (uint32_t i, uint32_t j)
  2501   </pre>
  2503   </ul>
  2505 <li><b>New WifiMacHelper objects</b>
  2506 <p>The type of wifi MAC is now set by two new specific helpers, NqosWifiMacHelper for non QoS MACs and QosWifiMacHelper for Qos MACs. They are passed as argument to WifiHelper::Install methods.</li>
  2507   <pre>
  2508 - void WifiHelper::SetMac (std::string type, std::string n0 = "", const AttributeValue &amp;v0 = EmptyAttributeValue (),...)
  2510 - NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phyHelper, NodeContainer c) const
  2511 + NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phyHelper, const WifiMacHelper &amp;macHelper, NodeContainer c) const
  2513 - NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, Ptr&lt;Node&gt; node) const
  2514 + NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, const WifiMacHelper &amp;mac, Ptr&lt;Node&gt; node) const
  2516 - NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, std::string nodeName) const
  2517 + NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, const WifiMacHelper &amp;mac, std::string nodeName) const
  2518   </pre>
  2519   See src/helper/nqos-wifi-mac-helper.h and src/helper/qos-wifi-mac-helper.h for more details.
  2520   </p>
  2522 <li><b>Remove Mac48Address::IsMulticast</b>
  2523   <p>This method was considered buggy and unsafe to call. Its replacement is Mac48Address::IsGroup.
  2524   </li>
  2526 </ul>
  2528 <h2>Changed behavior:</h2>
  2529 <ul>
  2530 </ul>
  2532 <hr>
  2533 <h1>Changes from ns-3.3 to ns-3.4</h1>
  2535 <h2>Changes to build system:</h2>
  2536 <ul>
  2537 <li>A major option regarding the downloading and building of ns-3 has been
  2538 added for ns-3.4 -- the ns-3-allinone feature.  This allows a user to
  2539 get the most common options for ns-3 downloaded and built with a minimum
  2540 amount of trouble.  See the ns-3 tutorial for a detailed explanation of
  2541 how to use this new feature.</li>
  2543 <li>The build system now runs build items in parallel by default.  This includes
  2544 the regression tests.</li>
  2545 </ul>
  2547 <h2>New API:</h2>
  2548 <ul>
  2549 <li>XML support has been added to the ConfigStore in src/contrib/</li>
  2551 <li>The ns-2 calendar queue scheduler option has been ported to src/simulator</li>
  2553 <li>A ThreeLogDistancePropagationLossModel has been added to src/devices/wifi</li>
  2555 <li>ConstantAccelerationMobilityModel in src/mobility/constant-acceleration-mobility-model.h</li>
  2557 <li>A new emulation mode is supported with the TapBridge net device (see
  2558 src/devices/tap-bridge)</li>
  2560 <li>A new facility for naming ns-3 Objects is included (see
  2561 src/core/names.{cc,h})</li>
  2563 <li>Wifi multicast support has been added in src/devices/wifi</li>
  2564 </ul>
  2566 <h2>Changes to existing API:</h2>
  2568 <ul>
  2569 <li>Some fairly significant changes have been made to the API of the
  2570 random variable code.  Please see the ns-3 manual and src/core/
  2571 for details.</li>
  2573 <li>The trace sources in the various NetDevice classes has been completely
  2574 reworked to allow for a consistent set of trace sources across the
  2575 devices.  The names of the trace sources have been changed to provide
  2576 some context with respect to the level at which the trace occurred.
  2577 A new set of trace sources has been added which emulates the behavior
  2578 of packet sniffers.  These sources have been used to implement tcpdump-
  2579 like functionality and are plumbed up into the helper classes.  The 
  2580 user-visible changes are the trace source name changes and the ability
  2581 to do promiscuous-mode pcap tracing via helpers.  For further information
  2582 regarding these changes, please see the ns-3 manual</li>
  2584 <li>StaticMobilityModel has been renamed ConstantPositionMobilityModel
  2585 StaticSpeedMobilityModel has been renamed ConstantVelocityMobilityModel</li>
  2587 <li>The Callback templates have been extended to support more parameters.
  2588 See src/core/callback.h</li>
  2590 <li>Many helper API have been changed to allow passing Object-based parameters
  2591 as string names to ease working with the object name service.</li>
  2593 <li>The Config APIs now accept path segments that are names defined by the
  2594 object name service.</li>
  2596 <li>Minor changes were made to make the system build under the Intel C++ compiler.</li>
  2598 <li>Trace hooks for association and deassociation to/from an access point were
  2599 added to src/devices/wifi/</li>
  2600 </ul>
  2602 <h2>Changed behavior:</h2>
  2604 <ul>
  2605 <li>The tracing system rework has introduced some significant changes in the
  2606 behavior of some trace sources, specifically in the positioning of trace sources
  2607 in the device code.  For example, there were cases where the packet transmit 
  2608 trace source was hit before the packet was enqueued on the device transmit quueue.
  2609 This now happens just before the packet is transmitted over the channel medium.
  2610 The scope of the changes is too large to be included here.  If you have concerns
  2611 regarding trace semantics, please consult the net device documentation for details.
  2612 As is usual, the ultimate source for documentation is the net device source code.</li>
  2613 </ul>
  2615 <hr>
  2616 <h1>Changes from ns-3.2 to ns-3.3</h1>
  2618 <h2>New API:</h2>
  2619 <ul>
  2620 <li>
  2621 ns-3 ABORT macros in src/core/abort.h
  2622 Config::MatchContainer
  2623 ConstCast and DynamicCast helper functions for Ptr casting
  2624 StarTopology added to several topology helpers
  2625 NetDevice::IsBridge () 
  2626 </li>
  2628 <li>17-11-2008; changeset 
  2629 <a href="">4c1c3f6bcd03</a></li>
  2630 <ul>
  2631 <li>
  2632 The PppHeader previously defined in the point-to-point-net-device code has been 
  2633 made public.
  2634 </li>
  2635 </ul>
  2637 <li>17-11-2008; changeset 
  2638 <a href="">16c2970a0344</a></li>
  2639 <ul>
  2640 <li>
  2641 An emulated net device has been added as enabling technology for ns-3 emulation
  2642 scenarios.  See src/devices/emu and examples/ for details.
  2643 </li>
  2644 </ul>
  2646 <li>17-11-2008; changeset 
  2647 <a href="">4222173d1e6d</a></li>
  2648 <ul>
  2649 <li>
  2650 Added method InternetStackHelper::EnableAsciiChange to allow allow a user to 
  2651 hook ascii trace to the drop trace events in Ipv4L3Protocol and ArpL3Protocol.
  2652 </li>
  2653 </ul>
  2655 </ul>
  2656 <h2>Changes to existing API:</h2>
  2657 <ul>
  2659 <li> NetDevice::MakeMulticastAddress() was renamed to NetDevice::GetMulticast()
  2660 and the original GetMulticast() removed </li>
  2662 <li> Socket API changes:
  2663 <ul>
  2664 <li> return type of SetDataSentCallback () changed from bool to void </li>
  2665 <li> Socket::Listen() no longer takes a queueLimit argument</li>
  2666 </ul>
  2668 <li> As part of the Wifi Phy rework, there have been several API changes
  2669 at the low level and helper API level.  </li>
  2670 <ul>
  2671 <li>  At the helper API level, the WifiHelper was split to three classes: 
  2672 a WifiHelper, a YansWifiChannel helper, and a YansWifiPhy helper.  Some
  2673 functions like Ascii and Pcap tracing functions were moved from class
  2674 WifiHelper to class YansWifiPhyHelper. 
  2675 <li>  At the low-level API, there have been a number of changes to
  2676 make the Phy more modular:</li>
  2677 <ul>
  2678 <li> composite-propagation-loss-model.h is removed</li>
  2679 <li> DcfManager::NotifyCcaBusyStartNow() has changed name</li>
  2680 <li> fragmentation related functions (e.g. DcaTxop::GetNFragments()) have
  2681 changed API to account for some implementation changes</li>
  2682 <li> Interference helper and error rate model added </li>
  2683 <li> JakesPropagationLossModel::GetLoss() moved to PropagationLoss() class</li>
  2684 <li> base class WifiChannel made abstract </li>
  2685 <li> WifiNetDevice::SetChannel() removed </li>
  2686 <li> a WifiPhyState helper class added </li>
  2687 <li> addition of the YansWifiChannel and YansWifiPhy classes </li>
  2688 </ul>
  2689 </ul>
  2691 <li>17-11-2008; changeset 
  2692 <a href="">dacfd1f07538</a></li>
  2693 <ul>
  2694 <li>
  2695 Change attribute "RxErrorModel" to "ReceiveErrorModel" in CsmaNetDevice for 
  2696 consistency between devices.
  2697 </li>
  2698 </ul>
  2700 </ul>
  2701 <h2>changed behavior:</h2>
  2702 <ul>
  2704 <li>17-11-2008; changeset 
  2705 <a href="">ed0dfce40459</a></li>
  2706 <ul>
  2707 <li>
  2708 Relax reasonableness testing in Ipv4AddressHelper::SetBase to allow the 
  2709 assignment of /32 addresses.
  2710 </li>
  2711 </ul>
  2713 <li>17-11-2008; changeset 
  2714 <a href="">756887a9bbea</a></li>
  2715 <ul>
  2716 <li>
  2717 Global routing supports bridge devices.
  2718 </li>
  2719 </ul>
  2720 </ul>
  2722 <hr>
  2723 <h1>Changes from ns-3.1 to ns-3.2</h1>
  2725 <h2>New API:</h2>
  2726 <ul>
  2728 <li>26-08-2008; changeset 
  2729 <a href="">5aa65b1ea001</a></li>
  2730 <ul>
  2731 <li>
  2732 Add multithreaded and real-time simulator implementation.  Allows for emulated
  2733 net devices running in threads other than the main simulation thread to schedule
  2734 events.  Allows for pacing the simulation clock at 1x real-time.
  2735 </li>
  2736 </ul>
  2739 <li>26-08-2008; changeset 
  2740 <a href="">c69779f5e51e</a></li>
  2741 <ul>
  2742 <li>
  2743 Add threading and synchronization primitives.  Enabling technology for 
  2744 multithreaded simulator implementation.
  2745 </li>
  2746 </ul>
  2748 </ul>
  2749 <h2>New API in existing classes:</h2>
  2750 <ul>
  2752 <li>01-08-2008; changeset 
  2753 <a href="">a18520551cdf</a></li>
  2754 <ul>
  2755 <li>class ArpCache has two new attributes:  MaxRetries 
  2756 and a Drop trace.  It also has some new public methods but these are 
  2757 mostly for internal use.
  2758 </ul>
  2759 </li>
  2761 </ul>
  2762 <h2>Changes to existing API:</h2>
  2763 <ul>
  2765 <li>05-09-2008; changeset 
  2766 <a href="">aa1fb0f43571</a></li>
  2767 <ul>
  2768 <li>
  2769 Change naming of MTU and packet size attributes in CSMA and Point-to-Point devices<br>
  2770 After much discussion it was decided that the preferred way to think about 
  2771 the different senses of transmission units and encapsulations was to call the 
  2772 MAC MTU simply MTU and to use the overall packet size as the PHY-level attribute
  2773 of interest.  See the Doxygen of CsmaNetDevice::SetFrameSize and 
  2774 PointToPointNetDevice::SetFrameSize for a detailed description.
  2775 </li>
  2776 </ul>
  2778 <li>25-08-2008; changeset 
  2779 <a href="">e5ab96db540e</a></li>
  2780 <ul>
  2781 <li>
  2782 bug 273: constify packet pointers.<br>
  2783 The normal and the promiscuous receive callbacks of the NetDevice API
  2784 have been changed from:
  2785 <pre>
  2786 Callback&lt;bool,Ptr&lt;NetDevice&gt;,Ptr&lt;Packet&gt;,uint16_t,const Address &amp;&gt;
  2787 Callback&lt;bool,Ptr&lt;NetDevice&gt;, Ptr&lt;Packet&gt;, uint16_t,
  2788          const Address &amp;, const Address &amp;, enum PacketType &gt;
  2789 </pre>
  2790 to:
  2791 <pre>
  2792 Callback&lt;bool,Ptr&lt;NetDevice&gt;,Ptr&lt;const Packet&gt;,uint16_t,const Address &amp;&gt;
  2793 Callback&lt;bool,Ptr&lt;NetDevice&gt;, Ptr&lt;const Packet&gt;, uint16_t,
  2794          const Address &amp;, const Address &amp;, enum PacketType &gt;
  2795 </pre>
  2796 to avoid the kind of bugs reported in 
  2797 <a href="">bug 273</a>.
  2798 Users who implement a subclass of the NetDevice base class need to change the signature
  2799 of their SetReceiveCallback and SetPromiscReceiveCallback methods.
  2800 </li>
  2801 </ul>
  2804 <li>04-08-2008; changeset 
  2805 <a href="">cba7b2b80fe8</a></li>
  2806 <ul>
  2807 <li>
  2808 Cleanup of MTU confusion and initialization in CsmaNetDevice<br>
  2809 The MTU of the CsmaNetDevice defaulted to 65535.  This did not correspond with
  2810 the expected MTU found in Ethernet-like devices.  Also there was not clear 
  2811 documentation regarding which MTU was being set.  There are two MTU here, one
  2812 at the MAC level and one at the PHY level.  We split out the MTU setting to make
  2813 this more clear and set the default PHY level MTU to 1500 to be more like
  2814 Ethernet.  The encapsulation mode defaults to LLC/SNAP which then puts the
  2815 MAC level MTU at 1492 by default.  We allow users to now set the encapsulation
  2816 mode, MAC MTU and PHY MTU while keeping the three values consistent.  See the
  2817 Doxygen of CsmaNetDevice::SetMaxPayloadLength for a detailed description of the
  2818 issues and solution.
  2819 </li>
  2820 </ul>
  2822 <li>21-07-2008; changeset 
  2823 <a href="
  2825 <ul>
  2826 <li> class NetDevice has added a pure virtual method that
  2827 must be implemented by all subclasses:
  2828 <pre>
  2829 virtual void SetPromiscReceiveCallback (PromiscReceiveCallback cb) = 0;
  2830 </pre>
  2831 All NetDevices must support this method, and must call this callback
  2832 when processing packets in the receive direction (the appropriate place
  2833 to call this is device-dependent).  An approach to stub this out
  2834 temporarily, if you do not care about immediately enabling this
  2835 functionality, would be to add this to your device:
  2836 <pre>
  2837 void
  2838 ExampleNetDevice::SetPromiscReceiveCallback
  2839 (NetDevice::PromiscReceiveCallback cb)
  2840 { 
  2841   NS_ASSERT_MSG (false, "No implementation yet for
  2842 SetPromiscReceiveCallback");
  2843 }
  2844 </pre>
  2845 To implement this properly, consult the CsmaNetDevice for examples of
  2846 when the m_promiscRxCallback is called.
  2847 </li>
  2848 </ul>
  2850 <li>03-07-2008; changeset 
  2851 <a href="">d5f8e5fae1c6</a></li>
  2852 <ul>
  2853 <li>
  2854 Miscellaneous cleanup of Udp Helper API, to fix bug 234
  2855 <pre>
  2856 class UdpEchoServerHelper
  2857 {
  2858 public:
  2859 - UdpEchoServerHelper ();
  2860 - void SetPort (uint16_t port); 
  2861 + UdpEchoServerHelper (uint16_t port);
  2862 + 
  2863 + void SetAttribute (std::string name, const AttributeValue &amp;value);
  2864 ApplicationContainer Install (NodeContainer c);
  2866 class UdpEchoClientHelper
  2867 {
  2868 public:
  2869 - UdpEchoClientHelper ();
  2870 + UdpEchoClientHelper (Ipv4Address ip, uint16_t port);
  2871 - void SetRemote (Ipv4Address ip, uint16_t port);
  2872 - void SetAppAttribute (std::string name, const AttributeValue &amp;value);
  2873 + void SetAttribute (std::string name, const AttributeValue &amp;value);
  2874 ApplicationContainer Install (NodeContainer c);
  2875 </pre>
  2876 </li>
  2877 </ul>
  2879 <li>03-07-2008; changeset 
  2880 <a href="
  2882 <ul>
  2883 <li>
  2884 Rename all instances method names using "Set..Parameter" to "Set..Attribute"
  2885 (bug 232)
  2886 </li>
  2887 <li> How to fix your code:  Any use of helper API that was using a method
  2888 "Set...Parameter()" should be changed to read "Set...Attribute()".  e.g.
  2889 <pre>
  2890 - csma.SetChannelParameter ("DataRate", DataRateValue (5000000));
  2891 - csma.SetChannelParameter ("Delay", TimeValue (MilliSeconds (2)));
  2892 + csma.SetChannelAttribute ("DataRate", DataRateValue (5000000));
  2893 + csma.SetChannelAttribute ("Delay", TimeValue (MilliSeconds (2)));
  2894 </pre>
  2895 </li>
  2896 </ul>
  2897 </li>
  2899 </ul>
  2900 <h2>Changed behavior:</h2>
  2901 <ul>
  2903 <li>07-09-2008; changeset 
  2904 <a href="">5d836ab1523b</a></li>
  2905 <ul>
  2907 <li>
  2908 Implement a finite receive buffer for TCP<br>
  2909 The native TCP model in TcpSocketImpl did not support a finite receive buffer.
  2910 This changeset adds the following functionality in this regard:
  2911 <ul>
  2912 <li>
  2913 Being able to set the receiver buffer size through the attributes system.
  2914 </li>
  2915 <li>
  2916 This receiver buffer size is now correctly exported in the TCP header as the
  2917 advertised window.  Prior to this changeset, the TCP header advertised window
  2918 was set to the maximum size of 2^16 bytes.
  2919 window
  2920 </li>
  2921 <li>
  2922 The aforementioned window size is correctly used for flow control, i.e. the
  2923 sending TCP will not send more data than available space in the receiver's
  2924 buffer.
  2925 </li>
  2926 <li>
  2927 In the case of a receiver window collapse, when a advertised zero-window
  2928 packet is received, the sender enters the persist probing state in which
  2929 it sends probe packets with one payload byte at exponentially backed-off
  2930 intervals up to 60s.  The receiver will continue to send advertised 
  2931 zero-window ACKs of the old data so long as the receiver buffer remains full.
  2932 When the receiver window clears up due to an application read, the TCP
  2933 will finally ACK the probe byte, and update its advertised window appropriately.
  2934 </li>
  2935 </ul>
  2936 See 
  2937 <a href=""> bug 239 </a> for
  2938 more.
  2939 </li>
  2940 </ul>
  2942 <li>07-09-2008; changeset 
  2943 <a href="">7afa66c2b291</a></li>
  2944 <ul>
  2945 <li>
  2946 Add correct FIN exchange behavior during TCP closedown<br>
  2947 The behavior of the native TcpSocketImpl TCP model was such that the final
  2948 FIN exchange was not correct, i.e. calling Socket::Close didn't send a FIN
  2949 packet, and even if it had, the ACK never came back, and even if it had, the
  2950 ACK would have incorrect sequence number.  All these various problems have been
  2951 addressed by this changeset.  See 
  2952 <a href=""> bug 242 </a> for
  2953 more.
  2954 </li>
  2955 </ul>
  2957 <li> 28-07-2008; changeset 
  2958 <a href="">6f68f1044df1</a>
  2959 <ul>
  2960 <li>
  2961 OLSR: HELLO messages hold time changed to 3*hello
  2962 interval from hello interval.  This is an important bug fix as
  2963 hold time == refresh time was never intentional, as it leads to
  2964 instability in neighbor detection.
  2965 </ul>
  2966 </li>
  2968 </ul>
  2970 </body>
  2971 </html>