CHANGES.html
changeset 4305 9ec113d84cc8
parent 4301 f1c83e54e541
child 4385 1114152c44dd
equal deleted inserted replaced
4304:9da5383b0c87 4305:9ec113d84cc8
    42 the cracks, unfortunately.  If you, as a user, can suggest improvements
    42 the cracks, unfortunately.  If you, as a user, can suggest improvements
    43 to this file based on your experience, please contribute a patch or drop
    43 to this file based on your experience, please contribute a patch or drop
    44 us a note on ns-developers mailing list.  </p>
    44 us a note on ns-developers mailing list.  </p>
    45 
    45 
    46 <hr>
    46 <hr>
    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>
       
    64 <ul>
    62 <ul>
    65 <li>XML support has been added to the ConfigStore in /src/contrib/config-store.cc</li>
    63 <li>XML support has been added to the ConfigStore in /src/contrib/config-store.cc</li>
    66 </ul>
    64 
    67 
       
    68 <ul>
       
    69 <li>The ns-2 calendar queue scheduler option has been ported to src/simulator</li>
    65 <li>The ns-2 calendar queue scheduler option has been ported to src/simulator</li>
    70 </ul>
    66 
    71 
       
    72 <ul>
       
    73 <li>A ThreeLogDistancePropagationLossModel has been added to src/devices/wifi</li>
    67 <li>A ThreeLogDistancePropagationLossModel has been added to src/devices/wifi</li>
    74 </ul>
    68 
    75 
       
    76 <ul>
       
    77 <li>ConstantAccelerationMobilityModel in src/mobility/constant-acceleration-mobility-model.h</li>
    69 <li>ConstantAccelerationMobilityModel in src/mobility/constant-acceleration-mobility-model.h</li>
    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>
       
    91 <li>Wifi multicast support has been added in src/devices/wifi</li>
    77 <li>Wifi multicast support has been added in src/devices/wifi</li>
    92 </ul>
    78 </ul>
    93 
    79 
    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>
       
   136 <li>Minor changes were made to make the system build under the Intel C++ compiler.</li>
   110 <li>Minor changes were made to make the system build under the Intel C++ compiler.</li>
   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>
   142 </ul>
   127 </ul>
   143 
   128 
   144 <hr>
   129 <hr>
   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>
   154 
   141 
   155 <li>17-11-2008; changeset 
   142 <li>17-11-2008; changeset 
   156 <a href="http://code.nsnam.org/ns-3-dev/rev/4c1c3f6bcd03">4c1c3f6bcd03</a></li>
   143 <a href="http://code.nsnam.org/ns-3-dev/rev/4c1c3f6bcd03">4c1c3f6bcd03</a></li>
   157 <ul>
   144 <ul>
   158 <li>
   145 <li>
   178 hook ascii trace to the drop trace events in Ipv4L3Protocol and ArpL3Protocol.
   165 hook ascii trace to the drop trace events in Ipv4L3Protocol and ArpL3Protocol.
   179 </li>
   166 </li>
   180 </ul>
   167 </ul>
   181 
   168 
   182 </ul>
   169 </ul>
   183 <h2>changes to existing API:</h2>
   170 <h2>Changes to existing API:</h2>
   184 <ul>
   171 <ul>
   185 
   172 
   186 <li> NetDevice::MakeMulticastAddress() was renamed to NetDevice::GetMulticast()
   173 <li> NetDevice::MakeMulticastAddress() was renamed to NetDevice::GetMulticast()
   187 and the original GetMulticast() removed </li>
   174 and the original GetMulticast() removed </li>
   188 
   175 
   245 </li>
   232 </li>
   246 </ul>
   233 </ul>
   247 </ul>
   234 </ul>
   248 
   235 
   249 <hr>
   236 <hr>
   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>
   253 <ul>
   240 <ul>
   254 
   241 
   255 <li>26-08-2008; changeset 
   242 <li>26-08-2008; changeset 
   256 <a href="http://code.nsnam.org/ns-3-dev/rev/5aa65b1ea001">5aa65b1ea001</a></li>
   243 <a href="http://code.nsnam.org/ns-3-dev/rev/5aa65b1ea001">5aa65b1ea001</a></li>
   257 <ul>
   244 <ul>
   271 multithreaded simulator implementation.
   258 multithreaded simulator implementation.
   272 </li>
   259 </li>
   273 </ul>
   260 </ul>
   274 
   261 
   275 </ul>
   262 </ul>
   276 <h2>new API in existing classes:</h2>
   263 <h2>New API in existing classes:</h2>
   277 <ul>
   264 <ul>
   278 
   265 
   279 <li>01-08-2008; changeset 
   266 <li>01-08-2008; changeset 
   280 <a href="http://code.nsnam.org/ns-3-dev/rev/a18520551cdf">a18520551cdf</a></li>
   267 <a href="http://code.nsnam.org/ns-3-dev/rev/a18520551cdf">a18520551cdf</a></li>
   281 <ul>
   268 <ul>
   284 mostly for internal use.
   271 mostly for internal use.
   285 </ul>
   272 </ul>
   286 </li>
   273 </li>
   287 
   274 
   288 </ul>
   275 </ul>
   289 <h2>changes to existing API:</h2>
   276 <h2>Changes to existing API:</h2>
   290 <ul>
   277 <ul>
   291 
   278 
   292 <li>05-09-2008; changeset 
   279 <li>05-09-2008; changeset 
   293 <a href="http://code.nsnam.org/ns-3-dev/rev/aa1fb0f43571">aa1fb0f43571</a></li>
   280 <a href="http://code.nsnam.org/ns-3-dev/rev/aa1fb0f43571">aa1fb0f43571</a></li>
   294 <ul>
   281 <ul>
   422 </li>
   409 </li>
   423 </ul>
   410 </ul>
   424 </li>
   411 </li>
   425 
   412 
   426 </ul>
   413 </ul>
   427 <h2>changed behavior:</h2>
   414 <h2>Changed behavior:</h2>
   428 <ul>
   415 <ul>
   429 
   416 
   430 <li>07-09-2008; changeset 
   417 <li>07-09-2008; changeset 
   431 <a href="http://code.nsnam.org/ns-3-dev/rev/5d836ab1523b">5d836ab1523b</a></li>
   418 <a href="http://code.nsnam.org/ns-3-dev/rev/5d836ab1523b">5d836ab1523b</a></li>
   432 <ul>
   419 <ul>