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