RELEASE_NOTES
author Tom Henderson <tomh@tomh.org>
Wed, 17 Sep 2014 19:59:14 -0700
changeset 10959 9a397051f10a
parent 10946 7c58d21348f4
permissions -rw-r--r--
update VERSION to ns-3.21
     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 Consult the file CHANGES.html for more detailed information about changed
    10 API and behavior across ns-3 releases.
    11 
    12 Release 3.21
    13 ============
    14 
    15 Availability
    16 ------------
    17 This release is available from:
    18 http://www.nsnam.org/release/ns-allinone-3.21.tar.bz2
    19 
    20 Supported platforms
    21 -------------------
    22 - Fedora Core 20 (32/64 bit) with g++-4.8.2
    23 - Ubuntu 14.04 (32/64 bit) with g++-4.8.2
    24 - Ubuntu 12.04.4 (64 bit) with g++-4.6.3
    25 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
    26 - CentOS/RHEL 6.5 (64-bit) with g++-4.4.7
    27 - OS X Mavericks 10.9 with Xcode 5.1.1 and clang-503.0.40
    28 - FreeBSD 9.2-RELEASE (64 bit) with clang-3.3
    29 
    30 New user-visible features
    31 -------------------------
    32 
    33 - The LTE module now supports the transport of the S1-U, X2-U and X2-C
    34   interfaces over emulated links via the new helper class EmuEpcHelper.
    35 - CommandLine can now provide a shorthand argument name for any
    36   Attribute.
    37 - Implemented support for Frequency Reuse algorithms in LTE module, as the 
    38   outcome of GSoC 2014 project. 
    39   The project also includes several sub-features, such as:
    40    - implementation of Downlink Power Control
    41    - implementation of Uplink Power Control
    42    - new DL-CQI generation approach, which increases throughput if FR algorithms 
    43      are used
    44    - seven options of Frequency Reuse algorithms: LteFrNoOpAlgorithm, 
    45      LteFrHardAlgorithm, LteFrStrictAlgorithm, LteFrSoftAlgorithm, 
    46      LteFfrSoftAlgorithm, LteFfrEnhancedAlgorithm, LteFfrDistributedAlgorithm
    47    - updated RadioEnvironmentMapHelper. Now RadioEnvironmentMap can be generated 
    48      for Data or Control channel and for specified RbId, what is helpful when 
    49      using FR algorithms
    50 - Added a CoDel queue model.  CoDel queues measure and control the queue
    51   traversal delay.  The ns-3 implementation is a port of the Linux 
    52   implementation.
    53 - Added support for TCP timestamp and window scale options, and added
    54   ability to trace the TCP slow start threshold value.
    55 - SimpleNetDevice and SimpleChannel (used for adding basic link effects
    56   for testing of higher-layer protocols) have been extended to support 
    57   the option of broadcast or PointToPoint link semantics.  The bandwidth
    58   and link delay can be constrained, and it uses an output queue.
    59 - SimpleNetDevice and SimpleChannel can be installed in a node through 
    60   a new helper: SimpleNetDeviceHelper.
    61 - Implemented new PacketSocketServer and PacketSocketClient applications.
    62   The primary use is in tests, to avoid using the ones from the 
    63   application module that also bring in a dependency on the internet module.
    64   
    65 Bugs fixed
    66 ----------
    67 
    68 - Bug 1673 - Config::Set/Connect does not search for attributes in parent class
    69 - Bug 1762 - UE stuck in IDLE_CONNECTING because RRC CONN REQ is not transmitted
    70 - Bug 1811 - basic traffic generator for network module 
    71 - Bug 1824 - L4 protocol sockets should support BindToNetDevice over IPv6
    72 - Bug 1831 - TcpSocket SlowStartThreshold is not a TraceSource
    73 - Bug 1851 - WifiRadioEnergyModel energy consumption values are taken from a 802.15.4 chip
    74 - Bug 1854 - std::out_of_range Problem
    75 - Bug 1858 - wireless examples not correctly recording packet reception
    76 - Bug 1860 - TCP needs the Window Scale option
    77 - Bug 1893 - issue in DoSchedUlTriggerReq with harq
    78 - Bug 1911 - AODV cannot work on nodes with more than one netdevice
    79 - Bug 1921 - Icmpv6L4Protocol::ForgeEchoRequest returns a malformed packet
    80 - Bug 1930 - Use of invalid reference in OLSR RemoveLinkTuple
    81 - Bug 1932 - NdiscCache entry is not failsafe on double neighbor probing.
    82 - Bug 1937 - FlowMonitor fails to track multiplexed packets
    83 - Bug 1942 - refactoring of lte-sinr-chunk-processor -> lte-chunk-processor
    84 - Bug 1943 - Waveform generator signal duration calc error
    85 - Bug 1951 - AODV does not update nexthop for 1-hop nodes
    86 - Bug 1955 - The IPv4 identification field should be unique per (source, destination, protocol) tuple
    87 - Bug 1960 - Wrong information on index range, about Node::GetDevice
    88 - Bug 1961 - planetlab-tap-creator "variable set but not used"
    89 - Bug 1963 - AODV can tag the same packet twice (and raise an assert)
    90 - Bug 1964 - Integer overflow on UniformRandomVariable::GetInteger()
    91 - Bug 1967 - LL Multicast is not compressed in the right way in IPHC
    92 - Bug 1981 - PyViz shell not compatible with ipython >= 0.11
    93 
    94 Known issues
    95 ------------
    96 - Bug 1770 - The mesh module will crash if used for g++ version >= 4.8.1
    97 in optimized mode, on a 32-bit Linux machine.  Lowering the optimization
    98 level to -O1 in this case can be used as a workaround.
    99 
   100 Release 3.20
   101 =============
   102 
   103 Availability
   104 ------------
   105 This release is available from:
   106 http://www.nsnam.org/release/ns-allinone-3.20.tar.bz2
   107 
   108 Supported platforms
   109 -------------------
   110 - Fedora Core 20 (32/64 bit) with g++-4.8.2
   111 - Ubuntu 14.04 (32/64 bit) with g++-4.8.2
   112 - Ubuntu 12.04.4 (64 bit) with g++-4.6.3
   113 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   114 - CentOS/RHEL 6.5 (64-bit) with g++-4.4.7
   115 - OS X Mavericks 10.9 with Xcode 5.1.1 and clang-503.0.40
   116 - FreeBSD 9.2-RELEASE (64 bit) with clang-3.3
   117 
   118 New user-visible features
   119 -------------------------
   120 
   121 - A new LrWpan model, providing initial support for IEEE 802.15.4 networks
   122 - A new IPv6 routing protocol has been added: RIPng. This protocol is
   123   an Interior Gateway Protocol and it is available in the Internet module.
   124 - A new LTE MAC downlink scheduling algorithm named Channel and QoS Aware (CQA) 
   125   Scheduler is provided by the new ``ns3::CqaFfMacScheduler`` object.
   126 - The Internet FlowMonitor can now track IPv6 packets.
   127 - FlowMonitor no longer tracks multicast/broadcast packets, reflecting
   128   its original design.
   129 - FlowMonitor "SerializeToXml" functions are now directly available 
   130   from the helper.
   131 - The SixLowPan model can now use uncompressed IPv6 headers. An option to
   132   define the minimum compressed packet size has been added. 
   133 - Simplify output of Times in a specific unit; see Time::As ()
   134 - Ipv6Extension::m_dropTrace has been removed. Ipv6L3Protocol::m_dropTrace 
   135   is now fired when appropriate.
   136 - IPv4 identification field value is now dependent on the protocol field.
   137 - Fixes to support Python >= 3.3 in ns3 Python bindings
   138 - Enable selection of high precision int64x64_t implementation
   139   at configure time, for debugging purposes.
   140 
   141 Bugs fixed
   142 ----------
   143 - Bug 1276 - optimize NistErrorRateModel
   144 - Bug 1294 - New PeekU8 () and Read (Buffer::Iterator start, uint32_t size) methods in Buffer::Iterator
   145 - Bug 1443 - MinDistance replaced by MinLoss in FriisPropagationLossModel, to
   146   better handle conditions outside of the assumed far field region.
   147 - Bug 1653 - Extension of CommandLine interface: restored operator << (CommandLine)
   148 - Bug 1717 - Detect unsettable attributes
   149 - Bug 1730 - no model library documentation for spectrum module
   150 - Bug 1739 - The endpoint is not deallocated for UDP sockets
   151 - Bug 1786 - os << int64x64_t prints un-normalized fractional values
   152 - Bug 1787 - Runtime error when using AnimationInterface::EnablePacketMetadata() to fetch metadata of CSMA packet
   153 - Bug 1792 - Parameter logger constructor
   154 - Bug 1808 - FlowMon relies on IPv4's Identification field to trace packets
   155 - Bug 1817 - IPv4 Identification field should consider protocol as well.
   156 - Bug 1818 - FlowMonitor needs IPv6 support
   157 - Bug 1820 - models library doc: make should not rm -rf figures
   158 - Bug 1821 - Setting an interface to Down state will cause various asserts in IPv6
   159 - Bug 1829 - Multiple TCP socket entries
   160 - Bug 1837 - AODV crashes when using multiple interfaces
   161 - Bug 1838 - FlowMonitorHelper must not be copied.
   162 - Bug 1841 - FlowMonitor fails to install if IPv4 is not installed in the node
   163 - Bug 1842 - FlowMonitor SerializeToXml<Something> should be called by the helper
   164 - Bug 1843 - IPv6 extensions dropped packets do not fire L3 drop trace
   165 - Bug 1845 - FlowMonitor should discard any broadcast/multicast packet
   166 - Bug 1846 - IPv6 should send Destination Unreachable if no route is available
   167 - Bug 1850 - TCP NewReno loss behavior
   168 - Bug 1852 - cairo-wideint-private.h error cannot find definitions for fixed-width integral types
   169 - Bug 1853 - NS_LOG_FUNCTION broken on OSX 10.9
   170 - Bug 1855 - SixLowPanNetDevice is not correctly indexed
   171 - Bug 1857 - Detect location of installed boost libraries
   172 - Bug 1862 - NS_LOG="Time=*|prefix_time" causes stack overflow
   173 - Bug 1868 - Optimized builds are sensitive to -fstrict-overflow
   174 - Bug 1870 - Remove unnecessary AsInt functions
   175 - Bug 1872 - Inside RREQ processing, in case of IP duplication, packet dropped instead of being forwarded
   176 - Bug 1873 - Energy source checked to be aggregated to the node
   177 - Bug 1874 - Ipv4L3Protocol::ProcessFragment: addressCombination and idProto identifiers not properly computed
   178 - Bug 1876 - enable OLSR HNA table access
   179 - Bug 1877 - constructors missing for PropagationLossModels
   180 - Bug 1882 - int64x64 tests trigger valgrind bug
   181 - Bug 1883 - IPv6 don't consider the prefix and network when choosing output address
   182 - Bug 1885 - WifiSpectrumValue5MhzFactory::CreateRfFilter does not align with the used 5Mhz SpectrumModel
   183 - Bug 1887 - Point-to-point traces should contain PPP headers
   184 - Bug 1888 - COST231 propagation loss model: corrections
   185 - Bug 1889 - PointToPointNetDevice: In some cases MacTxDrop trace is not called
   186 - Bug 1890 - UdpClientTrace: MPEG frame size is squeezed into (insufficient) 16 bit integer
   187 - Bug 1891 - UdpSocketImpl::GetSockName doesn't return the IPv6 address
   188 - Bug 1894 - CqaFfMacScheduler needs an update
   189 - Bug 1895 - IP header Source Address changed while forwarding RREQ
   190 - Bug 1900 - Avoid floating point differences across platforms in test outputs
   191 - Bug 1903 - Namespace usage in olsr-state.cc/h
   192 - Bug 1907 - Add IsSupportedMcs method in YansWifiPhy
   193 - Bug 1912 - Avoid multiple Wifi MacTxMiddle instances
   194 - Bug 1913 - Avoid crash in Wifi BlockAckManager::GetNextPacket()
   195 - Bug 1915 - BRITE channel delay is rounded to an integer
   196 - Bug 1916 - RandomWalk2dMobilityMode default "Bounds" attribute is not a rectangle
   197 - Bug 1919 - Strip trailing semi-colons from mobility trace files
   198 - Bug 1920 - Remove DSR attributes so file can be re-loaded by config-store
   199 - Bug 1922 - WAVE GetSsid should not be fatal
   200 - Bug 1923 - Setting Active Probing to false in Wifi Sta has no effect
   201 - Bug 1924 - sensing radius and CCA
   202 
   203 Known issues
   204 ------------
   205 - Bug 1770 - The mesh module will crash if used for g++ version >= 4.8.1
   206 in optimized mode, on a 32-bit Linux machine.  Lowering the optimization
   207 level to -O1 in this case can be used as a workaround.
   208 
   209 Release 3.19
   210 =============
   211 
   212 Availability
   213 ------------
   214 This release is available from:
   215 http://www.nsnam.org/release/ns-allinone-3.19.tar.bz2
   216 
   217 Supported platforms
   218 -------------------
   219 These platforms have been tested; others may work also:
   220 - Fedora Core 20 (32 bit) with g++-4.8.2
   221 - Fedora Core 19 (32/64 bit) with g++-4.8.1
   222 - Ubuntu 13.10 (64 bit) with g++-4.8.1
   223 - Ubuntu 12.04.3 (32/64 bit) with g++-4.6.3
   224 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   225 - OS X Mavericks 10.9 with Xcode 5.0.1 and clang-500.2.79
   226 - OS X Mountain Lion 10.8.5 with Xcode 5 and g++-4.2.1
   227 - FreeBSD 9.2-RELEASE (64 bit) with clang-3.3
   228 
   229 New user-visible features
   230 -------------------------
   231 - Extension to UE measurements and improved handover algorithm models in LTE
   232   module, as the outcome of GSoC 2013 project. The project also includes several
   233   sub-features, such as:
   234    - implementation of System Information Block Type 1 (SIB1);
   235    - a new option for automatic UE attachment using Idle mode cell selection
   236      procedure;
   237    - improved configurability of UE measurements; and
   238    - two options of handover algorithms for enabling automatic handover trigger
   239      in LTE simulation: A2-A4-RSRQ and strongest cell (A3-RSRP).
   240 
   241 - A new FixedRoomPositionAllocator has been added to the buildings
   242   module. It allows one to generate a random position uniformly
   243   distributed in the volume of a chosen room inside a chosen building.  
   244 
   245 - A new attribute ns3::LteRlcAm::TxOpportunityForRetxAlwaysBigEnough
   246   allows to overcome the lack for re-segmentation in the RLC AM
   247   implementation by assuming that the size of a TxOpportunity is
   248   always big enough for the RLC AM PDU to be retransmitted.
   249 
   250 - After some profiling, the code of LteMiErrorModel has been optimized
   251   for speed, resulting in a significantly lower execution time of the
   252   LTE model when used with the error model enabled.
   253 
   254 - A new WiFi extension for vehicular simulation support is available in 
   255   the src/wave directory.  The current code represents an interim capability 
   256   to realize an IEEE 802.11p-compliant device, but without the WAVE 
   257   extensions (which are planned for a later patch).  The WaveNetDevice 
   258   modelled herein enforces that a WAVE-compliant physical layer (at 5.9 GHz)
   259   is selected, and does not require any association between devices (similar 
   260   to an adhoc WiFi MAC), but is otherwise similar (at this time) to a 
   261   WifiNetDevice.  WAVE capabililties of switching between control and 
   262   service channels, or using multiple radios, are not yet modelled.
   263 
   264 - A new IPv6 over Low power Wireless Personal Area Networks (6LoWPAN) model
   265   is available.  Using ns-3's naming convention, the acronym is expanded
   266   to SixLowPanNetDevice.   The SixLowPanNetDevice is able to act as a 
   267   shim between IPv6 and a NetDevice, compressing IPv6 headers according 
   268   to RFCs 4944 and 6262.  The SixLowPanNetDevice is meant to be used over 
   269   IEEE 802.15.4 NetDevices, but it can be used on other NetDevices as 
   270   well (see the manual for full details).  This model precedes the
   271   general availability of an 802.15.4 model, so must be run in conjunction
   272   with a wired NetDevice model for now, or with experimental versions of
   273   802.15.4 models.
   274 
   275 - It is now possible to use Ipv6PacketInfoTag from UDP applications in the
   276   same way as with Ipv4PacketInfoTag. See Doxygen for current limitations in
   277   using Ipv[4,6]PacketInfoTag to set IP properties.
   278   
   279 - Ipv[4,6]Interfaces not respecting the minimum MTU requirements (68 octects
   280   for IPv4 and 1280 octects for IPv6) will be automatically set as Down.
   281   
   282 - IPv6 addresses and routing tables are printed in a more conventional way,
   283   closely matching the Linux "route -A inet6" command.
   284 
   285 - Additional time units (Year, Day, Hour, Minute) were added to the time
   286   value class that represents simulation time; the largest unit prior to 
   287   this addition was Second.
   288 
   289 - A new parallel scheduling algorithm based on null messages, a common 
   290   parallel DES scheduling algorithm, has been added.  The null message 
   291   scheduler has better scaling properties when running on some scenarios
   292   with large numbers of nodes since it does not require a global 
   293   communication.
   294   
   295 Bugs fixed
   296 ----------
   297 - Bug 1496 - Option to print log level in NS_LOG messages, and documentation.
   298 - Bug 1592 - Parsing bug in FlowMonitor example script
   299 - Bug 1756 - RLC AM Mode State Variable Bug
   300 - Bug 1763 - Message 3 should be sent using the UL GRANT in the RAR
   301 - Bug 1778 - Implement TapBridge::IsLinkUp() function
   302 - Bug 1777 - Implement the more direct way of "using" configuration of existing tap interface
   303 - Bug 1776 - Improve CRC performance for CsmaNetDevice in emulation modes
   304 - Bug 1788 - unused private field warning
   305 - Bug 1789 - missing test condition for sigma in buildings-shadowing-test
   306 - Bug 1796 - Ipv6PacketInfoTag is not filled by UdpSocketImpl::ForwardUp6
   307 - Bug 1798 - Changing the rate of onOffApplication might stop transmission
   308 - Bug 1802 - FlowMon header deserialization problem with IPv4 fragments
   309 - Bug 1803 - Lookup /NodeList/4/DeviceList/0/LteEnbRrc/UeMap/0 got no matches
   310 - Bug 1807 - Multiple bugs in Ipv4L3Protocol::LocalDeliver
   311 - Bug 1810 - IP packets can be sent on NetDevices not respecting the minimum MTU requirements
   312 - Bug 1814 - IPv6 Packet with length not multiple of 8 bytes are fragmented incorrectly.
   313 - Bug 1815 - Python bindings compilation with clang compiler toolchain
   314 - Bug 1816 - IPv4 fragmentation loses Packet tags
   315 - Bug 1877 - constructor missing for <something>PropagationLossModels
   316 
   317 Release 3.18.2
   318 ==============
   319 
   320 ns-allinone-3.18.2 was released to include a bake configuration file update
   321 for Direct Code Execution.  The ns-3 code in this release was unchanged
   322 from that of ns-3.18.1.
   323 
   324 Release 3.18.1
   325 ==============
   326 
   327 This release is mainly to provide updated compiler support (clang/LLVM)
   328 and fix the Python API scanning facility.  A few additional bug fixes
   329 and new features are described below.
   330 
   331 Availability
   332 ------------
   333 This release is available from:
   334 http://www.nsnam.org/release/ns-allinone-3.18.1.tar.bz2
   335 
   336 Supported platforms
   337 -------------------
   338 These platforms have been tested; others may work also:
   339 - Fedora Core 19 (32/64 bit) with g++-4.8.1
   340 - Ubuntu 13.10 (64 bit) with g++-4.8.1
   341 - Ubuntu 12.04.3 (32/64 bit) with g++-4.6.3
   342 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   343 - OS X Mavericks 10.9 with Xcode 5.0.1 and clang-500.2.79
   344 - OS X Mountain Lion 10.8.5 with Xcode 5 and g++-4.2.1
   345 - FreeBSD 9.2-RELEASE (64 bit) with clang-3.3
   346 
   347 New user-visible features
   348 -------------------------
   349 - It is now possible to randomize the time of the first beacon from an 
   350   access point.  Use an attribute "EnableBeaconJitter" to enable/disable 
   351   this feature.
   352 - A new FixedRoomPositionAllocator helper class is available; it
   353   allows one to generate a random position uniformly distributed in the
   354   volume of a chosen room inside a chosen building.
   355 - Logging wildcards:  allow "***" as synonym for "*=**" to turn on all logging.
   356 - The log component list ("NS_LOG=print-list") is now printed alphabetically.
   357 
   358 Bugs fixed
   359 ----------
   360 - Bug 1779 - NS_UNUSED_GLOBAL not working in attribute test class declaration
   361 - Bug 1766 - Fixes to wifi-hidden-terminal.cc example
   362 - Bug 1722 - Avoid transmitting beacons concurrently
   363 - Bug 1691 - RTS/CTS NAV reset prematurely
   364 - Bug 1622 - Avoid waf hanging during apiscan
   365 - Bug 1616 - WifiPhyStateHelper reports false CCA_BUSY times at State trace source
   366 - Bug 1552 - Storing log name inside LogComponent class (NS_LOG) as std::string
   367 - Bug 1011 - assert failed. file=../src/devices/wifi/dcf-manager.cc
   368 - bug 945 - remove deprecated IEEE 802.11p code from wifi module
   369 - Fix aliasing bug in optimized static builds
   370 - Fix memory leak due to circular reference in MPI module
   371 - Make wifi tests more robust to random variable perturbations
   372 - Fix Time class doxygen
   373 - Fix compilation with Clang 3.2 and newer versions, including Apple Xcode 5
   374 - Miscellaneous NetAnim fixes
   375 
   376 Release 3.18
   377 =============
   378 
   379 Availability
   380 ------------
   381 This release is available from: 
   382 http://www.nsnam.org/release/ns-allinone-3.18.tar.bz2
   383 
   384 Supported platforms
   385 -------------------
   386 These platforms have been tested; others may work also:
   387 - Fedora Core 18 (32/64 bit) with g++-4.7.2
   388 - Fedora Core 17 (32/64 bit) with g++-4.7.0
   389 - Ubuntu 13.04 (32/64 bit) with g++-4.7.3
   390 - Ubuntu 12.04 (32/64 bit) with g++-4.6.3
   391 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   392 - OS X Mountain Lion 10.8.3 with g++-4.2.1
   393 - FreeBSD 9.1-RELEASE (64 bit) with g++-4.2.1
   394 
   395 New user-visible features
   396 -------------------------
   397 - Time attributes can now be bounded.  See attribute-test-suite.cc for an
   398   example.
   399 - Data collection components have been added to the stats module.  These
   400   components can be used to generate time series data in files and plots.
   401 - IPv6 address class 2001:db8::/32 is now dropped by routers (RFC 3849).
   402 - New generic hash function interface.  Two hash functions are provided:
   403   murmur3 (default), and the venerable FNV1a.  See the Hash Functions
   404   section in the Manual.
   405 - New Mac16Address has been added, Mac64Address is now in-line with 
   406   Mac48Address and all the three can be used in IPv6 autoconfigure. 
   407 - Previously, the use of Building models was limited to the use of the
   408   companion BuildingsMobilityModel. Now, any MobilityModel can be
   409   used with Building models. 
   410 - The latest LTE module code by the LENA project has been merged,
   411   including the following new features: 
   412    - PHY support for UE measurements (RSRP and RSRQ)
   413    - RRC support for UE measurements (configuration, execution, reporting)
   414    - Automatic Handover trigger based on RRC UE measurement reports
   415 - IPv6 can now detect and use Path-MTU. See 
   416   examples/ipv6/fragmentation-ipv6-two-MTU.cc for an example.
   417 - Radvd application have a new Helper. See the updated 
   418   examples/ipv6/radvd.cc for an example.
   419 - 11n- It is now possible to create a high throughput (HT) node that used the new 11n data rates and preambles.
   420 - It is now possible to request printing command line arguments to the
   421   desired output stream using PrintHelp or operator <<
   422 
   423 Bugs fixed
   424 ----------
   425 - Bug  760 - IP address removal can be painful
   426 - Bug 1190 - Suppress hello if bcast was sent within the last hello interval
   427 - Bug 1296 - Enhancement in Ipv[4,6]RoutingHelper
   428 - Bug 1390 - ICMPv6 Redirect are handled correctly only for /64 networks
   429 - Bug 1522 - Hidden node scenario leads to ARP failure
   430 - Bug 1584 - Old Association Request Timeouts are not canceled
   431 - Bug 1629 - Make AODV Default to Disable Hello
   432 - Bug 1643 - NdiscCache creation and existence checks
   433 - Bug 1646 - ICMPv6 Redirect are sent from global address instead of link-local
   434 - Bug 1662 - m_type not set for Ipv6OptionRouterAlertHeader
   435 - Bug 1678 - C++11 compliance problem with std::pair"
   436 - Bug 1682 - ./waf crashes on FC10
   437 - Bug 1683 - IPv6 autoconfigured don't use *infinite* lifetimes
   438 - Bug 1669 - ns-3 should support binding two and three (possibly more) arguments
   439 - Bug 1675 - Throughput computation error in Wireless examples
   440 - Bug 1687 - wscript features report doesn't respect NOCOLOR
   441 - Bug 1688 - Routers should advertise themselves from the link-local address
   442 - Bug 1689 - IPv6 shouldn't add a default gateway without checking the Router lifetime
   443 - Bug 1690 - missing header files from wifi wscript
   444 - Bug 1697 - ICMPv6 Redirect trigger contains multiple bugs
   445 - Bug 1698 - mobility.SetPositionAllocator misses prefix "ns3::"
   446 - Bug 1700 - Ipv6RawSocket does not honor the bound address when sending packets
   447 - Bug 1701 - Ipv6StaticRouting: the source address should match the destination scope
   448 - Bug 1702 - Ipv6InterfaceContainer::SetRouter should not always add the router as the default router.
   449 - Bug 1703 - Nodes don't react to a DAD
   450 - Bug 1712 - The IP (v4 and v6) forwarding needs a test
   451 - Bug 1718 - Ipv4StaticRouting log component is misspelled
   452 - Bug 1720 - IPv6 Fragmentation cause crashes
   453 - Bug 1721 - Path MTU isn't handled properly
   454 - Bug 1723 - name clash in ipv4-header.h with <termios.h>
   455 - Bug 1727 - Ping6 should use a proper source address
   456 - Bug 1728 - Radvd application is missing an Helper
   457 - Bug 1731 - lte-phy-error-model passes unexpectedly
   458 - Bug 1738 - strict aliasing compiler bug
   459 - Bug 1742 - IPv6 HbH and Dst Extension Header size is not correctly calculated
   460 - Bug 1752 - RadvdInterface m_defaultLifeTime is set to milliseconds instead of seconds
   461 - Bug 1753 - Halting Issue with DistributedSimulatorImpl
   462 - Bug 1754 - Missing GIL lock in generated callback destructor
   463 
   464 Known issues
   465 ------------
   466 In general, known issues are tracked on the project tracker available
   467 at http://www.nsnam.org/bugzilla/
   468 
   469 Release 3.17
   470 ============
   471 
   472 Availability
   473 ------------
   474 This release is available from: 
   475 http://www.nsnam.org/release/ns-allinone-3.17.tar.bz2
   476 
   477 Supported platforms
   478 -------------------
   479 These platforms have been tested; others may work also:
   480 - Fedora Core 18 (32/64 bit) with g++-4.7.2
   481 - Fedora Core 17 (32/64 bit) with g++-4.7.0
   482 - Ubuntu 13.04 (32/64 bit) with g++-4.7.3
   483 - Ubuntu 12.10 (32/64 bit) with g++-4.6.3
   484 - Ubuntu 12.04 (32/64 bit) with g++-4.6.3
   485 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   486 - OS X Mountain Lion 10.8.3 with g++-4.2.1
   487 - FreeBSD 9.1-RELEASE (64 bit) with g++-4.2.1
   488 
   489 New user-visible features
   490 -------------------------
   491 - new TCP Westwood and Westwood+ models
   492 - new FdNetDevice model and associated helpers.  The FdNetDevice is able
   493   to read and write from a file descriptor.  Various helpers are provided
   494   to associate this descriptor with underlying devices or sockets on the 
   495   host operating system, including a packet socket for emulation, and
   496   tap devices including a version specialized for use on PlanetLab.
   497 - ns-3-click: it's now possible to (i) have Click pull random numbers from
   498   ns-3 and (ii) have ns-3 set "defines" in Click via the simulation file 
   499   (see src/click/examples/nsclick-defines.cc).
   500 - Waf shipped with ns-3 has been upgraded to version 1.7.10 and custom
   501   pkg-config generator has been replaced by Waf's builtin tool.
   502 - create-module.py script has been updated to work with waf 1.7 and support
   503   for creating modules with names containing dashes has been added.
   504 - the M5 release of the LTE module by the LENA project has been
   505   merged; please see src/lte/RELEASE_NOTES for more detailed info 
   506 
   507 Bugs fixed
   508 ----------
   509 - bug 1256 - Unnecessary SND.NXT advance, missing ACK for Out of Order segments
   510 - bug 1318 - Ipv6L3Protocol::LocalDeliver can get stuck in an infinte loop
   511 - bug 1409 - Add an attribute "SystemId" to configure the ID for MPI
   512 - bug 1421 - Frequency dependent propagation loss models need uniform Frequency / Lambda attribute
   513 - bug 1434 - DSR throughput not comparable to other protocols for manet example
   514 - bug 1502 - Shutdown on tcp socket seems to misbehave
   515 - bug 1503 - BlockAckManager infine loop
   516 - bug 1517 - Waf clean/distclean doesn't remove the doc/html directory
   517 - bug 1540 - Waf not finding click libraries
   518 - bug 1549 - Test for NS_LOG
   519 - bug 1556 - Uses of htonl making OpenFlow's match field error
   520 - bug 1563 - Reduce valgrind test scope
   521 - bug 1564 - Packet meta data isn't shown in dumbbell-animation.xml
   522 - bug 1566 - WiFi SNR tag improvements
   523 - bug 1568 - Deserialized addresses are implicity marked as Mac48Address
   524 - bug 1569 - droptail_vs_red example doesn't run
   525 - bug 1570 - Valgrind errors in new test examples
   526 - bug 1574 - Node color overwritten, by mobility updates in netanim
   527 - bug 1575 - Invert the y-axis in netanim
   528 - bug 1576 - Frequency units HERTZ and MEGAHERTZ mix up
   529 - bug 1577 - Typo in ascii picture in example aodv script
   530 - bug 1579 - edca-txop-n fragmentation causes segfault
   531 - bug 1582 - IPv6 raw socket return value is not like Linux socket
   532 - bug 1585 - Length field of A-MSDU subframe header endianness
   533 - bug 1586 - Building documentation fails if make runs in parallel
   534 - bug 1588 - UdpEchoServer::HandleRead logs fail when using Ipv6
   535 - bug 1589 - Bake - support pre-2.7 version of python
   536 - bug 1590 - Bake - more autotools version support
   537 - bug 1595 - Function declarations without implementations cause problems with dsr module's python bindings
   538 - bug 1596 - Inet TopologyReader is skipping one link and duplicating another one
   539 - bug 1600 - Icmpv6OptionLinkLayerAddress can only carry 48 bit addresses correctly
   540 - bug 1601 - RttEstimator doesn't set the m_currentEstimatedRtt to m_initialEstimatedRtt on creation
   541 - bug 1602 - waf build can break due to file collisions in higher-level directory
   542 - bug 1603 - random-variable-stream-helper - this unavalable for static member functions
   543 - bug 1607 - OnOffApplication over TCP with IPv6 support
   544 - bug 1608 - DSR Network ACK is not handled correctly
   545 - bug 1609 - Route Request table is needed
   546 - bug 1612 - pyviz (visualizer) will not be installed
   547 - bug 1613 - Can't build ns-3-dev with g++ 4.7.2
   548 - bug 1615 - Adjusting OLSR HelloInterval Attribute results in no links
   549 - bug 1618 - bake.py not detecting install of libxml2-dev on ubuntu
   550 - bug 1623 - pybindgen rev809 is not able to build after Ubuntu 1210
   551 - bug 1625 - ns-3-dev fails to build on Debian wheezy amd64
   552 - bug 1626 - ipv6-only network can't use UDP or TCP
   553 - bug 1632 - Prepend bake build directory to the guessed locations
   554              that waf will look to find libraries
   555 - bug 1633 - Bake - should not report that it is downloading qt4 when it is already installed
   556 - bug 1635 - Small bug without Simulator::Destroy()
   557 - bug 1636 - Compilation error flagged as unmet dependency
   558 - bug 1637 - Bake calling apt-get for unpriviledged user
   559 - bug 1639 - bake.py support for linux mint
   560 - bug 1640 - bake needs to test for g++
   561 - bug 1641 - bake reports autotools dependency, but needs automake
   562 - bug 1661 - Variable ub1 defined but not used in ipv6-address.cc
   563 
   564 Known issues
   565 ------------
   566 In general, known issues are tracked on the project tracker available
   567 at http://www.nsnam.org/bugzilla/
   568 
   569 Release 3.16
   570 ============
   571 
   572 Availability
   573 ------------
   574 This release is available from: 
   575 http://www.nsnam.org/release/ns-allinone-3.16.tar.bz2
   576 
   577 Supported platforms
   578 -------------------
   579 - Fedora Core 17 (32/64 bit) with g++-4.7.0
   580 - Fedora Core 15 (64 bit) with g++-4.6.3
   581 - Ubuntu 12.10 (32/64 bit) with g++-4.6.3
   582 - Ubuntu 12.04 (32/64 bit) with g++-4.6.3
   583 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   584 - OS X Mountain Lion 10.8.3 with g++-4.2.1
   585 - FreeBSD 8.2 (32 bit) with g++-4.2.1
   586 - Cygwin 1.7.9-1 with g++-4.5.3
   587 
   588 New user-visible features
   589 -------------------------
   590 - Support several new LTE MAC schedulers developed in GSoC 2012 project. 
   591   Those schedulers include FD-MT, TD-MT, TTA, FD-BET, TD-BET, FD-TBFQ,
   592   TD-TBFQ, PSS. Here, FD and TD mean frequency domain and time domain 
   593   respectively.
   594 - It's now possible to use distcc when building ns-3 by using
   595   $ CXX='distcc g++' ./waf configure
   596   $ ./waf build
   597 - Support topology generation with the (external) BRITE topology generation 
   598   tool
   599 
   600 Bugs fixed
   601 ----------
   602 - bug  555 - DCF immediate access
   603 - bug  976 - wifi-wired-bridging regression test fails because of 
   604              rounding errors in mobility model
   605 - bug 1055:  Wrong UAN's Thorp absorption loss model formula
   606 - bug 1284 - ./test.py performance tests do not exist
   607 - bug 1324 - ns3tcp-cwnd-test-suite.cc test failing
   608 - bug 1340 - ns3tcp-loss-suite.cc tests failing
   609 - bug 1342 - ns3tcp-cwnd-test-suite.cc tests failing
   610 - bug 1345 - ns-3 builds with clang compiler >= 3.0
   611 - bug 1359 - TCP cannot receive ICMP
   612 - bug 1361 - Set TOS from Application level (sockets)
   613 - bug 1463 - ./test.py --example should automatically detect the path
   614 - bug 1479 - When the Ipv4RawSocket "IpHeaderInclude" Attribute set true,
   615              Ip Checksum error
   616 - bug 1485 - Setting global properties in config file (raw text) does
   617              not have any effect
   618 - bug 1493 - test.py --list should show the test type default tip
   619 - bug 1493 - test.py --list should show the test type 
   620 - bug 1494 - test.py --constrain doesn't work
   621 - bug 1495 - test.py claims test passed when no test was run
   622 - bug 1506:  TCP data segment piggybacking acknowledgment
   623 - bug 1509 - RttEstimator returns invalid value in presence of errors
   624 - bug 1516 - GtkConfigStore does not show read-only attributes
   625 - bug 1520 - Config paths not fully documented (partial fix)
   626 - bug 1524 - Fragmentation Threshold equals to Packet Size at MAC Layer 
   627              (Data + IP + UDP) crash the reception
   628 - bug 1525 - Linker error with mpi on Mac 10.8
   629 - bug 1526:  Wrong calculation of pathloss within 
   630              UanPropModelThorp::GetPathLossDb
   631 - bug 1527 - Ipv4RawSocket's BindToNetDevice not working
   632 - bug 1528 - BindToNetDevice not working for IPv6 sockets
   633 - bug 1531 - Crash when using NS_LOG in destructors of static objects
   634 - bug 1532 - unimplemented LTE Scheduler methods
   635 
   636 Known issues
   637 ------------
   638 In general, known issues are tracked on the project tracker available
   639 at http://www.nsnam.org/bugzilla/
   640 
   641 Release 3.15
   642 ============
   643 
   644 Availability
   645 ------------
   646 This release is available from: 
   647 http://www.nsnam.org/release/ns-allinone-3.15.tar.bz2
   648 
   649 Supported platforms
   650 -------------------
   651 - Fedora Core 17 (32/64 bit) with g++-4.7.0
   652 - Fedora Core 15 (64 bit) with g++-4.6.3
   653 - Ubuntu 12.04 (32/64 bit) with g++-4.6.3
   654 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   655 - OS X Mountain Lion 10.7.4 with g++-4.2.1
   656 - OS X Snow Leopard 10.6.8 with g++-4.2.1 
   657 - FreeBSD 8.2 (32 bit) with g++-4.2.1
   658 - Cygwin 1.7.9-1 with g++-4.5.3
   659 
   660 New user-visible features
   661 -------------------------
   662 - A new random variable base class called 'RandomVariableStream', has been
   663   introduced.  This base class derives from ns3::Object, unlike the current 
   664   'RandomVariable' class which is a special type of object in the ns-3 
   665   system to date.  By making this class derive from ns3::Object, it can be 
   666   handled with the Ptr class, can carry attributes, and can have its parameters
   667   and initial state saved in the config-store subsystem.  A new attribute
   668   called "Stream" has been introduced for this class, to allow users to
   669   better control the assignment of underlying pseudo-random sequences to
   670   the RandomVariableStream objects (bug 101).
   671 
   672 Bugs fixed
   673 ----------
   674  - bug 101 - random variable initialization
   675  - bug 1256 - Unnecessary SND.NXT advance, missing ACK for Out of Order segments
   676  - bug 1308 - Nix-vector; do not process packets to self
   677  - bug 1386 - assert if PositionAllocator not provided to 
   678               RandomWaypointMobilityModel
   679  - bug 1399 - TCP not backing off retransmissions properly
   680  - bug 1441 - IPv4 header length handling
   681  - bug 1464 - ConfigStore Save + Load => Could not set default value 
   682                   for ns3::UdpSocketImpl::IcmpCallback
   683  - bug 1470 - define default parameter for constructor in .h file
   684  - bug 1473 - GetQueue/SetQueue missing from Csma python bindings
   685  - bug 1475 - "test.py --list" should sort the output
   686  - bug 1476 - TestCase::GetName () should not be private
   687  - bug 1477 - Click doesn't work with raw sockets
   688  - bug 1481 - Openflow example doesn't run
   689  - bug 1486 - Segfaults in nix-vector-routing with bridges
   690  - bug 1489 - Jakes Log component is missing
   691  - fixed bug with multiple LCs in UL BSR
   692  - fixed bug with lena-dual-stripe crashes with --homeUesHomeEnbRatio=2
   693 
   694 Known issues
   695 ------------
   696 In general, known issues are tracked on the project tracker available
   697 at http://www.nsnam.org/bugzilla/
   698 
   699 Release 3.14.1
   700 ==============
   701 
   702 Availability
   703 ------------
   704 This release is available from:
   705 http://www.nsnam.org/release/ns-allinone-3.14.1.tar.bz2
   706 
   707 Bugs fixed
   708 ----------
   709 This hotfix release contains a fix for the PyViz visualizer and makes it
   710 easier to add PyViz support to examples; otherwise it is the same as the
   711 ns-3.14 release.
   712 
   713 Release 3.14
   714 ============
   715 
   716 Availability
   717 ------------
   718 This release is available from: 
   719 http://www.nsnam.org/release/ns-allinone-3.14.tar.bz2
   720 
   721 Supported platforms
   722 -------------------
   723 ns-3.14 has been tested on the following platforms.  Not all features are
   724 available on all platforms; check the Installation page on the project wiki.
   725 
   726 - Fedora Core 17 (32/64 bit) with g++-4.7.0
   727 - Fedora Core 16 (32/64 bit) with g++-4.6.3
   728 - Fedora Core 15 (64 bit) with g++-4.6.3
   729 - Ubuntu 12.04 (32/64 bit) with g++-4.6.3
   730 - Ubuntu 11.10 (32 bit) with g++-4.6.1
   731 - Ubuntu 10.04.4 LTS (64 bit) with g++-4.4.3
   732 - OS X Lion 10.7.4 with g++-4.2.1
   733 - OS X Snow Leopard 10.6.8 with g++-4.2.1 
   734 - FreeBSD 8.2 (32 bit) with g++-4.2.1
   735 - Cygwin 1.7.9-1 with g++-4.5.3
   736 
   737 New user-visible features
   738 -------------------------
   739 - Transport protocol implementations (TCP, UDP) have been refactored to
   740   support also IPv6 connections. Dual-stacked IPv6 sockets are implemented. 
   741   An IPv6 socket can accept an IPv4 connection, returning the sender's 
   742   address as an IPv4-mapped address (IPV6_V6ONLY socket option is not 
   743   implemented).
   744 - The LTE code from the LENA project has been merged, bringing in a
   745   significant redesign of the LTE module as well as many new features.
   746 - An antenna module is now included, which includes different
   747   radiation pattern models. See the corresponding new section of the
   748   ns-3 models library documentation for details.
   749 - A new buildings module is introduced which allows to model the
   750   presence of buildings in a wireless network topology.  
   751 - New propagation models (OkumuraHata, ITU-R P.1411, ITU-R P.1238)
   752   have been added
   753 - The Dynamic Source Routing (DSR) MANET routing protocol for IPv4 was added.
   754 - A Random Early Detection (RED) queue model has been added.
   755 - Ipv6RoutingHelper is now in-line with Ipv4RoutingHelper concerning the RT 
   756   print functions. Various minor changes were made in Ipv6RoutingProtocol and 
   757   derived classes to make this possible.
   758 - New "SendIcmpv6Redirect" attribute (and getter/setter functions) to 
   759   Ipv6L3Protocol. The behavior is similar to Linux's conf "send_redirects",
   760   i.e., enable/disable the ICMPv6 Redirect sending.
   761 - Longer and more descriptive names are used for error units in RateErrorModel
   762   class and queue mode in Queue class. Attributes in those classes are also
   763   changed for consistency. See API documentation for details.
   764 - The netanim animator is now bundled with the release.
   765 
   766 Bugs fixed
   767 ----------
   768  - bug 603 - Simulator::Next is useless
   769  - bug 631 - RealtimeSimulatorImpl does not handle Ctrl-C with python bindings
   770  - bug 962 - list of paths to reach objects contains bogus entries
   771  - bug 1000 - Make RealtimeSimulatorImpl last until stop
   772  - bug 1053 - Need better error diagnostics in ns2-mobility-trace example
   773  - bug 1109 - Point out the effects of ArpCache::PendingQueueSize
   774  - bug 1179 - Add LTE trace hooks for supporting visualizer
   775  - bug 1180 - LTE: Add TX/RX trace support
   776  - bug 1273 - Better error message on missing Python development files
   777  - bug 1282 - Sleep state and CCA
   778  - bug 1283 - PacketSocket::SendTo should return number of bytes 
   779  - bug 1302 - Flow monitor bug
   780  - bug 1304 - Tag information changed after transmission
   781  - bug 1313 - Stddev (average.h) returning NaN
   782  - bug 1318 - Asserts for IPv6 malformed packets
   783  - bug 1319 - Fix Ipv6RawSocketImpl Icmpv6 filter
   784  - bug 1325 - Python examples get valgrind errors when build subdirectories 
   785               are specified in waf
   786  - bug 1339 - test.py uses the old name for the test runner
   787  - bug 1348 - python bindings: deprecated conversion from string constant 
   788               to ‘char*’
   789  - bug 1349 - TypeId.LookupAttributeByName Python bindings missing
   790  - bug 1350 - Simulator.ScheduleWithContext Python binding missing
   791  - bug 1351 and 1333 - TCP not able to take RTT samples on long delay network
   792  - bug 1352 - Fixed MapAttributes, previously was mapped to a vector in 
   793               ObjectPtrContainer and (and key information was dropped). 
   794               Now the container is a map.
   795  - bug 1354 - Building scratch subdir programs is broken
   796  - bug 1355 - Visualizer dependencies not detected at buildtime
   797  - bug 1357 - IPv6 fragmentation fails due to checks about malformed extensions
   798  - bug 1362 - ICMPv6 does not forward ICMPs to upper layers (and minor 
   799               fixes to ICMPv6)
   800  - bug 1376 - wrong wind variable's name
   801  - bug 1378 - UdpEchoClient::SetFill () does not set packet size correctly
   802  - bug 1379 - lte-multiple-flows example crashes
   803  - bug 1380 - lte-phy-uplink example crashes
   804  - bug 1391 - .ns3rc does not allow comments as expected
   805  - bug 1392 - Modules built report does not clarify C++ or Python
   806  - bug 1393 - IPv6 Routing Helper RT Print functions
   807  - bug 1395 - AODV DeferredRouteOutputTag missing constructor
   808  - bug 1396 - ARP with hardware addresses longer than 6 bytes
   809  - bug 1399 - TCP not backing off retransmissions properly
   810  - bug 1404 - Bound user input in tutorial third.cc program
   811  - bug 1406 - waf exits with maximum recursion depth exceeded 
   812  - bug 1415 - examples-to-run.py doesn't work with command line arguments
   813  - bug 1420 - no python bindings for csma-layout
   814  - bug 1441 - IPv4 header length handling
   815  
   816 Known issues
   817 ------------
   818 In general, known issues are tracked on the project tracker available
   819 at http://www.nsnam.org/bugzilla/
   820 
   821 Release 3.13
   822 ==============
   823 
   824 Availability
   825 ------------
   826 This release is available from: 
   827 http://www.nsnam.org/release/ns-allinone-3.13.tar.bz2
   828 
   829 Supported platforms
   830 -------------------
   831 ns-3.13 has been tested on the following platforms.  Not all features are
   832 available on all platforms; check the Installation page on the project wiki.
   833 
   834 - Ubuntu 11.10 (32 bit) with g++-4.5.2
   835 - Ubuntu 11.04 (32/64 bit) with g++-4.5.2 
   836 - Ubuntu 10.04.3 LTS (64 bit) with g++-4.4.3, g++-3.4.6 
   837 - OS X Lion with g++-4.2.1
   838 - OS X Snow Leopard with g++-4.2.1 
   839 - Fedora Core 16 (32/64 bit) with g++-4.6.2
   840   --  however, g++-3.4.6 fails on Fedora 16 i686 
   841 - Fedora Core 14 (64 bit) with g++-4.5.1
   842 - FreeBSD 9.0-RC1 (AMD64) with g++-4.2.1
   843 
   844 New user-visible features
   845 -------------------------
   846 - IPv6 address generator with support for duplicate address detection
   847 
   848 Bugs fixed
   849 ----------
   850  - bug 962 - list of paths to reach objects contains bogus entries
   851  - bug 1001 - Buffer::CopyData() doesn't return the number of bytes copied
   852  - bug 1010 - Uan model sleep patch
   853  - bug 1020 - Wrong usage of the originator sequence number in HWMP PREP
   854  - bug 1021 - Beacon collision avoidance in Mesh module works incorrectly
   855  - bug 1039 - Nagle's algorithm in TCP 
   856  - bug 1055 - Wrong UAN's Thorp absorption loss model formula
   857  - bug 1059 - Unable to load trace files created from SUMO and TraNS Lite
   858  - bug 1112 - Advance m_nextTxSequence upon retransmit after RTO 
   859  - bug 1137 - mpi module is hard-coded for openmpi
   860  - bug 1166 - IPV4 TCP failed to send a RST when connect arrives before listen
   861  - bug 1186 - Ipv4Header lacks DSCP and ECN
   862  - bug 1204 - Can't Parse Time +100000000.0ns
   863  - bug 1219 - Coding style of ns2-mobility-helper-test-suite.cc is fixed
   864  - bug 1257 - waf install __init__ Python files even with --disable-python
   865  - bug 1263 - waf configure fails on FreeBSD 9.0-BETA2 amd64
   866  - bug 1266 - gdb cannot be loaded
   867  - bug 1227 - Spurious RTO due to low min RTO
   868  - bug 1229 - Multiplication overflow in WaypointMobilityModel::EndMobility
   869  - bug 1242 - m_lastRtt in tcp-socket-base.cc not implemented
   870  - bug 1256 - TCP unnecessary snd.nxt advance
   871  - bug 1265 - Make ns-3 directory "movable"
   872  - bug 1269 - sqlite3 not found on FreeBSD
   873  - bug 1270 - "Checking boost includes" weirdness
   874  - bug 1278 - Ipv4ClickRouting::HandleScheduleFromClick bug
   875  - bug 1281 - Checksum not calculated when doing IP fragmentation
   876  - bug 1285 - IPv6 Localhost is marked as GLOBAL instead of HOST
   877  - bug 1290 - buffer-test.cc gets a valgrind error
   878  - bug 1295 - Missing const qualifiers in TopologyRead 
   879  - bug 1299 - EnableAsciiIpv4All tracing doesn't show transmitted/recvd packets
   880  - bug 1300 - HalfDuplexIdealPhy notify SpectrumInterference of AbortRx 
   881  - bug 1301 - Ns2MobilityHelper causes Node GetPosition() to return NaN
   882  - bug 1305 - do not list modules built upon exiting waf shell
   883  - bug 1312: TopologyRead Assert condition fix
   884  - IPv4 packets double fragmentation was broken 
   885  - Fix wifi-clear-channel-cmu.cc example
   886  - NetAnim: fix for bcast packet reuse
   887  - Missing PropagationLossModel.CalcRxPower in Python bindings
   888  - Corrected compilation behavior in Ubuntu 11.10 due to ldd behavior change
   889  - Added required PTHREAD dependency to RT library check.
   890 
   891 Known issues
   892 ------------
   893 In general, known issues are tracked on the project tracker available
   894 at http://www.nsnam.org/bugzilla/
   895 
   896 Release 3.12.1
   897 ==============
   898 
   899 Availability
   900 ------------
   901 This release is available from: 
   902 http://www.nsnam.org/release/ns-allinone-3.12.1.tar.bz2
   903 
   904 Bugs fixed
   905 ----------
   906 This release fixes PyViz visualizer's python bindings; otherwise, it
   907 is the same as the ns-3.12 release.
   908 
   909 Release 3.12
   910 ===========
   911 
   912 Availability
   913 ------------
   914 This release is available from: 
   915 http://www.nsnam.org/release/ns-allinone-3.12.tar.bz2
   916 
   917 Supported platforms
   918 -------------------
   919 ns-3.12 has been tested on the following platforms.  Not all features are
   920 available on all platforms; check the Installation page on the project wiki.
   921 
   922 - Fedora Core 15 (32/64 bit) with g++-4.6.0 
   923 - Ubuntu 11.04 (32/64 bit) with g++-4.5.2 
   924 - OS X Lion with g++-4.2.1 
   925 - Fedora Core 14 (64 bit) with g++-4.3.4, g++-4.5.3, g++-4.4.6 
   926 - Fedora Core 12 (64 bit) with g++-4.4.4 
   927 - OS X Snow Leopard with g++-4.2.1 
   928 - Ubuntu 10.04.3 LTS (64 bit) with g++-4.4.3, g++-3.4.6 
   929 
   930 New user-visible features
   931 -------------------------
   932 
   933 - SpectrumChannel models now support the usage of single-frequency
   934   propagation loss models based on the PropagationLossModel
   935   class. These model can be used in conjunction with
   936   the frequency-dependent propagation loss model based on the
   937   SpectrumPropagationLossModel class already supported by
   938   SpectrumChannel. 
   939 
   940 - Extend the attribute system extend the attribute system to store map
   941   container objects in addition to vector containers.  The ObjectMap
   942   and related classes are patterned after ObjectVector.
   943 
   944 - Support for IPv4 fragmentation has been added.
   945 
   946 - Significant performance improvement for AODV in dense mobile scenarios
   947   due to a fixed bug in RERR processing.
   948 
   949 - WiFi traces that were named promiscuous are now renamed monitor, and
   950   a separate flag for setting the interface to promiscuous mode has been
   951   introduced.  This disambiguates monitor mode from promiscuous mode.
   952 
   953 - Monolithic Python bindings have been removed
   954 
   955 Bugs fixed
   956 ----------
   957  - bug 845  - fix ConfigStore output for changing default values
   958  - bug 1010 - Uan model Sleep patch
   959  - bug 1033 - Mesh airtime-metric fixed
   960  - bug 1043 - lte-spectrum-value-helper.cc file swapped uplink/downlink freq.
   961  - bug 1050 - ISO C++ forbids variable length array; remove all instances
   962  - bug 1057 - LTE bearers differentiation issue
   963  - bug 1082 - Check that log component names are correct when taken from NS_LOG
   964  - bug 1100 - IPv6 fragmentation enhancements
   965  - bug 1102 - IPv4 header fragment offset field not set correctly
   966  - bug 1123 - class MinMaxAvgTotalCalculator does not implement all methods
   967  - bug 1134 - Fix LiIonEnergySource attribute spelling for InitialCellVoltage
   968  - bug 1139 - Broadcast packets issue in uan cw mac
   969  - bug 1141 - MeshWifiInterfaceMac adds supported modes to wrong remote station
   970  - bug 1163 - Ipv4EndPointDemux::AllocateEphemeralPort forget to increment port
   971  - bug 1164 - IPV4 TCP Bind already used port failed, but without setting errno
   972  - bug 1168 - BridgeNetDevice: default expiration time not realistic
   973  - bug 1174 - Ns-3 does not generate static libraries
   974  - bug 1175 - shared libraries are not versioned
   975  - bug 1193 - AODV Hello timers scheduling skewed when RREP, RREQ are processed
   976  - bug 1194 - AODV Incorrect RERR processing
   977  - bug 1201 - UDP sockets need to set connected state before notifying the ConnectionSucceeded callback
   978  - bug 1208 - Spectrum module example causing valgrind errors
   979  - bug 1209 - ns-3-click fails to build on Fedora 15 when tests are enabled
   980  - bug 1220 - FdReader always stops with NS_FATAL_ERROR
   981  - bug 1222 - Incomplete PointToPointNetDevice Python bindings
   982  - bug 1224 - ns-3-allinone fails to compile on OS X Lion
   983  - bug 1226 - Incomplete YansWifiChannel Python bindings
   984  - bug 1234 - GetAttributeChecker is not defined anymore but still used
   985  - bug 1239 - Add assertion that reference count never overflows
   986  - bug 1244 - Seg Faults in optimized builds due to missing Logging components
   987  - Fix ARP issue in nsclick-ip-router.click and static route in nsclick-routing-node2.click
   988 
   989 Known issues
   990 ------------
   991 In general, known issues are tracked on the project tracker available
   992 at http://www.nsnam.org/bugzilla/
   993 
   994 Release 3.11
   995 ===========
   996 
   997 Availability
   998 ------------
   999 This release is available from: 
  1000 http://www.nsnam.org/release/ns-allinone-3.11.tar.bz2
  1001 
  1002 Supported platforms
  1003 -------------------
  1004 ns-3.11 has been tested on the following platforms.  Not all features are
  1005 available on all platforms; check the Installation page on the project wiki.
  1006 
  1007 - Linux x86_64 Ubuntu 11.04
  1008   - g++-4.5.2
  1009 - Linux i686 Ubuntu 11.04
  1010   - g++-4.5.2, g++-4.4.5
  1011 - Linux x86_64 Fedora Core 15
  1012   - g++-4.6.0
  1013 - Linux x86_64 Fedora Core 14
  1014   - g++-4.5.3, g++-4.4.6, g++-4.3.4
  1015 - Linux x86_64 Fedora Core 10
  1016   - g++-3.4.6, 4.0.4, 4.1.2, 4.2.4, 4.3.2, 4.4.0
  1017 - OS X Snow Leopard
  1018   - g++-4.2.1 
  1019 
  1020 New user-visible features
  1021 -------------------------
  1022 
  1023   - The build system has been modularized, and the source code reorganized,
  1024     to allow for modular libraries instead of a single monolithic ns-3
  1025     library.   User programs now link a number of smaller, per-module
  1026     libraries depending on the dependencies expressed to the build system.  
  1027     Source code is now being maintained in individual modules with
  1028     consistent directory structures.
  1029 
  1030   - Python bindings have also been modularized, and the bindings are now
  1031     generated into a 'ns' namespace instead of 'ns3' for the old
  1032     (monolithic) bindings.  By default the bindings are now modular, with
  1033     a backward compatibility layer for older programs.  
  1034 
  1035   - By default, example and test programs are disabled from the build.
  1036     Users can enable them via the use of a waf command at configure time,
  1037     or automatically through the use of a new .ns3rc file.
  1038 
  1039   - int64x64_t is a new type which allows portable and easy to write arithmetic
  1040     calculations that require a high degree of fractional precision.
  1041 
  1042   - An interface to the Click Modular Router and an Ipv4ClickRouting
  1043     class has been added, to allow a node to use Click for external routing.
  1044 
  1045   - An interface to an OpenFlow software implementation distribution has
  1046     been added to allow the simulation of OpenFlow switches in ns-3.
  1047 
  1048   - ns-3 coding style requirements have been applied to the entire coding
  1049     base, resulting in a large number of whitespace changes.  The coding 
  1050     style has been automatically enforced by running a style checking 
  1051     program (utils/check-style.py) that uses the uncrustify (v. 0.58)
  1052     program to apply changes. 
  1053 
  1054   - Some documentation reorganization to split documentation between
  1055     the ns-3 manual (primarily focusing on the ns-3 core) and a new 
  1056     "model library" document has been started.
  1057 
  1058 Bugs fixed
  1059 ----------
  1060 The following lists many of the bugs fixed or small feature additions
  1061 since ns-3.10, in many cases referencing the Bugzilla bug number.
  1062 
  1063    - bugfix: CsmaNetDevice ErrorModel not discarding packet
  1064    - bugfix: do not call RouteOutput() twice 
  1065    - Workaround gccxml bug scanning Seconds(0) as default value 
  1066    - Copy a bug fix from ns3modulescan.py into ns3modulescan-modular.py 
  1067    - Modular Python bindings work (many bug fixes, more modules tested) 
  1068    - Modular bindings: bug fixes, more verbose scanning 
  1069    - ./waf --apiscan: fix bug in detection of whether the per-module
  1070    - Remove the 'Modules to build' debug print 
  1071    - CsmaNetDevice ReceiveErrorModel was not dropping the packet
  1072    - Several "set but not used" bugs for newer compilers quick-fixed
  1073 
  1074    - bug 445 - Is the class name Scalar in nstime.h appropriate?
  1075    - bug 699 - TestCase::DoRun probably should not return a bool
  1076    - bug 823 - Need finer-grained control over what goes into libns3
  1077    - bug 957 - Issue with test.py
  1078    - bug 1017 - node --> internet-stack --> node
  1079    - bug 1018 - mobility --> helper --> mobility circular dependency
  1080    - bug 1019 - common --> node --> common circular dependency
  1081    - bug 1038 - Time::Get*Seconds () return signed integer while actually returning unsigned.
  1082    - bug 1040 - Olsr and multiple interfaces
  1083    - bug 1042 - AODV RERR implosion (missing RERR_RATELIMIT) 
  1084    - bug 1044 - Seconds (1e-9) creates Time that is not IsPositive ()
  1085    - bug 1047 - Multicast routes on nodes with >16 interfaces
  1086    - bug 1048 - suggested MatrixPropagationLossModel::SetLoss() API change
  1087    - bug 1049 - Issues with OLSR HNA messages sent by multiple gateways
  1088    - bug 1052 - olsr::RoutingProtocol::LinkTupleUpdated incorrect detection of asymetric link with multiple interface nodes
  1089    - bug 1054 - ipv6 InternetStackHelper EnablePcapIpv6All() broken
  1090    - bug 1056 - CSMA: padding not handled correctly for LLC encapsulation
  1091    - bug 1058 - InternetStackHelper pitfall: calling Install before adding routing protocols
  1092    - bug 1060 - Setting NqStaWifiMac Active Probing true, crashes simulation
  1093    - bug 1061 - Title level inconsistent in click.rst
  1094    - bug 1062 - rescale-pdf not working
  1095    - bug 1064 - Correct Friis propagation loss equation in spectrum module
  1096    - bug 1066 - Set Radiotap modulation type flags correctly
  1097    - bug 1069 - ApWifiMac unduly calls RegularWifiMac::Receive and crashes
  1098    - bug 1070 - csma/ipv6 examples duplicate NS_LOG_COMPONENT_DEFINE
  1099    - bug 1072 - crash upon call to Packet::AddAtEnd of fragmented packets 
  1100    - bug 1075 - Python examples fail when static built is enabled
  1101    - bug 1076 - Waf gives an error if you enable only a single module
  1102    - bug 1078 - PacketTagList::Add performs NS_ASSERT counting one byte too few
  1103    - bug 1079 - MPI code doesn't compile
  1104    - bug 1081 - wutils.py refers to the old directory for visualizer module
  1105    - bug 1083 - scratch doesn't work when only some modules are enabled
  1106    - bug 1085 - Build failed: list index out of range
  1107    - bug 1086 - sanity check for not calling Object::Dispose () twice
  1108    - bug 1087 - Call MPI_Finalize to exit MPI environment
  1109    - bug 1088 - Code in scratch directory assumes all modules are enabled
  1110    - bug 1089 - lwip build issue
  1111    - bug 1090 - WifiMacQueue is not accessible through the attribute path
  1112    - bug 1092 - Problem building FreeBSD stack with g++ 4.5.2 (Ubuntu)
  1113    - bug 1094 - Object::GetObject upon dlopen 
  1114    - bug 1097 - AODV routing entry set to be VALID mistakenly.
  1115    - bug 1098 - when to show users which modules are enabled?
  1116    - bug 1101 - Sqlite stats disappeared from configuration file src/wscript
  1117    - bug 1103 - Useless assignment in omnet-data-output.cc
  1118    - bug 1105 - Move topology helpers into separate per-device modules
  1119    - bug 1106 - Remove "CanvasLocation" dependencies in p2p helpers
  1120    - bug 1108 - test.py -e option needs repair
  1121    - bug 1110 - Sort alphabetically and display "Modules built" in columns
  1122    - bug 1117 - bindings failures on selected platforms
  1123    - bug 1122 - spectrum-value test should check tolerance on a per-value basis
  1124    - bug 1125 - ./waf --enable-modules fails
  1125    - bug 1131 - Bug in Ipv4L3Protocol::RemoveAddress()
  1126    - bug 1133 - DSDV: Possible bug in settling time calc
  1127    - bug 1142 - Wrong 802.11p Slot time
  1128    - bug 1146 - help string for test.py with disabled tests
  1129 
  1130 Known issues
  1131 ------------
  1132 In general, known issues are tracked on the project tracker available
  1133 at http://www.nsnam.org/bugzilla/
  1134 
  1135 Release 3.10
  1136 ===========
  1137 
  1138 Availability
  1139 ------------
  1140 This release is available from: 
  1141 http://www.nsnam.org/release/ns-allinone-3.10.tar.bz2
  1142 
  1143 Supported platforms
  1144 -------------------
  1145 ns-3.10 has been tested on the following platforms.  Not all features are
  1146 available on all platforms; check the Installation page on the project wiki.
  1147 
  1148 - Linux i686 Ubuntu 10.10
  1149   - g++-4.4.5
  1150 - Linux x86_64 Ubuntu 8.04.4
  1151   - g++-3.4.6, g++-4.2.4
  1152 - Linux x86_64 Fedora Core 12
  1153   - g++-4.4.4
  1154 - Linux x86_64 Fedora Core 10
  1155   - g++-3.4.6, 4.0.4, 4.1.2, 4.2.4, 4.3.4, 4.4.0
  1156 - OS X Snow Leopard
  1157   - g++-4.2.1 
  1158 - OS X powerpc Leopard 
  1159   - g++-4.0, g++-4.2
  1160 
  1161 New user-visible features
  1162 -------------------------
  1163 
  1164    - NS-3 PyViz, a live simulation visualizer, has been added.  The 
  1165      visualizer interacts with a running simulation, such that it uses no
  1166      trace files. It can be most useful for debugging purposes, i.e. to
  1167      figure out if mobility models are what you expect, where packets are
  1168      being dropped, etc. There is also a builtin interactive python console
  1169      that can be used to debug the state of the running objects. Although
  1170      it is mostly written in Python, it works both with Python and pure C++
  1171      simulations.
  1172 
  1173    - Wi-Fi MAC high classes have been reorganised in attempt to
  1174      consolidate shared functionality into a single class. This new
  1175      class is RegularWifiMac, and it derives from the abstract
  1176      WifiMac, and is parent of AdhocWifiMac, StaWifiMac, ApWifiMac,
  1177      and MeshWifiInterfaceMac. The QoS and non-QoS class variants are
  1178      no longer, with a RegularWifiMac attribute "QosSupported"
  1179      allowing selection between these two modes of
  1180      operation.
  1181 
  1182    - Support for IEEE 802.11g (specifically, rates with Modulation
  1183      Class ERP-OFDM) has been added to the wifi module. The new
  1184      WifiModes have names of the form ErpOfdmRatexxMbps, where xx is
  1185      the rate in Mbps (one of 6, 9, 12, 18, 24, 36, 48, 54), and a
  1186      WifiPhyStandard enumeration WIFI_PHY_STANDARD_80211g has been
  1187      added to allow configuration of a Wi-Fi STA supporting ERP-OFDM,
  1188      HR/DSSS, and DSSS rates (which some call an "802.11b/g" station).
  1189 
  1190    - Two attributes were added to WaypointMobilityModel.  The first
  1191      "LazyNotify" (default false), if enabled to true, will suppress
  1192      course change notifications if there are no position updates.
  1193      The second, "InitialPositionIsWaypoint" (default false), if enabled,
  1194      will allow an initial call to SetPosition () (before any waypoints
  1195      have been added) to be treated as the first waypoint.
  1196 
  1197    - Regression testing is now completely performed within test.py
  1198      rather than a separate "./waf --regression" that consults
  1199      reference traces in the ns-3.x-ref-traces directory.  In most
  1200      cases, the example programs whose traces were included in 
  1201      ns-3.x-ref-traces have a corresponding test called from the
  1202      test.py program.  It is still possible to write trace-based
  1203      regression tests but they are now called from the test.py
  1204      program.
  1205 
  1206    - New BulkSendApplication sends data as fast as possible up to 
  1207      MaxBytes or unlimited if MaxBytes is zero.  Think OnOff, but 
  1208      without the "off" and without the variable data rate. This 
  1209      application only works with SOCK_STREAM and SOCK_SEQPACKET 
  1210      sockets, for example TCP sockets and not UDP sockets.
  1211 
  1212    - Extensions to the energy models:  1) a new Rakhmatov Vrudhula 
  1213      non-linear battery model, 2) additional support for modeling 
  1214      energy consumption in WiFi devices, 3) an example for how to add 
  1215      energy models to a WiFi-based simulation (in examples/energy/ 
  1216      directory).
  1217 
  1218    - New methods to print IPv4 routing tables to an output stream.
  1219 
  1220    - A replacement implementation for TCP for IPv4.  TcpSocketBase
  1221      now replaces TcpSocketImpl.  There are subclasses defined for
  1222      TCP Tahoe, Reno, NewReno, and the original RFC793 without
  1223      congestion control.
  1224 
  1225    - Energy support for UAN module and Li-Ion energy model.
  1226      Now each network node can have an associated energy source
  1227      from which it consumes energy. The user can specify a custom
  1228      energy model for the underwater transducer, with default values
  1229      set for WHOI acoustic transducer. Li-Ion battery model added
  1230      into energy models folder.
  1231 
  1232    - Destination-Sequenced Distance Vector (DSDV) routing protocol 
  1233      is a proactive, table-driven routing protocol for MANETs 
  1234      developed by Charles E. Perkins and Pravin Bhagwat in 1994. 
  1235      This implementation is for IPv4 routing and was contributed 
  1236      by ResilNets Research Group.
  1237 
  1238    - A novel model to simulate LTE networks has been added.  It focuses 
  1239      mainly on modeling the E-UTRA part of the system, with a particular 
  1240      attention on the aspects related to the channel, PHY and MAC layers. 
  1241      The most important features available at this moment are (i) a basic 
  1242      implementation of both the UE and the eNB devices, (ii) RRC and 
  1243      entities for both the UE and the eNB, (iii) an Adaptive Modulation 
  1244      and Coding (AMC) scheme for the downlink, (iv) the management of the 
  1245      data radio bearers (with their QoS parameters), the MAC queues and 
  1246      the RLC instances, (v) Channel Quality Indicator (CQI) management, 
  1247      (vi) support for both uplink and downlik packet scheduling, 
  1248      (vii) a PHY layer model with Resource Block level granularity, and 
  1249      (viii) a channel model with the outdoor E-UTRAN propagation loss 
  1250      model.
  1251 
  1252    - Project documentation has been converted from GNU Texinfo to Sphinx. 
  1253 
  1254 Bugs fixed
  1255 ----------
  1256 The following lists many of the bugs fixed or small feature additions
  1257 since ns-3.9, in many cases referencing the Bugzilla bug number
  1258 
  1259    - bug 824 - TCP should implement FastRecovery by default
  1260    - bug 852 - Add support for 802.11g devices
  1261    - bug 892 - WaypointMobilityModel incompatible with MobilityHelper::Install
  1262    - bug 893 - Lazy CourseChange notification for WaypointMobilityModel
  1263    - bug 903 - TapBridge does not shut down properly
  1264    - bug 953 - WiMAX channel scanning overflow
  1265    - bug 967 - Need to decouple Ipv4L4Protocols from Ipv4L3Protocol
  1266    - bug 978 - Consolidate Wi-Fi MAC high functionality
  1267    - bug 979 - Multi-octet fields in Wi-Fi headers have wrong endianness
  1268    - bug 981 - use a cache to keep track of received MPDUs under block ack
  1269    - bug 983 - handle correctly ADDBA response action frames in QadhocWifiMac
  1270    - bug 984 - EmuNetDevice should use DIX encapsulation by default
  1271    - bug 985 - WiMAX Invalid management message type on wimax-simple
  1272    - bug 988 - MacRxMiddle::SequenceControlSmaller method
  1273    - bug 990 - Error with an NS_ASSERT at uan-phy-gen.cc
  1274    - bug 991 - InterferenceHelper assertion failure
  1275    - bug 992 - Unusual (possibly incorrect assertion) in Packet::Deserialize
  1276    - bug 993 - MinstrelWifiManager::UpdateStats useless if clause
  1277    - bug 994 - PointToPointGridHelper useless if clauses
  1278    - bug 995 - Useless (possibly incorrect) comparison of unsigned int
  1279    - bug 1004 - module header not rebuilt
  1280    - bug 1005 - GetSocket() methods for OnOffApplication and PacketSink
  1281    - bug 1009 - decouple m_finSequence (TcpSocketImpl) from tx sequence numbers
  1282    - bug 1012 - UAN Throp propagation model bug
  1283    - bug 1015 - GetChannelFrequencyMhz() does not match with standard
  1284    - bug 1022 - inappropriate ASSERT in tcp-socket-impl.cc
  1285    - bug 1025 - wimax-ipv4 script exists with signal SIGSEGV when nbSS>20
  1286    - bug 1027 - RocketfuelTopologyReader is not working at all
  1287    - bug 1029 - v4Ping application endian issues
  1288    - bug 1030 - routing/aodv example fixed
  1289    - bug 1031 - Wifi hidden terminal example does not work
  1290    - bug 1032 - Unable to specify multiple Compiler/Linker flags
  1291 
  1292 Known issues
  1293 ------------
  1294 In general, known issues are tracked on the project tracker available
  1295 at http://www.nsnam.org/bugzilla/
  1296 
  1297 Windows XP 32 bit Cygwin 1.7.7 does not seem to work because of a
  1298 problem (reported elsewhere) in linking large libraries.
  1299 
  1300 Release 3.9
  1301 ===========
  1302 
  1303 Availability
  1304 ------------
  1305 This release is immediately available from:
  1306 http://www.nsnam.org/release/ns-allinone-3.9.tar.bz2
  1307 
  1308 Supported platforms
  1309 -------------------
  1310 ns-3.9 has been tested on the following platforms:
  1311 - Ubuntu 10.04 LTS 32/64-bit gcc-4.4.3
  1312 - Fedora Core 12 64-bit gcc-4.4.3
  1313 - Ubuntu 9.10 32-bit gcc-4.4.1
  1314 - Ubuntu 8.04 LTS 64-bit gcc-4.2.4
  1315 - Fedora Core 5 32-bit gcc-4.1.1
  1316 - Mac OS X Leopard powerpc gcc-4.0.1
  1317 - Windows Cygwin 1.7.5
  1318 
  1319 Not all ns-3 options are available on all platforms; consult the
  1320 wiki for more information:
  1321 http://www.nsnam.org/wiki/Installation
  1322 
  1323 New user-visible features
  1324 -------------------------
  1325 
  1326    - A reorganisation of the construction of Wi-Fi transmit rates has
  1327      been undertaken with the aim of simplifying the task of
  1328      supporting further IEEE 802.11 PHYs. This work has been completed
  1329      under the auspices of Bug 871. A consequence of this work is that
  1330      WifiModes have a new (hopefully future-proof) naming, and
  1331      simulations which specify rates by name will need updating. The
  1332      list of new rate names is given in the error message produced
  1333      when an attempt is made to use any invalid rate name (including
  1334      those that were previously valid).
  1335 
  1336    - A new OFDM error rate model for WiFi (NistErrorRateModel); this model
  1337      has been validated in clear-channel testbed tests.  For 802.11b, it
  1338      uses the same underlying model as the YansErrorRateModel, but it differs
  1339      from YansErrorRateModel for OFDM modes (802.11a/g).  The default
  1340      YansWifiPhyHelper has been changed to use this model.
  1341 
  1342    - A new NS-2 mobility trace reader supports BonnMotion, SUMO, TraNS, 
  1343      etc. traces.
  1344 
  1345    - An energy model for nodes and devices, including an energy source
  1346      model and device energy models allowing energy-aware devices
  1347      to notify the energy source about energy consumption.  
  1348 
  1349    - Rocketfuel topology dataset support for existing topology reader
  1350      Rocketfuel project: 
  1351      http://www.cs.washington.edu/research/networking/rocketfuel/
  1352 
  1353    - Underwater Acoustic Network (UAN) model, split in to three parts, the 
  1354      channel, PHY, and MAC models to enable researchers to model a variety 
  1355      of underwater network scenarios.
  1356 
  1357    - the Spectrum framework, which provides support for spectrum-aware
  1358      Channel and PHY layer modeling. It features a set of classes that
  1359      allows the mathematical representation of frequency dependent
  1360      phenomena. Some example channel, propagation and device
  1361      implementations that make use of this framework are also
  1362      included.  
  1363 
  1364 Bugs fixed
  1365 ----------
  1366 The following lists many of the bugs fixed or small feature additions 
  1367 since ns-3.8, in many cases referencing the Bugzilla bug number
  1368 
  1369    - IPv4 global routing code; stub networks were assumed to be /24
  1370      and added as /24 networks even if the mask is actually different
  1371    - OLSR was generating messages on non-OLSR interfaces
  1372    - ICMPv4 objects not properly registered; affected serialization code
  1373    - bug 231 - SocketAddressTag needs to be removed from a packet before 
  1374                forwarding the packet to the user
  1375    - bug 385 - Add a generic "sequence number" class
  1376    - bug 473 - [PATCH] Alternative ns-2 trace reader
  1377    - bug 665 - Need Tutorial Sectino on Config Path and Tracing Use
  1378    - bug 671 - add packet-info-tag.cc for IP_PKTINFO/IPV6_PKTINFO
  1379    - bug 702 - Global routing doesn't respond to interface events
  1380    - bug 799 - Interference helper is too slow
  1381    - bug 800 - Erroneous packet sender while using aloha or cw mac in uan module
  1382    - bug 802 - Minstrel algorithm causes segmentation fault
  1383    - bug 826 - Using uint64_t instead of Time in DcfManager
  1384    - bug 828 - PacketSocket::Close does not unregister protocol handler
  1385    - bug 842 - ns-3-dev crashes using block acks
  1386    - bug 843 - Most wifi examples change BeaconInterval to unrealistic values
  1387    - bug 844 - YansWifiPhy::GetPowerDbm off-by-one problem when calculating Tx 
  1388                power
  1389    - bug 846 - packet.cc triggers deprecated warning
  1390    - bug 853 - Rates for Wi-Fi control responses are incorrectly selected
  1391    - bug 854 - Support DROP_QUEUE reason-code in Ipv4FlowProbe
  1392    - bug 858 - support MSG_PEEK in IPv4/IPv6 raw socket
  1393    - bug 861 - Forwarding drops (due to no route found) were not being logged 
  1394                in IPv4 or IPv6 ascii traces
  1395    - bug 869 - suggested test framework enhancements
  1396    - bug 871 - naming for WifiPhyStandard
  1397    - bug 873 - Queue occupancy counter not decremented in WifiMacQueue::Remove()
  1398    - bug 874 - wrong modulation type is selected in the forwardBurst method
  1399    - bug 875 - "frame includes FCS" flag should be set in Radiotap frame header
  1400    - bug 879 - source address selection for AODV using DeferredRouteRequest
  1401    - bug 881 - Reorganise to allow wider use of WifiInformationElement
  1402    - bug 890 - several rate adaptation algorithms not tested by test.py
  1403    - bug 900:  RawTextConfigLoad::Default does not load configurations
  1404    - bug 901 - Optimize Mac48Address < != and ==
  1405    - bug 902 - TCP: handle out-of-order packets during connection shutdown
  1406    - bug 905 - WimaxNetDevice loses packet uid, tags, and memory optimization
  1407    - bug 906 - NSC TCP socket fork did not copy txbuffersize over
  1408    - bug 908 - test.py should exit if waf dies
  1409    - bug 910 - Change Wi-Fi "AccessClass" to something closer to the standard
  1410    - bug 911 - IPv4/v6 multicast forwarding not going to all output interfaces
  1411    - bug 913 - Queue Enqueue/Drop trace sources behavior unintuitive
  1412    - bug 916 - EnableAsciiAll ("prefix") does not work for YansWifiPhyHelper
  1413    - bug 918 - samples/main-packet-header.cc is broken
  1414    - bug 919 - minstrel does not pass valgrind tests
  1415    - bug 921 - Inconsistent declaration of class/struct Object in object.h
  1416    - bug 922 - Inconsistent declaration of class/struct in 
  1417                wifi-remote-station-manager.h
  1418    - bug 923 - Inconsistent declaration of class/struct in mac-low.h
  1419    - bug 924 - Inconsistent declaration of class/struct in <xxx>-wifi-managers 
  1420    - bug 925 - Various IPv6 cc files trigger deprecated warning
  1421    - bug 926 - olsr handling of multicast packets 
  1422    - bug 927 - SimpleOfdmWimaxChannel RxPower computation
  1423    - bug 930 - examples/topology-read/topology-example-sim.cc uses variable 
  1424                length array
  1425    - bug 931 - Abnormal exit reports SIGSEGV on failure
  1426    - bug 932 - Support IP_HDRINCL option for Ipv4RawSocket
  1427    - bug 933 - Flushing ostream and files on abnormal program exit 
  1428                (ASSERT, ABORT and FATAL_ERROR)
  1429    - bug 936 - Waf build error for python bindings on "AccessClass"
  1430    - bug 937 - bugs in ns-3 wimax
  1431    - bug 939 - EmuNetDevice uses too much memory when reading packet bursts
  1432    - bug 940 - AODV fails to set up a correct path
  1433    - bug 941 - Wifi Dcf attributes not reachable through configuration namespace
  1434    - bug 943 - Add a SO_BROADCAST socket option
  1435    - bug 944 - change default ErrorRateModel from YansErrorRateModel to 
  1436                NistErrorRateModel
  1437    - bug 946 - Rocketfuel topology dataset support for topology reader
  1438    - bug 949 - Node::NonPromiscReceiveFromDevice reports a meaningless 
  1439                destination address to user callbacks 
  1440    - bug 950 - PointToPointNetDevice says promisc support is not implemented 
  1441                but it is
  1442    - bug 955 - Install NSC for NS3 in a Itanium Architecture (ia64) with Linux 2.6.16.6
  1443    - bug 956 - Bindings failure in core (traced-value) with older gcc
  1444    - bug 958 - WiFi uses wrong default values for MTU, FragmentationThreshold 
  1445                and RtsCtsThreshold
  1446    - bug 959 - Simulation never finishes when using RealtimeSimulatorImpl
  1447    - bug 960 - V4Ping does not generate checksum
  1448    - bug 961 - Problem with MPI activation 
  1449    - bug 964 - AODV does not work with host addressed interfaces
  1450    - bug 965 - Problem building /src/core/callback.cc
  1451    - bug 966 - AODV originates new RREQ on each packet, when doesn't have 
  1452                valid route
  1453    - bug 969 - No SocketList is present in UdpL4Protocol class
  1454    - bug 971 - fix AODV header Print functions 
  1455    - bug 972 - [flow monitor] assertion fails in pv4-flow-probe.cc
  1456 
  1457 Known issues
  1458 ------------
  1459 
  1460 Release 3.8
  1461 ===========
  1462 
  1463 Availability
  1464 ------------
  1465 This release is immediately available from:
  1466 http://www.nsnam.org/release/ns-allinone-3.8.tar.bz2
  1467 
  1468 Supported platforms
  1469 -------------------
  1470 ns-3.8 has been tested on the following platforms:
  1471   - linux x86 gcc 4.4.0, 4.3.2, 4.2, 4.1.1, 4.1 and 3.4.6 (debug and optimized)
  1472   - 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)
  1473   - MacOS X ppc gcc 4.0.x and 4.2.x (debug and optimized)
  1474   - cygwin gcc 4.3.4 (debug and optimized)
  1475 
  1476 Not all ns-3 options are available on all platforms; consult the
  1477 wiki for more information:
  1478 http://www.nsnam.org/wiki/Installation
  1479 
  1480 New user-visible features
  1481 -------------------------
  1482   a) WiMAX net device: Allow to simulated IEEE 802.16 point to multi-point based networks 
  1483 
  1484   b) Distributed simulation for point-to-point networks using the Message 
  1485      Passing Interface (MPI) standard.
  1486     
  1487   c) Matrix propagation loss model uses a two-dimensional matrix of path loss indexed 
  1488      by source and destination nodes.
  1489 
  1490   d) Topology read system: Allows quick and easy creation of large topologies by reading 
  1491      Inet or Orbis files
  1492 
  1493   e) Gauss-Markov mobility model: Adds 3-d adaptation of Gauss-Markov mobility model which 
  1494      has both memory and variability
  1495 
  1496   f) Steady-state random waypoint mobility model: Based on random waypoint mobility (RWM) model for case when 
  1497      speed, pause and position are uniformly distributed random variables. However, initial values of these 
  1498      parameters are not from uniform distribution but from stationary distribution of RWM model.
  1499 
  1500   g) Two-ray ground propagation loss model: Calculates the crossover distance under which Friis is used. 
  1501      The antenna height is set to the nodes z coordinate, but can be added to using the model parameter 
  1502      SetHeightAboveZ, which will affect ALL stations
  1503 
  1504 
  1505 API changes from ns-3.7
  1506 -----------------------
  1507 API changes for this release are documented in the file CHANGES.html. 
  1508 
  1509 Bugs fixed
  1510 ----------
  1511 The following lists many of the bugs that were fixed since ns-3.7, in
  1512 many cases referencing the Bugzilla bug number
  1513    - bug 155 - std::ostream & os" parameters not Python friendly
  1514    - bug 184 - GtkConfigStore do not support ConfigureDefault
  1515    - bug 407 - OLSR is missing HNA support
  1516    - bug 414 - No ReceiveErrorModel in SimpleNetDevice
  1517    - bug 602 - WifiRemoteStation lacks information about the access class of outgoing packets
  1518    - bug 622 - [PATCH] Friendly names for pcap traces
  1519    - bug 683 - Helper methods for pcap tracing with explicit filenames
  1520    - bug 706 - Backoff counting when starting NS.
  1521    - bug 720 - TapBridge creation fails from a script outside the ns3 tree
  1522    - bug 731 - Send function in point-to-point-net-device fails to check the return value of the Dequeue function
  1523    - bug 747 - Listening TCP socket closes on RST
  1524    - bug 748 - Cloned TCP socket uses wrong source address
  1525    - bug 772 - AODV is unable to correctly buffer packets waiting for route reply
  1526    - bug 777 - AODV ignores specified outgoing interface in RouteOutput()
  1527    - bug 778 - OLSR ignores specified outgoing interface in RouteOutput()
  1528    - bug 787 - Addition of Two Ray Ground model to propagation loss model and tests
  1529    - bug 788 - OLSR_NEIGH_HOLD_TIME should be 3 times OLSR_REFRESH_INTERVAL 
  1530    - bug 789 - [PATCH] Globalrouting externalroutes to use the new GetRootExitDirections()
  1531    - bug 794 - Ipv4Mask constructor for "/yy"-notation is wrong
  1532    - bug 796 - TCP bug in ns-3-dev branch : Crash detected during retesting of Chord on ns-3-dev branch
  1533    - bug 797 - Enhancements to src/core/random-variable.cc/h
  1534    - bug 801 - ns-3.7 and SVN not coexisting nicely
  1535    - bug 802 - Minstrel algorithm causes segmentation fault
  1536    - bug 804 - null-pointer references in 3.7 internet stack
  1537    - bug 806 - TCP doesn't work over a CSMA link
  1538    - bug 807 - ns2-mobility-helper.cc: node id parsed wrong
  1539    - bug 809 - Missing Python binding for Ipv4GlobalRouting::GetRoute
  1540    - bug 810 - In TCP, Socket::GetSockName() does not return the local socket address
  1541    - bug 812 - Assert when getting socket in RecvReply for AODV
  1542    - bug 813 - Nqos AP sends packet to non associated STA
  1543    - bug 814 - Function logging causing assert in wireless examples
  1544    - bug 815 - waf shell file descriptor leak
  1545    - bug 816 - tap-creator deadlock when python bindings enabled
  1546    - bug 817 - Pareto rng constructors using scale and shape instead of mean and shape
  1547    - bug 818 - TCP Socket implementation does not set ACK flag on retransmits
  1548    - bug 819 - Build break when gtk not installed
  1549    - bug 820 - Bad things happen in test.py when logging is enabled
  1550    - bug 821 - AODV asserts with function logging enabled
  1551    - bug 822 - Move Mtu attribute from NetDevice base class to subclasses
  1552    - bug 825 - UDP-Client-server's packet loss counter not properly reset
  1553    - bug 828 - PacketSocket::Close does not unregister protocol handler
  1554    - bug 829 - TCP unbound memory problem (pending data)
  1555    - bug 833 - OnOffApplication with PacketSocket: sniffs all traffic
  1556    - bug 834 - Incorrect signature of Ipv4FlowProbe::DropLogger
  1557    - bug 835 - Unlimited receive queues in sockets == evil
  1558    - bug 836 - Delay is incremented over time with BsUplinkSchedulerSimple and BsUplinkSchedulerRtps
  1559    - bug 838 - ns-3 can't compile on MacOS with 32bit processor
  1560    - bug 839 - TestSuite wimax-ss-mac-layer crashes on Darwin 9.8.0 Power Macintosh
  1561    - bug 840 - BS scheduler does not support fragmentation for UGS flows
  1562    - bug 841 - Multicast transmission breaks with QoS Wifi
  1563    - bug 844 - YansWifiPhy::GetPowerDbm off-by-one problem when calculating Tx power
  1564    - bug 847 - Segfaults on BaseStationNetDevice with OnOffApplication and rtPS sched
  1565    - bug 849 - stray patch files in lwip directory
  1566    - bug 850 - Ipv4GlobalRouting::LookupGlobal bug
  1567    - bug 855 - waf dies badly when switching from debug to optimized build or vice versa
  1568    - bug 856 - initialize vbl
  1569    - bug 857 - Link-Local Multicast handle in Ipv4 Output processing 
  1570    - bug 859 - Output interface estimation for the source address bound socket in IPv4 Raw socket
  1571    - bug 860 - waf sometimes dies while executing ns3header or gen_ns3_module_header tasks in case of 
  1572                parallel jobs
  1573    - bug 862 - NotifyInterfaceUp() Adds network route even when netmask is /32
  1574    - bug 863 - Wrong Scalar arithmetics
  1575    - bug 864 - Invalid return value in UdpSocketImpl::Send and Ipv4RawSocketImpl::Send
  1576    - bug 865 - Ipv4RawSocketImpl::RecvFrom does not return from address all the time.
  1577    - bug 866 - WiMAX mobility models not aggregated to Node
  1578    - bug 867 - Minor bug in Ipv4L3Protocol::Send()
  1579    - bug 868 - invalid packet size after Ipv4L3Protocol::Send
  1580    - bug 872 - ns3::PcapFileWrapper::Write explodes stack
  1581    - bug 873 - Queue occupancy counter not decremented in WifiMacQueue::Remove()
  1582    - bug 876 - Tcp socket does not handle ShutdownRecv correctly
  1583    - bug 877 - python bindings broken with multiple inheritance ?
  1584    - bug 880 - Node sending a packet to itself via 127.0.0.1 aborts
  1585    - bug 885 - Error in Ascii tracing in Python examples
  1586    - bug 888 - Writing ascii trace to addtional tests fails
  1587    - bug 891 - WiMAX device helper does not include propagation loss model by default 
  1588    - bug 894 - ./waf --run error message upon segfault
  1589    - bug 895 - SimpleOfdmWimaxPhy SNR computation
  1590    - bug 899 - EmuNetDevice::SetPromiscReceiveCallback not implemented
  1591 
  1592 Known issues
  1593 ------------
  1594 ns-3 builds have been known to fail on the following platforms:
  1595   - gcc 3.3 and earlier
  1596   - optimized builds on gcc 3.4.4 and 3.4.5
  1597   - optimized builds on linux x86 gcc 4.0.x
  1598 
  1599 
  1600 Release 3.7
  1601 ===========
  1602 
  1603 Availability
  1604 ------------
  1605 This release is immediately available from:
  1606 http://www.nsnam.org/release/ns-allinone-3.7.tar.bz2
  1607 
  1608 Supported platforms
  1609 -------------------
  1610 ns-3.7 has been tested on the following platforms:
  1611   - linux x86 gcc 4.4.0, 4.3.2, 4.2, 4.1.1, 4.1 and 3.4.6 (debug and optimized)
  1612   - 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)
  1613   - MacOS X ppc gcc 4.0.x and 4.2.x (debug and optimized)
  1614   - cygwin gcc 3.4.4 (debug only), gcc 4.3.2 (debug and optimized)
  1615 
  1616 Unofficially supported platform
  1617 -------------------
  1618 - mingw gcc 3.4.5 (debug only)
  1619 
  1620 Not all ns-3 options are available on all platforms; consult the
  1621 wiki for more information:
  1622 http://www.nsnam.org/wiki/Installation
  1623 
  1624 New user-visible features
  1625 -------------------------
  1626 
  1627   a) Ad hoc On-Demand Distance Vector (AODV) routing model (RFC 3561)
  1628 
  1629   b) IPv6 extensions support to add IPv6 extensions and options.  Two 
  1630      examples (fragmentation and loose routing) are available.
  1631 
  1632   c) NetAnim interface: Provides an interface to the Qt-based NetAnim 
  1633      animator, which supports static, point-to-point topology-based 
  1634      packet animations.
  1635 
  1636   d) New topology helpers have been introduced
  1637      - PointToPointDumbbellHelper
  1638      - PointToPointGridHelper
  1639      - PointToPointStarHelper
  1640      - CsmaStarHelper
  1641 
  1642   e) Equal-cost multipath for global routing: Enables quagga's equal 
  1643      cost multipath for Ipv4GlobalRouting, and adds an attribute that
  1644      can enable it with random packet distribution policy across 
  1645      equal cost routes.
  1646 
  1647   f) Binding sockets to devices:  A method analogous to a SO_BINDTODEVICE
  1648      socket option has been introduced to class Socket
  1649 
  1650   g) Object::DoStart: Users who need to complete their object setup at 
  1651      the start of a simulation can override this virtual method, perform their 
  1652      adhoc setup, and then, must chain up to their parent.
  1653 
  1654   h) Ipv4::IsDestinationAddress method added to support checks of whether a 
  1655      destination address should be accepted as one of the host's own 
  1656      addresses.  
  1657 
  1658   i) UniformDiscPositionAllocator added; distributes uniformly the nodes 
  1659      within a disc of given radius. 
  1660 
  1661   j) ChannelNumber attribute added to YansWifiPhy. Now it is possible to 
  1662      setup wifi channel using WifiPhyHelper::Set() method.
  1663 
  1664   k) WaypointMobilityModel provides a method to add mobility as a set of 
  1665      (time, position) pairs
  1666 
  1667   l) 802.11p WiFi standards 
  1668   
  1669   m) UDP Client/Server application
  1670 
  1671   n) Support transactions in the SQLite output interface, making it usable for larger amounts of data
  1672 
  1673 API changes from ns-3.6
  1674 -----------------------
  1675 API changes for this release are documented in the file CHANGES.html. 
  1676 
  1677 Bugs fixed
  1678 ----------
  1679 The following lists many of the bugs that were fixed since ns-3.6, in
  1680 many cases referencing the Bugzilla bug number
  1681    - bug 752: Object::DoStart is not executed for objects created at t > 0
  1682    - bug 767:  Incorrect modulation for 802.11a modes
  1683    - bug 725: wifi fragmentation and RTS cannot be used at the same time
  1684    - bug 782: CreateTap () requires IP address in modes other than 
  1685      CONFIGURE_LOCAL.
  1686    - bug 769: Queue::GetTotalReceived{Bytes,Packets}() broken
  1687    - bug 738 ReceiveErrorModel called too late
  1688    - Fix NSC improper response to FIN
  1689    - Fixed bug in serialization of PbbAddressBlock.
  1690    - Fix bug 780 (problem in RoutingTableComputation with asymetric links), 
  1691      while adding debugging methods to OLSR.  
  1692    - bug 759: Ipv6 uses wrong outgoing interface.
  1693    - bug 770: IPv6 size calculation for unknown options is wrong.
  1694    - bug 771: Radvd does not set ttl value.
  1695    - Fix bug 606:  Arp depends on IP routing system
  1696    - pad out CSMA payloads to 46 bytes if needed
  1697    - Drop CSMA packets with CRC errors, rescan, dox tweaks
  1698    - Add FCS capability to CSMA
  1699    - Mesh:Dot11s: fixed airtime metric
  1700    - Get emu working again:  Add Dix/Llc option, add and use contextual 
  1701      realtime schedule ops, don't refcount realtime simulator impl
  1702    - bug 695 - DcfManager::UpdateBackoff () uses slow HighPrecision::Div()
  1703    - bug 674 - EIFS is not handled correctly in DcfManager::GetAccessGrantStart
  1704    - bug 739 -  OLSR: Strange HTime value in HELLO messages 
  1705    - bug 746 -  UDP source address is not set to bound address
  1706    - bug 735 Update Olsr for local delivery
  1707    - bug 740 OLSR MprCompute () works wrong: fixed
  1708    - bug 729 Enable IPv6 over PPP.
  1709    - bug 645: fixes for opening stats file with OMNeT++
  1710    - bug 689: default energy detection and CCA thresholds are changed to be 
  1711      more realistic.
  1712    - bug 733: OLSR MPR Computation give incorrect result
  1713    - Mesh: HWMP: fixed proactive routes
  1714    - Mesh: fixed FLAME PATH_UPDATE procedure, fixed mesh.cc 
  1715 
  1716 Known issues
  1717 ------------
  1718 ns-3 builds have been known to fail on the following platforms:
  1719   - gcc 3.3 and earlier
  1720   - optimized builds on gcc 3.4.4 and 3.4.5
  1721   - optimized builds on linux x86 gcc 4.0.x
  1722 
  1723 
  1724 Release 3.6
  1725 ===========
  1726 
  1727 Availability
  1728 ------------
  1729 This release is immediately available from:
  1730 http://www.nsnam.org/release/ns-allinone-3.6.tar.bz2
  1731 
  1732 Supported platforms
  1733 -------------------
  1734 ns-3.6 has been tested on the following platforms:
  1735   - linux x86 gcc 4.4.1, 4.2, 4.1, and, 3.4.6.
  1736   - linux x86_64 gcc 4.4.0, 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
  1737   - MacOS X ppc and x86 (gcc 4.0.x and 4.2.x)
  1738   - cygwin gcc 3.4.4 (debug only), gcc 4.3.2 (debug and optimized)
  1739 
  1740 Not all ns-3 options are available on all platforms; consult the
  1741 wiki for more information:
  1742 http://www.nsnam.org/wiki/Installation
  1743 
  1744 New user-visible features
  1745 -------------------------
  1746 
  1747   a) 802.11 models:
  1748      - Add an implementation of the minstrel rate control algorithm 
  1749        (Duy Nguyen for gsoc)
  1750      - AthstatsHelper: enables the wifi device to produce periodic 
  1751        reports similar to the ones generated by madwifi's
  1752        athstats tool (Nicola Baldo)
  1753      - 10MHz and 5MHz channel width supported by 802.11a model 
  1754        (Ramon Bauza and Kirill Andreev)
  1755      - Channel switching support. YansWifiPhy can now switch among 
  1756        different channels (Ramon Bauza and Pavel Boyko)
  1757   
  1758   b) IPv6 models:
  1759     - IPv6 interface;
  1760     - IPv6 layer;
  1761     - IPv6 raw socket;
  1762     - Static IPv6 routing;
  1763     - ICMPv6 layer;
  1764     - Some ICMPv6 error messages (destination unreachable, ...);
  1765     - Neighbor Discovery Protocol (NS/NA, RS/RA, redirection);
  1766     - Ping6 application (send Echo request);
  1767     - Radvd application (send RA);
  1768     - Examples (ping6, simple-routing-ping6, radvd, radvd-two-prefix,
  1769       icmpv6-redirect).
  1770 
  1771   c) Wireless Mesh Networking models:
  1772     - General multi-interface mesh stack infrastructure (devices/mesh module).
  1773     - IEEE 802.11s (Draft 3.0) model including Peering Management Protocol and HWMP.
  1774     - Forwarding Layer for Meshing (FLAME) protocol.
  1775 
  1776   d) Nix-vector routing:  
  1777     - Ipv4NixVectorHelper
  1778     - Examples (nix-simple, nms-p2p-nix)
  1779 
  1780   e) New Test Framework
  1781     - Use test.py instead of ./waf check or ./waf --regression
  1782     - Previous unit tests have been ported to new framework.
  1783     - Examples are tested for run-ability.
  1784 
  1785   f) A new Flow Monitor module
  1786    - To very easily measure flow metrics in a simulation
  1787    - No need to use trace callbacks or parsing trace files
  1788 
  1789 API changes from ns-3.5
  1790 -----------------------
  1791 API changes for this release are documented in the file CHANGES.html. 
  1792 
  1793 Known issues
  1794 ------------
  1795 ns-3.6 build is known to fail on the following platforms:
  1796   - gcc 3.3 and earlier
  1797   - optimized builds on gcc 3.4.4 and 3.4.5
  1798   - optimized builds on linux x86 gcc 4.0.x
  1799 
  1800 Release 3.5
  1801 ===========
  1802 
  1803 Availability
  1804 ------------
  1805 This release is immediately available from:
  1806 http://www.nsnam.org/release/ns-allinone-3.5.tar.bz2
  1807 
  1808 Supported platforms
  1809 -------------------
  1810 ns-3.5 has been tested on the following platforms:
  1811   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
  1812   - linux x86_64 gcc 4.4.0, 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
  1813   - MacOS X ppc and x86 (gcc 4.0.x and 4.2.x)
  1814   - cygwin gcc 3.4.4 (debug only), gcc 4.3.2 (debug and optimized)
  1815   - mingw gcc 3.4.5 (debug only)
  1816 
  1817 Not all ns-3 options are available on all platforms; consult the
  1818 wiki for more information:
  1819 http://www.nsnam.org/wiki/Installation
  1820 
  1821 New user-visible features
  1822 -------------------------
  1823 
  1824   a) 802.11 MAC:
  1825      - EDCA multi-qos-class support (Mirko Banchi)
  1826      - 802.11n initial support for A-MSDU frame aggregation (Mirko Banchi)
  1827      - aarf-cd and cara rate control algorithms (Federico Maguolo)
  1828   b) 802.11 PHY:
  1829      - 802.11b PHY support (Gary Pei)
  1830      - Nakagami propagation loss model (Timo Bingmann)
  1831      - radiotap and prism headers for PCAP output (Nicola Baldo)
  1832   c) RandomVariable:
  1833      - GammaVariable and ErlangVariable (Timo Bingmann)
  1834      - ZipfVariable (Francesco Malandrino)
  1835   d) UdpEcho: allows setting the payload of echo packets
  1836   e) Ipv4/Ipv4RoutingProtocol: allow fine-grained control over
  1837      routing policy and arbitrary composition of routing protocols
  1838  
  1839 API changes from ns-3.4
  1840 -----------------------
  1841 API changes for this release are documented in the file CHANGES.html.  The
  1842 internal API and composition of the IPv4 stack underwent significant
  1843 refactoring in this release cycle.
  1844 
  1845 Known issues
  1846 ------------
  1847 ns-3 build is known to fail on the following platforms:
  1848   - gcc 3.3 and earlier
  1849   - optimized builds on gcc 3.4.4 and 3.4.5
  1850   - optimized builds on linux x86 gcc 4.0.x
  1851 
  1852 Future releases
  1853 ---------------
  1854 Our next release, which is expected to happen in 2 to 4 months from now, will
  1855 feature the merging of some of our projects currently in development including
  1856 fuller IPv6 support, some smaller features such as a new Global ARP 
  1857 package, and possibly a new Testing and Validation suite.
  1858 
  1859 Release 3.4
  1860 ===========
  1861 
  1862 Availability
  1863 ------------
  1864 This release is immediately available from:
  1865 http://www.nsnam.org/release/ns-allinone-3.4.tar.bz2
  1866 
  1867 Supported platforms
  1868 -------------------
  1869 ns-3.4 has been tested on the following platforms:
  1870   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
  1871   - linux x86_64 gcc 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
  1872   - MacOS X ppc and x86
  1873   - cygwin gcc 3.4.4 (debug only)
  1874 
  1875 Not all ns-3 options are available on all platforms; consult the
  1876 wiki for more information:
  1877 http://www.nsnam.org/wiki/Installation
  1878 
  1879 New user-visible features
  1880 -------------------------
  1881   a) Wifi models: Timo Bingman contributed a ThreeLogDistance and a Nakagami
  1882      propagation loss model based on the ns-2 models. Fabian Mauchle contributed
  1883      multicast support.
  1884 
  1885   b) Object Name Service:  A facility allowing ns-3 Objects to be assigned
  1886      names has been added.
  1887 
  1888   c) Tap Bridge:  A second option for integrating ns-3 with real-world hosts
  1889      has been added.  This allows for real hosts to talk over ns-3 net devices
  1890      and simulated networks.
  1891 
  1892   d) A new build option (ns-3-allinone) has been provided to make it easier for
  1893      users to download and bulid commonly used ns-3 configurations.
  1894 
  1895   e) The ns-3 calendar queue scheduler has been ported to ns-3.
  1896 
  1897   f) XML support has been added to the ConfigStore.
  1898 
  1899 API changes from ns-3.3
  1900 -----------------------
  1901 API changes for this release are documented in the file CHANGES.html
  1902 
  1903 Known issues
  1904 ------------
  1905 ns-3 build is known to fail on the following platforms:
  1906   - gcc 3.3 and earlier
  1907   - optimized builds on gcc 3.4.4 and 3.4.5
  1908   - optimized builds on linux x86 gcc 4.0.x
  1909   - optimized builds on Ubuntu 8.10 alpha 5 x86 gcc4.3.2
  1910   - MinGW
  1911 
  1912 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
  1913 in preparation of the merge of the IPv6 API and implementation.
  1914 
  1915 Future releases
  1916 ---------------
  1917 Our next release, which is expected to happen in 2 to 4 months from now, will
  1918 feature the merging of some of our projects currently in development including
  1919 fuller IPv6 support, and IPv4 and routing protocol refactoring, and some smaller
  1920 features such as a new Global ARP package and possibly a new Testing and Validation
  1921 suite,
  1922 
  1923 Release 3.3
  1924 ===========
  1925 
  1926 Availability
  1927 ------------
  1928 This release is immediately available from:
  1929 http://www.nsnam.org/release/ns-3.3.tar.bz2
  1930 
  1931 Supported platforms
  1932 -------------------
  1933 ns-3.3 has been tested on the following platforms:
  1934   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
  1935   - linux x86_64 gcc 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
  1936   - MacOS X ppc and x86
  1937   - cygwin gcc 3.4.4 (debug only)
  1938 
  1939 Not all ns-3 options are available on all platforms; consult the
  1940 wiki for more information:
  1941 http://www.nsnam.org/wiki/Installation
  1942 
  1943 New user-visible features
  1944 -------------------------
  1945   a) Emulated Net Device
  1946      A new net device has been added as enabling technology for ns-3 emulation
  1947      scenarios.  See src/devices/emu and examples/emu-udp-echo.cc for details.
  1948 
  1949   b) ICMP Support
  1950      Support for several ICMP messages has been added to ns-3.  See 
  1951      src/internet-stack/icmpv4.h for details.
  1952 
  1953   c) IPv6 Address Support
  1954      New clases to support IPv6 addresses has been added to the system.  This
  1955      is enabling technology for fuller IPv6 support scheduled for ns-3.4.
  1956 
  1957   d) A flow-id tag has been added to the contributed code section
  1958 
  1959   e) Star topologies can be created from the topology helper functions
  1960 
  1961   f) The global routing code has been made dynamic (not just limited to
  1962      (pre-simulation computation) and supports stub network interfaces and 
  1963      bridge net devices 
  1964 
  1965   g) A MatchContainer has been added to the configuration subsystem
  1966 
  1967 API changes from ns-3.2
  1968 -----------------------
  1969 API changes for this release are documented in the file CHANGES.html
  1970 
  1971 Known issues
  1972 ------------
  1973 ns-3 build is known to fail on the following platforms:
  1974   - gcc 3.3 and earlier
  1975   - optimized builds on gcc 3.4.4 and 3.4.5
  1976   - optimized builds on linux x86 gcc 4.0.x
  1977   - optimized builds on Ubuntu 8.10 alpha 5 x86 gcc4.3.2
  1978   - MinGW
  1979 
  1980 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
  1981 in preparation of the merge of the IPv6 API and implementation.
  1982 
  1983 Future releases
  1984 ---------------
  1985 Our next release, which is expected to happen in 2 to 4 months from now, will
  1986 feature the merging of some of our projects currently in development including
  1987 fuller IPv6 support, and IPv4 and routing protocol refactoring, and some smaller
  1988 features such as an object naming facility and a new Global ARP package.
  1989 
  1990 Release 3.2
  1991 ===========
  1992 
  1993 Availability
  1994 ------------
  1995 This release is immediately available from:
  1996 http://www.nsnam.org/release/ns-3.2.tar.bz2
  1997 
  1998 Supported platforms
  1999 -------------------
  2000 ns-3.2 has been tested on the following platforms:
  2001   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
  2002   - linux x86_64 gcc 4.3.2, 4.2.3, 4.2.1, 4.1.3, 3.4.6
  2003   - MacOS X ppc and x86
  2004   - cygwin gcc 3.4.4 (debug only)
  2005 
  2006 Not all ns-3 options are available on all platforms; consult the
  2007 wiki for more information:
  2008 http://www.nsnam.org/wiki/Installation
  2009 
  2010 New user-visible features
  2011 -------------------------
  2012   a) Learning bridge (IEEE 802.1D)
  2013     It is now possible to bridge together multiple layer 2 devices to
  2014     create larger layer 2 networks. The Wifi and Csma models support
  2015     this new mode of operation. (contributed by Gustavo Carneiro)
  2016 
  2017   b) Python bindings
  2018     It is now possible to write simulation scripts in python using our 
  2019     python bindings (contributed by Gustavo Carneiro).
  2020 
  2021   c) Real-time simulator
  2022     It is now possible to run simulations synchronized on the real-world
  2023     wall-clock time (contributed by Craig Dowell).
  2024 
  2025   d) Network Simulation Cradle
  2026     It is now possible to use the Network Simulation Cradle 
  2027     (http://www.wand.net.nz/~stj2/nsc/) in ns-3 and run simulations 
  2028     using various versions of kernel TCP network stacks. (contributed
  2029     by Florian Westphal as part of his Google Summer of Code work)
  2030 
  2031   e) A statistics framework
  2032     Joseph Kopena contributed a statistics framework which can be used
  2033     keep track of simulation data in persistent storage across multiple 
  2034     runs (database and ascii file backends are available).
  2035     More information on the wiki:
  2036     http://www.nsnam.org/wiki/Statistical_Framework_for_Network_Simulation
  2037 
  2038 API changes from ns-3.1
  2039 -----------------------
  2040 API changes for this release are documented in the file CHANGES.html
  2041 
  2042 Known issues
  2043 ------------
  2044 ns-3 build is known to fail on the following platforms:
  2045   - gcc 3.3 and earlier
  2046   - optimized builds on gcc 3.4.4 and 3.4.5
  2047   - optimized builds on linux x86 gcc 4.0.x
  2048   - optimized builds on Ubuntu 8.10 alpha 5 x86 gcc4.3.2
  2049   - MinGW
  2050 
  2051 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
  2052 in preparation of the merge of the IPv6 API and implementation.
  2053 
  2054 Future releases
  2055 ---------------
  2056 Our next release, which is expected to happen in 2 to 4 months from now, will
  2057 feature the merging of some of our projects currently in development: IPv6, 
  2058 emulation, and synchronous posix sockets.
  2059 
  2060 Release 3.1 (2008/06/30)
  2061 ========================
  2062 
  2063 The first ns-3 stable release
  2064 -----------------------------
  2065 
  2066 This release is immediately available from:
  2067 http://www.nsnam.org/release/ns-3.1.tar.bz2
  2068 
  2069 We dedicate this initial ns-3 release to our late contributor and friend, 
  2070 Federico Maguolo.
  2071 
  2072 What is ns-3 ?
  2073 --------------
  2074 
  2075 ns-3 is a new discrete-event network simulator designed for supporting network
  2076 research and education. ns-3 features a solid, well documented C++ core and 
  2077 models for TCP/IP (IPv4), several link types including WiFi, and mobility 
  2078 models.
  2079 
  2080 ns-3 is an open source project released under the GNU GPLv2 license which 
  2081 allows anyone to use ns-3 without having to pay any license fee or royalties. 
  2082 ns-3 is actively seeking new contributors to extend the range of supported 
  2083 models and/or to maintain existing models.
  2084 
  2085 Where to get more information about ns-3
  2086 ----------------------------------------
  2087 
  2088 All the ns-3 documentation, is accessible from the ns-3 website: 
  2089 http://www.nsnam.org
  2090 
  2091 Including, tutorials:
  2092 http://www.nsnam.org/tutorials.html
  2093 
  2094 Supported platforms
  2095 -------------------
  2096 
  2097 ns-3 is regularly tested on the following platforms:
  2098   - linux x86 gcc 4.2, 4.1, and, 3.4.6.
  2099   - linux x86_64 gcc 4.1.3, 4.2.1, 3.4.6
  2100   - MacOS X ppc and x86
  2101   - cygwin gcc 3.4.4 (debug only)
  2102 
  2103 Known issues
  2104 ------------
  2105 
  2106 ns-3 is known to fail on the following platforms:
  2107   - gcc 3.3 and earlier
  2108   - optimized builds on gcc 3.4.4 and 3.4.5
  2109   - optimized builds on linux x86 gcc 4.0.x
  2110 
  2111 The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
  2112 in preparation of the merge of the IPv6 API and implementation.
  2113 
  2114 Future releases
  2115 ---------------
  2116 
  2117 Our next release, which is expected to happen in 2 to 4 months from now, will
  2118 feature the merging of some of our projects currently in development: python 
  2119 scripting, IPv6, emulation, a statistics framework and synchronous posix 
  2120 sockets.
  2121 
  2122 Release 3.0.13 (2008/06/02)
  2123 ===========================
  2124 - point to point links generate ppp pcap traces
  2125 - point to point links support asymmetrical data rates.
  2126 - generate doxygen documentation for all attributes and trace sources
  2127 - add ConfigStore and GtkConfigStore to contrib module
  2128 - socket API now support tx and rx buffers: implemented for UDP and TCP
  2129 - ARP cache now supports per-entry pending queues
  2130 - lots of bugfixes and implementation and API cleanups
  2131 
  2132 Warning: among API changes in this release, Application::Start and 
  2133 Application::Stop now interprets the time argument as a relative
  2134 instead of absolute simulation time, to align with how Simulator::Schedule
  2135 behaves.  Any code that calls these APIs in the middle of the simulation 
  2136 will need to be adapted.  
  2137 
  2138 The API of Simulator::StopAt (time) has also changed.  Now it is 
  2139 called Simulator::Stop (time), and takes a relative time, instead of 
  2140 absolute.
  2141 
  2142 Release 3.0.12 (2008/04/07)
  2143 ===========================
  2144     - Add Attribute support to the TypeId metadata system and add
  2145 attribute support to all in-tree models
  2146     - Add a mid-level helper API to build simulation topologies 
  2147 and perform simple ascii and pcap link-level tracing.
  2148     - Large amount of structural changes to accomodate the needs
  2149 of the upcoming python bindings
  2150     - new rate control algorithm (RRAA) and a jakes propagation model
  2151 in the 802.11 model (Federico Maguolo).
  2152     - regression test framework added
  2153     - TCP delayed acknowledgements and multitasking server
  2154 
  2155 Release 3.0.11 (2008/02/15)
  2156 ===========================
  2157     - Initial port of GTNetS TCP implementation (initial version 
  2158 that does not support multitasking or delayed acknowledgments yet, 
  2159 but supports a reliable stream service)
  2160     - Changes to the ns-3 object model to create a TypeId-based 
  2161 metadata system
  2162     - lots of bug fixes throughout the system
  2163     - tutorial updates
  2164 
  2165 Release 3.0.10 (2008/01/15)
  2166 ===========================
  2167    - Add tutorial document content;
  2168    - Valgrind option for "waf" tool;
  2169    - Doxygen organization changes.
  2170 
  2171 Release 3.0.9 (2007/12/15)
  2172 ==========================
  2173    - A 802.11 model ported from Yans. This model supports:
  2174        * a rather extensive PHY model
  2175        * log-distance and friis propagation model
  2176        * a simple set of rate control algorithms (ARF, Ideal, 
  2177          AARF, constant-rate)
  2178        * adhoc and infrastructure mode (beacon+assoc)
  2179    - Use smart pointer for Packet in the APIs
  2180    - A new contrib directory with helper classes: 
  2181      EventGarbageCollector, Gnuplot
  2182    - Tracing support for Applications
  2183    - many bugs fixed
  2184 
  2185 Release 3.0.8 (2007/11/15)
  2186 ==========================
  2187    - A simple error model
  2188    - Source files for ns-3 tutorial
  2189 
  2190 Release 3.0.7 (2007/10/15)
  2191 ==========================
  2192   - OLSR routing protocol
  2193   - A timer class
  2194   - Additional mobility models (random waypoint, random 2D walk)
  2195   - A mobility visualization tool 
  2196 
  2197 Release 3.0.6 (2007/09/15)
  2198 ==========================
  2199   - Static multicast IPv4 routing
  2200   - Logging overhaul (NS_LOG macros)
  2201   - Refactoring of tracing subsystem
  2202   - Tutorial document started
  2203  
  2204 Release 3.0.5 (2007/08/15)
  2205 ==========================
  2206 
  2207   - Refactoring to support win32-based unix environments (Cygwin, mingw)
  2208   - "Packet socket" for allowing applications to access NetDevices directly
  2209   - Generalized, polymorphic Address class
  2210   - Add CSMA NetDevice model (from Emmanuelle Laprise)
  2211   - Modularize IPv4 routing support (from Gustavo Carneiro)
  2212   - Add mobility framework and basic mobility models 
  2213   - Global unicast centralized routing 
  2214 
  2215 Release 3.0.4 (2007/07/15)
  2216 ==========================
  2217 
  2218   - Enable waf as the default build system.
  2219   - Per-packet metadata:  a system to track which headers and trailers 
  2220     are added to a packet
  2221   - Simplifications to point-to-point devices and channel
  2222 
  2223 Release 3.0.3 (2007/06/15)
  2224 ==========================
  2225 
  2226   - Enable Waf for release tarballs: users can now build ns-3
  2227     with the "waf" tool. See doc/build-waf.txt.
  2228   - Add support for variable time precision: it is now possible
  2229     to run a simulation with an accuracy which is higher or lower
  2230     than a nanosecond: seconds, milliseconds, microseconds, 
  2231     femtoseconds and picoseconds are supported.
  2232   - Optimize and rework the COM framework, solidify the component 
  2233     manager
  2234   - Many small API cleanups
  2235 
  2236 Release 3.0.2 (2007/05/18)
  2237 ==========================
  2238 
  2239   - Implement a new memory management infrastructure based
  2240     on reference counting and smart pointers (the latter being
  2241     optional)
  2242 
  2243   - Implement a COM-like framework with support for QueryInterface
  2244     to provide object extensibility
  2245 
  2246   - Add support for a BSD-style socket API for user applications
  2247 
  2248 Release 3.0.1 (2007/03/31)
  2249 ==========================
  2250 
  2251   - First public release; not yet pre-alpha.
  2252 
  2253   - Simple UDP-based simulation script (examples/simple-p2p.cc)