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.10

===========

Availability

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

This release is not yet available.

Supported platforms

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

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

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

- Linux i686 Ubuntu 10.10

  - g++-4.4.5

- Linux x86_64 Ubuntu 8.04.4

  - g++-3.4.6, g++-4.2.4

- Linux x86_64 Fedora Core 12

  - g++-4.4.4

- Linux x86_64 Fedora Core 10

  - g++-3.4.6, 4.0.4, 4.1.2, 4.2.4, 4.3.4, 4.4.0

- OS X Snow Leopard

  - g++-4.2.1 

- OS X powerpc Leopard 

  - g++-4.0, g++-4.2

New user-visible features

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

   - NS-3 PyViz, a live simulation visualizer, has been added.  The 

     visualizer interacts with a running simulation, such that it uses no

     trace files. It can be most useful for debugging purposes, i.e. to

     figure out if mobility models are what you expect, where packets are

     being dropped, etc. There is also a builtin interactive python console

     that can be used to debug the state of the running objects. Although

     it is mostly written in Python, it works both with Python and pure C++

     simulations.

   - Wi-Fi MAC high classes have been reorganised in attempt to

     consolidate shared functionality into a single class. This new

     class is RegularWifiMac, and it derives from the abstract

     WifiMac, and is parent of AdhocWifiMac, StaWifiMac, ApWifiMac,

     and MeshWifiInterfaceMac. The QoS and non-QoS class variants are

     no longer, with a RegularWifiMac attribute "QosSupported"

     allowing selection between these two modes of

     operation.

   - Support for IEEE 802.11g (specifically, rates with Modulation

     Class ERP-OFDM) has been added to the wifi module. The new

     WifiModes have names of the form ErpOfdmRatexxMbps, where xx is

     the rate in Mbps (one of 6, 9, 12, 18, 24, 36, 48, 54), and a

     WifiPhyStandard enumeration WIFI_PHY_STANDARD_80211g has been

     added to allow configuration of a Wi-Fi STA supporting ERP-OFDM,

     HR/DSSS, and DSSS rates (which some call an "802.11b/g" station).

   - Two attributes were added to WaypointMobilityModel.  The first

     "LazyNotify" (default false), if enabled to true, will suppress

     course change notifications if there are no position updates.

     The second, "InitialPositionIsWaypoint" (default false), if enabled,

     will allow an initial call to SetPosition () (before any waypoints

     have been added) to be treated as the first waypoint.

   - Regression testing is now completely performed within test.py

     rather than a separate "./waf --regression" that consults

     reference traces in the ns-3.x-ref-traces directory.  In most

     cases, the example programs whose traces were included in 

     ns-3.x-ref-traces have a corresponding test called from the

     test.py program.  It is still possible to write trace-based

     regression tests but they are now called from the test.py

     program.

   - New BulkSendApplication sends data as fast as possible up to 

     MaxBytes or unlimited if MaxBytes is zero.  Think OnOff, but 

     without the "off" and without the variable data rate. This 

     application only works with SOCK_STREAM and SOCK_SEQPACKET 

     sockets, for example TCP sockets and not UDP sockets.

   - Extensions to the energy models:  1) a new Rakhmatov Vrudhula 

     non-linear battery model, 2) additional support for modeling 

     energy consumption in WiFi devices, 3) an example for how to add 

     energy models to a WiFi-based simulation (in examples/energy/ 

     directory).

   - New methods to print IPv4 routing tables to an output stream.

   - A replacement implementation for TCP for IPv4.  TcpSocketBase

     now replaces TcpSocketImpl.  There are subclasses defined for

     TCP Tahoe, Reno, NewReno, and the original RFC793 without

     congestion control.

   - Energy support for UAN module and Li-Ion energy model.

     Now each network node can have an associated energy source

     from which it consumes energy. The user can specify a custom

     energy model for the underwater transducer, with default values

     set for WHOI acoustic transducer. Li-Ion battery model added

     into energy models folder.

   - Destination-Sequenced Distance Vector (DSDV) routing protocol 

     is a proactive, table-driven routing protocol for MANETs 

     developed by Charles E. Perkins and Pravin Bhagwat in 1994. 

     This implementation is for IPv4 routing and was contributed 

     by ResilNets Research Group.

   - A novel model to simulate LTE networks has been added.  It focuses 

     mainly on modeling the E-UTRA part of the system, with a particular 

     attention on the aspects related to the channel, PHY and MAC layers. 

     The most important features available at this moment are (i) a basic 

     implementation of both the UE and the eNB devices, (ii) RRC and 

     entities for both the UE and the eNB, (iii) an Adaptive Modulation 

     and Coding (AMC) scheme for the downlink, (iv) the management of the 

     data radio bearers (with their QoS parameters), the MAC queues and 

     the RLC instances, (v) Channel Quality Indicator (CQI) management, 

     (vi) support for both uplink and downlik packet scheduling, 

     (vii) a PHY layer model with Resource Block level granularity, and 

     (viii) a channel model with the outdoor E-UTRAN propagation loss 

     model.

   - Project documentation has been converted from GNU Texinfo to Sphinx. 

Bugs fixed

----------

The following lists many of the bugs fixed or small feature additions

since ns-3.9, in many cases referencing the Bugzilla bug number

   - bug 824 - TCP should implement FastRecovery by default

   - bug 852 - Add support for 802.11g devices

   - bug 892 - WaypointMobilityModel incompatible with MobilityHelper::Install

   - bug 893 - Lazy CourseChange notification for WaypointMobilityModel

   - bug 903 - TapBridge does not shut down properly

   - bug 953 - WiMAX channel scanning overflow

   - bug 967 - Need to decouple Ipv4L4Protocols from Ipv4L3Protocol

   - bug 978 - Consolidate Wi-Fi MAC high functionality

   - bug 979 - Multi-octet fields in Wi-Fi headers have wrong endianness

   - bug 981 - use a cache to keep track of received MPDUs under block ack

   - bug 983 - handle correctly ADDBA response action frames in QadhocWifiMac

   - bug 984 - EmuNetDevice should use DIX encapsulation by default

   - bug 985 - WiMAX Invalid management message type on wimax-simple

   - bug 988 - MacRxMiddle::SequenceControlSmaller method

   - bug 990 - Error with an NS_ASSERT at uan-phy-gen.cc

   - bug 991 - InterferenceHelper assertion failure

   - bug 992 - Unusual (possibly incorrect assertion) in Packet::Deserialize

   - bug 993 - MinstrelWifiManager::UpdateStats useless if clause

   - bug 994 - PointToPointGridHelper useless if clauses

   - bug 995 - Useless (possibly incorrect) comparison of unsigned int

   - bug 1004 - module header not rebuilt

   - bug 1005 - GetSocket() methods for OnOffApplication and PacketSink

   - bug 1009 - decouple m_finSequence (TcpSocketImpl) from tx sequence numbers

   - bug 1012 - UAN Throp propagation model bug

   - bug 1015 - GetChannelFrequencyMhz() does not match with standard

   - bug 1022 - inappropriate ASSERT in tcp-socket-impl.cc

   - bug 1025 - wimax-ipv4 script exists with signal SIGSEGV when nbSS>20

   - bug 1027 - RocketfuelTopologyReader is not working at all

   - bug 1029 - v4Ping application endian issues

   - bug 1030 - routing/aodv example fixed

   - bug 1031 - Wifi hidden terminal example does not work

   - bug 1032 - Unable to specify multiple Compiler/Linker flags

Known issues

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

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

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

Windows XP 32 bit Cygwin 1.7.7 does not seem to work because of a

problem (reported elsewhere) in linking large libraries.

Release 3.9

===========

Availability

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

This release is immediately available from:

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

Supported platforms

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

ns-3.9 has been tested on the following platforms:

- Ubuntu 10.04 LTS 32/64-bit gcc-4.4.3

- Fedora Core 12 64-bit gcc-4.4.3

- Ubuntu 9.10 32-bit gcc-4.4.1

- Ubuntu 8.04 LTS 64-bit gcc-4.2.4

- Fedora Core 5 32-bit gcc-4.1.1

- Mac OS X Leopard powerpc gcc-4.0.1

- Windows Cygwin 1.7.5

Not all ns-3 options are available on all platforms; consult the

wiki for more information:

http://www.nsnam.org/wiki/index.php/Installation

New user-visible features

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

   - A reorganisation of the construction of Wi-Fi transmit rates has

     been undertaken with the aim of simplifying the task of

     supporting further IEEE 802.11 PHYs. This work has been completed

     under the auspices of Bug 871. A consequence of this work is that

     WifiModes have a new (hopefully future-proof) naming, and

     simulations which specify rates by name will need updating. The

     list of new rate names is given in the error message produced

     when an attempt is made to use any invalid rate name (including

     those that were previously valid).

   - A new OFDM error rate model for WiFi (NistErrorRateModel); this model

     has been validated in clear-channel testbed tests.  For 802.11b, it

     uses the same underlying model as the YansErrorRateModel, but it differs

     from YansErrorRateModel for OFDM modes (802.11a/g).  The default

     YansWifiPhyHelper has been changed to use this model.

   - A new NS-2 mobility trace reader supports BonnMotion, SUMO, TraNS, 

     etc. traces.

   - An energy model for nodes and devices, including an energy source

     model and device energy models allowing energy-aware devices

     to notify the energy source about energy consumption.  

   - Rocketfuel topology dataset support for existing topology reader

     Rocketfuel project: 

     http://www.cs.washington.edu/research/networking/rocketfuel/

   - Underwater Acoustic Network (UAN) model, split in to three parts, the 

     channel, PHY, and MAC models to enable researchers to model a variety 

     of underwater network scenarios.

   - the Spectrum framework, which provides support for spectrum-aware

     Channel and PHY layer modeling. It features a set of classes that

     allows the mathematical representation of frequency dependent

     phenomena. Some example channel, propagation and device

     implementations that make use of this framework are also

     included.  

Bugs fixed

----------

The following lists many of the bugs fixed or small feature additions 

since ns-3.8, in many cases referencing the Bugzilla bug number

   - IPv4 global routing code; stub networks were assumed to be /24

     and added as /24 networks even if the mask is actually different

   - OLSR was generating messages on non-OLSR interfaces

   - ICMPv4 objects not properly registered; affected serialization code

   - bug 231 - SocketAddressTag needs to be removed from a packet before 

               forwarding the packet to the user

   - bug 385 - Add a generic "sequence number" class

   - bug 473 - [PATCH] Alternative ns-2 trace reader

   - bug 665 - Need Tutorial Sectino on Config Path and Tracing Use

   - bug 671 - add packet-info-tag.cc for IP_PKTINFO/IPV6_PKTINFO

   - bug 702 - Global routing doesn't respond to interface events

   - bug 799 - Interference helper is too slow

   - bug 800 - Erroneous packet sender while using aloha or cw mac in uan module

   - bug 802 - Minstrel algorithm causes segmentation fault

   - bug 826 - Using uint64_t instead of Time in DcfManager

   - bug 828 - PacketSocket::Close does not unregister protocol handler

   - bug 842 - ns-3-dev crashes using block acks

   - bug 843 - Most wifi examples change BeaconInterval to unrealistic values

   - bug 844 - YansWifiPhy::GetPowerDbm off-by-one problem when calculating Tx 

               power

   - bug 846 - packet.cc triggers deprecated warning

   - bug 853 - Rates for Wi-Fi control responses are incorrectly selected

   - bug 854 - Support DROP_QUEUE reason-code in Ipv4FlowProbe

   - bug 858 - support MSG_PEEK in IPv4/IPv6 raw socket

   - bug 861 - Forwarding drops (due to no route found) were not being logged 

               in IPv4 or IPv6 ascii traces

   - bug 869 - suggested test framework enhancements

   - bug 871 - naming for WifiPhyStandard

   - bug 873 - Queue occupancy counter not decremented in WifiMacQueue::Remove()

   - bug 874 - wrong modulation type is selected in the forwardBurst method

   - bug 875 - "frame includes FCS" flag should be set in Radiotap frame header

   - bug 879 - source address selection for AODV using DeferredRouteRequest

   - bug 881 - Reorganise to allow wider use of WifiInformationElement

   - bug 890 - several rate adaptation algorithms not tested by test.py

   - bug 900:  RawTextConfigLoad::Default does not load configurations

   - bug 901 - Optimize Mac48Address < != and ==

   - bug 902 - TCP: handle out-of-order packets during connection shutdown

   - bug 905 - WimaxNetDevice loses packet uid, tags, and memory optimization

   - bug 906 - NSC TCP socket fork did not copy txbuffersize over

   - bug 908 - test.py should exit if waf dies

   - bug 910 - Change Wi-Fi "AccessClass" to something closer to the standard

   - bug 911 - IPv4/v6 multicast forwarding not going to all output interfaces

   - bug 913 - Queue Enqueue/Drop trace sources behavior unintuitive

   - bug 916 - EnableAsciiAll ("prefix") does not work for YansWifiPhyHelper

   - bug 918 - samples/main-packet-header.cc is broken

   - bug 919 - minstrel does not pass valgrind tests

   - bug 921 - Inconsistent declaration of class/struct Object in object.h

   - bug 922 - Inconsistent declaration of class/struct in 

               wifi-remote-station-manager.h

   - bug 923 - Inconsistent declaration of class/struct in mac-low.h

   - bug 924 - Inconsistent declaration of class/struct in <xxx>-wifi-managers 

   - bug 925 - Various IPv6 cc files trigger deprecated warning

   - bug 926 - olsr handling of multicast packets 

   - bug 927 - SimpleOfdmWimaxChannel RxPower computation

   - bug 930 - examples/topology-read/topology-example-sim.cc uses variable 

               length array

   - bug 931 - Abnormal exit reports SIGSEGV on failure

   - bug 932 - Support IP_HDRINCL option for Ipv4RawSocket

   - bug 933 - Flushing ostream and files on abnormal program exit 

               (ASSERT, ABORT and FATAL_ERROR)

   - bug 936 - Waf build error for python bindings on "AccessClass"

   - bug 937 - bugs in ns-3 wimax

   - bug 939 - EmuNetDevice uses too much memory when reading packet bursts

   - bug 940 - AODV fails to set up a correct path

   - bug 941 - Wifi Dcf attributes not reachable through configuration namespace

   - bug 943 - Add a SO_BROADCAST socket option

   - bug 944 - change default ErrorRateModel from YansErrorRateModel to 

               NistErrorRateModel

   - bug 946 - Rocketfuel topology dataset support for topology reader

   - bug 949 - Node::NonPromiscReceiveFromDevice reports a meaningless 

               destination address to user callbacks 

   - bug 950 - PointToPointNetDevice says promisc support is not implemented 

               but it is

   - bug 955 - Install NSC for NS3 in a Itanium Architecture (ia64) with Linux 2.6.16.6

   - bug 956 - Bindings failure in core (traced-value) with older gcc

   - bug 958 - WiFi uses wrong default values for MTU, FragmentationThreshold 

               and RtsCtsThreshold

   - bug 959 - Simulation never finishes when using RealtimeSimulatorImpl

   - bug 960 - V4Ping does not generate checksum

   - bug 961 - Problem with MPI activation 

   - bug 964 - AODV does not work with host addressed interfaces

   - bug 965 - Problem building /src/core/callback.cc

   - bug 966 - AODV originates new RREQ on each packet, when doesn't have 

               valid route

   - bug 969 - No SocketList is present in UdpL4Protocol class

   - bug 971 - fix AODV header Print functions 

   - bug 972 - [flow monitor] assertion fails in pv4-flow-probe.cc

Known issues

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

Release 3.8

===========

Availability

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

This release is immediately available from:

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

Supported platforms

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

ns-3.8 has been tested on the following platforms:

  - linux x86 gcc 4.4.0, 4.3.2, 4.2, 4.1.1, 4.1 and 3.4.6 (debug and optimized)

  - linux x86_64 gcc 4.4.0, 4.3.2, 4.2.4, 4.2.3, 4.2.1, 4.1.3, 3.4.6 (debug and optimized)

  - MacOS X ppc gcc 4.0.x and 4.2.x (debug and optimized)

  - cygwin gcc 4.3.4 (debug and optimized)

Not all ns-3 options are available on all platforms; consult the

wiki for more information:

http://www.nsnam.org/wiki/index.php/Installation

New user-visible features

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

  a) WiMAX net device: Allow to simulated IEEE 802.16 point to multi-point based networks 

  b) Distributed simulation for point-to-point networks using the Message 

     Passing Interface (MPI) standard.

  c) Matrix propagation loss model uses a two-dimensional matrix of path loss indexed 

     by source and destination nodes.

  d) Topology read system: Allows quick and easy creation of large topologies by reading 

     Inet or Orbis files

  e) Gauss-Markov mobility model: Adds 3-d adaptation of Gauss-Markov mobility model which 

     has both memory and variability

  f) Steady-state random waypoint mobility model: Based on random waypoint mobility (RWM) model for case when 

     speed, pause and position are uniformly distributed random variables. However, initial values of these 

     parameters are not from uniform distribution but from stationary distribution of RWM model.

  g) Two-ray ground propagation loss model: Calculates the crossover distance under which Friis is used. 

     The antenna height is set to the nodes z coordinate, but can be added to using the model parameter 

     SetHeightAboveZ, which will affect ALL stations

API changes from ns-3.7

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

API changes for this release are documented in the file CHANGES.html. 

Bugs fixed

----------

The following lists many of the bugs that were fixed since ns-3.7, in

many cases referencing the Bugzilla bug number

   - bug 155 - std::ostream & os" parameters not Python friendly

   - bug 184 - GtkConfigStore do not support ConfigureDefault

   - bug 407 - OLSR is missing HNA support

   - bug 414 - No ReceiveErrorModel in SimpleNetDevice

   - bug 602 - WifiRemoteStation lacks information about the access class of outgoing packets

   - bug 622 - [PATCH] Friendly names for pcap traces

   - bug 683 - Helper methods for pcap tracing with explicit filenames

   - bug 706 - Backoff counting when starting NS.

   - bug 720 - TapBridge creation fails from a script outside the ns3 tree

   - bug 731 - Send function in point-to-point-net-device fails to check the return value of the Dequeue function

   - bug 747 - Listening TCP socket closes on RST

   - bug 748 - Cloned TCP socket uses wrong source address

   - bug 772 - AODV is unable to correctly buffer packets waiting for route reply

   - bug 777 - AODV ignores specified outgoing interface in RouteOutput()

   - bug 778 - OLSR ignores specified outgoing interface in RouteOutput()

   - bug 787 - Addition of Two Ray Ground model to propagation loss model and tests

   - bug 788 - OLSR_NEIGH_HOLD_TIME should be 3 times OLSR_REFRESH_INTERVAL 

   - bug 789 - [PATCH] Globalrouting externalroutes to use the new GetRootExitDirections()

   - bug 794 - Ipv4Mask constructor for "/yy"-notation is wrong

   - bug 796 - TCP bug in ns-3-dev branch : Crash detected during retesting of Chord on ns-3-dev branch

   - bug 797 - Enhancements to src/core/random-variable.cc/h

   - bug 801 - ns-3.7 and SVN not coexisting nicely

   - bug 802 - Minstrel algorithm causes segmentation fault

   - bug 804 - null-pointer references in 3.7 internet stack

   - bug 806 - TCP doesn't work over a CSMA link

   - bug 807 - ns2-mobility-helper.cc: node id parsed wrong

   - bug 809 - Missing Python binding for Ipv4GlobalRouting::GetRoute

   - bug 810 - In TCP, Socket::GetSockName() does not return the local socket address

   - bug 812 - Assert when getting socket in RecvReply for AODV

   - bug 813 - Nqos AP sends packet to non associated STA

   - bug 814 - Function logging causing assert in wireless examples

   - bug 815 - waf shell file descriptor leak

   - bug 816 - tap-creator deadlock when python bindings enabled

   - bug 817 - Pareto rng constructors using scale and shape instead of mean and shape

   - bug 818 - TCP Socket implementation does not set ACK flag on retransmits

   - bug 819 - Build break when gtk not installed

   - bug 820 - Bad things happen in test.py when logging is enabled

   - bug 821 - AODV asserts with function logging enabled

   - bug 822 - Move Mtu attribute from NetDevice base class to subclasses

   - bug 825 - UDP-Client-server's packet loss counter not properly reset

   - bug 828 - PacketSocket::Close does not unregister protocol handler

   - bug 829 - TCP unbound memory problem (pending data)

   - bug 833 - OnOffApplication with PacketSocket: sniffs all traffic

   - bug 834 - Incorrect signature of Ipv4FlowProbe::DropLogger

   - bug 835 - Unlimited receive queues in sockets == evil

   - bug 836 - Delay is incremented over time with BsUplinkSchedulerSimple and BsUplinkSchedulerRtps

   - bug 838 - ns-3 can't compile on MacOS with 32bit processor

   - bug 839 - TestSuite wimax-ss-mac-layer crashes on Darwin 9.8.0 Power Macintosh

   - bug 840 - BS scheduler does not support fragmentation for UGS flows

   - bug 841 - Multicast transmission breaks with QoS Wifi

   - bug 844 - YansWifiPhy::GetPowerDbm off-by-one problem when calculating Tx power

   - bug 847 - Segfaults on BaseStationNetDevice with OnOffApplication and rtPS sched

   - bug 849 - stray patch files in lwip directory

   - bug 850 - Ipv4GlobalRouting::LookupGlobal bug

   - bug 855 - waf dies badly when switching from debug to optimized build or vice versa

   - bug 856 - initialize vbl

   - bug 857 - Link-Local Multicast handle in Ipv4 Output processing 

   - bug 859 - Output interface estimation for the source address bound socket in IPv4 Raw socket

   - bug 860 - waf sometimes dies while executing ns3header or gen_ns3_module_header tasks in case of 

               parallel jobs

   - bug 862 - NotifyInterfaceUp() Adds network route even when netmask is /32

   - bug 863 - Wrong Scalar arithmetics

   - bug 864 - Invalid return value in UdpSocketImpl::Send and Ipv4RawSocketImpl::Send

   - bug 865 - Ipv4RawSocketImpl::RecvFrom does not return from address all the time.

   - bug 866 - WiMAX mobility models not aggregated to Node

   - bug 867 - Minor bug in Ipv4L3Protocol::Send()

   - bug 868 - invalid packet size after Ipv4L3Protocol::Send

   - bug 872 - ns3::PcapFileWrapper::Write explodes stack

   - bug 873 - Queue occupancy counter not decremented in WifiMacQueue::Remove()

   - bug 876 - Tcp socket does not handle ShutdownRecv correctly

   - bug 877 - python bindings broken with multiple inheritance ?

   - bug 880 - Node sending a packet to itself via 127.0.0.1 aborts

   - bug 885 - Error in Ascii tracing in Python examples

   - bug 888 - Writing ascii trace to addtional tests fails

   - bug 891 - WiMAX device helper does not include propagation loss model by default 

   - bug 894 - ./waf --run error message upon segfault

   - bug 895 - SimpleOfdmWimaxPhy SNR computation

   - bug 899 - EmuNetDevice::SetPromiscReceiveCallback not implemented

Known issues

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

ns-3 builds have been 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

Release 3.7

===========

Availability

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

This release is immediately available from:

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

Supported platforms

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

ns-3.7 has been tested on the following platforms: