RELEASE_NOTES
author Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
Fri, 29 Aug 2008 14:56:24 +0100
changeset 3567 728eb3f583b3
parent 3480 a920df6b9f02
child 3593 dfd634417b8d
permissions -rw-r--r--
Require new PyBindGen (now ignores the badly scanned anonymous containers that cause problems on cygwin) and rescan API.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
421
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     1
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     2
		ns-3 RELEASE NOTES
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     3
657
be551a3b07c6 minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents: 635
diff changeset
     4
This file contains ns-3 release notes (most recent releases first).
421
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     5
3466
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
     6
Release 3.2 (pending)
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
     7
=====================
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
     8
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
     9
New functionality added
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    10
-----------------------
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    11
- Add learning bridge (IEEE 802.1D) implementation: BridgeNetDevice;
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    12
- Python bindings added
3426
108fd72e3291 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3361
diff changeset
    13
- Kernel thread support (class SystemThread) added;
108fd72e3291 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3361
diff changeset
    14
- Kernel mutual exclusion support (class SystemMutex) added;
108fd72e3291 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3361
diff changeset
    15
- Kernel critical section RAII support (class CriticalSection) added;
108fd72e3291 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3361
diff changeset
    16
- Kernel system condition support (class SystemCondition) added;
108fd72e3291 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3361
diff changeset
    17
- Move required methods in helper classes to constructors;
108fd72e3291 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3361
diff changeset
    18
- Change obsolete references to Parameter to Attribute in helpers;
3471
0896bd4a38dd update on-demand RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3426
diff changeset
    19
- Split simulator into interface and implementation pieces, make 
0896bd4a38dd update on-demand RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3426
diff changeset
    20
  implementation a replaceable component via the 
0896bd4a38dd update on-demand RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3426
diff changeset
    21
  "SimulatorImplementationType" global value.
0896bd4a38dd update on-demand RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3426
diff changeset
    22
  Hint:  try ./waf --run "udp-echo --PrintGlobals"
3466
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    23
- implement Packet::PeekHeader and Packet::PeekTrailer to avoid evil workarounds when receiving tcp packets. 
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    24
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    25
Bugs fixed
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    26
----------
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    27
- add optional support for TCP and UDP checksum (bug 236)
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    28
- close socket upon PacketSink::StopApplication (bug 243)
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    29
- fix build failure with gcc 4.3.x (bug 245)
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    30
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    31
API changes from 3.1 to 3.2
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    32
---------------------------
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    33
- several helper APIs related to attribute setting (changeset d5f8e5fae1c6, 
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    34
  bug 234); old variants are currently deprecated API and will be removed
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    35
  in a future release
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    36
- remove references to Parameter in helper APIs (changeset 3cdd9d60f7c7,
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    37
  bug 232); old variants are currently deprecated API and will be removed
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    38
  in a future release
3480
a920df6b9f02 Make the new NetDevice APIs pure virtual methods, by Mathieu's insistence.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3472
diff changeset
    39
- New NetDevice APIs: SendFrom, SetPromiscRxCallback,
a920df6b9f02 Make the new NetDevice APIs pure virtual methods, by Mathieu's insistence.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3472
diff changeset
    40
  SupportsPromiscuous.  These are pure virtual methods, so they need
a920df6b9f02 Make the new NetDevice APIs pure virtual methods, by Mathieu's insistence.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3472
diff changeset
    41
  to be implemented by NetDevice subclasses;
3465
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    42
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    43
In order to support the learning bridge, some API changes in Node and
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    44
NetDevice were made.
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    45
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    46
In NetDevice, devices may optionally implement the virtual methods
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    47
SendFrom, SupportsPromiscuous, and SetPromiscReceiveCallback.  If
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    48
these new methods are not implemented, the code still compiles and
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    49
works, except if they are used in a BridgeNetDevice.
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    50
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    51
In Node, the signature for protocol handler callbacks (used in
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    52
AddProtocolHandler) has changed.  Now it looks like:
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    53
3466
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    54
  void ReceiveFromDevice (Ptr<NetDevice> device, Ptr<Packet> packet, 
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    55
    uint16_t protocol, Address const &source, Address const &destination, 
cbf5120f5eb6 more details for 3.2 release notes
Tom Henderson <tomh@tomh.org>
parents: 3465
diff changeset
    56
    PacketType packetType);
3465
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    57
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    58
The extra parameters 'destination' and 'packetType' are present for
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    59
all protocol handlers, but only have valid values for promiscuous
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    60
protocol handlers.  Protocol handlers are non-promiscuous by default,
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    61
so no action is needed to adapt existing code besides updating the
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    62
callback signature.
a1d2a8165500 Add release notes.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 3426
diff changeset
    63
3357
93218ac0d373 Prepare for 3.1
Craig Dowell <craigdo@ee.washington.edu>
parents: 3279
diff changeset
    64
Release 3.1 (2008/06/30)
3279
Craig Dowell <craigdo@ee.washington.edu>
parents: 3196
diff changeset
    65
========================
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    66
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    67
The first ns-3 stable release
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    68
-----------------------------
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    69
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    70
This release is immediately available from:
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    71
http://www.nsnam.org/releases/ns-3.1.tar.bz2
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    72
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    73
We dedicate this initial ns-3 release to our late contributor and friend, 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    74
Federico Maguolo.
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    75
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    76
What is ns-3 ?
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    77
--------------
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    78
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    79
ns-3 is a new discrete-event network simulator designed for supporting network
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    80
research and education. ns-3 features a solid, well documented C++ core and 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    81
models for TCP/IP (IPv4), several link types including WiFi, and mobility 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    82
models.
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    83
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    84
ns-3 is an open source project released under the GNU GPLv2 license which 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    85
allows anyone to use ns-3 without having to pay any license fee or royalties. 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    86
ns-3 is actively seeking new contributors to extend the range of supported 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    87
models and/or to maintain existing models.
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    88
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    89
Where to get more information about ns-3
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    90
----------------------------------------
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    91
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    92
All the ns-3 documentation, is accessible from the ns-3 website: 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    93
http://www.nsnam.org
3279
Craig Dowell <craigdo@ee.washington.edu>
parents: 3196
diff changeset
    94
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    95
Including, tutorials:
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    96
http://www.nsnam.org/tutorials.html
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    97
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    98
Supported platforms
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
    99
-------------------
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   100
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   101
ns-3 is regularly tested on the following platforms:
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   102
  - linux x86 gcc 4.2, 4.1, and, 3.4.6.
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   103
  - linux x86_64 gcc 4.1.3, 4.2.1, 3.4.6
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   104
  - MacOS X ppc and x86
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   105
  - cygwin gcc 3.4.4 (debug only)
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   106
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   107
Known issues
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   108
------------
3279
Craig Dowell <craigdo@ee.washington.edu>
parents: 3196
diff changeset
   109
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   110
ns-3 is known to fail on the following platforms:
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   111
  - gcc 3.3 and earlier
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   112
  - optimized builds on gcc 3.4.4 and 3.4.5
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   113
  - optimized builds on linux x86 gcc 4.0.x
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   114
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   115
The IPv4 API defined in src/node/ipv4.h is expected to undergo major changes 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   116
in preparation of the merge of the IPv6 API and implementation.
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   117
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   118
Future releases
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   119
---------------
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   120
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   121
Our next release, which is expected to happen in 2 to 4 months from now, will
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   122
feature the merging of some of our projects currently in development: python 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   123
scripting, IPv6, emulation, a statistics framework and synchronous posix 
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   124
sockets.
3279
Craig Dowell <craigdo@ee.washington.edu>
parents: 3196
diff changeset
   125
3194
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   126
Release 3.0.13 (2008/06/02)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   127
===========================
3194
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   128
- point to point links generate ppp pcap traces
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   129
- point to point links support asymmetrical data rates.
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   130
- generate doxygen documentation for all attributes and trace sources
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   131
- add ConfigStore and GtkConfigStore to contrib module
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   132
- socket API now support tx and rx buffers: implemented for UDP and TCP
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   133
- ARP cache now supports per-entry pending queues
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   134
- lots of bugfixes and implementation and API cleanups
79dba133b5f8 update RELEASE_NOTES and a few other files
Tom Henderson <tomh@tomh.org>
parents: 2891
diff changeset
   135
3196
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   136
Warning: among API changes in this release, Application::Start and 
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   137
Application::Stop now interprets the time argument as a relative
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   138
instead of absolute simulation time, to align with how Simulator::Schedule
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   139
behaves.  Any code that calls these APIs in the middle of the simulation 
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   140
will need to be adapted.  
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   141
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   142
The API of Simulator::StopAt (time) has also changed.  Now it is 
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   143
called Simulator::Stop (time), and takes a relative time, instead of 
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   144
absolute.
539a710e5cf9 Gustavo's API warnings
Tom Henderson <tomh@tomh.org>
parents: 3194
diff changeset
   145
2891
aeca90b95bf5 nits for 3.0.12 release
Tom Henderson <tomh@tomh.org>
parents: 2842
diff changeset
   146
Release 3.0.12 (2008/04/07)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   147
===========================
2842
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   148
    - Add Attribute support to the TypeId metadata system and add
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   149
attribute support to all in-tree models
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   150
    - Add a mid-level helper API to build simulation topologies 
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   151
and perform simple ascii and pcap link-level tracing.
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   152
    - Large amount of structural changes to accomodate the needs
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   153
of the upcoming python bindings
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   154
    - new rate control algorithm (RRAA) and a jakes propagation model
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   155
in the 802.11 model (Federico Maguolo).
2891
aeca90b95bf5 nits for 3.0.12 release
Tom Henderson <tomh@tomh.org>
parents: 2842
diff changeset
   156
    - regression test framework added
aeca90b95bf5 nits for 3.0.12 release
Tom Henderson <tomh@tomh.org>
parents: 2842
diff changeset
   157
    - TCP delayed acknowledgements and multitasking server
2842
d6a128110975 initial draft of release notes.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2337
diff changeset
   158
2337
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   159
Release 3.0.11 (2008/02/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   160
===========================
2337
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   161
    - Initial port of GTNetS TCP implementation (initial version 
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   162
that does not support multitasking or delayed acknowledgments yet, 
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   163
but supports a reliable stream service)
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   164
    - Changes to the ns-3 object model to create a TypeId-based 
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   165
metadata system
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   166
    - lots of bug fixes throughout the system
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   167
    - tutorial updates
604a3bc1fbb3 initial release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2219
diff changeset
   168
2219
b5bf2588cde2 bump version and add release notes
Craig Dowell <craigdo@ee.washington.edu>
parents: 2194
diff changeset
   169
Release 3.0.10 (2008/01/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   170
===========================
2219
b5bf2588cde2 bump version and add release notes
Craig Dowell <craigdo@ee.washington.edu>
parents: 2194
diff changeset
   171
   - Add tutorial document content;
b5bf2588cde2 bump version and add release notes
Craig Dowell <craigdo@ee.washington.edu>
parents: 2194
diff changeset
   172
   - Valgrind option for "waf" tool;
b5bf2588cde2 bump version and add release notes
Craig Dowell <craigdo@ee.washington.edu>
parents: 2194
diff changeset
   173
   - Doxygen organization changes.
2194
25bad6958d13 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 2192
diff changeset
   174
2185
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   175
Release 3.0.9 (2007/12/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   176
==========================
2185
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   177
   - A 802.11 model ported from Yans. This model supports:
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   178
       * a rather extensive PHY model
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   179
       * log-distance and friis propagation model
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   180
       * a simple set of rate control algorithms (ARF, Ideal, 
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   181
         AARF, constant-rate)
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   182
       * adhoc and infrastructure mode (beacon+assoc)
2192
4db981a0d9eb bump VERSION and finish RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 2185
diff changeset
   183
   - Use smart pointer for Packet in the APIs
4db981a0d9eb bump VERSION and finish RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 2185
diff changeset
   184
   - A new contrib directory with helper classes: 
4db981a0d9eb bump VERSION and finish RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 2185
diff changeset
   185
     EventGarbageCollector, Gnuplot
4db981a0d9eb bump VERSION and finish RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 2185
diff changeset
   186
   - Tracing support for Applications
2185
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   187
   - many bugs fixed
d3582be30902 initial release notes for upcoming release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 1850
diff changeset
   188
1850
560a5091e0e6 release files
Craig Dowell <craigdo@ee.washington.edu>
parents: 1785
diff changeset
   189
Release 3.0.8 (2007/11/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   190
==========================
1850
560a5091e0e6 release files
Craig Dowell <craigdo@ee.washington.edu>
parents: 1785
diff changeset
   191
   - A simple error model
560a5091e0e6 release files
Craig Dowell <craigdo@ee.washington.edu>
parents: 1785
diff changeset
   192
   - Source files for ns-3 tutorial
560a5091e0e6 release files
Craig Dowell <craigdo@ee.washington.edu>
parents: 1785
diff changeset
   193
1785
04704f042c03 Release notes for 3.0.7
Tom Henderson <tomh@tomh.org>
parents: 1516
diff changeset
   194
Release 3.0.7 (2007/10/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   195
==========================
1785
04704f042c03 Release notes for 3.0.7
Tom Henderson <tomh@tomh.org>
parents: 1516
diff changeset
   196
  - OLSR routing protocol
04704f042c03 Release notes for 3.0.7
Tom Henderson <tomh@tomh.org>
parents: 1516
diff changeset
   197
  - A timer class
04704f042c03 Release notes for 3.0.7
Tom Henderson <tomh@tomh.org>
parents: 1516
diff changeset
   198
  - Additional mobility models (random waypoint, random 2D walk)
04704f042c03 Release notes for 3.0.7
Tom Henderson <tomh@tomh.org>
parents: 1516
diff changeset
   199
  - A mobility visualization tool 
04704f042c03 Release notes for 3.0.7
Tom Henderson <tomh@tomh.org>
parents: 1516
diff changeset
   200
1516
6c4850dc539e release notes for 3.0.6
Tom Henderson <tomh@tomh.org>
parents: 1284
diff changeset
   201
Release 3.0.6 (2007/09/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   202
==========================
1516
6c4850dc539e release notes for 3.0.6
Tom Henderson <tomh@tomh.org>
parents: 1284
diff changeset
   203
  - Static multicast IPv4 routing
6c4850dc539e release notes for 3.0.6
Tom Henderson <tomh@tomh.org>
parents: 1284
diff changeset
   204
  - Logging overhaul (NS_LOG macros)
6c4850dc539e release notes for 3.0.6
Tom Henderson <tomh@tomh.org>
parents: 1284
diff changeset
   205
  - Refactoring of tracing subsystem
6c4850dc539e release notes for 3.0.6
Tom Henderson <tomh@tomh.org>
parents: 1284
diff changeset
   206
  - Tutorial document started
6c4850dc539e release notes for 3.0.6
Tom Henderson <tomh@tomh.org>
parents: 1284
diff changeset
   207
 
1284
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   208
Release 3.0.5 (2007/08/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   209
==========================
999
a3c715562d79 start filling release notes with merged items
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 929
diff changeset
   210
1284
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   211
  - Refactoring to support win32-based unix environments (Cygwin, mingw)
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   212
  - "Packet socket" for allowing applications to access NetDevices directly
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   213
  - Generalized, polymorphic Address class
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   214
  - Add CSMA NetDevice model (from Emmanuelle Laprise)
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   215
  - Modularize IPv4 routing support (from Gustavo Carneiro)
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   216
  - Add mobility framework and basic mobility models 
e201ec8a248f Release notes updated
Tom Henderson <tomh@tomh.org>
parents: 999
diff changeset
   217
  - Global unicast centralized routing 
999
a3c715562d79 start filling release notes with merged items
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 929
diff changeset
   218
929
9394956b7fc4 changes for 3.0.4 release
Tom Henderson <tomh@tomh.org>
parents: 759
diff changeset
   219
Release 3.0.4 (2007/07/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   220
==========================
929
9394956b7fc4 changes for 3.0.4 release
Tom Henderson <tomh@tomh.org>
parents: 759
diff changeset
   221
9394956b7fc4 changes for 3.0.4 release
Tom Henderson <tomh@tomh.org>
parents: 759
diff changeset
   222
  - Enable waf as the default build system.
9394956b7fc4 changes for 3.0.4 release
Tom Henderson <tomh@tomh.org>
parents: 759
diff changeset
   223
  - Per-packet metadata:  a system to track which headers and trailers 
9394956b7fc4 changes for 3.0.4 release
Tom Henderson <tomh@tomh.org>
parents: 759
diff changeset
   224
    are added to a packet
9394956b7fc4 changes for 3.0.4 release
Tom Henderson <tomh@tomh.org>
parents: 759
diff changeset
   225
  - Simplifications to point-to-point devices and channel
9394956b7fc4 changes for 3.0.4 release
Tom Henderson <tomh@tomh.org>
parents: 759
diff changeset
   226
759
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   227
Release 3.0.3 (2007/06/15)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   228
==========================
759
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   229
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   230
  - Enable Waf for release tarballs: users can now build ns-3
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   231
    with the "waf" tool. See doc/build-waf.txt.
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   232
  - Add support for variable time precision: it is now possible
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   233
    to run a simulation with an accuracy which is higher or lower
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   234
    than a nanosecond: seconds, milliseconds, microseconds, 
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   235
    femtoseconds and picoseconds are supported.
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   236
  - Optimize and rework the COM framework, solidify the component 
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   237
    manager
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   238
  - Many small API cleanups
8d6562ea21a4 add release notes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 657
diff changeset
   239
657
be551a3b07c6 minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents: 635
diff changeset
   240
Release 3.0.2 (2007/05/18)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   241
==========================
635
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   242
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   243
  - Implement a new memory management infrastructure based
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   244
    on reference counting and smart pointers (the latter being
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   245
    optional)
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   246
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   247
  - Implement a COM-like framework with support for QueryInterface
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   248
    to provide object extensibility
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   249
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   250
  - Add support for a BSD-style socket API for user applications
71b92dfe5f55 write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 421
diff changeset
   251
657
be551a3b07c6 minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents: 635
diff changeset
   252
Release 3.0.1 (2007/03/31)
3361
b8db6cd10444 update RELEASE_NOTES
Craig Dowell <craigdo@ee.washington.edu>
parents: 3357
diff changeset
   253
==========================
421
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
   254
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
   255
  - First public release; not yet pre-alpha.
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
   256
56928998e05c Final pre-release files
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
   257
  - Simple UDP-based simulation script (examples/simple-p2p.cc)