ns-3 RELEASE NOTES

This file contains ns-3 release notes (most recent releases first).

Release 3.2 (pending)

=====================

Release 3.1 (2008/06/30)

========================

The first ns-3 stable release

-----------------------------

This release is immediately available from:

http://www.nsnam.org/releases/ns-3.1.tar.bz2

We dedicate this initial ns-3 release to our late contributor and friend, 

Federico Maguolo.

What is ns-3 ?

--------------

ns-3 is a new discrete-event network simulator designed for supporting network

research and education. ns-3 features a solid, well documented C++ core and 

models for TCP/IP (IPv4), several link types including WiFi, and mobility 

models.

ns-3 is an open source project released under the GNU GPLv2 license which 

allows anyone to use ns-3 without having to pay any license fee or royalties. 

ns-3 is actively seeking new contributors to extend the range of supported 

models and/or to maintain existing models.

Where to get more information about ns-3

----------------------------------------

All the ns-3 documentation, is accessible from the ns-3 website: 

http://www.nsnam.org

Including, tutorials:

http://www.nsnam.org/tutorials.html

Supported platforms

-------------------

ns-3 is regularly tested on the following platforms:

  - linux x86 gcc 4.2, 4.1, and, 3.4.6.

  - linux x86_64 gcc 4.1.3, 4.2.1, 3.4.6

  - MacOS X ppc and x86

  - cygwin gcc 3.4.4 (debug only)

Known issues

------------

ns-3 is known to fail on the following platforms:

  - gcc 3.3 and earlier

  - optimized builds on gcc 3.4.4 and 3.4.5

  - optimized builds on linux x86 gcc 4.0.x

The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 

in preparation of the merge of the IPv6 API and implementation.

Future releases

---------------

Our next release, which is expected to happen in 2 to 4 months from now, will

feature the merging of some of our projects currently in development: python 

scripting, IPv6, emulation, a statistics framework and synchronous posix 

sockets.

Release 3.0.13 (2008/06/02)

===========================

- point to point links generate ppp pcap traces

- point to point links support asymmetrical data rates.

- generate doxygen documentation for all attributes and trace sources

- add ConfigStore and GtkConfigStore to contrib module

- socket API now support tx and rx buffers: implemented for UDP and TCP

- ARP cache now supports per-entry pending queues

- lots of bugfixes and implementation and API cleanups

Warning: among API changes in this release, Application::Start and 

Application::Stop now interprets the time argument as a relative

instead of absolute simulation time, to align with how Simulator::Schedule

behaves.  Any code that calls these APIs in the middle of the simulation 

will need to be adapted.  

The API of Simulator::StopAt (time) has also changed.  Now it is 

called Simulator::Stop (time), and takes a relative time, instead of 

absolute.

Release 3.0.12 (2008/04/07)

===========================

    - Add Attribute support to the TypeId metadata system and add

attribute support to all in-tree models

    - Add a mid-level helper API to build simulation topologies 

and perform simple ascii and pcap link-level tracing.

    - Large amount of structural changes to accomodate the needs

of the upcoming python bindings

    - new rate control algorithm (RRAA) and a jakes propagation model

in the 802.11 model (Federico Maguolo).

    - regression test framework added

    - TCP delayed acknowledgements and multitasking server

Release 3.0.11 (2008/02/15)

===========================

    - Initial port of GTNetS TCP implementation (initial version 

that does not support multitasking or delayed acknowledgments yet, 

but supports a reliable stream service)

    - Changes to the ns-3 object model to create a TypeId-based 

metadata system

    - lots of bug fixes throughout the system

    - tutorial updates

Release 3.0.10 (2008/01/15)

===========================

   - Add tutorial document content;

   - Valgrind option for "waf" tool;

   - Doxygen organization changes.

Release 3.0.9 (2007/12/15)

==========================

   - A 802.11 model ported from Yans. This model supports:

       * a rather extensive PHY model

       * log-distance and friis propagation model

       * a simple set of rate control algorithms (ARF, Ideal, 

         AARF, constant-rate)

       * adhoc and infrastructure mode (beacon+assoc)

   - Use smart pointer for Packet in the APIs

   - A new contrib directory with helper classes: 

     EventGarbageCollector, Gnuplot

   - Tracing support for Applications

   - many bugs fixed

Release 3.0.8 (2007/11/15)

==========================

   - A simple error model

   - Source files for ns-3 tutorial

Release 3.0.7 (2007/10/15)

==========================

  - OLSR routing protocol

  - A timer class

  - Additional mobility models (random waypoint, random 2D walk)

  - A mobility visualization tool 

Release 3.0.6 (2007/09/15)

==========================

  - Static multicast IPv4 routing

  - Logging overhaul (NS_LOG macros)

  - Refactoring of tracing subsystem

  - Tutorial document started

Release 3.0.5 (2007/08/15)

==========================

  - Refactoring to support win32-based unix environments (Cygwin, mingw)

  - "Packet socket" for allowing applications to access NetDevices directly

  - Generalized, polymorphic Address class

  - Add CSMA NetDevice model (from Emmanuelle Laprise)

  - Modularize IPv4 routing support (from Gustavo Carneiro)

  - Add mobility framework and basic mobility models 

  - Global unicast centralized routing 

Release 3.0.4 (2007/07/15)

==========================

  - Enable waf as the default build system.

  - Per-packet metadata:  a system to track which headers and trailers 

    are added to a packet

  - Simplifications to point-to-point devices and channel

Release 3.0.3 (2007/06/15)

==========================

  - Enable Waf for release tarballs: users can now build ns-3

    with the "waf" tool. See doc/build-waf.txt.

  - Add support for variable time precision: it is now possible

    to run a simulation with an accuracy which is higher or lower

    than a nanosecond: seconds, milliseconds, microseconds, 

    femtoseconds and picoseconds are supported.

  - Optimize and rework the COM framework, solidify the component 

    manager

  - Many small API cleanups

Release 3.0.2 (2007/05/18)

==========================

  - Implement a new memory management infrastructure based

    on reference counting and smart pointers (the latter being

    optional)

  - Implement a COM-like framework with support for QueryInterface

    to provide object extensibility

  - Add support for a BSD-style socket API for user applications

Release 3.0.1 (2007/03/31)

==========================

  - First public release; not yet pre-alpha.

  - Simple UDP-based simulation script (examples/simple-p2p.cc)