47 <h1>changes from ns-3.3 to ns-3.4</h1>

    47 <h1>Changes from ns-3.3 to ns-3.4</h1>

    48 

    48 

    49 <h2>changes to build system</h2>

    49 <h2>Changes to build system</h2>

    50 <ul>

    50 <ul>

    51 <li>A major option regarding the downloading and building of ns-3 has been</li>

    51 <li>A major option regarding the downloading and building of ns-3 has been

    52 <li>added for ns-3.4 -- the ns-3-allinone feature.  This allows a user to</li>

    52 added for ns-3.4 -- the ns-3-allinone feature.  This allows a user to

    53 <li>get the most common options for ns-3 downloaded and built with a minimum</li>

    53 get the most common options for ns-3 downloaded and built with a minimum

    54 <li>amount of trouble.  See the ns-3 tutorial for a detailed explanation of<li>

    54 amount of trouble.  See the ns-3 tutorial for a detailed explanation of

    55 <li>how to use this new feature.</li>

    55 how to use this new feature.</li>

    56 </ul>

    56 

    57 

    57 <li>The build system now runs build items in parallel by default.  This includes

    58 <ul>

    58 the regression tests.</li>

    59 <li>The build system now runs build items in parallel by default.  This</li>

    59 </ul>

    60 <li>includes the regression tests.<li>

    60 

    61 </ul>

    61 <h2>New API:</h2>

    62 

    63 <h2>new API:</h2>

    66 </ul>

    64 

    67 

    68 <ul>

    70 </ul>

    66 

    71 

    72 <ul>

    74 </ul>

    68 

    75 

    76 <ul>

    78 </ul>

    70 

    79 

    71 <li>A new emulation mode is supported with the TapBridge net device (see

    80 <ul>

    72 src/devices/tap-bridge)</li>

    81 <li>A new emulation mode is supported with the TapBridge net device (see</li>

    73 

    82 <li>src/devices/tap-bridge)</li>

    74 <li>A new facility for naming ns-3 Objects is included (see

    83 </ul>

    75 src/core/names.{cc,h})</li>

    84 

    76 

    85 <ul>

    86 <li>A new facility for naming ns-3 Objects is included (see</li>

    87 <li>src/core/names.{cc,h})</li>

    88 </ul>

    89 

    90 <ul>

    94 <h2>changes to existing API:</h2>

    80 <h2>Changes to existing API:</h2>

    95 

    81 

    96 <ul>

    82 <ul>

    97 <li>Some fairly significant changes have been made to the API of the</li>

    83 <li>Some fairly significant changes have been made to the API of the

    98 <li>random variable code.  Please see the ns-3 manual and src/core/random-variable.cc</li>

    84 random variable code.  Please see the ns-3 manual and src/core/random-variable.cc

    99 <li>for details.</li>

    85 for details.</li>

   100 </ul>

    86 

   101 

    87 <li>The trace sources in the various NetDevice classes has been completely

   102 <ul>

    88 reworked to allow for a consistent set of trace sources across the

   103 <li>The trace sources in the various NetDevice classes has been completely</li>

    89 devices.  The names of the trace sources have been changed to provide

   104 <li>reworked to allow for a consistent set of trace sources across the</li>

    90 some context with respect to the level at which the trace occurred.

   105 <li>devices.  The names of the trace sources have been changed to provide</li>

    91 A new set of trace sources has been added which emulates the behavior

   106 <li>some context with respect to the level at which the trace occurred.</li>

    92 of packet sniffers.  These sources have been used to implement tcpdump-

   107 <li>A new set of trace sources has been added which emulates the behavior</li>

    93 like functionality and are plumbed up into the helper classes.  The 

   108 <li>of packet sniffers.  These sources have been used to implement tcpdump-</li>

    94 user-visible changes are the trace source name changes and the ability

   109 <li>like functionality and are plumbed up into the helper classes.  The </li>

    95 to do promiscuous-mode pcap tracing via helpers.  For further information

   110 <li>user-visible changes are the trace source name changes and the ability </li>

    96 regarding these changes, please see the ns-3 manual</li>

   111 <li>to do promiscuous-mode pcap tracing via helpers.  For further information</li>

    97 

   112 <li>regarding these changes, please see the ns-3 manual</li>

    98 <li>StaticMobilityModel has been renamed ConstantPositionMobilityModel

   113 </ul>

    99 StaticSpeedMobilityModel has been renamed ConstantVelocityMobilityModel</li>

   114 

   100 

   115 <ul>

   101 <li>The Callback templates have been extended to support more parameters.

   116 <li>StaticMobilityModel has been renamed ConstantPositionMobilityModel</li>

   102 See src/core/callback.h</li>

   117 <li>StaticSpeedMobilityModel has been renamed ConstantVelocityMobilityModel</li>

   103 

   118 </ul>

   104 <li>Many helper API have been changed to allow passing Object-based parameters

   119 

   105 as string names to ease working with the object name service.</li>

   120 <ul>

   106 

   121 <li>The Callback templates have been extended to support more parameters.</li>

   107 <li>The Config APIs now accept path segments that are names defined by the

   122 <li>See src/core/callback.h</li>

   108 object name service.</li>

   123 </ul>

   109 

   124 

   125 <ul>

   126 <li>Many helper API have been changed to allow passing Object-based parameters</li>

   127 <li>as string names to ease working with the object name service.</li>

   128 </ul>

   129 

   130 <ul>

   131 <li>The Config APIs now accept path segments that are names defined by the </li>

   132 <li>object name service.</li>

   133 </ul>

   134 

   135 <ul>

   137 </ul>

   111 

   138 

   112 <li>Trace hooks for association and deassociation to/from an access point were

   139 <ul>

   113 added to src/devices/wifi/nqsta-wifi-mac.cc</li>

   140 <li>Trace hooks for association and deassociation to/from an access point were</li>

   114 </ul>

   141 <li>added to src/devices/wifi/nqsta-wifi-mac.cc</li>

   115 

   116 <h2>Changed behavior:</h2>

   117 

   118 <ul>

   119 <li>The tracing system rework has introduced some significant changes in the

   120 behavior of some trace sources, specifically in the positioning of trace sources

   121 in the device code.  For example, there were cases where the packet transmit 

   122 trace source was hit before the packet was enqueued on the device transmit quueue.

   123 This now happens just before the packet is transmitted over the channel medium.

   124 The scope of the changes is too large to be included here.  If you have concerns

   125 regarding trace semantics, please consult the net device documentation for details.

   126 As is usual, the ultimate source for documentation is the net device source code.</li>

   145 <h1>changes from ns-3.2 to ns-3.3</h1>

   130 <h1>Changes from ns-3.2 to ns-3.3</h1>

   146 

   131 

   147 <h2>new API:</h2>

   132 <h2>New API:</h2>

   148 <ul>

   133 <ul>

   149 <li> ns-3 ABORT macros in src/core/abort.h</li>

   134 <li>

   150 <li> Config::MatchContainer </li>

   135 ns-3 ABORT macros in src/core/abort.h

   151 <li> ConstCast and DynamicCast helper functions for Ptr casting</li>

   136 Config::MatchContainer

   152 <li> StarTopology added to several topology helpers </li>

   137 ConstCast and DynamicCast helper functions for Ptr casting

   153 <li> NetDevice::IsBridge () </li>

   138 StarTopology added to several topology helpers

   139 NetDevice::IsBridge () 

   140 </li>

   183 <h2>changes to existing API:</h2>

   170 <h2>Changes to existing API:</h2>

   250 <h1>changes from ns-3.1 to ns-3.2</h1>

   237 <h1>Changes from ns-3.1 to ns-3.2</h1>

   251 

   238 

   252 <h2>new API:</h2>

   239 <h2>New API:</h2>

   276 <h2>new API in existing classes:</h2>

   263 <h2>New API in existing classes:</h2>

   289 <h2>changes to existing API:</h2>

   276 <h2>Changes to existing API:</h2>

   427 <h2>changed behavior:</h2>

   414 <h2>Changed behavior:</h2>