RELEASE_NOTES
author Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
Sat, 04 Jul 2009 08:15:48 +0200
changeset 4654 2eaebe77d66b
parent 4636 527e807151ae
permissions -rw-r--r--
Added tag ns-3.5 for changeset c975274c9707
     1 
     2 		ns-3 RELEASE NOTES
     3 
     4 This file contains ns-3 release notes (most recent releases first).
     5 
     6 All of the ns-3 documentation is accessible from the ns-3 website: 
     7 http://www.nsnam.org including tutorials: http://www.nsnam.org/tutorials.html
     8 
     9 Release 3.5
    10 ===========
    11 
    12 Availability
    13 ------------
    14 This release is immediately available from:
    15 http://www.nsnam.org/releases/ns-allinone-3.5.tar.bz2
    16 
    17 Supported platforms
    18 -------------------
    19 ns-3.5 has been tested on the following platforms:
    20   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
    21   - linux x86_64 gcc 4.4.0, 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
    22   - MacOS X ppc and x86 (gcc 4.0.x and 4.2.x)
    23   - cygwin gcc 3.4.4 (debug only), gcc 4.3.2 (debug and optimized)
    24   - mingw gcc 3.4.5 (debug only)
    25 
    26 Not all ns-3 options are available on all platforms; consult the
    27 wiki for more information:
    28 http://www.nsnam.org/wiki/index.php/Installation
    29 
    30 New user-visible features
    31 -------------------------
    32 
    33   a) 802.11 MAC:
    34      - EDCA multi-qos-class support (Mirko Banchi)
    35      - 802.11n initial support for A-MSDU frame aggregation (Mirko Banchi)
    36      - aarf-cd and cara rate control algorithms (Federico Maguolo)
    37   b) 802.11 PHY:
    38      - 802.11b PHY support (Gary Pei)
    39      - Nakagami propagation loss model (Timo Bingmann)
    40      - radiotap and prism headers for PCAP output (Nicola Baldo)
    41   c) RandomVariable:
    42      - GammaVariable and ErlangVariable (Timo Bingmann)
    43      - ZipfVariable (Francesco Malandrino)
    44   d) UdpEcho: allows setting the payload of echo packets
    45   e) Ipv4/Ipv4RoutingProtocol: allow fine-grained control over
    46      routing policy and arbitrary composition of routing protocols
    47  
    48 API changes from ns-3.4
    49 -----------------------
    50 API changes for this release are documented in the file CHANGES.html.  The
    51 internal API and composition of the IPv4 stack underwent significant
    52 refactoring in this release cycle.
    53 
    54 Known issues
    55 ------------
    56 ns-3 build is known to fail on the following platforms:
    57   - gcc 3.3 and earlier
    58   - optimized builds on gcc 3.4.4 and 3.4.5
    59   - optimized builds on linux x86 gcc 4.0.x
    60 
    61 Future releases
    62 ---------------
    63 Our next release, which is expected to happen in 2 to 4 months from now, will
    64 feature the merging of some of our projects currently in development including
    65 fuller IPv6 support, some smaller features such as a new Global ARP 
    66 package, and possibly a new Testing and Validation suite.
    67 
    68 Release 3.4
    69 ===========
    70 
    71 Availability
    72 ------------
    73 This release is immediately available from:
    74 http://www.nsnam.org/releases/ns-allinone-3.4.tar.bz2
    75 
    76 Supported platforms
    77 -------------------
    78 ns-3.4 has been tested on the following platforms:
    79   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
    80   - linux x86_64 gcc 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
    81   - MacOS X ppc and x86
    82   - cygwin gcc 3.4.4 (debug only)
    83 
    84 Not all ns-3 options are available on all platforms; consult the
    85 wiki for more information:
    86 http://www.nsnam.org/wiki/index.php/Installation
    87 
    88 New user-visible features
    89 -------------------------
    90   a) Wifi models: Timo Bingman contributed a ThreeLogDistance and a Nakagami
    91      propagation loss model based on the ns-2 models. Fabian Mauchle contributed
    92      multicast support.
    93 
    94   b) Object Name Service:  A facility allowing ns-3 Objects to be assigned
    95      names has been added.
    96 
    97   c) Tap Bridge:  A second option for integrating ns-3 with real-world hosts
    98      has been added.  This allows for real hosts to talk over ns-3 net devices
    99      and simulated networks.
   100 
   101   d) A new build option (ns-3-allinone) has been provided to make it easier for
   102      users to download and bulid commonly used ns-3 configurations.
   103 
   104   e) The ns-3 calendar queue scheduler has been ported to ns-3.
   105 
   106   f) XML support has been added to the ConfigStore.
   107 
   108 API changes from ns-3.3
   109 -----------------------
   110 API changes for this release are documented in the file CHANGES.html
   111 
   112 Known issues
   113 ------------
   114 ns-3 build is known to fail on the following platforms:
   115   - gcc 3.3 and earlier
   116   - optimized builds on gcc 3.4.4 and 3.4.5
   117   - optimized builds on linux x86 gcc 4.0.x
   118   - optimized builds on Ubuntu 8.10 alpha 5 x86 gcc4.3.2
   119   - MinGW
   120 
   121 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
   122 in preparation of the merge of the IPv6 API and implementation.
   123 
   124 Future releases
   125 ---------------
   126 Our next release, which is expected to happen in 2 to 4 months from now, will
   127 feature the merging of some of our projects currently in development including
   128 fuller IPv6 support, and IPv4 and routing protocol refactoring, and some smaller
   129 features such as a new Global ARP package and possibly a new Testing and Validation
   130 suite,
   131 
   132 Release 3.3
   133 ===========
   134 
   135 Availability
   136 ------------
   137 This release is immediately available from:
   138 http://www.nsnam.org/releases/ns-3.3.tar.bz2
   139 
   140 Supported platforms
   141 -------------------
   142 ns-3.3 has been tested on the following platforms:
   143   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
   144   - linux x86_64 gcc 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
   145   - MacOS X ppc and x86
   146   - cygwin gcc 3.4.4 (debug only)
   147 
   148 Not all ns-3 options are available on all platforms; consult the
   149 wiki for more information:
   150 http://www.nsnam.org/wiki/index.php/Installation
   151 
   152 New user-visible features
   153 -------------------------
   154   a) Emulated Net Device
   155      A new net device has been added as enabling technology for ns-3 emulation
   156      scenarios.  See src/devices/emu and examples/emu-udp-echo.cc for details.
   157 
   158   b) ICMP Support
   159      Support for several ICMP messages has been added to ns-3.  See 
   160      src/internet-stack/icmpv4.h for details.
   161 
   162   c) IPv6 Address Support
   163      New clases to support IPv6 addresses has been added to the system.  This
   164      is enabling technology for fuller IPv6 support scheduled for ns-3.4.
   165 
   166   d) A flow-id tag has been added to the contributed code section
   167 
   168   e) Star topologies can be created from the topology helper functions
   169 
   170   f) The global routing code has been made dynamic (not just limited to
   171      (pre-simulation computation) and supports stub network interfaces and 
   172      bridge net devices 
   173 
   174   g) A MatchContainer has been added to the configuration subsystem
   175 
   176 API changes from ns-3.2
   177 -----------------------
   178 API changes for this release are documented in the file CHANGES.html
   179 
   180 Known issues
   181 ------------
   182 ns-3 build is known to fail on the following platforms:
   183   - gcc 3.3 and earlier
   184   - optimized builds on gcc 3.4.4 and 3.4.5
   185   - optimized builds on linux x86 gcc 4.0.x
   186   - optimized builds on Ubuntu 8.10 alpha 5 x86 gcc4.3.2
   187   - MinGW
   188 
   189 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
   190 in preparation of the merge of the IPv6 API and implementation.
   191 
   192 Future releases
   193 ---------------
   194 Our next release, which is expected to happen in 2 to 4 months from now, will
   195 feature the merging of some of our projects currently in development including
   196 fuller IPv6 support, and IPv4 and routing protocol refactoring, and some smaller
   197 features such as an object naming facility and a new Global ARP package.
   198 
   199 Release 3.2
   200 ===========
   201 
   202 Availability
   203 ------------
   204 This release is immediately available from:
   205 http://www.nsnam.org/releases/ns-3.2.tar.bz2
   206 
   207 Supported platforms
   208 -------------------
   209 ns-3.2 has been tested on the following platforms:
   210   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
   211   - linux x86_64 gcc 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
   212   - MacOS X ppc and x86
   213   - cygwin gcc 3.4.4 (debug only)
   214 
   215 Not all ns-3 options are available on all platforms; consult the
   216 wiki for more information:
   217 http://www.nsnam.org/wiki/index.php/Installation
   218 
   219 New user-visible features
   220 -------------------------
   221   a) Learning bridge (IEEE 802.1D)
   222     It is now possible to bridge together multiple layer 2 devices to
   223     create larger layer 2 networks. The Wifi and Csma models support
   224     this new mode of operation. (contributed by Gustavo Carneiro)
   225 
   226   b) Python bindings
   227     It is now possible to write simulation scripts in python using our 
   228     python bindings (contributed by Gustavo Carneiro).
   229 
   230   c) Real-time simulator
   231     It is now possible to run simulations synchronized on the real-world
   232     wall-clock time (contributed by Craig Dowell).
   233 
   234   d) Network Simulation Cradle
   235     It is now possible to use the Network Simulation Cradle 
   236     (http://www.wand.net.nz/~stj2/nsc/) in ns-3 and run simulations 
   237     using various versions of kernel TCP network stacks. (contributed
   238     by Florian Westphal as part of his Google Summer of Code work)
   239 
   240   e) A statistics framework
   241     Joseph Kopena contributed a statistics framework which can be used
   242     keep track of simulation data in persistent storage across multiple 
   243     runs (database and ascii file backends are available).
   244     More information on the wiki:
   245     http://www.nsnam.org/wiki/index.php/Statistical_Framework_for_Network_Simulation
   246 
   247 API changes from ns-3.1
   248 -----------------------
   249 API changes for this release are documented in the file CHANGES.html
   250 
   251 Known issues
   252 ------------
   253 ns-3 build is known to fail on the following platforms:
   254   - gcc 3.3 and earlier
   255   - optimized builds on gcc 3.4.4 and 3.4.5
   256   - optimized builds on linux x86 gcc 4.0.x
   257   - optimized builds on Ubuntu 8.10 alpha 5 x86 gcc4.3.2
   258   - MinGW
   259 
   260 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
   261 in preparation of the merge of the IPv6 API and implementation.
   262 
   263 Future releases
   264 ---------------
   265 Our next release, which is expected to happen in 2 to 4 months from now, will
   266 feature the merging of some of our projects currently in development: IPv6, 
   267 emulation, and synchronous posix sockets.
   268 
   269 Release 3.1 (2008/06/30)
   270 ========================
   271 
   272 The first ns-3 stable release
   273 -----------------------------
   274 
   275 This release is immediately available from:
   276 http://www.nsnam.org/releases/ns-3.1.tar.bz2
   277 
   278 We dedicate this initial ns-3 release to our late contributor and friend, 
   279 Federico Maguolo.
   280 
   281 What is ns-3 ?
   282 --------------
   283 
   284 ns-3 is a new discrete-event network simulator designed for supporting network
   285 research and education. ns-3 features a solid, well documented C++ core and 
   286 models for TCP/IP (IPv4), several link types including WiFi, and mobility 
   287 models.
   288 
   289 ns-3 is an open source project released under the GNU GPLv2 license which 
   290 allows anyone to use ns-3 without having to pay any license fee or royalties. 
   291 ns-3 is actively seeking new contributors to extend the range of supported 
   292 models and/or to maintain existing models.
   293 
   294 Where to get more information about ns-3
   295 ----------------------------------------
   296 
   297 All the ns-3 documentation, is accessible from the ns-3 website: 
   298 http://www.nsnam.org
   299 
   300 Including, tutorials:
   301 http://www.nsnam.org/tutorials.html
   302 
   303 Supported platforms
   304 -------------------
   305 
   306 ns-3 is regularly tested on the following platforms:
   307   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
   308   - linux x86_64 gcc 4.1.3, 4.2.1, 3.4.6
   309   - MacOS X ppc and x86
   310   - cygwin gcc 3.4.4 (debug only)
   311 
   312 Known issues
   313 ------------
   314 
   315 ns-3 is known to fail on the following platforms:
   316   - gcc 3.3 and earlier
   317   - optimized builds on gcc 3.4.4 and 3.4.5
   318   - optimized builds on linux x86 gcc 4.0.x
   319 
   320 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
   321 in preparation of the merge of the IPv6 API and implementation.
   322 
   323 Future releases
   324 ---------------
   325 
   326 Our next release, which is expected to happen in 2 to 4 months from now, will
   327 feature the merging of some of our projects currently in development: python 
   328 scripting, IPv6, emulation, a statistics framework and synchronous posix 
   329 sockets.
   330 
   331 Release 3.0.13 (2008/06/02)
   332 ===========================
   333 - point to point links generate ppp pcap traces
   334 - point to point links support asymmetrical data rates.
   335 - generate doxygen documentation for all attributes and trace sources
   336 - add ConfigStore and GtkConfigStore to contrib module
   337 - socket API now support tx and rx buffers: implemented for UDP and TCP
   338 - ARP cache now supports per-entry pending queues
   339 - lots of bugfixes and implementation and API cleanups
   340 
   341 Warning: among API changes in this release, Application::Start and 
   342 Application::Stop now interprets the time argument as a relative
   343 instead of absolute simulation time, to align with how Simulator::Schedule
   344 behaves.  Any code that calls these APIs in the middle of the simulation 
   345 will need to be adapted.  
   346 
   347 The API of Simulator::StopAt (time) has also changed.  Now it is 
   348 called Simulator::Stop (time), and takes a relative time, instead of 
   349 absolute.
   350 
   351 Release 3.0.12 (2008/04/07)
   352 ===========================
   353     - Add Attribute support to the TypeId metadata system and add
   354 attribute support to all in-tree models
   355     - Add a mid-level helper API to build simulation topologies 
   356 and perform simple ascii and pcap link-level tracing.
   357     - Large amount of structural changes to accomodate the needs
   358 of the upcoming python bindings
   359     - new rate control algorithm (RRAA) and a jakes propagation model
   360 in the 802.11 model (Federico Maguolo).
   361     - regression test framework added
   362     - TCP delayed acknowledgements and multitasking server
   363 
   364 Release 3.0.11 (2008/02/15)
   365 ===========================
   366     - Initial port of GTNetS TCP implementation (initial version 
   367 that does not support multitasking or delayed acknowledgments yet, 
   368 but supports a reliable stream service)
   369     - Changes to the ns-3 object model to create a TypeId-based 
   370 metadata system
   371     - lots of bug fixes throughout the system
   372     - tutorial updates
   373 
   374 Release 3.0.10 (2008/01/15)
   375 ===========================
   376    - Add tutorial document content;
   377    - Valgrind option for "waf" tool;
   378    - Doxygen organization changes.
   379 
   380 Release 3.0.9 (2007/12/15)
   381 ==========================
   382    - A 802.11 model ported from Yans. This model supports:
   383        * a rather extensive PHY model
   384        * log-distance and friis propagation model
   385        * a simple set of rate control algorithms (ARF, Ideal, 
   386          AARF, constant-rate)
   387        * adhoc and infrastructure mode (beacon+assoc)
   388    - Use smart pointer for Packet in the APIs
   389    - A new contrib directory with helper classes: 
   390      EventGarbageCollector, Gnuplot
   391    - Tracing support for Applications
   392    - many bugs fixed
   393 
   394 Release 3.0.8 (2007/11/15)
   395 ==========================
   396    - A simple error model
   397    - Source files for ns-3 tutorial
   398 
   399 Release 3.0.7 (2007/10/15)
   400 ==========================
   401   - OLSR routing protocol
   402   - A timer class
   403   - Additional mobility models (random waypoint, random 2D walk)
   404   - A mobility visualization tool 
   405 
   406 Release 3.0.6 (2007/09/15)
   407 ==========================
   408   - Static multicast IPv4 routing
   409   - Logging overhaul (NS_LOG macros)
   410   - Refactoring of tracing subsystem
   411   - Tutorial document started
   412  
   413 Release 3.0.5 (2007/08/15)
   414 ==========================
   415 
   416   - Refactoring to support win32-based unix environments (Cygwin, mingw)
   417   - "Packet socket" for allowing applications to access NetDevices directly
   418   - Generalized, polymorphic Address class
   419   - Add CSMA NetDevice model (from Emmanuelle Laprise)
   420   - Modularize IPv4 routing support (from Gustavo Carneiro)
   421   - Add mobility framework and basic mobility models 
   422   - Global unicast centralized routing 
   423 
   424 Release 3.0.4 (2007/07/15)
   425 ==========================
   426 
   427   - Enable waf as the default build system.
   428   - Per-packet metadata:  a system to track which headers and trailers 
   429     are added to a packet
   430   - Simplifications to point-to-point devices and channel
   431 
   432 Release 3.0.3 (2007/06/15)
   433 ==========================
   434 
   435   - Enable Waf for release tarballs: users can now build ns-3
   436     with the "waf" tool. See doc/build-waf.txt.
   437   - Add support for variable time precision: it is now possible
   438     to run a simulation with an accuracy which is higher or lower
   439     than a nanosecond: seconds, milliseconds, microseconds, 
   440     femtoseconds and picoseconds are supported.
   441   - Optimize and rework the COM framework, solidify the component 
   442     manager
   443   - Many small API cleanups
   444 
   445 Release 3.0.2 (2007/05/18)
   446 ==========================
   447 
   448   - Implement a new memory management infrastructure based
   449     on reference counting and smart pointers (the latter being
   450     optional)
   451 
   452   - Implement a COM-like framework with support for QueryInterface
   453     to provide object extensibility
   454 
   455   - Add support for a BSD-style socket API for user applications
   456 
   457 Release 3.0.1 (2007/03/31)
   458 ==========================
   459 
   460   - First public release; not yet pre-alpha.
   461 
   462   - Simple UDP-based simulation script (examples/simple-p2p.cc)