ns-3 RELEASE NOTES

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

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

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

Consult the file CHANGES.html for more detailed information about changed

API and behavior across ns-3 releases.

Release 3-dev

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

Availability

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

This release is not yet available.

Supported platforms

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

New user-visible features

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

Bugs fixed

----------

- Bug 1390 - ICMPv6 Redirect are handled correctly only for /64 networks

- Bug 1643 - NdiscCache creation and existence checks

- Bug 1646 - ICMPv6 Redirect are sent from global address instead of link-local

- Bug 1662 - m_type not set for Ipv6OptionRouterAlertHeader

- Bug 1678 - C++11 compliance problem with std::pair"

- Bug 1683 - IPv6 autoconfigured don't use *infinite* lifetimes

- Bug 1669 - ns-3 should support binding two and three (possibly more) arguments

- Bug 1688 - Routers should advertise themselves from the link-local address

- Bug 1689 - IPv6 shouldn't add a default gateway without checking the Router lifetime

- Bug 1697 - ICMPv6 Redirect trigger contains multiple bugs

- Bug 1700 - Ipv6RawSocket does not honor the bound address when sending packets

- Bug 1701 - Ipv6StaticRouting: the source address should match the destination scope

- Bug 1703 - Nodes don't react to a DAD

- Bug 1718 - Ipv4StaticRouting log component is misspelled

- Bug 1719 - IPv6 default state is set to not forward packets

Known issues

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

In general, known issues are tracked on the project tracker available

at http://www.nsnam.org/bugzilla/

Release 3.17

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

Availability

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

This release is available from: 

http://www.nsnam.org/release/ns-allinone-3.17.tar.bz2

Supported platforms

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

These platforms have been tested; others may work also:

- Fedora Core 18 (32/64 bit) with g++-4.7.2

- Fedora Core 17 (32/64 bit) with g++-4.7.0

- Ubuntu 13.04 (32/64 bit) with g++-4.7.3

- Ubuntu 12.10 (32/64 bit) with g++-4.6.3

- Ubuntu 12.04 (32/64 bit) with g++-4.6.3

- Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3

- OS X Mountain Lion 10.8.3 with g++-4.2.1

- FreeBSD 9.1-RELEASE (64 bit) with g++-4.2.1

New user-visible features

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

- new TCP Westwood and Westwood+ models

- new FdNetDevice model and associated helpers.  The FdNetDevice is able

  to read and write from a file descriptor.  Various helpers are provided

  to associate this descriptor with underlying devices or sockets on the 

  host operating system, including a packet socket for emulation, and

  tap devices including a version specialized for use on PlanetLab.

- ns-3-click: it's now possible to (i) have Click pull random numbers from

  ns-3 and (ii) have ns-3 set "defines" in Click via the simulation file 

  (see src/click/examples/nsclick-defines.cc).

- Waf shipped with ns-3 has been upgraded to version 1.7.10 and custom

  pkg-config generator has been replaced by Waf's builtin tool.

- create-module.py script has been updated to work with waf 1.7 and support

  for creating modules with names containing dashes has been added.

- the M5 release of the LTE module by the LENA project has been

  merged; please see src/lte/RELEASE_NOTES for more detailed info 

Bugs fixed

----------

- bug 1256 - Unnecessary SND.NXT advance, missing ACK for Out of Order segments

- bug 1318 - Ipv6L3Protocol::LocalDeliver can get stuck in an infinte loop

- bug 1409 - Add an attribute "SystemId" to configure the ID for MPI

- bug 1421 - Frequency dependent propagation loss models need uniform Frequency / Lambda attribute

- bug 1434 - DSR throughput not comparable to other protocols for manet example

- bug 1502 - Shutdown on tcp socket seems to misbehave

- bug 1503 - BlockAckManager infine loop

- bug 1517 - Waf clean/distclean doesn't remove the doc/html directory

- bug 1540 - Waf not finding click libraries

- bug 1549 - Test for NS_LOG

- bug 1556 - Uses of htonl making OpenFlow's match field error

- bug 1563 - Reduce valgrind test scope

- bug 1564 - Packet meta data isn't shown in dumbbell-animation.xml

- bug 1566 - WiFi SNR tag improvements

- bug 1568 - Deserialized addresses are implicity marked as Mac48Address

- bug 1569 - droptail_vs_red example doesn't run

- bug 1570 - Valgrind errors in new test examples

- bug 1574 - Node color overwritten, by mobility updates in netanim

- bug 1575 - Invert the y-axis in netanim

- bug 1576 - Frequency units HERTZ and MEGAHERTZ mix up

- bug 1577 - Typo in ascii picture in example aodv script

- bug 1579 - edca-txop-n fragmentation causes segfault

- bug 1582 - IPv6 raw socket return value is not like Linux socket

- bug 1585 - Length field of A-MSDU subframe header endianness

- bug 1586 - Building documentation fails if make runs in parallel

- bug 1588 - UdpEchoServer::HandleRead logs fail when using Ipv6

- bug 1589 - Bake - support pre-2.7 version of python

- bug 1590 - Bake - more autotools version support

- bug 1595 - Function declarations without implementations cause problems with dsr module's python bindings

- bug 1596 - Inet TopologyReader is skipping one link and duplicating another one

- bug 1600 - Icmpv6OptionLinkLayerAddress can only carry 48 bit addresses correctly

- bug 1601 - RttEstimator doesn't set the m_currentEstimatedRtt to m_initialEstimatedRtt on creation

- bug 1602 - waf build can break due to file collisions in higher-level directory

- bug 1603 - random-variable-stream-helper - this unavalable for static member functions

- bug 1607 - OnOffApplication over TCP with IPv6 support

- bug 1608 - DSR Network ACK is not handled correctly

- bug 1609 - Route Request table is needed

- bug 1612 - pyviz (visualizer) will not be installed

- bug 1613 - Can't build ns-3-dev with g++ 4.7.2

- bug 1615 - Adjusting OLSR HelloInterval Attribute results in no links

- bug 1618 - bake.py not detecting install of libxml2-dev on ubuntu

- bug 1623 - pybindgen rev809 is not able to build after Ubuntu 1210

- bug 1625 - ns-3-dev fails to build on Debian wheezy amd64

- bug 1626 - ipv6-only network can't use UDP or TCP

- bug 1632 - Prepend bake build directory to the guessed locations

             that waf will look to find libraries

- bug 1633 - Bake - should not report that it is downloading qt4 when it is already installed

- bug 1635 - Small bug without Simulator::Destroy()

- bug 1636 - Compilation error flagged as unmet dependency

- bug 1637 - Bake calling apt-get for unpriviledged user

- bug 1639 - bake.py support for linux mint

- bug 1640 - bake needs to test for g++

- bug 1641 - bake reports autotools dependency, but needs automake

- bug 1661 - Variable ub1 defined but not used in ipv6-address.cc

Known issues

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

In general, known issues are tracked on the project tracker available

at http://www.nsnam.org/bugzilla/

Release 3.16

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

Availability

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

This release is available from: 

http://www.nsnam.org/release/ns-allinone-3.16.tar.bz2

Supported platforms

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

- Fedora Core 17 (32/64 bit) with g++-4.7.0

- Fedora Core 15 (64 bit) with g++-4.6.3

- Ubuntu 12.10 (32/64 bit) with g++-4.6.3

- Ubuntu 12.04 (32/64 bit) with g++-4.6.3

- Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3

- OS X Mountain Lion 10.8.3 with g++-4.2.1

- FreeBSD 8.2 (32 bit) with g++-4.2.1

- Cygwin 1.7.9-1 with g++-4.5.3

New user-visible features

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

- Support several new LTE MAC schedulers developed in GSoC 2012 project. 

  Those schedulers include FD-MT, TD-MT, TTA, FD-BET, TD-BET, FD-TBFQ,

  TD-TBFQ, PSS. Here, FD and TD mean frequency domain and time domain 

  respectively.

- It's now possible to use distcc when building ns-3 by using

  $ CXX='distcc g++' ./waf configure

  $ ./waf build

- Support topology generation with the (external) BRITE topology generation 

  tool

Bugs fixed

----------

- bug  555 - DCF immediate access

- bug  976 - wifi-wired-bridging regression test fails because of 

             rounding errors in mobility model

- bug 1055:  Wrong UAN's Thorp absorption loss model formula

- bug 1284 - ./test.py performance tests do not exist

- bug 1324 - ns3tcp-cwnd-test-suite.cc test failing

- bug 1340 - ns3tcp-loss-suite.cc tests failing

- bug 1342 - ns3tcp-cwnd-test-suite.cc tests failing

- bug 1345 - ns-3 builds with clang compiler >= 3.0

- bug 1359 - TCP cannot receive ICMP

- bug 1361 - Set TOS from Application level (sockets)

- bug 1463 - ./test.py --example should automatically detect the path

- bug 1479 - When the Ipv4RawSocket "IpHeaderInclude" Attribute set true,

             Ip Checksum error

- bug 1485 - Setting global properties in config file (raw text) does

             not have any effect

- bug 1493 - test.py --list should show the test type default tip

- bug 1493 - test.py --list should show the test type 

- bug 1494 - test.py --constrain doesn't work

- bug 1495 - test.py claims test passed when no test was run

- bug 1506:  TCP data segment piggybacking acknowledgment

- bug 1509 - RttEstimator returns invalid value in presence of errors

- bug 1516 - GtkConfigStore does not show read-only attributes

- bug 1520 - Config paths not fully documented (partial fix)

- bug 1524 - Fragmentation Threshold equals to Packet Size at MAC Layer 

             (Data + IP + UDP) crash the reception

- bug 1525 - Linker error with mpi on Mac 10.8

- bug 1526:  Wrong calculation of pathloss within 

             UanPropModelThorp::GetPathLossDb

- bug 1527 - Ipv4RawSocket's BindToNetDevice not working

- bug 1528 - BindToNetDevice not working for IPv6 sockets

- bug 1531 - Crash when using NS_LOG in destructors of static objects

- bug 1532 - unimplemented LTE Scheduler methods

Known issues

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

In general, known issues are tracked on the project tracker available

at http://www.nsnam.org/bugzilla/

Release 3.15

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

Availability

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

This release is available from: 

http://www.nsnam.org/release/ns-allinone-3.15.tar.bz2

Supported platforms

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

- Fedora Core 17 (32/64 bit) with g++-4.7.0

- Fedora Core 15 (64 bit) with g++-4.6.3

- Ubuntu 12.04 (32/64 bit) with g++-4.6.3

- Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3

- OS X Mountain Lion 10.7.4 with g++-4.2.1

- OS X Snow Leopard 10.6.8 with g++-4.2.1 

- FreeBSD 8.2 (32 bit) with g++-4.2.1

- Cygwin 1.7.9-1 with g++-4.5.3

New user-visible features

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

- A new random variable base class called 'RandomVariableStream', has been

  introduced.  This base class derives from ns3::Object, unlike the current 

  'RandomVariable' class which is a special type of object in the ns-3 

  system to date.  By making this class derive from ns3::Object, it can be 

  handled with the Ptr class, can carry attributes, and can have its parameters

  and initial state saved in the config-store subsystem.  A new attribute

  called "Stream" has been introduced for this class, to allow users to

  better control the assignment of underlying pseudo-random sequences to

  the RandomVariableStream objects (bug 101).

Bugs fixed

----------

 - bug 101 - random variable initialization

 - bug 1256 - Unnecessary SND.NXT advance, missing ACK for Out of Order segments

 - bug 1308 - Nix-vector; do not process packets to self

 - bug 1386 - assert if PositionAllocator not provided to 

              RandomWaypointMobilityModel

 - bug 1399 - TCP not backing off retransmissions properly

 - bug 1441 - IPv4 header length handling

 - bug 1464 - ConfigStore Save + Load => Could not set default value 

                  for ns3::UdpSocketImpl::IcmpCallback

 - bug 1470 - define default parameter for constructor in .h file

 - bug 1473 - GetQueue/SetQueue missing from Csma python bindings

 - bug 1475 - "test.py --list" should sort the output

 - bug 1476 - TestCase::GetName () should not be private

 - bug 1477 - Click doesn't work with raw sockets

 - bug 1481 - Openflow example doesn't run

 - bug 1486 - Segfaults in nix-vector-routing with bridges

 - bug 1489 - Jakes Log component is missing

 - fixed bug with multiple LCs in UL BSR

 - fixed bug with lena-dual-stripe crashes with --homeUesHomeEnbRatio=2

Known issues

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

In general, known issues are tracked on the project tracker available

at http://www.nsnam.org/bugzilla/

Release 3.14.1

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

Availability

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

This release is available from:

http://www.nsnam.org/release/ns-allinone-3.14.1.tar.bz2

Bugs fixed

----------

This hotfix release contains a fix for the PyViz visualizer and makes it

easier to add PyViz support to examples; otherwise it is the same as the

ns-3.14 release.

Release 3.14

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

Availability

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

This release is available from: 

http://www.nsnam.org/release/ns-allinone-3.14.tar.bz2

Supported platforms

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

ns-3.14 has been tested on the following platforms.  Not all features are

available on all platforms; check the Installation page on the project wiki.

- Fedora Core 17 (32/64 bit) with g++-4.7.0

- Fedora Core 16 (32/64 bit) with g++-4.6.3

- Fedora Core 15 (64 bit) with g++-4.6.3

- Ubuntu 12.04 (32/64 bit) with g++-4.6.3

- Ubuntu 11.10 (32 bit) with g++-4.6.1

- Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3

- OS X Lion 10.7.4 with g++-4.2.1

- OS X Snow Leopard 10.6.8 with g++-4.2.1 

- FreeBSD 8.2 (32 bit) with g++-4.2.1

- Cygwin 1.7.9-1 with g++-4.5.3

New user-visible features

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

- Transport protocol implementations (TCP, UDP) have been refactored to

  support also IPv6 connections. Dual-stacked IPv6 sockets are implemented. 

  An IPv6 socket can accept an IPv4 connection, returning the sender's 

  address as an IPv4-mapped address (IPV6_V6ONLY socket option is not 

  implemented).

- The LTE code from the LENA project has been merged, bringing in a

  significant redesign of the LTE module as well as many new features.

- An antenna module is now included, which includes different

  radiation pattern models. See the corresponding new section of the

  ns-3 models library documentation for details.

- A new buildings module is introduced which allows to model the

  presence of buildings in a wireless network topology.  

- New propagation models (OkumuraHata, ITU-R P.1411, ITU-R P.1238)

  have been added

- The Dynamic Source Routing (DSR) MANET routing protocol for IPv4 was added.

- A Random Early Detection (RED) queue model has been added.

- Ipv6RoutingHelper is now in-line with Ipv4RoutingHelper concerning the RT 

  print functions. Various minor changes were made in Ipv6RoutingProtocol and 

  derived classes to make this possible.

- New "SendIcmpv6Redirect" attribute (and getter/setter functions) to 

  Ipv6L3Protocol. The behavior is similar to Linux's conf "send_redirects",

  i.e., enable/disable the ICMPv6 Redirect sending.

- Longer and more descriptive names are used for error units in RateErrorModel

  class and queue mode in Queue class. Attributes in those classes are also

  changed for consistency. See API documentation for details.

- The netanim animator is now bundled with the release.

Bugs fixed

----------

 - bug 603 - Simulator::Next is useless

 - bug 631 - RealtimeSimulatorImpl does not handle Ctrl-C with python bindings

 - bug 962 - list of paths to reach objects contains bogus entries

 - bug 1000 - Make RealtimeSimulatorImpl last until stop

 - bug 1053 - Need better error diagnostics in ns2-mobility-trace example

 - bug 1109 - Point out the effects of ArpCache::PendingQueueSize

 - bug 1179 - Add LTE trace hooks for supporting visualizer

 - bug 1180 - LTE: Add TX/RX trace support

 - bug 1273 - Better error message on missing Python development files

 - bug 1282 - Sleep state and CCA

 - bug 1283 - PacketSocket::SendTo should return number of bytes 

 - bug 1302 - Flow monitor bug

 - bug 1304 - Tag information changed after transmission

 - bug 1313 - Stddev (average.h) returning NaN

 - bug 1318 - Asserts for IPv6 malformed packets

 - bug 1319 - Fix Ipv6RawSocketImpl Icmpv6 filter

 - bug 1325 - Python examples get valgrind errors when build subdirectories 

              are specified in waf

 - bug 1339 - test.py uses the old name for the test runner

 - bug 1348 - python bindings: deprecated conversion from string constant 

              to ‘char*’

 - bug 1349 - TypeId.LookupAttributeByName Python bindings missing

 - bug 1350 - Simulator.ScheduleWithContext Python binding missing

 - bug 1351 and 1333 - TCP not able to take RTT samples on long delay network

 - bug 1352 - Fixed MapAttributes, previously was mapped to a vector in 

              ObjectPtrContainer and (and key information was dropped). 

              Now the container is a map.

 - bug 1354 - Building scratch subdir programs is broken

 - bug 1355 - Visualizer dependencies not detected at buildtime

 - bug 1357 - IPv6 fragmentation fails due to checks about malformed extensions

 - bug 1362 - ICMPv6 does not forward ICMPs to upper layers (and minor 

              fixes to ICMPv6)

 - bug 1376 - wrong wind variable's name

 - bug 1378 - UdpEchoClient::SetFill () does not set packet size correctly

 - bug 1379 - lte-multiple-flows example crashes

 - bug 1380 - lte-phy-uplink example crashes

 - bug 1391 - .ns3rc does not allow comments as expected

 - bug 1392 - Modules built report does not clarify C++ or Python

 - bug 1393 - IPv6 Routing Helper RT Print functions

 - bug 1395 - AODV DeferredRouteOutputTag missing constructor

 - bug 1396 - ARP with hardware addresses longer than 6 bytes

 - bug 1399 - TCP not backing off retransmissions properly

 - bug 1404 - Bound user input in tutorial third.cc program

 - bug 1406 - waf exits with maximum recursion depth exceeded 

 - bug 1415 - examples-to-run.py doesn't work with command line arguments

 - bug 1420 - no python bindings for csma-layout

 - bug 1441 - IPv4 header length handling

Known issues

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

In general, known issues are tracked on the project tracker available

at http://www.nsnam.org/bugzilla/

Release 3.13

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

Availability

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

This release is available from: 

http://www.nsnam.org/release/ns-allinone-3.13.tar.bz2

Supported platforms

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

ns-3.13 has been tested on the following platforms.  Not all features are

available on all platforms; check the Installation page on the project wiki.

- Ubuntu 11.10 (32 bit) with g++-4.5.2

- Ubuntu 11.04 (32/64 bit) with g++-4.5.2 

- Ubuntu 10.04.3 LTS (64 bit) with g++-4.4.3, g++-3.4.6 

- OS X Lion with g++-4.2.1

- OS X Snow Leopard with g++-4.2.1 

- Fedora Core 16 (32/64 bit) with g++-4.6.2

  --  however, g++-3.4.6 fails on Fedora 16 i686 

- Fedora Core 14 (64 bit) with g++-4.5.1

- FreeBSD 9.0-RC1 (AMD64) with g++-4.2.1

New user-visible features

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

- IPv6 address generator with support for duplicate address detection

Bugs fixed

----------

 - bug 962 - list of paths to reach objects contains bogus entries

 - bug 1001 - Buffer::CopyData() doesn't return the number of bytes copied

 - bug 1010 - Uan model sleep patch

 - bug 1020 - Wrong usage of the originator sequence number in HWMP PREP

 - bug 1021 - Beacon collision avoidance in Mesh module works incorrectly

 - bug 1039 - Nagle's algorithm in TCP 

 - bug 1055 - Wrong UAN's Thorp absorption loss model formula

 - bug 1059 - Unable to load trace files created from SUMO and TraNS Lite

 - bug 1112 - Advance m_nextTxSequence upon retransmit after RTO 

 - bug 1137 - mpi module is hard-coded for openmpi

 - bug 1166 - IPV4 TCP failed to send a RST when connect arrives before listen

 - bug 1186 - Ipv4Header lacks DSCP and ECN

 - bug 1204 - Can't Parse Time +100000000.0ns

 - bug 1219 - Coding style of ns2-mobility-helper-test-suite.cc is fixed

 - bug 1257 - waf install __init__ Python files even with --disable-python

 - bug 1263 - waf configure fails on FreeBSD 9.0-BETA2 amd64

 - bug 1266 - gdb cannot be loaded

 - bug 1227 - Spurious RTO due to low min RTO

 - bug 1229 - Multiplication overflow in WaypointMobilityModel::EndMobility

 - bug 1242 - m_lastRtt in tcp-socket-base.cc not implemented

 - bug 1256 - TCP unnecessary snd.nxt advance

 - bug 1265 - Make ns-3 directory "movable"

 - bug 1269 - sqlite3 not found on FreeBSD

 - bug 1270 - "Checking boost includes" weirdness

 - bug 1278 - Ipv4ClickRouting::HandleScheduleFromClick bug

 - bug 1281 - Checksum not calculated when doing IP fragmentation

 - bug 1285 - IPv6 Localhost is marked as GLOBAL instead of HOST

 - bug 1290 - buffer-test.cc gets a valgrind error

 - bug 1295 - Missing const qualifiers in TopologyRead 

 - bug 1299 - EnableAsciiIpv4All tracing doesn't show transmitted/recvd packets

 - bug 1300 - HalfDuplexIdealPhy notify SpectrumInterference of AbortRx 

 - bug 1301 - Ns2MobilityHelper causes Node GetPosition() to return NaN

 - bug 1305 - do not list modules built upon exiting waf shell

 - bug 1312: TopologyRead Assert condition fix

 - IPv4 packets double fragmentation was broken 

 - Fix wifi-clear-channel-cmu.cc example

 - NetAnim: fix for bcast packet reuse

 - Missing PropagationLossModel.CalcRxPower in Python bindings

 - Corrected compilation behavior in Ubuntu 11.10 due to ldd behavior change

 - Added required PTHREAD dependency to RT library check.

Known issues

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

In general, known issues are tracked on the project tracker available

at http://www.nsnam.org/bugzilla/

Release 3.12.1

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

Availability

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

This release is available from: 

http://www.nsnam.org/release/ns-allinone-3.12.1.tar.bz2

Bugs fixed

----------

This release fixes PyViz visualizer's python bindings; otherwise, it

is the same as the ns-3.12 release.