CHANGES.html
author Stefano Avallone <stavallo@unina.it>
Thu, 14 Sep 2017 18:12:19 +0200
changeset 13060 7670ef916b21
parent 13059 037e9046f940
child 13061 80f47eaeae23
permissions -rw-r--r--
traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     1
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     2
<html>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     3
<head>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     4
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     5
   <title>ns-3 Change Log</title>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     6
</head>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     7
<body>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     8
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     9
<h1>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    10
ns-3: API and model change history</h1>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    11
<!--
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    12
This ChangeLog is updated in the reverse order 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    13
with the most recent changes coming first.  Date format:  DD-MM-YYYY
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    14
-->
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    15
<p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    16
ns-3 is an evolving system and there will be API or behavioral changes
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    17
from time to time.   Users who try to use scripts or models across
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    18
versions of ns-3 may encounter problems at compile time, run time, or
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    19
may see the simulation output change.  </p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    20
<p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    21
We have adopted the development policy that we are going to try to ease
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    22
the impact of these changes on users by documenting these changes in a
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    23
single place (this file), and not by providing a temporary or permanent
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    24
backward-compatibility software layer.  </p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    25
<p>
9212
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
    26
A related file is the RELEASE_NOTES file in the top level directory.
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
    27
This file complements RELEASE_NOTES by focusing on API and behavioral
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
    28
changes that users upgrading from one release to the next may encounter.
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
    29
RELEASE_NOTES attempts to comprehensively list all of the changes
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
    30
that were made.  There is generally some overlap in the information 
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
    31
contained in RELEASE_NOTES and this file.  </p>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
    32
<p>
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    33
The goal is that users who encounter a problem when trying to use older
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    34
code with newer code should be able to consult this file to find
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    35
guidance as to how to fix the problem.  For instance, if a method name
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    36
or signature has changed, it should be stated what the new replacement
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    37
name is. </p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    38
<p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    39
Note that users who upgrade the simulator across versions, or who work
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    40
directly out of the development tree, may find that simulation output
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    41
changes even when the compilation doesn't break, such as when a
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    42
simulator default value is changed.  Therefore, it is good practice for
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    43
_anyone_ using code across multiple ns-3 releases to consult this file,
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    44
as well as the RELEASE_NOTES, to understand what has changed over time.
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    45
</p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    46
<p>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    47
This file is a best-effort approach to solving this issue; we will do
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    48
our best but can guarantee that there will be things that fall through
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    49
the cracks, unfortunately.  If you, as a user, can suggest improvements
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    50
to this file based on your experience, please contribute a patch or drop
7791
21c3495394b4 Enhancement 1393 - IPv6 Routing Helper RT Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7717
diff changeset
    51
us a note on ns-developers mailing list.</p>
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    52
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    53
<hr>
12363
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
    54
<h1>Changes from ns-3.26 to ns-3.27</h1>
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
    55
<h2>New API:</h2>
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
    56
<ul>
12804
a87af91635ce Document new vector API in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12790
diff changeset
    57
<li>Added <code>Vector{2,3}D.GetLength ()</code>.</li>
a87af91635ce Document new vector API in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12790
diff changeset
    58
<li>Overloaded <code>operator+</code> and <code>operator-</code> for <code>Vector{2,3}D</code>.</li>
12790
8154ca19d840 Document WifiHelper::Install in CHANGES
Alexander Krotov <krotov@iitp.ru>
parents: 12745
diff changeset
    59
<li>Added iterator version of WifiHelper::Install() to install Wi-Fi devices on range of nodes.</li>
12672
10ea1cca0a24 tcp: Advertised Window was still incorrect
Christoph Döpmann <doepmanc@informatik.hu-berlin.de>
parents: 12668
diff changeset
    60
<li>Added a new attribute in TcpSocketBase to track the advertised window.</li>
12668
64600193d9dc tcp: Added TCP Ledbat
Ankit Deepak <adadeepak8@gmail.com>
parents: 12655
diff changeset
    61
<li>Included the model of <b>TCP Ledbat</b>.</li>
64600193d9dc tcp: Added TCP Ledbat
Ankit Deepak <adadeepak8@gmail.com>
parents: 12655
diff changeset
    62
<li>Included the TCP SACK-based loss recovery algorithm outlined in RFC 6675.</li>
12651
4fe9e782a0f6 tcp: updated CHANGES.html and RELEASE_NOTES
Natale Patriciello <natale.patriciello@gmail.com>
parents: 12589
diff changeset
    63
<li>Added <b>TCP SACK</b> and the <b>SACK emulation</b>. Added an Attribute to TcpSocketBase class,
4fe9e782a0f6 tcp: updated CHANGES.html and RELEASE_NOTES
Natale Patriciello <natale.patriciello@gmail.com>
parents: 12589
diff changeset
    64
    called "Sack", to enable or disable the SACK option usage.</li>
12583
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    65
<li>In 'src/wifi', several changes were made to enable partial <b>802.11ax</b> High Effiency (HE) support:
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    66
    <ul>
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    67
      <li>A new standard value has been added that enables the new 11ax data rates.</li>
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    68
      <li>A new 11ax preamble has been added.</li>
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    69
      <li>A new attribute was added to configure the guard interval duration for High Efficiency (HE) PHY entities. This attribute can be set using the YansWifiPhyHelper.</li>
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    70
      <li>A new information element has been added:  HeCapabilities. This information element is added to the MAC frame header if the node is a HE node. This HeCapabilites information element is used to advertise the HE capabilites of the node to other nodes in the network.</li>
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    71
    </ul>
40a9ab9779c6 wifi: Add initial support for 802.11ax
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12571
diff changeset
    72
</li>
12694
5209b094838e wifi: add RRPAA wifi rate control (patch from Matias Richart)
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12672
diff changeset
    73
<li> A new class were added for the RRPAA WiFi rate control mechanism.</li>
12654
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    74
<li>Included carrier aggregation feature in LTE module</li>
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    75
    <ul>
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    76
      <li>LTE model is extended to support carrier aggregation feature according to 3GPP Release 10, for up to 5 component 
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    77
      carriers. </li>
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    78
      <li>InstallSingleEnbDevice and InstalSingeUeDevice functions of LteHelper are now constructing LteEnbDevice and LteUeDevice 
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    79
      according to CA architecture. Each device, UE and eNodeB contains an instance of component carrier manager, and may 
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    80
      have several component carrier instances.</li>
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    81
      <li>SAP interfaces are extended to include CA message exchange funtionality.</li>
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    82
      <li>RRC connection procedure is extended to allow RRC connection reconfiguration for the configuration of the secondary carriers.</li>
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    83
      <li>RRC measurement reporting is extended to allow measurement reporting from the secondary carriers.</li>
12655
a471df71edfe lte: remove empty line from changes.html
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12654
diff changeset
    84
      <li>LTE traces are extended to include component carrier id.</li>
12654
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    85
    </ul>
3866ca3832eb lte: update release notes, changes, and lte 3GPP release version.
Biljana Bojovic <biljana.bojovic@gmail.com>
parents: 12651
diff changeset
    86
</li>
12389
d99ffe039f18 routing: (fixes #2527) Extend PrintRoutingTable to specify the time unit for the report.
Robert Ammon <ammo6818@vandals.uidaho.edu>
parents: 12375
diff changeset
    87
<li>Function <b>PrintRoutingTable</b> has been extended to add an optional Time::Units
d99ffe039f18 routing: (fixes #2527) Extend PrintRoutingTable to specify the time unit for the report.
Robert Ammon <ammo6818@vandals.uidaho.edu>
parents: 12375
diff changeset
    88
    parameter to specify the time units used on the report.  The new parameter is
d99ffe039f18 routing: (fixes #2527) Extend PrintRoutingTable to specify the time unit for the report.
Robert Ammon <ammo6818@vandals.uidaho.edu>
parents: 12375
diff changeset
    89
    optional and if not specified defaults to the previous behavior (Time::S).
d99ffe039f18 routing: (fixes #2527) Extend PrintRoutingTable to specify the time unit for the report.
Robert Ammon <ammo6818@vandals.uidaho.edu>
parents: 12375
diff changeset
    90
</li>
12451
ac1e0cdd5ca9 wifi: (fixes #2463) Add TxopTrace trace source to EdcaTxopN
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12425
diff changeset
    91
<li><b>TxopTrace</b>: new trace source exported by EdcaTxopN.</li>
12745
8d6d77be85bc flow-monitor: Keep track of the DSCP value of packets
Stefano Avallone <stavallo@unina.it>
parents: 12742
diff changeset
    92
<li>A <b>GetDscpCounts</b> method is added to <b>Ipv4FlowClassifier</b> and <b>Ipv6FlowClassifier</b>
8d6d77be85bc flow-monitor: Keep track of the DSCP value of packets
Stefano Avallone <stavallo@unina.it>
parents: 12742
diff changeset
    93
    which returns a vector of pairs (dscp,count), each of which indicates how many packets with the
8d6d77be85bc flow-monitor: Keep track of the DSCP value of packets
Stefano Avallone <stavallo@unina.it>
parents: 12742
diff changeset
    94
    associated dscp value have been classified for a given flow.
8d6d77be85bc flow-monitor: Keep track of the DSCP value of packets
Stefano Avallone <stavallo@unina.it>
parents: 12742
diff changeset
    95
</li>
12889
d9a9fc0dbe01 traffic-control: Add the mq queue disc
Stefano Avallone <stavallo@unina.it>
parents: 12808
diff changeset
    96
<li>MqQueueDisc, a multi-queue aware queue disc modelled after the mq qdisc in Linux, has been introduced.
d9a9fc0dbe01 traffic-control: Add the mq queue disc
Stefano Avallone <stavallo@unina.it>
parents: 12808
diff changeset
    97
</li>
13060
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
    98
<li>Added <b>QueueDisc::GetStats()</b> which returns detailed statistics about the operations of a queue disc.
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
    99
    Consequently, a number of methods of the QueueDisc class have been removed: <b>GetTotalReceivedPackets()</b>,
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
   100
    <b>GetTotalReceivedBytes()</b>, <b>GetTotalDroppedPackets()</b>, <b>GetTotalDroppedBytes()</b>,
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
   101
    <b>GetTotalRequeuedPackets()</b>, <b>GetTotalRequeuedBytes()</b>.
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
   102
</li>
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
   103
<li>Two new methods, <b>QueueDisc::DropBeforeEnqueue()</b> and <b>QueueDisc::DropAfterDequeue()</b> have
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
   104
    been introduced to replace <b>QueueDisc::Drop()</b>. Correspondingly, two new trace sources have been added to the QueueDisc class: DropBeforeEnqueue and DropAfterDequeue.
7670ef916b21 traffic-control: (fixes #2751) Ensure queue discs keep correct statistics
Stefano Avallone <stavallo@unina.it>
parents: 13059
diff changeset
   105
</li>
12363
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   106
</ul>
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   107
<h2>Changes to existing API:</h2>
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   108
<ul>
12397
6572761077e5 core: (fixes #2513) - Deprecates Mean attribute in ParetoRandomVariable
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12389
diff changeset
   109
<li><b>ParetoRandomVariable</b> "Mean" attribute has been deprecated, 
6572761077e5 core: (fixes #2513) - Deprecates Mean attribute in ParetoRandomVariable
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12389
diff changeset
   110
    the "Scale" Attribute have to be used instead.
6572761077e5 core: (fixes #2513) - Deprecates Mean attribute in ParetoRandomVariable
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12389
diff changeset
   111
    Changing the Mean attribute has no more an effect on the distribution.
6572761077e5 core: (fixes #2513) - Deprecates Mean attribute in ParetoRandomVariable
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12389
diff changeset
   112
    See the documentation for the relationship between Mean, Scale and Shape. 
6572761077e5 core: (fixes #2513) - Deprecates Mean attribute in ParetoRandomVariable
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12389
diff changeset
   113
</li>
12560
9bf327ae8008 core: (fixes #2490) Change logging timestamp precision
Tom Henderson <tomh@tomh.org>
parents: 12505
diff changeset
   114
<li>The default logging timestamp precision has been changed from 6 digits
9bf327ae8008 core: (fixes #2490) Change logging timestamp precision
Tom Henderson <tomh@tomh.org>
parents: 12505
diff changeset
   115
    to 9 digits, with a fixed format to ensure that 9 digits to the right of
9bf327ae8008 core: (fixes #2490) Change logging timestamp precision
Tom Henderson <tomh@tomh.org>
parents: 12505
diff changeset
   116
    the decimal point are always printed.  Previously, default C++ iostream
9bf327ae8008 core: (fixes #2490) Change logging timestamp precision
Tom Henderson <tomh@tomh.org>
parents: 12505
diff changeset
   117
    precision and formatting was used.
9bf327ae8008 core: (fixes #2490) Change logging timestamp precision
Tom Henderson <tomh@tomh.org>
parents: 12505
diff changeset
   118
</li>
12571
80142e260133 wifi: code refactoring phase 1
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12564
diff changeset
   119
<li>Abstract base class <b>WifiChannel</b> has been removed. As a result, a Channel type instead of a WifiChannel type
80142e260133 wifi: code refactoring phase 1
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12564
diff changeset
   120
is now exported by WifiNetDevice.</li>
12742
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   121
<li> The <b>GetPacketSize</b> method of <b>QueueItem</b> has been renamed <b>GetSize</b>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   122
</li>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   123
<li> The <b>DequeueAll</b> method of <b>Queue</b> has been renamed <b>Flush</b>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   124
</li>
12413
f379a30efa16 wifi: (fixes #2533) Improve 802.11n MIMO PHY abstraction
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12397
diff changeset
   125
<li>The attributes <b>WifiPhy::TxAntennas</b> and <b>WifiPhy::RxAntennas</b>,
f379a30efa16 wifi: (fixes #2533) Improve 802.11n MIMO PHY abstraction
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12397
diff changeset
   126
    and the related accessor methods, were replaced by <b>WifiPhy::MaxSupportedTxSpatialStreams</b>
f379a30efa16 wifi: (fixes #2533) Improve 802.11n MIMO PHY abstraction
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12397
diff changeset
   127
    and <b>WifiPhy::MaxSupportedRxSpatialStreams</b>. A new attribute <b>WifiPhy::Antennas</b>
f379a30efa16 wifi: (fixes #2533) Improve 802.11n MIMO PHY abstraction
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12397
diff changeset
   128
    was added to allow users to define the number of physical antennas on the device.
f379a30efa16 wifi: (fixes #2533) Improve 802.11n MIMO PHY abstraction
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12397
diff changeset
   129
</li>
12936
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   130
<li>Sockets do not receive anymore broadcast packets, unless they are bound to an "Any" address (0.0.0.0)
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   131
    or to a subnet-directed broadcast packet (e.g., x.y.z.0 for a /24 noterok).
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   132
    As in Linux, the following rules are now enforced:
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   133
    <ul>
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   134
    <li> A socket bound to 0.0.0.0 will receive everything.</li>
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   135
    <li> A socket bound to x.y.z.0/24 will receive subnet-directed broadcast (x.y.z.255) and unicast packets.</li>
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   136
    <li> A socket bound to x.y.z.w will only receive unicast packets.</li>
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   137
    </ul> 
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   138
    <b>Previously, a socket bound to an unicast address received also subnet-directed broadcast packets. 
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   139
    This is not anymore possible</b>.
eb1a121ab8bd internet: (fixes #2758) IPv4 sockets bound to unicast receive also subnet-directed broadcasts
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12889
diff changeset
   140
</li>
12958
6e192ac0b562 internet: (fixes #2762) BindToNetDevice behaviour is not coherent with Linux
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12936
diff changeset
   141
<li>You can now Bind as many socket as you want to an address/port, provided that they are bound to different NetDevices.
6e192ac0b562 internet: (fixes #2762) BindToNetDevice behaviour is not coherent with Linux
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12936
diff changeset
   142
    Moreover, BindToNetDevice does not anymore call Bind. In other terms, Bind and BindToNetDevice can be called
6e192ac0b562 internet: (fixes #2762) BindToNetDevice behaviour is not coherent with Linux
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12936
diff changeset
   143
    in any order.
6e192ac0b562 internet: (fixes #2762) BindToNetDevice behaviour is not coherent with Linux
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12936
diff changeset
   144
    However, it is suggested to use BindToNetDevice <i>before</i> Bind in order to avoid conflicts.
6e192ac0b562 internet: (fixes #2762) BindToNetDevice behaviour is not coherent with Linux
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12936
diff changeset
   145
</li>
12808
f2dba79bb5d1 build: (fixes #2630) Add contrib directory in parallel to src
Lauri Sormunen <lauri.sormunen@magister.fi>
parents: 12804
diff changeset
   146
</ul>
f2dba79bb5d1 build: (fixes #2630) Add contrib directory in parallel to src
Lauri Sormunen <lauri.sormunen@magister.fi>
parents: 12804
diff changeset
   147
<h2>Changes to build system:</h2>
f2dba79bb5d1 build: (fixes #2630) Add contrib directory in parallel to src
Lauri Sormunen <lauri.sormunen@magister.fi>
parents: 12804
diff changeset
   148
<ul>
f2dba79bb5d1 build: (fixes #2630) Add contrib directory in parallel to src
Lauri Sormunen <lauri.sormunen@magister.fi>
parents: 12804
diff changeset
   149
<li> Modules can now be located in the 'contrib/' directory in addition to 'src/'
f2dba79bb5d1 build: (fixes #2630) Add contrib directory in parallel to src
Lauri Sormunen <lauri.sormunen@magister.fi>
parents: 12804
diff changeset
   150
</li>
12564
f0e46b2c62df build: (fixes #2518) Suppress module list for Python programs
Ankit Deepak <adadeepak8@gmail.com>
parents: 12560
diff changeset
   151
<li> Behavior for running Python programs was aligned with that of C++ programs; the list of modules built is no longer printed out.
f0e46b2c62df build: (fixes #2518) Suppress module list for Python programs
Ankit Deepak <adadeepak8@gmail.com>
parents: 12560
diff changeset
   152
</li>
12363
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   153
</ul>
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   154
<h2>Changed behavior:</h2>
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   155
<ul>
12375
92983bffd4a0 Describe behavior changes related to #2467 in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12363
diff changeset
   156
<li><b>MultiModelSpectrumChannel</b> does not call StartRx for receivers that
92983bffd4a0 Describe behavior changes related to #2467 in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12363
diff changeset
   157
    operate on subbands orthogonal to transmitter subbands. Models that depend
92983bffd4a0 Describe behavior changes related to #2467 in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12363
diff changeset
   158
    on receiving signals with zero power spectral density from orthogonal bands
92983bffd4a0 Describe behavior changes related to #2467 in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12363
diff changeset
   159
    may change their behavior.
92983bffd4a0 Describe behavior changes related to #2467 in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12363
diff changeset
   160
    See <a href=https://www.nsnam.org/bugzilla/show_bug.cgi?id=2467>bug 2467</a>
92983bffd4a0 Describe behavior changes related to #2467 in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12363
diff changeset
   161
    for discussion.
92983bffd4a0 Describe behavior changes related to #2467 in CHANGES.html
Alexander Krotov <krotov@iitp.ru>
parents: 12363
diff changeset
   162
</li>
12425
1313ad34c26a network: (fixes #2221) Remove size constraint of Tag objects
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 12413
diff changeset
   163
<li><b>Packet Tag objects</b> are no longer constrained to fit within 21 
1313ad34c26a network: (fixes #2221) Remove size constraint of Tag objects
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 12413
diff changeset
   164
    bytes; a maximum size is no longer enforced.
1313ad34c26a network: (fixes #2221) Remove size constraint of Tag objects
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 12413
diff changeset
   165
</li>
12589
5608f5d3d604 wifi: Change default TxGain and RxGain attributes to 0 dB
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12583
diff changeset
   166
  <li> The default value of the <b>TxGain</b> and <b>RxGain</b> attributes in WifiPhy was changed from 1 dB to 0 dB.
5608f5d3d604 wifi: Change default TxGain and RxGain attributes to 0 dB
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12583
diff changeset
   167
  </li>
12742
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   168
<li><b>Queue</b> has been redesigned as a template class object, where the type parameter
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   169
    specifies the type of items to be stored in the queue. As a consequence:
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   170
    <ul>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   171
      <li>Being a subclass of Queue, <b>DropTailQueue</b> is a template class as well.
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   172
      <li>Network devices such as SimpleNetDevice, PointToPointNetDevice and CsmaNetDevice
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   173
      use a queue of type Queue&lt;Packet&gt; to store the packets to transmit. The SetQueue
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   174
      method of their helpers, however, can still be invoked as, e.g.,
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   175
      SetQueue ("ns3::DropTailQueue") instead of, e.g., SetQueue
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   176
      ("ns3::DropTailQueue&lt;Packet&gt;").</li>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   177
      <li>The attributes <b>Mode</b>, <b>MaxPackets</b> and <b>MaxBytes</b> are now
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   178
      defined by the QueueBase class (which Queue is derived from).</li>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   179
    </ul>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   180
</li>
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   181
<li>Queue discs that can operate both in packet mode and byte mode (Red, CoDel, Pie) define their own
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   182
    enum QueueDiscMode instead of using QueueBase::QueueMode.
4edae42e6e6b network: The Queue class holds a list of items
Stefano Avallone <stavallo@unina.it>
parents: 12694
diff changeset
   183
</li>
13059
037e9046f940 wifi: Enable beacon jitter by default
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12958
diff changeset
   184
</li>
037e9046f940 wifi: Enable beacon jitter by default
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12958
diff changeset
   185
  <li> The default value of the <b>EnableBeaconJitter</b> attribute in ApWifiMac was changed from false to true.
037e9046f940 wifi: Enable beacon jitter by default
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12958
diff changeset
   186
  </li>
12363
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   187
</ul>
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   188
c1b44cbbebea documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12361
diff changeset
   189
<hr>
12070
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   190
<h1>Changes from ns-3.25 to ns-3.26</h1>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   191
<h2>New API:</h2>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   192
<ul>
12219
a7e5825d00b6 wifi: (closes #2400) Add SpectrumWifiPhy model
Tom Henderson <tomh@tomh.org>
parents: 12215
diff changeset
   193
<li>A <b>SocketPriorityTag</b> is introduced to carry the packet priority. Such a tag
12210
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   194
    is added to packets by sockets that support this mechanism (UdpSocketImpl,
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   195
    TcpSocketBase and PacketSocket). The base class Socket has a new SetPriority
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   196
    method to set the socket priority. When the IPv4 protocol is used, the
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   197
    priority is set based on the ToS. See the Socket options section of the
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   198
    Network model for more information.
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   199
</li>
12219
a7e5825d00b6 wifi: (closes #2400) Add SpectrumWifiPhy model
Tom Henderson <tomh@tomh.org>
parents: 12215
diff changeset
   200
<li>A <b>WifiNetDevice::SelectQueue</b> method has been added to determine the user
12210
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   201
    priority of an MSDU. This method is called by the traffic control layer before
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   202
    enqueuing a packet in the queue disc, if a queue disc is installed on
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   203
    the outgoing device, or passing a packet to the device, otherwise. The
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   204
    user priority is set to the three most significant bits of the DS field
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   205
    (TOS field in case of IPv4 and Traffic Class field in case of IPv6). The
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   206
    packet priority carried by the SocketPriorityTag is set to the user priority.
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   207
</li>
12219
a7e5825d00b6 wifi: (closes #2400) Add SpectrumWifiPhy model
Tom Henderson <tomh@tomh.org>
parents: 12215
diff changeset
   208
<li>The <b>PfifoFastQueueDisc</b> classifies packets into bands based on their priority.
12210
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   209
    See the pfifo_fast queue disc section of the Traffic Control Layer model
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   210
    for more information.
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   211
</li>
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   212
<li>A new class <b>SpectrumWifiPhy</b> has been introduced that makes use of the 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   213
    Spectrum module.  Its functionality and API is currently very similar to that 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   214
    of the YansWifiPhy, especially because it reuses the same InterferenceHelper 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   215
    and ErrorModel classes (for this release).  Some example programs in the 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   216
    'examples/wireless/' directory, such as 'wifi-spectrum-per-example.cc', 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   217
    illustrate how the SpectrumWifiPhy class can be substituted for the default 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   218
    YansWifiPhy PHY model.
12219
a7e5825d00b6 wifi: (closes #2400) Add SpectrumWifiPhy model
Tom Henderson <tomh@tomh.org>
parents: 12215
diff changeset
   219
</li>
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   220
<li>We have added support for generating traces for the
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   221
    <a href="https://wilseypa.github.io/desMetrics">DES Metrics</a> project.
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   222
    These can be enabled by adding <tt>--enable-des-metrics</tt> at configuration;
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   223
    you must also use <tt>CommandLine</tt> in your script.  See the API docs
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   224
    for class <b>DesMetrics</b> for more details.
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   225
</li>
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   226
<li> The traffic control module now includes the <b>FQ-CoDel</b> and <b>PIE</b> queue disc 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   227
    models, and behavior corresponding to Linux <b>Byte Queue Limits (BQL)</b>.
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   228
</li>
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   229
<li> Several new TCP congestion control variants were introduced, including
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   230
    <b>TCP Vegas, Scalable, Veno, Illinois, Bic, YeAH, and H-TCP</b> 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   231
    congestion control algorithms.
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   232
</li>
12070
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   233
</ul>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   234
<h2>Changes to existing API:</h2>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   235
<ul>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   236
<li><b>SocketAddressTag</b> was a long-standing approach to approximate the POSIX
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   237
    socket recvfrom behavior (i.e., to know the source address of a packet) 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   238
    without actually calling RecvFrom.  Experience with this revealed that
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   239
    this option was difficult to use with tunnels (the new tag has to 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   240
    replace the old one).  Moreover, there is no real need 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   241
    to create a new API when there is a an existing one (i.e., RecvFrom).
12139
6869e7e72137 internet: (fixes #231) Remove SocketAddressTag
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12070
diff changeset
   242
    As a consequence, SocketAddressTag has been completely removed from ns-3.
6869e7e72137 internet: (fixes #231) Remove SocketAddressTag
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12070
diff changeset
   243
    Users can use RecvFrom (for UDP), GetPeerName (for TCP), or similar. 
6869e7e72137 internet: (fixes #231) Remove SocketAddressTag
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 12070
diff changeset
   244
</li>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   245
<li><b>InetSockAddress</b> can now store a ToS value, which can be set through its
12210
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   246
    SetTos method. The Bind and Connect methods of UDP (UdpSocketImpl) and
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   247
    TCP (TcpSocketBase) sockets set the socket ToS value to the value provided
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   248
    through the address input parameter (of type InetSockAddress). See the
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   249
    Socket options section of the Network model for more information.
7209087bf8cc documentation: Update CHANGES.html and doxygen
Stefano Avallone <stavallo@unina.it>
parents: 12139
diff changeset
   250
</li>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   251
<li>The <b>QosTag</b> is removed as it has been superseded by the SocketPriorityTag.</li>
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   252
<li>The <b>Ipv4L3Protocol::DefaultTos</b> attribute is removed.</li>
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   253
<li>The attributes <b>YansWifiPhy::Frequency, YansWifiPhy::ChannelNumber, and 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   254
    YansWifiPhy::ChannelWidth</b>, and the related accessor methods, were moved to 
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   255
    base class WifiPhy.  YansWifiPhy::GetChannelFrequencyMhz() was deleted.  
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   256
    A new method WifiPhy::DefineChannelNumber () was added to allow users to 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   257
    define relationships between channel number, standard, frequency, and channel width.
12219
a7e5825d00b6 wifi: (closes #2400) Add SpectrumWifiPhy model
Tom Henderson <tomh@tomh.org>
parents: 12215
diff changeset
   258
</li>
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   259
<li>The class <b>WifiSpectrumValueHelper</b> has been refactored; previously it 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   260
    was an abstract base class supporting the WifiSpectrumValue5MhzFactory spectrum 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   261
    model.  It now contains various static member methods supporting the creation 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   262
    of power spectral densities with the granularity of a Wi-Fi OFDM subcarrier 
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   263
    bandwidth.  The class <b>WifiSpectrumValue5MhzFactory</b> and its API remain but 
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   264
    it is not subclassed.
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   265
 </li>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   266
<li>A new Wifi method <b>InterferenceHelper::AddForeignSignal</b> has been introduced to 
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   267
    support use of the SpectrumWifiPhy (so that non-Wi-Fi signals may be handled 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   268
    as noise power).
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   269
</li>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   270
<li>A new Wifi attribute <b>Dcf::TxopLimit</b> has been introduced to add support for 802.11e TXOP.
12357
f5edea84a92f documentation: Update CHANGES.html for 802.11e TXOP
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12329
diff changeset
   271
</li>
12070
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   272
</ul>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   273
<h2>Changes to build system:</h2>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   274
<ul>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   275
  <li> A new waf build option, <tt>--check-config</tt>, was added to allow users to print the current configuration summary, as appears at the end of ./waf configure.  See bug 2459 for discussion.</li>
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   276
  <li> The <tt>configure</tt> summary is now sorted, to make it easier to check the status of optional features.</li>
12070
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   277
</ul>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   278
<h2>Changed behavior:</h2>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   279
This section is for behavioral changes to the models that were not due to a bug fix.
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   280
<ul>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   281
  <li>The relationship between Wi-Fi channel number, frequency, channel width, 
12308
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   282
      and Wi-Fi standard has been revised (see bug 2412).  Previously, ChannelNumber 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   283
      and Frequency were attributes of class YansWifiPhy, and the frequency was 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   284
      defined as the start of the band.  Now, Frequency has been redefined to be 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   285
      the center frequency of the channel, and the underlying device relies on 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   286
      the pair of frequency and channel width to control behavior; the channel 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   287
      number and Wi-Fi standard are used as attributes to configure frequency 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   288
      and channel width.  The wifi module documentation discusses this change 
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   289
      and the new behavior.
4916e2174a59 aodv: (fixes #2123) AODV doesn't use / honor IP TTL in the RREQ / RREP
Andrea Lupia <alupia@dimes.unical.it>
parents: 12297
diff changeset
   290
  </li>
12361
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   291
  <li>AODV now honors the TTL in RREQ/RREP and it uses a method 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   292
      compliant with <a href="http://www.ietf.org/rfc/rfc3561.txt">RFC 3561</a>.      The node search radius is increased progressively. This could increase 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   293
      slightly the node search time, but it also decreases the network 
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   294
      congestion.
0287b775fa6c update CHANGES.html and RELEASE_NOTES for ns-3.26
Tom Henderson <tomh@tomh.org>
parents: 12357
diff changeset
   295
  </li>
12070
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   296
</ul>
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   297
b250ea441642 documentation: Update for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 12056
diff changeset
   298
<hr>
11670
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   299
<h1>Changes from ns-3.24 to ns-3.25</h1>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   300
<h2>New API:</h2>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   301
<ul>
11730
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   302
  <li> In 'src/internet/test', a new environment is created to test TCP properties.</li>
12038
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   303
  <li> The 'src/traffic-control' module has been added, with new API for adding and configuring queue discs and packet filters.</li>
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   304
  <li> Related to traffic control, a new interface has been added to the
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   305
NetDevice to provide a queue interface to access device queue state and
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   306
register callbacks used for flow control.</li>
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   307
  <li> In 'src/wifi', a new rate control (MinstrelHT) has been added for
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   308
802.11n/ac modes.</li>
11859
b73bc6f93c61 wifi: Update documentation for new helpers and APIs
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11843
diff changeset
   309
  <li> In 'src/wifi', a new helper (WifiMacHelper) is added and is a merged helper from all previously existing MAC helpers (NqosWifiMacHelper, QosWifiMacHelper, HtWifiMacHelper and VhtWifiMacHelper).</li>
11937
fe202d97ae3d Update CHANGES and RELEASE_NOTES
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 11897
diff changeset
   310
  <li> It is now possible to use RIPv2 in IPv4 network simulations.</li>
11670
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   311
</ul>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   312
<h2>Changes to existing API:</h2>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   313
<ul>
11730
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   314
  <li>TCP-related changes:
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   315
    <ul>
11797
838552e9d264 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11739
diff changeset
   316
      <li>Classes TcpRfc793, TcpTahoe, and TcpReno were removed.</li>
838552e9d264 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11739
diff changeset
   317
      <li>The 'TcpNewReno' log component was effectively replaced by 'TcpCongestionOps'
11739
d3dbffe065b2 Release notes and changes updated for Hybla and HighSpeed
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11730
diff changeset
   318
      <li>TCP Hybla and HighSpeed have been added.</li>
11730
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   319
      <li>Added the concept of Congestion State Machine inside TcpSocketBase.</li>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   320
      <li>Merged Fast Recovery and Fast Retransmit inside TcpSocketBase.</li>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   321
      <li>Some member variables have been moved from TcpSocketBase inside TcpSocketState. Attributes are not touched.</li>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   322
      <li>Congestion control splitted from TcpSocketBase as subclass of TcpCongestionOps.</li>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   323
      <li>Added Rx and Tx callbacks on TcpSocketBase.</li>
11897
f347382e0d42 internet: added BytesInFlight trace inside TcpSocketBase
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11859
diff changeset
   324
      <li>Added BytesInFlight trace source on TcpSocketBase. The trace is updated when the implementation requests the value.</li>
11730
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   325
      <li>Added attributes about the number of connection and data retransmission attempts.</li>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   326
    </ul>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   327
  </li>
11859
b73bc6f93c61 wifi: Update documentation for new helpers and APIs
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11843
diff changeset
   328
  <li> ns-3 is now capable of serializing SLL (a.k.a. cooked) headers.
11843
1de7febc2653 network: (fixes #2286) Support for SLL header (de)serialization
Matt <matthieu.coudron@lip6.fr>
parents: 11805
diff changeset
   329
       This is used in DCE to allow the generation of pcap directly readable by wireshark.
1de7febc2653 network: (fixes #2286) Support for SLL header (de)serialization
Matt <matthieu.coudron@lip6.fr>
parents: 11805
diff changeset
   330
  </li>
11859
b73bc6f93c61 wifi: Update documentation for new helpers and APIs
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11843
diff changeset
   331
  <li> In the WifiHelper class in the wifi module, Default has been declared deprecated. This is now immediately handled by the constructor of the class.</li>
b73bc6f93c61 wifi: Update documentation for new helpers and APIs
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11843
diff changeset
   332
  <li> The API for configuring 802.11n/ac aggregation has been modified to be more user friendly. As any MAC layer attributes, aggregation parameters can now also be configured through WifiMacHelper::SetType. </li>
12038
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   333
  <li> The class Queue and subclasses derived from it have been changed in two ways:
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   334
  <ul>
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   335
    <li>Queues no longer enqueue simple Packets but instead enqueue QueueItem objects, which include Packet but possibly other information such as headers.</li>
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   336
    <li>The attributes governing the mode of operation (packets or bytes) and the maximum size have been moved to base class Queue.</li>
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   337
  </ul>
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   338
  </li>
12056
0539652e9551 documentation: Update CHANGES.html for changed behavior
Stefano Avallone <stavallo@unina.it>
parents: 12038
diff changeset
   339
  <li> Users of advanced queues (RED, CoDel) who have been using them directly in the NetDevice will need to adjust to the following changes:
0539652e9551 documentation: Update CHANGES.html for changed behavior
Stefano Avallone <stavallo@unina.it>
parents: 12038
diff changeset
   340
    <ul>
0539652e9551 documentation: Update CHANGES.html for changed behavior
Stefano Avallone <stavallo@unina.it>
parents: 12038
diff changeset
   341
      <li> RED and CoDel are no longer specializations of the Queue classe, but are now specializations of the new QueueDisc class. This means that RED and CoDel can now be installed in the context of the new Traffic Control layer instead of as queues in (some) NetDevices. The reason for such a change is to make the ns-3 stack much more similar to that of real operating systems (Linux has been taken as a reference).  Queuing disciplines such as RED and CoDel can now be tested with all the NetDevices, including WifiNetDevices. </li>
0539652e9551 documentation: Update CHANGES.html for changed behavior
Stefano Avallone <stavallo@unina.it>
parents: 12038
diff changeset
   342
      <li> NetDevices still use queues to buffer packets. The only subclass of Queue currently available for this purpose is DropTailQueue. If one wants to approximate the old behavior, one needs to set the DropTailQueue MaxPackets attribute to very low values, e.g., 1.</li>
0539652e9551 documentation: Update CHANGES.html for changed behavior
Stefano Avallone <stavallo@unina.it>
parents: 12038
diff changeset
   343
      <li> The Traffic Control layer features a mechanism by which packets dropped by the NetDevice are requeued in the queue disc (more precisely: if NetDevice::Send returns false, the packet is requeued), so that they are retransmitted later. This means that the MAC drop traces may include packets that have not been actually lost, because they have been dropped by the device, requeued by the traffic control layer and successfully retransmitted. To get the correct number of packets that have been actually lost, one has to subtract the number of packets requeued from the number of packets dropped as reported by the MAC drop trace. </li>
0539652e9551 documentation: Update CHANGES.html for changed behavior
Stefano Avallone <stavallo@unina.it>
parents: 12038
diff changeset
   344
    </ul>
0539652e9551 documentation: Update CHANGES.html for changed behavior
Stefano Avallone <stavallo@unina.it>
parents: 12038
diff changeset
   345
  </li>
11670
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   346
</ul>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   347
<h2>Changes to build system:</h2>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   348
<ul>
12038
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   349
  <li> Waf was upgraded to 1.8.19</li>
11805
391bf90839ed add waf --check-profile option
Tom Henderson <tomh@tomh.org>
parents: 11797
diff changeset
   350
  <li> A new waf build option, --check-profile, was added to allow users to check the currently active build profile.  It is discussed in bug 2202 in the tracker.</li>
11670
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   351
</ul>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   352
<h2>Changed behavior:</h2>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   353
This section is for behavioral changes to the models that were not due to a bug fix.
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   354
<ul>
11730
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   355
  <li>TCP behavioral changes:
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   356
    <ul>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   357
      <li>TCP closes connection after a number of failed segment retries,
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   358
        rather than trying indefinitely. The maximum number of retries, for both SYN
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   359
        attempts and data attempts, is controlled by attributes.</li>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   360
      <li>Congestion algorithms not compliant with Fast Retransmit
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   361
        and Fast Recovery (TCP 793, Reno, Tahoe) have been removed.</li>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   362
    </ul>
84e170fa754b Updated CHANGES and RELEASE_NOTES after merging GSoC-TCP
Natale Patriciello <natale.patriciello@gmail.com>
parents: 11670
diff changeset
   363
  </li>
11859
b73bc6f93c61 wifi: Update documentation for new helpers and APIs
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11843
diff changeset
   364
  <li> 802.11n/ac MPDU aggregation is now enabled by default for both AC_BE and AC_VI.</li>
12038
ee5a6d04e199 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11937
diff changeset
   365
  <li> The introduction of the traffic control layer leads to some additional buffering by default in the stack; when a device queue fills up, additional packets become enqueued at the traffic control layer.</li>
11670
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   366
</ul>
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   367
28a8a46fbb98 update RELEASE_NOTES and CHANGES.html for next release cycle
Tom Henderson <tomh@tomh.org>
parents: 11656
diff changeset
   368
<hr>
11397
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   369
<h1>Changes from ns-3.23 to ns-3.24</h1>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   370
<h2>New API:</h2>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   371
<ul>
11647
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   372
  <li>In 'src/wifi', several changes were made to enable partial 802.11ac support:
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   373
    <ul>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   374
      <li>A new helper (VhtWifiMacHelper) was added to set up a Very high throughput (VHT) MAC entity.</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   375
      <li>A new standard value has been added that enables the new 11ac data rates.</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   376
      <li>A new 11ac preamble has been added.</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   377
      <li>A new information element has been added:  VhtCapabilities. This information element is added to the MAC frame header if the node is a VHT node. This VhtCapabilites information element is used to advertise the VHT capabilites of the node to other nodes in the network.</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   378
    </ul>
11656
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   379
  </li>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   380
  <li>The ArpCache API was extended to allow the manual removal of ArpCache entries and the addition of permanent (static) entries for IPv4.
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   381
  </li>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   382
  <li> The SimpleChannel in the 'network' module now allows per-NetDevice blacklists, in order to do hidden terminal testcases.
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   383
  </li>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   384
</ul>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   385
<h2>Changes to existing API:</h2>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   386
<ul>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   387
  <li> The signatures on several TcpHeader methods were changed to take const arguments.</li>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   388
  <li> class TcpL4Protocol replaces Send() methods with SendPacket(), and adds new methods to AddSocket() and RemoveSocket() from a node.  Also, a new PacketReceived() method was introduced to get the TCP header of an incoming packet and check its checksum.</li>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   389
  <li> The CongestionWindow and SlowStartThreshold trace sources have been moved from the TCP subclasses such as NewReno, Reno, Tahoe, and Westwood to the TcpSocketBase class.</li>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   390
  <li> The WifiMode object has been refactored:
11647
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   391
    <ul>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   392
      <li>11n data rates are now renamed according to their MCS value. E.g. OfdmRate65MbpsBW20MHz has been renamed into HtMcs7. 11ac data rates have been defined according to this new renaming.</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   393
      <li>HtWifiMacHelper and VhtWifiMacHelper provide a helper to convert a MCS value into a data rate value.</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   394
      <li>The channel width is no longer tied to the wifimode. It is now included in the TXVECTOR.</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   395
      <li>The physical bitrate is no longer tied to the wifimode. It is computed based on the selected wifimode and on the TXVECTOR parameters (channel width, guard interval and number of spatial streams).</li>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   396
    </ul>
4c87d32ffb07 Update changes.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11516
diff changeset
   397
  </li>
11397
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   398
</ul>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   399
<h2>Changes to build system:</h2>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   400
<ul>
11656
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   401
  <li> Waf was upgraded to 1.8.12</li>
64199441c3d6 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11647
diff changeset
   402
  <li> Waf scripts and test.py test runner program were made compatible with Python 3</li>
11397
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   403
</ul>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   404
<h2>Changed behavior:</h2>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   405
This section is for behavioral changes to the models that were not due to a bug fix.
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   406
<ul>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   407
</ul>
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   408
1887754d4504 update RELEASE_NOTES and CHANGES.html for next release
Tom Henderson <tomh@tomh.org>
parents: 11391
diff changeset
   409
<hr>
11216
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   410
<h1>Changes from ns-3.22 to ns-3.23</h1>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   411
<h2>New API:</h2>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   412
<ul>
11287
a0764d24359a update RELEASE_NOTES, CHANGES.html, and AUTHORS
Tom Henderson <tomh@tomh.org>
parents: 11270
diff changeset
   413
  <li> The mobility module includes a GeographicPositions class used to
a0764d24359a update RELEASE_NOTES, CHANGES.html, and AUTHORS
Tom Henderson <tomh@tomh.org>
parents: 11270
diff changeset
   414
convert geographic to cartesian coordinates, and to generate randomly
a0764d24359a update RELEASE_NOTES, CHANGES.html, and AUTHORS
Tom Henderson <tomh@tomh.org>
parents: 11270
diff changeset
   415
distributed geographic coordinates.
a0764d24359a update RELEASE_NOTES, CHANGES.html, and AUTHORS
Tom Henderson <tomh@tomh.org>
parents: 11270
diff changeset
   416
  </li>
a0764d24359a update RELEASE_NOTES, CHANGES.html, and AUTHORS
Tom Henderson <tomh@tomh.org>
parents: 11270
diff changeset
   417
  <li>  The spectrum module includes new TvSpectrumTransmitter classes and helpers to create television transmitter(s) that transmit PSD spectrums customized by attributes such as modulation type, power, antenna type, channel frequency, etc.
a0764d24359a update RELEASE_NOTES, CHANGES.html, and AUTHORS
Tom Henderson <tomh@tomh.org>
parents: 11270
diff changeset
   418
  </li>
11216
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   419
</ul>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   420
<h2>Changes to existing API:</h2>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   421
<ul>
11270
de1a251c80a4 removed LteSpectrumPhy's LtePhyRxDataEndErrorCallback
Nicola Baldo <nbaldo@cttc.es>
parents: 11216
diff changeset
   422
  <li> In LteSpectrumPhy, LtePhyTxEndCallback and the corresponding methods have been removed, since they were unused.
de1a251c80a4 removed LteSpectrumPhy's LtePhyRxDataEndErrorCallback
Nicola Baldo <nbaldo@cttc.es>
parents: 11216
diff changeset
   423
  </li>
11391
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   424
  <li> In the DataRate class in the network module, CalculateTxTime has been declared deprecated.  CalculateBytesTxTime and CalculateBitsTxTime are to be used instead.  The return value is a Time, instead of a double.
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   425
  </li>
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   426
  <li> In the Wi-Fi InterferenceHelper, the interference event now takes the WifiTxVector as an input parameter, instead of the WifiMode.  A similar change was made to the WifiPhy::RxOkCallback signature.
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   427
  </li>
11216
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   428
</ul>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   429
<h2>Changes to build system:</h2>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   430
<ul>
11391
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   431
  <li> None </li>
11216
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   432
</ul>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   433
<h2>Changed behavior:</h2>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   434
This section is for behavioral changes to the models that were not due to a bug fix.
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   435
<ul>
11391
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   436
  <li> In Wi-Fi, HT stations (802.11n) now support two-level aggregation. The InterferenceHelper now distinguishes between the PLCP and regular payload reception, for higher fidelity modeling.  ACKs are now sent using legacy rates and preambles.  Acces points now establish BSSBasicRateSet for control frame transmissions.  PLCP header and PLCP payload reception have been decoupled to improve PHY layer modeling accuracy.  RTS/CTS with A-MPDU is now fully supported.  
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   437
  </li>
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   438
  <li> The mesh module was made more compliant to the IEEE 802.11s-2012 standard and packet traces are now parseable by Wireshark.  
b0cc0d945d36 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11287
diff changeset
   439
  </li>
11216
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   440
</ul>
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   441
cce9772d17c7 update RELEASE_NOTES and CHANGES.html for post-ns-3.22
Tom Henderson <tomh@tomh.org>
parents: 11212
diff changeset
   442
<hr>
10959
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   443
<h1>Changes from ns-3.21 to ns-3.22</h1>
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   444
<h2>New API:</h2>
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   445
<ul>
11212
4db6a4741ec7 update RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11211
diff changeset
   446
  <li> New classes were added for the PARF and APARF WiFi power and rate control mechanisms. 
11209
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   447
  </li>
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   448
  <li> Support for WiFi 802.11n MPDU aggregation has been added.
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   449
  </li>
11212
4db6a4741ec7 update RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11211
diff changeset
   450
  <li> Additional support for modeling of vehicular WiFi networks has been added, including the channel-access coordination feature of IEEE 1609.4.  In addition, a Basic Safety Message (BSM) packet generator and related statistics-gathering classes have been added to the wave module. 
11209
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   451
  </li>
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   452
  <li> A complete LTE release bearer procedure is now implemented which can be invoked by calling the new helper method LteHelper::DeActivateDedicatedEpsBearer ().
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   453
  </li>
10965
14cde591d8e4 Bug 652 - no public API for IPv4 neighbor table - Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10959
diff changeset
   454
  <li> It is now possible to print the Neighbor Cache (ARP and NDISC) by using
14cde591d8e4 Bug 652 - no public API for IPv4 neighbor table - Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10959
diff changeset
   455
       the RoutingProtocolHelper
14cde591d8e4 Bug 652 - no public API for IPv4 neighbor table - Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10959
diff changeset
   456
  </li>
11028
abeb2185bce5 add TimeProbe class to data collection framework
Tom Henderson <tomh@tomh.org>
parents: 11026
diff changeset
   457
  <li> A TimeProbe class has been added to the data collection framework in 
abeb2185bce5 add TimeProbe class to data collection framework
Tom Henderson <tomh@tomh.org>
parents: 11026
diff changeset
   458
       the stats module, enabling TracedValues emitting values of type 
abeb2185bce5 add TimeProbe class to data collection framework
Tom Henderson <tomh@tomh.org>
parents: 11026
diff changeset
   459
       ns3::Time to be handled by the framework.
abeb2185bce5 add TimeProbe class to data collection framework
Tom Henderson <tomh@tomh.org>
parents: 11026
diff changeset
   460
  </li>
11209
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   461
  <li> A new attribute 'ClockGranularity' was added to the TcpSocketBase class,
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   462
to control modeling of RTO calculation.
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   463
  </li>
10959
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   464
</ul>
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   465
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   466
<h2>Changes to existing API:</h2>
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   467
<ul>
11026
19b4146b1d39 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10965
diff changeset
   468
  <li> Several deprecated classes and class methods were removed, including EmuNetDevice, RandomVariable and derived classes, Packet::PeekData(), Ipv6AddressHelper::NewNetwork(Ipv6Address, Ipv6Prefix), Ipv6InterfaceContainer::SetRouter(), Ipv4Route::GetOutputTtl(), TestCase::AddTestCase(TestCase*), and TestCase::GetErrorStatus().
19b4146b1d39 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10965
diff changeset
   469
  </li>
19b4146b1d39 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10965
diff changeset
   470
  <li> Print methods involving routing tables and neighbor caches, in classes Ipv4RoutingHelper and Ipv6RoutingHelper, were converted to static methods.
19b4146b1d39 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10965
diff changeset
   471
  </li>  
19b4146b1d39 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10965
diff changeset
   472
  <li>PointerValue attribute types in class UanChannel (NoiseModel), UanPhyGen (PerModel and SinrModel), UanPhyDual (PerModelPhy1, PerModelPhy2, SinrModelPhy1, and SinrModelPhy2), and SimpleNetDevice (TxQueue), were changed from PointerValue type to StringValue type, making them configurable via the Config subsystem. 
19b4146b1d39 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10965
diff changeset
   473
  </li>
11043
0c1fce0706de update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 11028
diff changeset
   474
  <li> WifiPhy::CalculateTxDuration() and WifiPhy::GetPayloadDurationMicroSeconds () now take an additional frequency parameter.
0c1fce0706de update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 11028
diff changeset
   475
  </li>
11065
2e6f9e4be3a3 fix misspelled attribute and doxygen in YansWifiPhy
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11043
diff changeset
   476
  <li> The attribute 'Recievers' in class YansWifiPhy was misspelled, so
2e6f9e4be3a3 fix misspelled attribute and doxygen in YansWifiPhy
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11043
diff changeset
   477
       this has been corrected to 'Receivers'.
2e6f9e4be3a3 fix misspelled attribute and doxygen in YansWifiPhy
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 11043
diff changeset
   478
  </li>
11087
486e1b0c1df6 Deprecate AddTraceSource without callback signature.
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11065
diff changeset
   479
  <li> We have now documented the callback function signatures
486e1b0c1df6 Deprecate AddTraceSource without callback signature.
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11065
diff changeset
   480
       for all TracedSources, using an extra (fourth) argument to
486e1b0c1df6 Deprecate AddTraceSource without callback signature.
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11065
diff changeset
   481
       TypeId::AddTraceSource to pass the fully-qualified name
486e1b0c1df6 Deprecate AddTraceSource without callback signature.
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11065
diff changeset
   482
       of the signature typedef.  To ensure that future TraceSources
11212
4db6a4741ec7 update RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11211
diff changeset
   483
       are similarly documented, the three argument version of 
4db6a4741ec7 update RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11211
diff changeset
   484
       AddTraceSource has been deprecated.
11087
486e1b0c1df6 Deprecate AddTraceSource without callback signature.
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11065
diff changeset
   485
  </li>	
11209
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   486
  <li> The "MinRTO" attribute of the RttEstimator class was moved to the TcpSocketBase class.  The "Gain" attribute of the RttMeanDeviation class was replaced 
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   487
by new "Alpha" and "Beta" attributes.  
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   488
  </li>	
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   489
  <li> Attributes of the TcpTxBuffer and TcpRxBuffer class are now accessible through the TcpSocketBase class.
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   490
  </li>	
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   491
  <li> The LrWpanHelper class has a new constructor allowing users to configure a MultiModelSpectrumChannel as an option, and also provides Set/Get API to allow users to access the underlying channel object. 
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   492
  </li>
10959
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   493
</ul>
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   494
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   495
<h2>Changes to build system:</h2>
11087
486e1b0c1df6 Deprecate AddTraceSource without callback signature.
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11065
diff changeset
   496
<ul>
11043
0c1fce0706de update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 11028
diff changeset
   497
  <li> waf was upgraded to version 1.7.16
0c1fce0706de update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 11028
diff changeset
   498
  </li>
10959
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   499
</ul>
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   500
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   501
<h2>Changed behavior:</h2>
11209
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   502
This section is for behavioral changes to the models that were not due to a bug fix.
10959
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   503
<ul>
11043
0c1fce0706de update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 11028
diff changeset
   504
  <li> The default value of the `Speed` attribute of ConstantSpeedPropagationDelayModel was changed from 300,000,000 m/s to 299,792,458 m/s (speed of light in a vacuum), causing propagation delays using this model to vary slightly.
0c1fce0706de update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 11028
diff changeset
   505
  </li>
11209
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   506
  <li> The LrWpanHelper object was previously instantiating only a LogDistancePropagationLossModel on a SingleModelSpectrumChannel, but no PropagationDelayModel.  The constructor now adds by default a ConstantSpeedPropagationDelayModel.
2ebe49d34182 updates to RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11087
diff changeset
   507
  </li>
11211
c7f9ed853e60 Add nix-vector lazy flush to RELEASE_NOTES and CHANGES.html
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11209
diff changeset
   508
  <li> The Nix-vector routing implementation now uses a lazy flush mechanism,
c7f9ed853e60 Add nix-vector lazy flush to RELEASE_NOTES and CHANGES.html
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11209
diff changeset
   509
       which dramatically speeds up the creation of large topologies.
c7f9ed853e60 Add nix-vector lazy flush to RELEASE_NOTES and CHANGES.html
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 11209
diff changeset
   510
  </li>
10959
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   511
</ul>
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   512
ccea27fc13e1 update CHANGES.html for new release version
Tom Henderson <tomh@tomh.org>
parents: 10947
diff changeset
   513
<hr>
10815
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   514
<h1>Changes from ns-3.20 to ns-3.21</h1>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   515
<h2>New API:</h2>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   516
<ul>
10842
b1d6e75793bb Add const double& operator[] to SpectrumValue
Sascha Alexander Jopen <jopen@informatik.uni-bonn.de>
parents: 10819
diff changeset
   517
  <li> New "const double& SpectrumValue:: operator[] (size_t index) const".
b1d6e75793bb Add const double& operator[] to SpectrumValue
Sascha Alexander Jopen <jopen@informatik.uni-bonn.de>
parents: 10819
diff changeset
   518
  </li>
10855
7ef081ddfc7f Bug 1831 - TcpSocket SlowStartThreshold is not a TraceSource
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10842
diff changeset
   519
  <li> A new TraceSource has been added to TCP sockets: SlowStartThreshold.
7ef081ddfc7f Bug 1831 - TcpSocket SlowStartThreshold is not a TraceSource
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10842
diff changeset
   520
  </li>
10861
40a485317b1d CommandLine Attribute shorthand
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10855
diff changeset
   521
  <li> New method CommmandLine::AddValue (name, attibutePath) to provide a
40a485317b1d CommandLine Attribute shorthand
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10855
diff changeset
   522
       shorthand argument "name" for the Attribute "path".  This also has
40a485317b1d CommandLine Attribute shorthand
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10855
diff changeset
   523
       the effect of including the help string for the Attribute in the
40a485317b1d CommandLine Attribute shorthand
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10855
diff changeset
   524
       Usage message.
40a485317b1d CommandLine Attribute shorthand
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10855
diff changeset
   525
  </li>
10892
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   526
  <li> The GSoC 2014 project in the LTE module has brought some additional APIs:
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   527
    <ul>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   528
      <li>a new abstract class LteFfrAlgorithm, which every future
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   529
          implementation of frequency reuse algorithm should inherit from</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   530
      <li>a new SAPs: one between MAC Scheduler and FrAlgorithm, one between
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   531
	  RRC and FrAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   532
      <li>new attribute to enable Uplink Power Control in LteUePhy</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   533
      <li>new LteUePowerControl class, an implementation of Uplink Power Control, which is 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   534
          configurable by attributes. ReferenceSignalPower is sent by eNB in SIB2. 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   535
          Uplink Power Control in Closed Loop Accumulative Mode is enabled by default</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   536
      <li>seven different Frequency Reuse Algorithms (each has its own attributes): </li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   537
        <ul>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   538
          <li>LteFrNoOpAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   539
          <li>LteFrHardAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   540
          <li>LteFrStrictAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   541
          <li>LteFrSoftAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   542
          <li>LteFfrSoftAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   543
          <li>LteFfrEnhancedAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   544
          <li>LteFfrDistributedAlgorithm</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   545
        </ul>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   546
      <li>attribute in LteFfrAlgorithm to set FrCellTypeId which is used in automatic 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   547
          Frequency Reuse algorithm configuration</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   548
      <li>LteHelper has been updated with new methods related to frequency reuse algorithm: 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   549
          SetFfrAlgorithmType and SetFfrAlgorithmAttribute</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   550
    </ul>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   551
  </li>
10899
9b501eb7910c Enhancements to SimpleNetDevice and SimpleChannel
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10892
diff changeset
   552
  <li> A new SimpleNetDeviceHelper can now be used to install SimpleNetDevices.
9b501eb7910c Enhancements to SimpleNetDevice and SimpleChannel
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10892
diff changeset
   553
  </li>
10902
527fc624722a Bug 1811 - Basic traffic generator for network module
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10899
diff changeset
   554
  <li> New PacketSocketServer and PacketSocketClient apps, meant to be used in tests.
527fc624722a Bug 1811 - Basic traffic generator for network module
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10899
diff changeset
   555
  </li>
10947
591909663749 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10933
diff changeset
   556
  <li> Tcp Timestamps and Window Scale options have been added and are enabled by default (controllable by attribute).
591909663749 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10933
diff changeset
   557
  </li>
591909663749 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10933
diff changeset
   558
  <li> A new CoDel queue model has been added to the 'internet' module.  
591909663749 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10933
diff changeset
   559
  </li>
11212
4db6a4741ec7 update RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11211
diff changeset
   560
  <li> New test macros NS_TEST_ASSERT_MSG_GT_OR_EQ() and NS_TEST_EXPECT_MSG_GT_OR_EQ() have been added.
4db6a4741ec7 update RELEASE_NOTES and CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 11211
diff changeset
   561
  </li>
10815
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   562
</ul>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   563
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   564
<h2>Changes to existing API:</h2>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   565
<ul>
10819
f49b201c1884 Bug 1921 - Icmpv6L4Protocol::ForgeEchoRequest returns a malformed packet
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10815
diff changeset
   566
  <li> "Icmpv6L4Protocol::ForgeEchoRequest" is now returning a packet with the proper IPv6 header.
f49b201c1884 Bug 1921 - Icmpv6L4Protocol::ForgeEchoRequest returns a malformed packet
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10815
diff changeset
   567
  </li>
10855
7ef081ddfc7f Bug 1831 - TcpSocket SlowStartThreshold is not a TraceSource
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10842
diff changeset
   568
  <li> The TCP socket Attribute "SlowStartThreshold" has been renamed "InitialSlowStartThreshold" to
7ef081ddfc7f Bug 1831 - TcpSocket SlowStartThreshold is not a TraceSource
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10842
diff changeset
   569
       clarify that the effect is only on the initial value.
7ef081ddfc7f Bug 1831 - TcpSocket SlowStartThreshold is not a TraceSource
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10842
diff changeset
   570
  </li>
10892
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   571
  <li> all schedulers were updated to interact with FR entity via FFR-SAP. Only PF, PSS, CQA, 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   572
       FD-TBFQ, TD-TBFQ schedulers supports Frequency Reuse functionality. In the beginning 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   573
       of scheduling process, schedulers ask FR entity for avaiable RBGs and then ask if UE 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   574
       can be scheduled on RB</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   575
  <li> eNB RRC interacts with FFR entity via RRC-FFR SAP</li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   576
  <li> new DL-CQI generation approach was implemented. Now DL-CQI is computed from control channel as signal
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   577
       and data channel (if received) as interference. New attribute in LteHelper was added to specify 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   578
       DL-CQI generation approach. New approach is default one in LteHelper </li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   579
  <li> RadioEnvironmentMap can be generated for Data or Control channel and for specified RbId;
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   580
       Data or Control channel and RbId can be configured by new attributes in RadioEnvironmentMapHelper </li>
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   581
  <li> lte-sinr-chunk-processor refactored to lte-chunk-processor. Removed all lte-xxx-chunk-processor 
3e86fac77082 GSoC 2014 FFR algorithms
Piotr Gawlowicz <gawlowicz.p@gmail.com>
parents: 10861
diff changeset
   582
       implementations</li>
10933
7442f5603ef4 Bug 1824 - L4 protocol sockets should support BindToNetDevice over IPv6
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10902
diff changeset
   583
  <li> BindToNetDevice affects also sockets using IPv6.</li>
7442f5603ef4 Bug 1824 - L4 protocol sockets should support BindToNetDevice over IPv6
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10902
diff changeset
   584
  <li> BindToNetDevice now calls implicitly Bind (). To bind a socket to a NetDevice and to a specific address,
7442f5603ef4 Bug 1824 - L4 protocol sockets should support BindToNetDevice over IPv6
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10902
diff changeset
   585
       the correct sequence is Bind (address) - BindToNetDevice (device). The opposite will raise an error.</li>
10815
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   586
</ul>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   587
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   588
<h2>Changes to build system:</h2>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   589
<ul>
10947
591909663749 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10933
diff changeset
   590
<li> None for this release. </li>
10815
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   591
</ul>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   592
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   593
<h2>Changed behavior:</h2>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   594
<ul>
10947
591909663749 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10933
diff changeset
   595
<li> Behavior will be changed due to the list of bugs fixed (listed in RELEASE_NOTES); users are requested to review that list as well.
10815
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   596
</ul>
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   597
d34be08307d0 start RELEASE_NOTES and CHANGES.html for next version
Tom Henderson <tomh@tomh.org>
parents: 10808
diff changeset
   598
<hr>
10798
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   599
<h1>Changes from ns-3.19 to ns-3.20</h1>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   600
<h2>New API:</h2>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   601
<ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   602
  <li> Models have been added for low-rate, wireless personal area networks
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   603
(LR-WPAN) as specified by IEEE standard 802.15.4 (2006).  The current 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   604
emphasis is on the unslotted mode of 802.15.4 operation for use in Zigbee, 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   605
and the scope is limited to enabling a single mode (CSMA/CA) with basic 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   606
data transfer capabilities. Association with PAN coordinators is not yet 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   607
supported, nor the use of extended addressing. Interference is modeled as 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   608
AWGN but this is currently not thoroughly tested.  The NetDevice Tx queue 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   609
is not limited, i.e., packets are never dropped due to queue becoming full. 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   610
They may be dropped due to excessive transmission retries or channel access 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   611
failure.  </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   612
  <li> A new IPv6 routing protocol has been added: RIPng. This protocol is
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   613
  an Interior Gateway Protocol and it is available in the Internet module. </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   614
  <li> A new LTE MAC downlink scheduling algorithm named Channel and QoS 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   615
  Aware (CQA) Scheduler is provided by the new "ns3::CqaFfMacScheduler" object.
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   616
  </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   617
  <li> Units may be attached to Time objects, to facilitate specific output
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   618
  formats (see Time::As()) </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   619
  <li> FlowMonitor "SerializeToXml" functions are now directly available
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   620
  from the helper.  </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   621
  <li> Access to OLSR's HNA table has been enabled </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   622
</ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   623
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   624
<h2>Changes to existing API:</h2>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   625
<ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   626
  <li> The SixLowPan model can now use uncompressed IPv6 headers. An option to
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   627
  define the minimum compressed packet size has been added.  </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   628
  <li> MinDistance wsa replaced by MinLoss in FriisPropagationLossModel, to
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   629
  better handle conditions outside of the assumed far field region. </li>
10808
8fa02a3cca47 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10798
diff changeset
   630
  <li> In the DSR model, the attribute DsrOptionRerrHeader::ErrorType" has
8fa02a3cca47 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 10798
diff changeset
   631
  been removed. </li>
10798
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   632
</ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   633
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   634
<h2>Changes to build system:</h2>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   635
<ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   636
  <li> Python 3.3 is now supported for Python bindings for ns-3.  Python 3.3 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   637
  support for API scanning is not supported.  Python 3.2 is not supported.</li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   638
  <li>  Enable selection of high precision int64x64_t implementation
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   639
  at configure time, for debugging purposes.</li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   640
  <li> Optimized builds are now enabling signed overflow optimization 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   641
  (-fstrict-overflow) and for gcc 4.8.2 and greater, also warning for cases 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   642
  where an optimizization may occur due to compiler assumption that 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   643
  overflow will not occur. </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   644
</ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   645
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   646
<h2>Changed behavior:</h2>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   647
<ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   648
  <li> The Internet FlowMonitor can now track IPv6 packets.  </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   649
  <li> Ipv6Extension::m_dropTrace has been removed. Ipv6L3Protocol::m_dropTrace
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   650
  is now fired when appropriate.  </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   651
  <li> IPv4 identification field value is now dependent on the protocol 
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   652
  field.  </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   653
  <li> Point-to-point trace sources now contain PPP headers </li>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   654
</ul>
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   655
79b9d13a1ffd update CHANGES.html for release
Tom Henderson <tomh@tomh.org>
parents: 10533
diff changeset
   656
<hr>
10422
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   657
<h1>Changes from ns-3.18.1 to ns-3.19</h1>
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   658
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   659
<h2>New API:</h2>
10459
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   660
<ul>
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   661
  <li> A new wifi extension for vehicular simulation support is available in the
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   662
    src/wave directory.  The current code represents an interim capability to 
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   663
    realize an IEEE 802.11p-compliant device, but without the WAVE extensions 
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   664
    (which are planned for a later patch).  The WaveNetDevice modelled herein 
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   665
    enforces that a WAVE-compliant physical layer (at 5.9 GHz) is selected, and 
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   666
    does not require any association between devices (similar to an adhoc WiFi 
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   667
    MAC), but is otherwise similar (at this time) to a WifiNetDevice.  WAVE 
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   668
    capabililties of switching between control and service channels, or using 
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   669
    multiple radios, are not yet modelled.
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   670
  </li>
10493
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   671
  <li>New SixLowPanNetDevice class providing a shim between 
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   672
    IPv6 and real NetDevices. The new module implements 6LoWPAN:
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   673
    "Transmission of IPv6 Packets over IEEE 802.15.4 Networks" (see
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   674
    <a href="http://www.ietf.org/rfc/rfc4944.txt">RFC 4944</a> and
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   675
    <a href="http://www.ietf.org/rfc/rfc6262.txt">RFC 6262</a>), 
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   676
    resulting in a heavy header compression for IPv6 packets.
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   677
    The module is intended to be used on 802.15.4 NetDevices, but
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   678
    it can be used over other NetDevices. See the manual for
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   679
    further discussion.
ccb3c64e55e8 Fix Changes.html - 6LoWPAN is a new API
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10479
diff changeset
   680
  </li>
10519
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   681
  <li> LteHelper has been updated with some new APIs:
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   682
    <ul>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   683
      <li>new overloaded Attach methods to enable UE to automatically determine
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   684
          the eNodeB to attach to (using initial cell selection);</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   685
      <li>new methods related to handover algorithm: SetHandoverAlgorithmType
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   686
          and SetHandoverAlgorithmAttribute;</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   687
      <li>a new attribute AnrEnabled to activate/deactivate Automatic Neighbour
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   688
          Relation (ANR) function; and</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   689
      <li>a new method SetUeDeviceAttribute for configuring LteUeNetDevice.</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   690
    </ul>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   691
  </li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   692
  <li> The GSoC 2013 project in the LTE module has brought some additional APIs:
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   693
    <ul>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   694
      <li>a new abstract class LteHandoverAlgorithm, which every future
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   695
          implementation of automatic handover trigger should inherit from;</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   696
      <li>new classes LteHandoverAlgorithm and LteAnr as sub-modules of
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   697
          LteEnbNetDevice class; both interfacing with the LteEnbRrc sub-module
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   698
          through Handover Management SAP and ANR SAP;</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   699
      <li>new attributes in LteEnbNetDevice and LteUeNetDevice classes related
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   700
          to Closed Subscriber Group (CSG) functionality in initial cell
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   701
          selection;</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   702
      <li>new attributes in LteEnbRrc for configuring UE measurements' filtering
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   703
          coefficient (i.e., quantity configuration);</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   704
      <li>a new public method AddUeMeasReportConfig in LteEnbRrc for setting up
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   705
          custom UE measurements' reporting configuration; measurement reports
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   706
          can then be captured from the RecvMeasurementReport trace source;
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   707
          and</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   708
      <li>new trace sources in LteUeRrc to capture more events, such as System
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   709
          Information messages (MIB, SIB1, SIB2), initial cell selection, random
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   710
          access, and handover.</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   711
    </ul>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   712
  </li>
10533
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   713
  <li>A new parallel scheduling algorithm based on null messages, a common 
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   714
  parallel DES scheduling algorithm, has been added.  The null message 
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   715
  scheduler has better scaling properties when running on some scenarios
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   716
  with large numbers of nodes since it does not require a global 
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   717
  communication.
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   718
  </li>
10459
f2e90c12a44f base implementation of the IEEE 802.11p standard
Junling Bu <linlinjavaer@gmail.com>
parents: 10446
diff changeset
   719
</ul>
10422
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   720
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   721
<h2>Changes to existing API:</h2>
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   722
<ul>
10528
c1e835b43726 Bug 1796 - Ipv6PacketInfoTag is not filled by UdpSocketImpl::ForwardUp6.
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10519
diff changeset
   723
    <li> It is now possible to use Ipv6PacketInfoTag from UDP applications in the
10531
f23c083bb537 editing in preparation for release
Tom Henderson <tomh@tomh.org>
parents: 10528
diff changeset
   724
      same way as with Ipv4PacketInfoTag. See Doxygen for current limitations in
10528
c1e835b43726 Bug 1796 - Ipv6PacketInfoTag is not filled by UdpSocketImpl::ForwardUp6.
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10519
diff changeset
   725
  	  using Ipv[4,6]PacketInfoTag to set IP properties.</li>
10446
Nicola Baldo <nbaldo@cttc.es>
parents: 10442 10434
diff changeset
   726
    <li>A change is introduced for the usage of the EpcHelper
10442
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   727
      class. Previously, the EpcHelper class included both the API
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   728
      definition and its (only) implementation; as such, users would
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   729
      instantiate and use the EpcHelper class directly in their
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   730
      simulation programs. From now on,
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   731
      EpcHelper is just the base class defining the API, and the
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   732
      implementation has been moved to derived classes; as such,
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   733
      users are now expected to use one of the derived classes in
10519
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   734
      their simulation program. The implementation previously
10442
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   735
      provided by the EpcHelper class has been moved to the new
a420385d5438 make EpcHelper abstract
Nicola Baldo <nbaldo@cttc.es>
parents: 10188
diff changeset
   736
      derived class PointToPointEpcHelper.</li>
10519
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   737
  <li> The automatic handover trigger and ANR functions in LTE module have been
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   738
    moved from LteEnbRrc class to separate classes. As a result, the related
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   739
    attributes, e.g., ServingCellHandoverThreshold, NeighbourCellHandoverOffset,
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   740
    EventA2Threshold, and EventA4Threshold have been removed from LteEnbRrc
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   741
    class. The equivalent attributes are now in A2A4RsrqHandoverAlgorithm and
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   742
    LteAnr classes.</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   743
  <li> Master Information Block (MIB) and System Information Block Type 1 (SIB1)
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   744
    are now transmitted as LTE control messages, so they are no longer part of
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   745
    RRC protocol.</li>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   746
  <li> UE RRC state model in LTE module has been considerably modified and is
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   747
    not backward compatible with the previous state model.</li>
10533
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   748
  <li> Additional time units (Year, Day, Hour, Minute) were added to the time
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   749
  value class that represents simulation time; the largest unit prior to 
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   750
  this addition was Second.
0daa97dec8db add to notes regarding null message parallel scheduler and new time units
Tom Henderson <tomh@tomh.org>
parents: 10531
diff changeset
   751
  </li>
10899
9b501eb7910c Enhancements to SimpleNetDevice and SimpleChannel
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10892
diff changeset
   752
  <li> SimpleNetDevice and SimpleChannel are not so simple anymore. SimpleNetDevice can be now a
9b501eb7910c Enhancements to SimpleNetDevice and SimpleChannel
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10892
diff changeset
   753
       Broadcast or PointToPoint NetDevice, it can have a limited bandwidth and it uses an output
9b501eb7910c Enhancements to SimpleNetDevice and SimpleChannel
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10892
diff changeset
   754
       queue.       
9b501eb7910c Enhancements to SimpleNetDevice and SimpleChannel
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10892
diff changeset
   755
  </li>
10519
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   756
</ul>
f7f72f3cc6e3 updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE details
Budiarto Herman <budiarto.herman@magister.fi>
parents: 10514
diff changeset
   757
10422
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   758
<h2>Changes to build system:</h2>
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   759
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   760
<h2>Changed behavior:</h2>
10434
b1850c85be24 update RELEASE_NOTES and CHANGES.html for TapBridge changes
Tom Henderson <tomh@tomh.org>
parents: 10422
diff changeset
   761
<ul>
b1850c85be24 update RELEASE_NOTES and CHANGES.html for TapBridge changes
Tom Henderson <tomh@tomh.org>
parents: 10422
diff changeset
   762
  <li> For the TapBridge device, in UseLocal mode there is a MAC learning function. TapBridge has been waiting for the first packet received from tap interface to set the address of the bridged device to the source address of the first packet. This has caused problems with WiFi.  The new behavior is that after connection to the tap interface, ns-3 learns the MAC address of that interface with a system call and immediately sets the address of the bridged device to the learned one.  See <a href="https://www.nsnam.org/bugzilla/show_bug.cgi?id=1777">bug 1777</a> for more details.</li>
b1850c85be24 update RELEASE_NOTES and CHANGES.html for TapBridge changes
Tom Henderson <tomh@tomh.org>
parents: 10422
diff changeset
   763
  <li> TapBridge device now correctly implements IsLinkUp() method.</li>
10494
69f1d28a831e Pretty-print IPv6 addresses and routing tables
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10493
diff changeset
   764
  <li> IPv6 addresses and routing tables are printed like in Linux "route -A inet6" command.</li>
10531
f23c083bb537 editing in preparation for release
Tom Henderson <tomh@tomh.org>
parents: 10528
diff changeset
   765
  <li> A change in Ipv[4,6]Interface enforces the correct behaviour of IP 
f23c083bb537 editing in preparation for release
Tom Henderson <tomh@tomh.org>
parents: 10528
diff changeset
   766
    when a device do not support the minimum MTU requirements.
f23c083bb537 editing in preparation for release
Tom Henderson <tomh@tomh.org>
parents: 10528
diff changeset
   767
    This is set to 68 and 1280 octects respectively.  IP simulations that
f23c083bb537 editing in preparation for release
Tom Henderson <tomh@tomh.org>
parents: 10528
diff changeset
   768
    may have run over devices with smaller MTUs than 68 or 1280, respectively,
f23c083bb537 editing in preparation for release
Tom Henderson <tomh@tomh.org>
parents: 10528
diff changeset
   769
    will no longer be able to use such devices.</li>
10434
b1850c85be24 update RELEASE_NOTES and CHANGES.html for TapBridge changes
Tom Henderson <tomh@tomh.org>
parents: 10422
diff changeset
   770
</ul>
10422
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   771
114314101699 update RELEASE_NOTES and CHANGES.html for new release
Tom Henderson <tomh@tomh.org>
parents: 10421
diff changeset
   772
<hr>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   773
<h1>Changes from ns-3.18 to ns-3.18.1</h1>
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   774
<h2>New API:</h2>
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   775
<ul>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   776
  <li> It is now possible to randomize the time of the first beacon from an
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   777
  access point.  Use an attribute "EnableBeaconJitter" to enable/disable
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   778
  this feature.
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   779
  </li>
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   780
  <li> A new FixedRoomPositionAllocator helper class is available; it
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   781
  allows one to generate a random position uniformly distributed in the
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   782
  volume of a chosen room inside a chosen building.
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   783
  </li>
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   784
</ul>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   785
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   786
<h2>Changes to existing API:</h2>
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   787
<ul>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   788
  <li> Logging wildcards:  allow "***" as synonym for "*=**" to turn on all logging.
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   789
  </li>
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   790
  <li> The log component list ("NS_LOG=print-list") is now printed alphabetically.
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   791
  </li>
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   792
  <li> Some deprecated IEEE 802.11p code has been removed from the wifi module
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   793
  </li>
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   794
</ul>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   795
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   796
<h2>Changes to build system:</h2>
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   797
<ul>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   798
  <li> The Python API scanning system (./waf --apiscan) has been fixed (bug 1622)
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   799
  </li> 
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   800
  <li> Waf has been upgraded from 1.7.11 to 1.7.13
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   801
  </li> 
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   802
</ul>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   803
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   804
<h2>Changed behavior:</h2>
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   805
<ul>
10421
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   806
  <li> Wifi simulations have additional jitter on AP beaconing (see above) and some bug fixes have been applied to wifi module (see RELEASE_NOTES)
f6cfad75eea5 update RELEASE_NOTES and CHANGES.html for ns-3.18.1 release
Tom Henderson <tomh@tomh.org>
parents: 10188
diff changeset
   807
  </li> 
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   808
</ul>
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   809
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   810
<hr>
9758
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   811
<h1>Changes from ns-3.17 to ns-3.18</h1>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   812
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   813
<h2>New API:</h2>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   814
<ul>
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   815
  <li>New features have been added to the LTE module:
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   816
  <ul>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   817
    <li>PHY support for UE measurements (RSRP and RSRQ)</li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   818
    <li>RRC support for UE measurements (configuration, execution, reporting)</li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   819
    <li>Automatic Handover trigger based on RRC UE measurement reports</li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   820
  </ul>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   821
  <li>Data collection components have been added in the 'src/stats' module.
10119
8d243058531d update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 10101
diff changeset
   822
      Data collection includes a Probe class that attaches to ns-3 trace
8d243058531d update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 10101
diff changeset
   823
      sources to filter their output, and two Aggregator classes for 
8d243058531d update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 10101
diff changeset
   824
      marshaling probed data into text files or gnuplot plots.  The ns-3
8d243058531d update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 10101
diff changeset
   825
      tutorial has been extended to illustrate basic functionality. </li>
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   826
  <li>In 'src/wifi', several changes were made to enable partial 802.11n support:
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   827
    <ul>
12505
20252f9f9406 Fix typo in CHANGES.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12451
diff changeset
   828
      <li>A new helper (HtWifiMacHelper) was added to set up a High Throughput (HT) MAC entity</li>
20252f9f9406 Fix typo in CHANGES.html
Sébastien Deronne <sebastien.deronne@gmail.com>
parents: 12451
diff changeset
   829
      <li>New attributes were added to help the user setup a High Throughput (HT) PHY entity. These attributes can be set using the YansWifiPhyHelper</li>
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   830
      <li>A new standard value has been added that enables the new 11n data rates.</li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   831
      <li>New 11n preambles has been added (Mixed format and greenfield). To be able to change Tx duration according to the preamble used, a new class TxVector has been added to carry the transmission parameters (mode, preamble, stbc,..).  Several functions have been updated to allow the passage of TxVector instead of WifiMode in MacLow, WifiRemoteStationManager, WifiPhy, YansWifiPhy,.. </li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   832
      <li>A new information element has been added:  HTCapabilities. This information element is added to the MAC frame header if the node is an HT node. This HTCapabilites information element is used to advertise the HT capabilites of the node to other nodes in the network</li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   833
    </ul>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   834
  <li>InternetStackHelper has two new functions:<tt>SetIpv4ArpJitter (bool enable)</tt>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   835
      and <tt>SetIpv6NsRsJitter (bool enable)</tt> to enable/disable
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   836
      the random jitter on the tranmission of IPv4 ARP Request and IPv6 NS/RS. </li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   837
  <li>Bounds on valid time inputs for time attributes can now be enabled.  
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   838
      See <tt>attribute-test-suite.cc</tt> for an example.</li>
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   839
  <li>New generic hash function interface provided in the simulation core.  
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   840
      Two hash functions are provided: murmur3 (default), and the venerable 
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   841
      FNV1a.  See the Hash Functions section in the ns-3 manual.</li>
9946
df4a7e93c13d Mac16Address added, Mac64Address refactored, and Mac[16,64]Address can be used in IPv6
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 9944
diff changeset
   842
  <li>New Mac16Address has been added. It can be used with IPv6 to make
df4a7e93c13d Mac16Address added, Mac64Address refactored, and Mac[16,64]Address can be used in IPv6
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 9944
diff changeset
   843
      an Autoconfigured address.</li>
df4a7e93c13d Mac16Address added, Mac64Address refactored, and Mac[16,64]Address can be used in IPv6
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 9944
diff changeset
   844
  <li>Mac64Address support has been extended. It can now be used with 
df4a7e93c13d Mac16Address added, Mac64Address refactored, and Mac[16,64]Address can be used in IPv6
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 9944
diff changeset
   845
      IPv6 to make an Autoconfigured address.</li>
10127
f4cee68de571 Bug 1721 - Path MTU isn't handled properly
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10119
diff changeset
   846
  <li>IPv6 can now detect and use Path-MTU. See 
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   847
      <tt>examples/ipv6/fragmentation-ipv6-two-MTU.cc</tt> for an example.</li>
10160
5bf2fe645784 Update internet-stack-helper API for jitter and CHANGES.html
John Abraham <john.abraham.in@gmail.com>
parents: 10159
diff changeset
   848
  <li>Radvd application has a new Helper. See the updated 
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   849
      <tt>examples/ipv6/radvd.cc</tt> for an example.</li>
9758
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   850
</ul>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   851
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   852
<h2>Changes to existing API:</h2>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   853
<ul>
10131
0dc090fc749d Bug 1702 - A router should't aways add itself as the default router
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10129
diff changeset
   854
  <li> The Ipv6InterfaceContainer functions to set a node in forwarding state (i.e., a router) 
0dc090fc749d Bug 1702 - A router should't aways add itself as the default router
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10129
diff changeset
   855
  and to install a default router in a group of nodes have been extensively changed.
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   856
  The old function <tt>void Ipv6InterfaceContainer::SetRouter (uint32_t i, bool router)</tt>
10131
0dc090fc749d Bug 1702 - A router should't aways add itself as the default router
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10129
diff changeset
   857
  is now DEPRECATED.
0dc090fc749d Bug 1702 - A router should't aways add itself as the default router
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10129
diff changeset
   858
  </li>
9919
5596934962c2 RFC 3849 - IPv6 Address Prefix Reserved for Documentation
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 9892
diff changeset
   859
  <li> The documentation's IPv6 addresses (2001:db8::/32, RFC 3849) are now
5596934962c2 RFC 3849 - IPv6 Address Prefix Reserved for Documentation
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 9892
diff changeset
   860
  dropped by routers.
5596934962c2 RFC 3849 - IPv6 Address Prefix Reserved for Documentation
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 9892
diff changeset
   861
  </li>
9845
ef943f320ea6 update CHANGES.html to reflect the removal of tools module
Tom Henderson <tomh@tomh.org>
parents: 9758
diff changeset
   862
  <li> The 'src/tools' module has been removed, and most files migrated to
ef943f320ea6 update CHANGES.html to reflect the removal of tools module
Tom Henderson <tomh@tomh.org>
parents: 9758
diff changeset
   863
  'src/stats'.  For users of these programs (the statistics-processing 
ef943f320ea6 update CHANGES.html to reflect the removal of tools module
Tom Henderson <tomh@tomh.org>
parents: 9758
diff changeset
   864
  in average.h, or the gnuplot support), the main change is likely to be
ef943f320ea6 update CHANGES.html to reflect the removal of tools module
Tom Henderson <tomh@tomh.org>
parents: 9758
diff changeset
   865
  replacing the inclusion of "tools-module.h" with "stats-module.h".
ef943f320ea6 update CHANGES.html to reflect the removal of tools module
Tom Henderson <tomh@tomh.org>
parents: 9758
diff changeset
   866
  Users of the event garbage collector, previously in tools, will now 
ef943f320ea6 update CHANGES.html to reflect the removal of tools module
Tom Henderson <tomh@tomh.org>
parents: 9758
diff changeset
   867
  include it from the core module.
ef943f320ea6 update CHANGES.html to reflect the removal of tools module
Tom Henderson <tomh@tomh.org>
parents: 9758
diff changeset
   868
  </li>
9849
b3ec74c99612 Bug 1697 - ICMPv6 Redirect trigger contains multiple bugs
Guowang Shi <shiguowang2007@gmail.com>
parents: 9845
diff changeset
   869
  <li> The Ipv6 UnicastForwardCallback and  MulticastForwardCallback 
10131
0dc090fc749d Bug 1702 - A router should't aways add itself as the default router
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 10129
diff changeset
   870
  have a new parameter, the NetDevice the packet has been received from.
9849
b3ec74c99612 Bug 1697 - ICMPv6 Redirect trigger contains multiple bugs
Guowang Shi <shiguowang2007@gmail.com>
parents: 9845
diff changeset
   871
  Existing Ipv6RoutingProtocols should update their RouteInput function
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   872
  accordingly, e.g., from <tt>ucb (rtentry, p, header);</tt> to <tt>ucb (idev, rtentry, p, header);</tt>
9849
b3ec74c99612 Bug 1697 - ICMPv6 Redirect trigger contains multiple bugs
Guowang Shi <shiguowang2007@gmail.com>
parents: 9845
diff changeset
   873
  </li>
10101
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   874
  <li> The previous buildings module relied on a specific MobilityModel called
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   875
    BuildingsMobilityModel, which supported buildings but only allowed
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   876
    static positions. This mobility model has been removed. Now, the
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   877
    Buildings module instead relies on a new class called
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   878
    MobilityBuildingInfo which can be aggregated to any MobilityModel. This
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   879
    allows having moving nodes in presence of buildings with any of
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   880
    the existing MobilityModels. 
9658a01ee462 addressed the comments in https://codereview.appspot.com/11374043/#msg2
Nicola Baldo <nbaldo@cttc.es>
parents: 9946
diff changeset
   881
  </li>
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   882
  <li>All functions in WifiRemoteStationManager named GetXxxMode have been changed to GetXxxTxVector </li>
9758
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   883
</ul>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   884
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   885
<h2>Changes to build system:</h2>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   886
<ul>
10157
02e3d2d7d7e1 Link to bug num in bug database with \bugid{num}
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10143
diff changeset
   887
  <li> Make references to bug id's in doxygen comments with
02e3d2d7d7e1 Link to bug num in bug database with \bugid{num}
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10143
diff changeset
   888
    <tt>\bugid{num}</tt>, where <tt>num</tt> is the bug id number.  This
02e3d2d7d7e1 Link to bug num in bug database with \bugid{num}
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10143
diff changeset
   889
    form will generate a link to the bug in the bug database.
02e3d2d7d7e1 Link to bug num in bug database with \bugid{num}
Peter D. Barnes, Jr. <barnes26@llnl.gov>
parents: 10143
diff changeset
   890
  </li>
9758
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   891
</ul>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   892
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   893
<h2>Changed behavior:</h2>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   894
<ul>
10143
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   895
  <li> Now it is possible to request printing command line arguments to the
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   896
desired output stream using PrintHelp or operator &lt;&lt;
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   897
<pre>
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   898
  CommandLine cmd;
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   899
  cmd.Parse (argc, argv);
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   900
...
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   901
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   902
  std::cerr << cmd;
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   903
</pre>
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   904
or
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   905
<pre>
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   906
  cmd.PrintHelp (std::cerr);
48f66512ec9b [PATCH] core: Extending public interface of CommandLine class
Alexander Afanasyev <alexander.afanasyev@ucla.edu>
parents: 10139
diff changeset
   907
</pre>
10163
0595ff454efe align command-line test suite to recent changes
Tom Henderson <tomh@tomh.org>
parents: 10160
diff changeset
   908
  </li>
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   909
  <li>Command line boolean arguments specified with no integer value (e.g. <tt>"--boolArg"</tt>) will toggle the value from the default, instead of always setting the value to true.
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   910
  </li>
10163
0595ff454efe align command-line test suite to recent changes
Tom Henderson <tomh@tomh.org>
parents: 10160
diff changeset
   911
  <li>IPv4's ARP Request and IPv6's NS/RS are now transmitted with a random delay.
0595ff454efe align command-line test suite to recent changes
Tom Henderson <tomh@tomh.org>
parents: 10160
diff changeset
   912
      The delay is, by default, a uniform random variable in time between 0 and 10ms.
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   913
      This is aimed at preventing reception errors due to collisions during wifi broadcasts when the sending behavior is synchronized (e.g. due to applications starting at the same time on several different nodes).
10163
0595ff454efe align command-line test suite to recent changes
Tom Henderson <tomh@tomh.org>
parents: 10160
diff changeset
   914
      This behaviour can be modified by using ArpL3Protocol's 
0595ff454efe align command-line test suite to recent changes
Tom Henderson <tomh@tomh.org>
parents: 10160
diff changeset
   915
      <tt>RequestJitter</tt> and Icmpv6L4Protocol's <tt>SolicitationJitter</tt>
0595ff454efe align command-line test suite to recent changes
Tom Henderson <tomh@tomh.org>
parents: 10160
diff changeset
   916
      attributes or by using the new InternetStackHelper functions.
0595ff454efe align command-line test suite to recent changes
Tom Henderson <tomh@tomh.org>
parents: 10160
diff changeset
   917
  </li>
10165
9d3dc60bada4 update CHANGES.html, cleanup some formatting
Tom Henderson <tomh@tomh.org>
parents: 10163
diff changeset
   918
  <li>AODV Hellos are disabled by default. The performance with Hellos enabled and disabled are almost identical. With Hellos enabled, AODV will suppress hellos from transmission, if any recent broadcast such as RREQ was transmitted. The attribute <tt>ns3::aodv::RoutingProtocol::EnableHello</tt> can be used to enable/disable Hellos.
9758
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   919
</ul>
b7f82950d534 prepare for next release
Tom Henderson <tomh@tomh.org>
parents: 9752
diff changeset
   920
10188
f2177f4b2cb1 update repository to start work on ns-3.19
Tom Henderson <tomh@tomh.org>
parents: 10165
diff changeset
   921
<hr>
9212
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   922
<h1>Changes from ns-3.16 to ns-3.17</h1>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   923
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   924
<h2>New API:</h2>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   925
<ul>
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   926
  <li>New TCP Westwood and Westwood+ models
9752
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   927
  <li>New FdNetDevice class providing a special NetDevice that is able to read
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   928
      and write traffic from a file descriptor.  Three helpers are provided
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   929
      to associate the file descriptor with different underlying devices:  
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   930
    <ul> 
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   931
    <li> EmuFdNetDeviceHelper (to associate the |ns3| device with a physical 
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   932
         device in the host machine).  This helper is intended to
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   933
         eventually replace the EmuNetDevice in src/emu. </li>
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   934
    <li> TapFdNetDeviceHelper (to associate the ns-3 device with the file 
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   935
         descriptor from a tap device in the host machine) </li>
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   936
    <li> PlanteLabFdNetDeviceHelper (to automate the creation of tap devices 
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   937
         in PlanetLab nodes, enabling |ns3| simulations that can send and 
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   938
         receive traffic though the Internet using PlanetLab resource.</li>
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   939
    </ul> 
c2c31a5059d4 update changes.html and release notes for FdNetDevice changes
Tom Henderson <tomh@tomh.org>
parents: 9751
diff changeset
   940
  </li>
9232
0958cf37fa89 Update CHANGES.html and release notes to reflect ns-3-click defines and random number API additions
Lalith Suresh <suresh.lalith@gmail.com>
parents: 9225
diff changeset
   941
  <li>In Ipv4ClickRouting, the following APIs were added:
0958cf37fa89 Update CHANGES.html and release notes to reflect ns-3-click defines and random number API additions
Lalith Suresh <suresh.lalith@gmail.com>
parents: 9225
diff changeset
   942
    <ul>
0958cf37fa89 Update CHANGES.html and release notes to reflect ns-3-click defines and random number API additions
Lalith Suresh <suresh.lalith@gmail.com>
parents: 9225
diff changeset
   943
      <li>Ipv4ClickRouting::SetDefines(), accessible through ClickInternetStackHelper::SetDefines(), for the user to set Click defines from the ns-3 simulation file.</li>
0958cf37fa89 Update CHANGES.html and release notes to reflect ns-3-click defines and random number API additions
Lalith Suresh <suresh.lalith@gmail.com>
parents: 9225
diff changeset
   944
      <li>SIMCLICK_GET_RANDOM_INT click-to-simulator command for ns-3 to drive Click's random number generation.</li>
0958cf37fa89 Update CHANGES.html and release notes to reflect ns-3-click defines and random number API additions
Lalith Suresh <suresh.lalith@gmail.com>
parents: 9225
diff changeset
   945
    </ul>
9714
e15fefdc07f4 Documentation
Brian Swenson <bswenson3@gatech.edu>
parents: 9232
diff changeset
   946
  </li>  
9736
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   947
  <li>LTE module
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   948
    <ul>
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   949
      <li> New user-visible LTE API
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   950
      <ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   951
        <li>Two new methods have been added to LteHelper to enable the X2-based handover functionality: AddX2Interface, which setups the X2 interface between two eNBs, and HandoverRequest, which is  a convenience method that schedules an explicit handover event to be executed at a given point in the simulation. </li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   952
        <li>the new LteHelper method EnablePhyTraces can now be used to enable the new PHY traces</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   953
      </ul>
9736
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   954
      </li> 
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   955
      <li> New internal LTE API 
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   956
      <ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   957
        <li>New LTE control message classes DlHarqFeedbackLteControlMessage, 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   958
         RachPreambleLteControlMessage, RarLteControlMessage, MibLteControlMessage</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   959
        <li>New class UeManager
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   960
        <li>New LteRadioBearerInfo subclasses LteSignalingRadioBearerInfo, 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   961
         LteDataRadioBearerInfo</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   962
        <li>New LteSinrChunkProcessor subclasses LteRsReceivedPowerChunkProcessor, 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   963
         LteInterferencePowerChunkProcessor</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   964
      </ul>
9736
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   965
      </li>
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   966
    </ul>
da5e3a6c4029 updated CHANGES.html and RELEASE_NOTES for LTE module
Nicola Baldo <nbaldo@cttc.es>
parents: 9714
diff changeset
   967
  </li>
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   968
  <li>New DSR API
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   969
  <ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   970
    <li>Added PassiveBuffer class to save maintenance packet entry for passive acknowledgment option</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   971
    <li>Added FindSourceEntry function in RreqTable class to keep track of route request entry received from same source node</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   972
    <li>Added NotifyDataReciept function in DsrRouting class to notify the data receipt of the next hop from link layer.  This is used for the link layer acknowledgment.</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   973
  </ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   974
  </li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   975
  <li>New Tag, PacketSocketTag, to carry the destination address of a packet and the packet type</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   976
  <li>New Tag, DeviceNameTag, to carry the ns3 device name from where a packet is coming</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   977
  <li>New Error Model, BurstError model, to determine which bursts of packets are errored corresponding to an underlying distribution, burst rate, and burst size</li>
9212
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   978
</ul>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   979
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   980
<h2>Changes to existing API:</h2>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
   981
<ul>
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   982
  <li>ns3::Object and subclasses DoStart has been renamed to DoInitialize</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   983
  <li>ns3::Object and subclasses Start has been renamed to Initialize</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   984
  <li>EnergySource StartDeviceModels renamed to InitializeDeviceModels</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   985
  <li>A typo was fixed in an LTE variable name. The variable ns3::AllocationRetentionPriority::preemprionVulnerability was changed to preemptionVulnerability.</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   986
  <li>Changes in TestCase API
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   987
  <ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   988
    <li>TestCase has new enumeration TestDuration containing QUICK, EXTENSIVE, TAKES_FOREVER</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   989
    <li>TestCase constructor now requires TestDuration, old constructor marked deprecated</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   990
 </ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   991
 </li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   992
  <li>Changes in LTE API
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   993
  <ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   994
    <li> User-visible LTE API 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   995
    <ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   996
      <li>The previous LteHelper method ActivateEpsBearer has been now replaced by two alternative methods: ActivateDataRadioBearer (to be used when the EPC model is not used) and ActivateDedicatedEpsBearer (to be used when the EPC model is used). In the case where the EPC model is used, the default EPS bearer is not automatically activated without the need for a specific method to be called.</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   997
    </ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   998
    </li> 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
   999
    <li> Internal LTE API 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1000
    <ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1001
      <li>EpcHelper added methods AddUe, AddX2Interface.  Method AddEnb now requires a cellId.  Signature of ActivateEpsBearer changed to void ActivateEpsBearer (Ptr<NetDevice> ueLteDevice, uint64_t imsi, Ptr<EpcTft> tft, EpsBearer bearer)</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1002
      <li>LteHelper added methods EnableDlPhyTraces, EnableUlPhyTraces, EnableDlTxPhyTraces, EnableUlTxPhyTraces, EnableDlRxPhyTraces, EnableUlRxPhyTraces</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1003
      <li>LteHelper removed methods EnableDlRlcTraces, EnableUlRlcTraces, EnableDlPdcpTraces, EnableUlPdcpTraces</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1004
      <li>RadioBearerStatsCalculator added methods (Set/Get)StartTime, (Set/Get)Epoch, RescheduleEndEpoch, EndEpoch</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1005
      <li>RadioBearerStatsCalculator removed methods StartEpoch, CheckEpoch</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1006
      <li>RadioBearerStatsCalculator methods UlTxPdu, DlRxPdu now require a cellId</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1007
      <li>EpcEnbApplication constructor now requires Ipv4Addresses enbS1uAddress and sgwS1uAddress as well as cellId</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1008
      <li>EpcEnbApplication added methods SetS1SapUser, GetS1SapProvider, SetS1apSapMme and GetS1apSapEnb</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1009
      <li>EpcEnbApplication removed method ErabSetupRequest</li> 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1010
      <li>EpcSgwPgwApplication added methods SetS11SapMme, GetS11SapSgw, AddEnb, AddUe, SetUeAddress</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1011
      <li>lte-common.h new structs PhyTransmissionStatParameters and PhyReceptionStatParameters used in TracedCallbacks</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1012
      <li>LteControlMessage new message types DL_HARQ, RACH_PREAMBLE, RAR, MIB</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1013
      <li>LteEnbCmacSapProvider new methods RemoveUe, GetRachConfig, AllocateNcRaPreamble, AllocateTemporaryCellRnti</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1014
      <li>LteEnbPhy new methods GetLteEnbCphySapProvider, SetLteEnbCphySapUser, GetDlSpectrumPhy, GetUlSpectrumPhy, CreateSrsReport</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1015
      <li>LteEnbPhy methods DoSendMacPdu, DoSetTransmissionMode, DoSetSrsConfigurationIndex, DoGetMacChTtiDelay, DoSendLteControlMessage, AddUePhy, DeleteUePhy made private</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1016
      <li>LteEnbPhySapProvider removed methods SetBandwidth, SetTransmissionMode, SetSrsConfigurationIndex, SetCellId</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1017
      <li>LteEnbPhySapUser added methods ReceiveRachPreamble, UlInfoListElementHarqFeeback, DlInfoListElementHarqFeeback</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1018
      <li>LtePdcp added methods (Set/Get)Status</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1019
      <li>LtePdcp DoTransmitRrcPdu renamed DoTransmitPdcpSdu</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1020
      <li>LteUeRrc new enum State.  New methods SetLteUeCphySapProvider, GetLteUeCphySapUser, SetLteUeRrcSapUser, GetLteUeRrcSapProvider, GetState, GetDlEarfcn, GetDlBandwidth, GetUlBandwidth, GetCellId, SetUseRlcSm .  GetRnti made const.</li> 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1021
      <li>LteUeRrc removed methods ReleaseRadioBearer, GetLcIdVector, SetForwardUpCallback, DoRrcConfigurationUpdateInd</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1022
      <li>LtePdcpSapProvider struct TransmitRrcPduParameters renamed TransmitPdcpSduParameters.  Method TransmitRrcPdu renamed TransmitPdcpSdu </li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1023
      <li>LtePdcpSapUser struct ReceiveRrcPduParameters renamed ReceivePdcpSduParameters.  Method ReceiveRrcPdu renamed TransmitPdcpSdu</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1024
      <li>LtePdcpSpecificLtePdcpSapProvider method TransmitRrcPdu renamed TransmitPdcpSdu</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1025
      <li>LtePdcpSpecificLtePdcpSapUser method ReceiveRrcPdu  renamed ReceivePdcpSdu. Method ReceiveRrcPdu renamed ReceivePdcpSdu</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1026
      <li>LtePhy removed methods DoSetBandwidth and DoSetEarfcn</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1027
      <li>LtePhy added methods ReportInterference and ReportRsReceivedPower</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1028
      <li>LteSpectrumPhy added methods SetHarqPhyModule, Reset, SetLtePhyDlHarqFeedbackCallback, SetLtePhyUlHarqFeedbackCallback,  AddRsPowerChunkProcessor, AddInterferenceChunkProcessor</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1029
      <li>LteUeCphySapProvider removed methods ConfigureRach, StartContentionBasedRandomAccessProcedure, StartNonContentionBasedRandomAccessProcedure</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1030
      <li>LteUeMac added method AssignStreams</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1031
      <li>LteUeNetDevice methods GetMac, GetRrc, GetImsi  made const</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1032
      <li>LteUeNetDevice new method GetNas</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1033
      <li>LteUePhy new methods GetLteUeCphySapProvider, SetLteUeCphySapUser, GetDlSpectrumPhy, GetUlSpectrumPhy, ReportInterference, ReportRsReceivedPower, ReceiveLteDlHarqFeedback</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1034
      <li>LteUePhy DoSendMacPdu, DoSendLteControlMessage, DoSetTransmissionMode, DoSetSrsConfigurationIndex made private</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1035
      <li>LteUePhySapProvider removed methods SetBandwidth, SetTransmissionMode, SetSrsConfigurationIndex</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1036
      <li>LteUePhySapProvider added method SendRachPreamble</li>  
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1037
    </ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1038
   </li>    
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1039
  </ul>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1040
  <li>AnimationInterface method EnableIpv4RouteTracking returns reference to calling AnimationInterface object</li>
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1041
  <li>To make the API more uniform across the various
9748
070273fe1cd5 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9745
diff changeset
  1042
  PropagationLossModel classes, the Set/GetLambda methods of the
070273fe1cd5 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9745
diff changeset
  1043
  FriisPropagationLossModel and TwoRayGroundPropagationLossModel
070273fe1cd5 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9745
diff changeset
  1044
  classes have been changed to Set/GetFrequency, and now a Frequency
070273fe1cd5 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9745
diff changeset
  1045
  attribute is exported which replaces the pre-existing Lambda
070273fe1cd5 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9745
diff changeset
  1046
  attribute. Any previous user code setting a value for Lambda should
070273fe1cd5 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9745
diff changeset
  1047
  be changed to set instead a value of Frequency = C / Lambda, with C
070273fe1cd5 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9745
diff changeset
  1048
  = 299792458.0. </li>
9714
e15fefdc07f4 Documentation
Brian Swenson <bswenson3@gatech.edu>
parents: 9232
diff changeset
  1049
</ul>
9212
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1050
<h2>Changes to build system:</h2>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1051
<ul>
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1052
  <li>Waf shipped with ns-3 has been upgraded to version 1.7.10 and custom
9741
98737f7646a1 update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 9736
diff changeset
  1053
  pkg-config generator has been replaced by Waf's builtin tool.
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1054
  </li>
9212
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1055
</ul>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1056
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1057
<h2>Changed behavior:</h2>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1058
<ul>
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1059
  <li>DSR link layer notification has changed.  The model originally used 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1060
  "TxErrHeader" in Ptr<WifiMac> to indicate the transmission
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1061
  error of a specific packet in link layer; however, it was not working
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1062
  correctly.  The model now uses a different path to implement
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1063
  the link layer notification mechanism; specifically, looking into the 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1064
  trace file to find packet receive events.  If the model finds one 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1065
  receive event for the data packet, it is used as the indicator for 
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1066
  successful data delivery.</li>
9212
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1067
</ul>
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1068
294690720935 start CHANGES.html and RELEASE_NOTES for next ns-3 version
Tom Henderson <tomh@tomh.org>
parents: 9189
diff changeset
  1069
<hr>
9097
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1070
<h1>Changes from ns-3.15 to ns-3.16</h1>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1071
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1072
<h2>New API:</h2>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1073
<ul>
9145
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1074
<li>In the Socket class, the following functions were added: 
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1075
 <ul>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1076
  <li>(Set/Get)IpTos - sets IP Type of Service field in the IP headers.</li>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1077
  <li>(Set/Is)IpRecvTos - tells the socket to pass information about IP ToS up the stack (by adding SocketIpTosTag to the packet).</li>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1078
  <li>(Set/Get)IpTtl - sets IP Time to live field in the IP headers.</li>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1079
  <li>(Set/Is)RecvIpTtl - tells the socket to pass information about IP TTL up the stack (by adding SocketIpTtlTag to the packet).</li>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1080
  <li>(Set/Is)Ipv6Tclass - sets Traffic Class field in the IPv6 headers.</li>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1081
  <li>(Set/Is)Ipv6RecvTclass - tells the socket to pass information about IPv6 TCLASS up the stack (by adding SocketIpv6TclassTag to the packet).</li>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1082
  <li>(Set/Get)Ipv6HopLimit - sets Hop Limit field in the IPv6 headers.</li>
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1083
  <li>(Set/Is)Ipv6RecvHopLimit - tells the socket to pass information about IPv6 HOPLIMIT up the stack (by adding SocketIpv6HoplimitTag to the packet).</li>
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1084
 </ul>  
9145
5752b425cdf5 Bug 1361 - Set TOS from Application level (sockets)
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9113
diff changeset
  1085
A user can call these functions to set/get the corresponding socket option. See examples/socket/socket-options-ipv4.cc and examples/socket/socket-options-ipv6.cc for examples.
9097
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1086
</ul>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1087
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1088
<h2>Changes to existing API:</h2>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1089
<ul>
9098
e507321e9a0d Update changes file again
Mitch Watrous <watrous@u.washington.edu>
parents: 9097
diff changeset
  1090
<li>In the MobilityHelper class, the functions EnableAscii () and EnableAsciiAll () were changed to use output stream wrappers rather than standard C++ ostreams. The purpose of this change was to make them behave analogously to other helpers in ns-3 that generate ascii traces.  Now, the file stream that is open in MobilityHelper is closed nicely upon asserts and program exits.</li>
9097
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1091
</ul>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1092
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1093
<h2>Changes to build system:</h2>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1094
<ul>
9189
b6e9f47c260b Document building with distcc in tutorial, add it to RELEASE_NOTES and CHANGES.html.
Vedran Miletić <rivanvx@gmail.com>
parents: 9145
diff changeset
  1095
<li>It's now possible to use distcc when building ns-3. See tutorial for details.</li>
9097
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1096
</ul>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1097
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1098
<h2>Changed behavior:</h2>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1099
<ul>
9111
e153cd03f531 Updates CHANGES.html and RELEASE_NOTES
Daniel Lertpratchya <nikkipui@gmail.com>
parents: 9098
diff changeset
  1100
<li>Sending a packet through Ipv4RawSocket now supports checksum in the Ipv4Header. It is still not possible to manually put in arbitrary checksum as the checksum is automatically calculated at Ipv4L3Protocol. The user has to enable checksum globally for this to work. Simply calling Ipv4Header::EnableChecksum() for a single Ipv4Header will not work.</li>
9113
63eba52498e1 make MultiModelSpectrumChannel support SpectrumModel changes at run time
Nicola Baldo <nbaldo@cttc.es>
parents: 9111
diff changeset
  1101
<li>Now MultiModelSpectrumChannel allows a SpectrumPhy instance to change SpectrumModel at runtime by issuing a call to MultiModelSpectrumChannel::AddRx (). Previously, MultiModelSpectrumChannel required each SpectrumPhy instance to stick with the same SpectrumModel for the whole simulation. 
63eba52498e1 make MultiModelSpectrumChannel support SpectrumModel changes at run time
Nicola Baldo <nbaldo@cttc.es>
parents: 9111
diff changeset
  1102
</li>
9097
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1103
</ul>
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1104
4d2b28c310db Update changes file
Mitch Watrous <watrous@u.washington.edu>
parents: 8878
diff changeset
  1105
<hr>
8846
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1106
<h1>Changes from ns-3.14 to ns-3.15</h1>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1107
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1108
<h2>New API:</h2>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1109
<ul>
8878
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1110
<li>A RandomVariableStreamHelper has been introduced to assist with 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1111
using the Config subsystem path names to assign fixed stream numbers
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1112
to RandomVariableStream objects.</li>
8846
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1113
</ul>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1114
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1115
<h2>Changes to existing API:</h2>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1116
<ul>
8878
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1117
<li>Derived classes of RandomVariable (i.e. the random variable 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1118
implementations) have been ported to a new RandomVariableStream base class.
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1119
<li>For a given distribution DistributionVariable (such as UniformVariable),
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1120
the new class name is DistributionRandomVariable (such as 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1121
UniformRandomVariable). </li>
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1122
<li>The new implementations are also derived from class ns3::Object and 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1123
are handled using the ns-3 smart pointer (Ptr) class.  </li>
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1124
<li>The new variable classes also have a new attributed called "Stream"
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1125
which allows them to be assigned to a fix stream index when assigned
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1126
to the underlying pseudo-random stream of numbers.</li>
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1127
</li>
8846
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1128
</ul>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1129
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1130
<h2>Changes to build system:</h2>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1131
<ul>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1132
<li></li>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1133
</ul>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1134
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1135
<h2>Changed behavior:</h2>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1136
<ul>
8878
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1137
<li>Programs using random variables or models that include random variables 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1138
may exhibit changed output for a given run number or seed, due to a possible 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1139
change in the order in which random variables are assigned to underlying 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1140
pseudo-random sequences.  Consult the manual for more information regarding 
a007dbfb3189 update CHANGES.html and RELEASE_NOTES for random variable merge
Tom Henderson <tomh@tomh.org>
parents: 8846
diff changeset
  1141
this.</li>
8846
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1142
</ul>
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1143
6e874a0fee27 start new release notes for future releases
Tom Henderson <tomh@tomh.org>
parents: 8839
diff changeset
  1144
<hr>
8839
d7e0dbcc899c update CHANGES.html for ns-3.14
Tom Henderson <tomh@tomh.org>
parents: 8798
diff changeset
  1145
<h1>Changes from ns-3.13 to ns-3.14</h1>
7698
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1146
7847
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1147
<h2>New API:</h2>
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1148
<ul>
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1149
<li>The new class AntennaModel provides an API for modeling the radiation pattern of antennas.
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1150
</li>
8749
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1151
<li>The new buildings module introduces an API (classes, helpers, etc)
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1152
  to model the presence of buildings in a wireless network topology. 
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1153
</li>
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1154
<li>The LENA project's implementation of the LTE Mac Scheduler Interface Specification
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1155
   standardized by the Small Cell Forum (formerly Femto Forum) is now available for
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1156
  use with the LTE module.
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1157
</li>
7847
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1158
</ul>
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1159
7698
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1160
<h2>Changes to existing API:</h2>
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1161
<ul>
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1162
<li> The Ipv6RawSocketImpl "IcmpFilter" attribute has been removed. Six 
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1163
new member functions have been added to enable the same functionality.
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1164
</li>
7717
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1165
<li> IPv6 support for TCP and UDP has been implemented.  Socket functions
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1166
that take an address [e.g. Send (), Connect (), Bind ()] can accept an
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1167
ns3::Ipv6Address or a ns3::Address in addition to taking an ns3::Ipv4Address.
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1168
(Note that the ns3::Address must contain a ns3::Ipv6Address or a ns3::Ipv4Address,
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1169
otherwise these functions will return an error).
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1170
Internally, the socket now stores the remote address as a type "ns3::Address"
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1171
instead of a type "ns3::Ipv4Address".  The IPv6 Routing Header extension is not
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1172
currently supported in ns3 and will not be reflected in the TCP and UDP checksum
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1173
calculations per RFC 2460.  Also note that UDP checksums for IPv6 packets are
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1174
required per RFC, but remain optional and disabled by default in ns3 (in the
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1175
interest of performance).
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1176
</li>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1177
<li>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1178
When calling Bind () on a socket without an address, the behavior remains the
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1179
same: it will bind to the IPv4 "any" address (0.0.0.0).  In order to Bind () to
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1180
the IPv6 "any" address in a similar fashion, use "Bind6 ()".
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1181
</li>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1182
<li>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1183
The prototype for the RxCallback function in the Ipv6EndPoint was changed.
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1184
It now includes the destination IPv6 address of the end point which was
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1185
needed for TCP.  This lead to a small change in the UDP and ICMPv6 L4
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1186
protocols as well.
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1187
</li>
7791
21c3495394b4 Enhancement 1393 - IPv6 Routing Helper RT Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7717
diff changeset
  1188
<li>
21c3495394b4 Enhancement 1393 - IPv6 Routing Helper RT Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7717
diff changeset
  1189
Ipv6RoutingHelper can now print the IPv6 Routing Tables at specific 
21c3495394b4 Enhancement 1393 - IPv6 Routing Helper RT Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7717
diff changeset
  1190
intervals or time. Exactly like Ipv4RoutingHelper do.
21c3495394b4 Enhancement 1393 - IPv6 Routing Helper RT Print functions
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7717
diff changeset
  1191
</li>
7793
1c81a8a91b1e Add SendIcmpv6Redirect attribute to Ipv6L3Protocol
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7791
diff changeset
  1192
<li>
1c81a8a91b1e Add SendIcmpv6Redirect attribute to Ipv6L3Protocol
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7791
diff changeset
  1193
New "SendIcmpv6Redirect" attribute (and getter/setter functions) to 
1c81a8a91b1e Add SendIcmpv6Redirect attribute to Ipv6L3Protocol
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7791
diff changeset
  1194
Ipv6L3Protocol. The behavior is similar to Linux's conf "send_redirects", 
1c81a8a91b1e Add SendIcmpv6Redirect attribute to Ipv6L3Protocol
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7791
diff changeset
  1195
i.e., enable/disable the ICMPv6 Redirect sending.
1c81a8a91b1e Add SendIcmpv6Redirect attribute to Ipv6L3Protocol
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7791
diff changeset
  1196
</li>
7847
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1197
<li> The SpectrumPhy abstract class now has a new method
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1198
<pre>virtual Ptr&#60;AntennaModel&#62; GetRxAntenna () = 0;</pre>
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1199
that all derived classes need to implement in order to integrate properly with the newly added antenna model. In addition, a new member variable "Ptr&#60;AntennaModel&#62; txAntenna" has been added to SpectrumSignalParameters in order to allow derived SpectrumPhy classes to provide information about the antenna model used for the transmission of a waveform.
411299d94e07 updated CHANGES.html and RELEASE_NOTES
Nicola Baldo <nbaldo@cttc.es>
parents: 7793
diff changeset
  1200
</li>
7860
ba8980d77369 Remove Ns2CalendarScheduler event scheduler
Tom Henderson <tomh@tomh.org>
parents: 7847
diff changeset
  1201
<li> The Ns2CalendarScheduler event scheduler has been removed.
ba8980d77369 Remove Ns2CalendarScheduler event scheduler
Tom Henderson <tomh@tomh.org>
parents: 7847
diff changeset
  1202
</li>
7880
f5c22d8411e6 Update CHANGES.html and RELEASE_NOTES for QueueMode and ErrorUnit.
Vedran Miletić <rivanvx@gmail.com>
parents: 7860
diff changeset
  1203
<li>
f5c22d8411e6 Update CHANGES.html and RELEASE_NOTES for QueueMode and ErrorUnit.
Vedran Miletić <rivanvx@gmail.com>
parents: 7860
diff changeset
  1204
ErrorUnit enum has been moved into RateErrorModel class, and symbols EU_BIT, EU_BYTE and EU_PKT have been renamed to RateErrorModel::ERROR_UNIT_BIT, RateErrorModel::ERROR_UNIT_BYTE and RateErrorModel::ERROR_UNIT_PACKET. RateErrorModel class attribute "ErrorUnit" values have also been renamed for consistency, and are now "ERROR_UNIT_BIT", "ERROR_UNIT_BYTE", "ERROR_UNIT_PACKET".
f5c22d8411e6 Update CHANGES.html and RELEASE_NOTES for QueueMode and ErrorUnit.
Vedran Miletić <rivanvx@gmail.com>
parents: 7860
diff changeset
  1205
</li>
f5c22d8411e6 Update CHANGES.html and RELEASE_NOTES for QueueMode and ErrorUnit.
Vedran Miletić <rivanvx@gmail.com>
parents: 7860
diff changeset
  1206
<li>
f5c22d8411e6 Update CHANGES.html and RELEASE_NOTES for QueueMode and ErrorUnit.
Vedran Miletić <rivanvx@gmail.com>
parents: 7860
diff changeset
  1207
QueueMode enum from DropTailQueue and RedQueue classes has been unified and moved to Queueu class. Symbols DropTailQueue::PACKETS and DropTailQueue::BYTES are now named Queue::QUEUE_MODE_PACKETS and DropTailQueue::QUEUE_MODE_BYTES. In addition, DropTailQueue and RedQueue class attributes "Mode" have been renamed for consistency from "Packets" and "Bytes" to "QUEUE_MODE_PACKETS" and "QUEUE_MODE_BYTES".
f5c22d8411e6 Update CHANGES.html and RELEASE_NOTES for QueueMode and ErrorUnit.
Vedran Miletić <rivanvx@gmail.com>
parents: 7860
diff changeset
  1208
</li>
8749
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1209
<li>
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1210
The API of the LTE module has undergone a significant redesign with
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1211
the merge of the code from the LENA project. The new API is not
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1212
backwards compatible with the previous version of the LTE module.
4462ac63d4cf merge of the code from the LENA project into ns-3-dev
Nicola Baldo <nbaldo@cttc.es>
parents: 7880
diff changeset
  1213
</li>
8798
5d8dfd7c6609 bug 1432: Align Ipv6AddressHelper API with Ipv4AddressHelper API
Tom Henderson <tomh@tomh.org>
parents: 8749
diff changeset
  1214
<li> The Ipv6AddressHelper API has been aligned with the Ipv4AddressHelper API. 
5d8dfd7c6609 bug 1432: Align Ipv6AddressHelper API with Ipv4AddressHelper API
Tom Henderson <tomh@tomh.org>
parents: 8749
diff changeset
  1215
The helper can be set with a call to Ipv6AddressHelper::SetBase 
5d8dfd7c6609 bug 1432: Align Ipv6AddressHelper API with Ipv4AddressHelper API
Tom Henderson <tomh@tomh.org>
parents: 8749
diff changeset
  1216
(Ipv6Address network, Ipv6Prefix prefix) instead of NewNetwork
5d8dfd7c6609 bug 1432: Align Ipv6AddressHelper API with Ipv4AddressHelper API
Tom Henderson <tomh@tomh.org>
parents: 8749
diff changeset
  1217
(Ipv6Address network, Ipv6Prefix prefix).  A new NewAddress (void) method
5d8dfd7c6609 bug 1432: Align Ipv6AddressHelper API with Ipv4AddressHelper API
Tom Henderson <tomh@tomh.org>
parents: 8749
diff changeset
  1218
has been added.  Typical usage will involve calls to SetBase (), NewNetwork (),
5d8dfd7c6609 bug 1432: Align Ipv6AddressHelper API with Ipv4AddressHelper API
Tom Henderson <tomh@tomh.org>
parents: 8749
diff changeset
  1219
and NewAddress (), as in class Ipv4AddressHelper. 
5d8dfd7c6609 bug 1432: Align Ipv6AddressHelper API with Ipv4AddressHelper API
Tom Henderson <tomh@tomh.org>
parents: 8749
diff changeset
  1220
</li>
7717
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1221
</ul>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1222
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1223
<h2>Changes to build system:</h2>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1224
<ul>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1225
<li> The following files are removed:
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1226
<pre>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1227
  src/internet/model/ipv4-l4-protocol.cc
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1228
  src/internet/model/ipv4-l4-protocol.h
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1229
  src/internet/model/ipv6-l4-protocol.cc
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1230
  src/internet/model/ipv6-l4-protocol.h
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1231
</pre>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1232
and replaced with:
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1233
<pre>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1234
  src/internet/model/ip-l4-protocol.cc
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1235
  src/internet/model/ip-l4-protocol.h
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1236
</pre>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1237
</li>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1238
</ul>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1239
<h2>Changed behavior:</h2>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1240
<ul>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1241
<li> Dual-stacked IPv6 sockets are implemented.  An IPv6 socket can accept
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1242
an IPv4 connection, returning the senders address as an IPv4-mapped address
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1243
(IPV6_V6ONLY socket option is not implemented).
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1244
</li>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1245
<li>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1246
The following examples/application/helpers were modified to support IPv6:
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1247
<pre>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1248
csma-layout/examples/csma-star [*]
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1249
netanim/examples/star-animation [*]
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1250
point-to-point-layout/model/point-to-point-star.cc
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1251
point-to-point-layout/model/point-to-point-grid.cc
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1252
point-to-point-layout/model/point-to-point-dumbbell.cc
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1253
examples/udp/udp-echo [*]
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1254
examples/udp-client-server/udp-client-server [*]
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1255
examples/udp-client-server/udp-trace-client-server [*]
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1256
applications/helper/udp-echo-helper
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1257
applications/model/udp-client
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1258
applications/model/udp-echo-client
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1259
applications/model/udp-echo-server
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1260
applications/model/udp-server
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1261
applications/model/udp-trace-client
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1262
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1263
[*]  Added '--useIpv6' flag to switch between IPv4 and IPv6
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1264
</pre>
cfa1741013dd Add support for IPv6 transport protocols
Ken Renard <kdrenard2@gmail.com>
parents: 7698
diff changeset
  1265
</li>
7698
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1266
</ul>
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1267
db9d8003b3cf Update Changes.html and Release_notes with the latest -dev info
Tommaso Pecorella <tommaso.pecorella@unifi.it>
parents: 7655
diff changeset
  1268
<hr>
7505
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1269
<h1>Changes from ns-3.12 to ns-3.13</h1>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1270
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1271
<h2>Changes to build system:</h2>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1272
<ul>
7506
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1273
<li> The underlying version of waf used by ns-3 was upgraded to 1.6.7.  
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1274
This has a few changes for users and developers:
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1275
<ul>
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1276
<li> by default, "build" no longer has a subdirectory debug or optimized.  
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1277
To get different build directories for different build types, you can use 
7655
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1278
the waf configure -o <argument> option, e.g.:
7506
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1279
<pre>
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1280
  ./waf configure -o shared
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1281
  ./waf configure --enable-static -o static
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1282
</pre>
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1283
</li>
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1284
<li> (for developers) the ns3headers taskgen needs to be created with a 
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1285
features parameter name:
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1286
<pre>
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1287
  -  headers = bld.new_task_gen('ns3header')
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1288
  +  headers = bld.new_task_gen(features=['ns3header'])
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1289
</pre>
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1290
<li> no longer need to edit src/wscript to add a module, just create your 
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1291
module directory inside src and ns-3 will pick it up
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1292
<li> In WAF 1.6, adding -Dxxx options is done via the DEFINES env. var.
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1293
instead of CXXDEFINES
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1294
<li> waf env values are always lists now, e.g. env['PYTHON'] returns
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1295
['/usr/bin/python'], so you may need to add [0] to the value in some places
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1296
</ul> 
7505
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1297
</ul>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1298
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1299
<h2>New API:</h2>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1300
<ul>
7655
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1301
<li> In the mobility module, there is a new MobilityModel::GetRelativeSpeed() method returning the relative speed of two objects. </li>
7643
ff15b50555ea update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7592
diff changeset
  1302
<li> A new Ipv6AddressGenerator class was added to generate sequential
ff15b50555ea update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7592
diff changeset
  1303
addresses from a provided base prefix and interfaceId.  It also will detect
ff15b50555ea update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7592
diff changeset
  1304
duplicate address assigments. </li> 
7505
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1305
</ul>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1306
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1307
<h2>Changes to existing API:</h2>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1308
<ul>
7581
6ac3fa410583 spectrum API change
Nicola Baldo <nicola@baldo.biz>
parents: 7553
diff changeset
  1309
<li> In the spectrum module, the parameters to SpectrumChannel::StartTx () and SpectrumPhy::StartRx () methods are now passed using the new struct SpectrumSignalParameters. This new struct supports inheritance, hence it allows technology-specific PHY implementations to provide technology-specific parameters in SpectrumChannel::StartTx() and SpectrumPhy::StartRx(), while at the same time keeping a set of technology-independent parameters common across all spectrum-enabled PHY implementations (i.e., the duration and the power spectral density which are needed for interference calculation). Additionally, the SpectrumType class has been removed, since now the type of a spectrum signal can be inferred by doing a dynamic cast on SpectrumSignalParameters. See the <A href="http://mailman.isi.edu/pipermail/ns-developers/2011-October/009495.html" >Spectrum API change discussion on ns-developers</A> for the motivation behind this API change.
6ac3fa410583 spectrum API change
Nicola Baldo <nicola@baldo.biz>
parents: 7553
diff changeset
  1310
</li>
6ac3fa410583 spectrum API change
Nicola Baldo <nicola@baldo.biz>
parents: 7553
diff changeset
  1311
7506
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1312
<li> The WifiPhyStandard enumerators for specifying half- and quarter-channel 
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1313
width standards has had a change in capitalization:
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1314
<ul>
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1315
<li> WIFI_PHY_STANDARD_80211_10Mhz was changed to WIFI_PHY_STANDARD_80211_10MHZ
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1316
<li> WIFI_PHY_STANDARD_80211_5Mhz was changed to WIFI_PHY_STANDARD_80211_5MHZ
59a4713417d9 Start documenting changes for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7505
diff changeset
  1317
</ul>
7553
2b93d333dea6 Bug 1271 - stronger type checking in SpectrumPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 7506
diff changeset
  1318
<li> In the SpectrumPhy base class, the methods to get/set the
2b93d333dea6 Bug 1271 - stronger type checking in SpectrumPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 7506
diff changeset
  1319
  MobilityModel and the NetDevice were previously working with
2b93d333dea6 Bug 1271 - stronger type checking in SpectrumPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 7506
diff changeset
  1320
  opaque Ptr&#60;Object&#62;. Now all these methods have been
2b93d333dea6 Bug 1271 - stronger type checking in SpectrumPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 7506
diff changeset
  1321
  changed so that they work with Ptr&#60;NetDevice&#62;
2b93d333dea6 Bug 1271 - stronger type checking in SpectrumPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 7506
diff changeset
  1322
  and Ptr&#60;MobilityModel&#62; as appropriate. See <A href="https://www.nsnam.org/bugzilla/show_bug.cgi?id=1271">Bug 1271</A> on
2b93d333dea6 Bug 1271 - stronger type checking in SpectrumPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 7506
diff changeset
  1323
  bugzilla for the motivation.
2b93d333dea6 Bug 1271 - stronger type checking in SpectrumPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 7506
diff changeset
  1324
</li>
7505
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1325
</ul>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1326
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1327
<h2>Changed behavior:</h2>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1328
<ul>
7655
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1329
<li> TCP bug fixes
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1330
<ul> 
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1331
<li> Connection retries count is a separate variable with the retries limit, so cloned sockets can reset the count
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1332
<li> Fix bug on RTO that may halt the data flow
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1333
<li> Make TCP endpoints always holds the accurate address:port info
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1334
<li> RST packet is sent on closed sockets
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1335
<li> Fix congestion window sizing problem upon partial ACK in TcpNewReno
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1336
<li> Acknowledgement is sent, rather than staying silent, upon arrival of unacceptable packets
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1337
<li> Advance TcpSocketBase::m_nextTxSequence after RTO
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1338
</ul>
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1339
<li> TCP enhancements
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1340
<ul>
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1341
<li> Latest RTT value now stored in variable TcpSocketBase::m_lastRtt
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1342
<li> The list variable TcpL4Protocol::m_sockets now always holds all the created, running TcpSocketBase objects
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1343
<li> Maximum announced window size now an attribute, ns3::TcpSocketBase::MaxWindowSize
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1344
<li> TcpHeader now recognizes ECE and CWR flags (c.f. RFC3168)
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1345
<li> Added TCP option handling call in TcpSocketBase for future extension
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1346
<li> Data out of range (i.e. outsize acceptable range of receive window) now computed on bytes, not packets
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1347
<li> TCP moves from time-wait state to closed state after twice the time specified by attribute ns3:TcpSocketBase::MaxSegLifeTime
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1348
<li> TcpNewReno supports limited transmit (RFC3042) if asserting boolean attribute ns3::TcpNewReno::LimitedTransmit
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1349
<li> Nagle's algorithm supported. Default off, turn on by calling TcpSocket::SetTcpNoDelay(true)
b60c39fc3abf Update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 7643
diff changeset
  1350
</ul>
7505
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1351
</ul>
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1352
99f36c5bce64 Seed the CHANGES.html and RELEASE_NOTES for ns-3.13
Tom Henderson <tomh@tomh.org>
parents: 7459
diff changeset
  1353
<hr>
7322
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1354
<h1>Changes from ns-3.11 to ns-3.12</h1>
7447
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1355
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1356
<h2>Changes to build system:</h2>
7322
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1357
<ul>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1358
</ul>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1359
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1360
<h2>New API:</h2>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1361
<ul>
7447
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1362
<li> New method, RegularWifiMac::SetPromisc (void), to set the interface
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1363
to promiscuous mode.
7322
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1364
</ul>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1365
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1366
<h2>Changes to existing API:</h2>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1367
<ul>
7447
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1368
<li> The spelling of the attribute 'IntialCellVoltage' from LiIonEnergySource 
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1369
was corrected to 'InitialCellVoltage'; this will affect existing users who 
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1370
were using the attribute with the misspelling.
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1371
<li> Two trace sources in class WifiPhy have had their names changed:
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1372
<ul> 
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1373
<li> 'PromiscSnifferRx' is now 'MonitorSnifferRx'
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1374
<li> 'PromiscSnifferTx' is now 'MonitorSnifferTx'
d246960da42f Update CHANGES.html and RELEASE_NOTES
Tom Henderson <tomh@tomh.org>
parents: 7435
diff changeset
  1375
</ul>
7322
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1376
</ul>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1377
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1378
<h2>Changed behavior:</h2>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1379
<ul>
7459
167fc2274f53 update for ns-3.12 release
Tom Henderson <tomh@tomh.org>
parents: 7447
diff changeset
  1380
<li> IPv4 fragmentation is now supported.
7322
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1381
</ul>
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1382
dd3e0eb91512 update CHANGES.html and RELEASE_NOTES for new release cycle
Tom Henderson <tomh@tomh.org>
parents: 7161
diff changeset
  1383
<hr>
6775
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1384
<h1>Changes from ns-3.10 to ns-3.11</h1>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1385
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1386
<h2>Changes to build system:</h2>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1387
<ul>
7024
4392d52b3536 Make examples not be built by default
Mitch Watrous <watrous@u.washington.edu>
parents: 7003
diff changeset
  1388
<li><b>Examples and tests are no longer built by default in ns-3</b>
6999
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1389
<p>
7024
4392d52b3536 Make examples not be built by default
Mitch Watrous <watrous@u.washington.edu>
parents: 7003
diff changeset
  1390
You can now make examples and tests be built in ns-3 in two ways.
6999
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1391
<ol>
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1392
<li> Using build.py when ns-3 is built for the first time:
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1393
<pre>
7024
4392d52b3536 Make examples not be built by default
Mitch Watrous <watrous@u.washington.edu>
parents: 7003
diff changeset
  1394
    ./build.py --enable-examples --enable-tests
6999
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1395
</pre>
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1396
<li> Using waf once ns-3 has been built:
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1397
<pre>
7024
4392d52b3536 Make examples not be built by default
Mitch Watrous <watrous@u.washington.edu>
parents: 7003
diff changeset
  1398
    ./waf configure --enable-examples --enable-tests
6999
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1399
</pre>
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1400
</ol>
dd78264fda2d Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6969
diff changeset
  1401
</p></li>
7003
a0b1500cdaad Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6999
diff changeset
  1402
<li><b> Subsets of modules can be enabled using the ns-3 configuration file</b>
a0b1500cdaad Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6999
diff changeset
  1403
<p>A new configuration file, .ns3rc, has been added to ns-3 that
a0b1500cdaad Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6999
diff changeset
  1404
specifies the modules that should be enabled during the ns-3 build.
a0b1500cdaad Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6999
diff changeset
  1405
See the documentation for details.
a0b1500cdaad Move tests from core module to its test library and update CHANGES.html
Mitch Watrous <watrous@u.washington.edu>
parents: 6999
diff changeset
  1406
</p></li>
6775
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1407
</ul>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1408
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1409
<h2>New API:</h2>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1410
<ul>
7059
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1411
<li><b>int64x64_t</b>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1412
<p>The <b>int64x64_t</b> type implements all the C++ arithmetic operators to behave like one of the
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1413
C++ native types. It is a 64.64 integer type which means that it is a 128bit integer type with
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1414
64 bits of fractional precision. The existing <b>Time</b> type is now automatically convertible to
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1415
<b>int64x64_t</b> to allow arbitrarily complex arithmetic operations on the content of <b>Time</b>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1416
objects. The implementation of <b>int64x64_t</b> is based on the previously-existing
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1417
<b>HighPrecision</b> type and supercedes it.
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1418
</p></li>
6775
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1419
</ul>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1420
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1421
<h2>Changes to existing API:</h2>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1422
<ul>
7143
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1423
<li><b>Wifi TX duration calculation moved from InterferenceHelper to WifiPhy</b>
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1424
<p>The following static methods have been moved from the InterferenceHelper class to the WifiPhy class:
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1425
   <pre>
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1426
static Time CalculateTxDuration (uint32_t size, WifiMode payloadMode, enum WifiPreamble preamble);
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1427
static WifiMode GetPlcpHeaderMode (WifiMode payloadMode, WifiPreamble preamble);
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1428
static uint32_t GetPlcpHeaderDurationMicroSeconds (WifiMode payloadMode, WifiPreamble preamble);
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1429
static uint32_t GetPlcpPreambleDurationMicroSeconds (WifiMode payloadMode, WifiPreamble preamble);
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1430
static uint32_t GetPayloadDurationMicroSeconds (uint32_t size, WifiMode payloadMode);
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1431
</pre>
0146b1916bc0 wifi tx duration calculations moved from InterferenceHelper to WifiPhy
Nicola Baldo <nicola@baldo.biz>
parents: 7059
diff changeset
  1432
</p></li>
6775
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1433
<li><b>Test cases no longer return a boolean value</b>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1434
<p>Unit test case DoRun() functions no longer return a bool value.  Now, they don't return a value at all.  The motivation for this change was to disallow users from merely returning "true" from a test case to force an error to be recorded.  Instead, test case macros should be used.
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1435
</p></li>
6969
1288d191868b PhyMac --> GenericPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 6775
diff changeset
  1436
<li><b>PhyMac renamed to GenericPhy</b>
1288d191868b PhyMac --> GenericPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 6775
diff changeset
  1437
<p>The PhyMac interface previously defined in phy-mac.h has been
1288d191868b PhyMac --> GenericPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 6775
diff changeset
  1438
  renamed to GenericPhy interface and moved to a new file
1288d191868b PhyMac --> GenericPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 6775
diff changeset
  1439
  generic-phy.h. The related variables and methods have been renamed accordingly. 
1288d191868b PhyMac --> GenericPhy
Nicola Baldo <nbaldo@cttc.es>
parents: 6775
diff changeset
  1440
</p></li>
7059
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1441
<li><b>Scalar</b>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1442
<p>The Scalar type has been removed. Typical code such as:
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1443
<pre>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1444
Time tmp = ...;
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1445
Time result = tmp * Scalar (5);
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1446
</pre>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1447
Can now be rewritten as:
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1448
<pre>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1449
Time tmp = ...;
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1450
Time result = Time (tmp * 5);
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1451
</pre>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1452
</p>
b971a123c861 RELEASE_NOTES, CHANGES.html
Mathieu Lacage <mathieu.lacage@inria.fr>
parents: 7024
diff changeset
  1453
</li>
7161
7cc4506fb853 bug 1047: Multicast routes on nodes with >16 interfaces
Ken Renard <kenneth.renard@arl.army.mil>
parents: 7143
diff changeset
  1454
<li><b>Multicast GetOutputTtl() commands</b>
7cc4506fb853 bug 1047: Multicast routes on nodes with >16 interfaces
Ken Renard <kenneth.renard@arl.army.mil>
parents: 7143
diff changeset
  1455
<p> As part of bug 1047 rework to enable multicast routes on nodes with
7cc4506fb853 bug 1047: Multicast routes on nodes with >16 interfaces
Ken Renard <kenneth.renard@arl.army.mil>
parents: 7143
diff changeset
  1456
more than 16 interfaces, the methods Ipv4MulticastRoute::GetOutputTtl () 
7cc4506fb853 bug 1047: Multicast routes on nodes with >16 interfaces
Ken Renard <kenneth.renard@arl.army.mil>
parents: 7143
diff changeset
  1457
and Ipv6MulticastRoute::GetOutputTtl () have been modified to return
7cc4506fb853 bug 1047: Multicast routes on nodes with >16 interfaces
Ken Renard <kenneth.renard@arl.army.mil>
parents: 7143
diff changeset
  1458
a std::map of interface IDs and TTLs for the route.
7cc4506fb853 bug 1047: Multicast routes on nodes with >16 interfaces
Ken Renard <kenneth.renard@arl.army.mil>
parents: 7143
diff changeset
  1459
</p>
7cc4506fb853 bug 1047: Multicast routes on nodes with >16 interfaces
Ken Renard <kenneth.renard@arl.army.mil>
parents: 7143
diff changeset
  1460
</li>
6775
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1461
</ul>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1462
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1463
<h2>Changed behavior:</h2>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1464
<ul>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1465
</ul>
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1466
0783f42a364b Make test cases not return bool valuesMake all TestSuite instances be static
Mitch Watrous <watrous@u.washington.edu>
parents: 6760
diff changeset
  1467
<hr>
6598
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1468
<h1>Changes from ns-3.9 to ns-3.10</h1>
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1469
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1470
<h2>Changes to build system:</h2>
6624
a071889af159 Remove regression tests from waf
Mitch Watrous <watrous@u.washington.edu>
parents: 6598
diff changeset
  1471
<ul>
a071889af159 Remove regression tests from waf
Mitch Watrous <watrous@u.washington.edu>
parents: 6598
diff changeset
  1472
<li><b>Regression tests are no longer run using waf</b>
6652
2d8de9b3be74 clarify the status of ./waf --regression removal
Tom Henderson <tomh@tomh.org>
parents: 6624
diff changeset
  1473
<p>All regression testing is now being done in test.py.  As a result, a 
2d8de9b3be74 clarify the status of ./waf --regression removal
Tom Henderson <tomh@tomh.org>
parents: 6624
diff changeset
  1474
separate reference trace repository is no longer needed to perform 
2d8de9b3be74 clarify the status of ./waf --regression removal
Tom Henderson <tomh@tomh.org>
parents: 6624
diff changeset
  1475
regression tests.  Tests that require comparison against known good traces
2d8de9b3be74 clarify the status of ./waf --regression removal
Tom Henderson <tomh@tomh.org>
parents: 6624
diff changeset
  1476
can still be run from test.py.  The --regression option for waf has been
6760
9e4859305744 update release notes and CHANGES.html file
Tom Henderson <tomh@tomh.org>
parents: 6735
diff changeset
  1477
removed.  However, the "-r" option to download.py has been kept to 
9e4859305744 update release notes and CHANGES.html file
Tom Henderson <tomh@tomh.org>
parents: 6735
diff changeset
  1478
allow users to fetch older revisions of ns-3 that contain these traces.
6624
a071889af159 Remove regression tests from waf
Mitch Watrous <watrous@u.washington.edu>
parents: 6598
diff changeset
  1479
</p>
6760
9e4859305744 update release notes and CHANGES.html file
Tom Henderson <tomh@tomh.org>
parents: 6735
diff changeset
  1480
<li><b>Documentation converted to Sphinx</b>
9e4859305744 update release notes and CHANGES.html file
Tom Henderson <tomh@tomh.org>
parents: 6735
diff changeset
  1481
<p> Project documentation (manual, tutorial, and testing) have been
9e4859305744 update release notes and CHANGES.html file
Tom Henderson <tomh@tomh.org>
parents: 6735
diff changeset
  1482
converted to Sphinx from the GNU Texinfo markup format.</p>
6624
a071889af159 Remove regression tests from waf
Mitch Watrous <watrous@u.washington.edu>
parents: 6598
diff changeset
  1483
</ul>
6598
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1484
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1485
<h2>New API:</h2>
6678
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1486
<ul>
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1487
<li><b>Pyviz visualizer</b>  
6679
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1488
<p>A Python-based visualizer called pyviz is now integrated with ns-3.
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1489
For Python simulations, there is an API to start the visualizer.  You
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1490
have to import the visualizer module, and call visualizer.start()
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1491
instead of ns3.Simulator.Run().  For C++ simulations, there is no API.
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1492
For C++ simulations (but also works for Python ones) you need to set
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1493
the GlobalValue SimulatorImplementationType to
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1494
"ns3::VisualSimulatorImpl".  This can be set from the command-line,
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1495
for example (add the
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1496
<tt>--SimulatorImplementationType=ns3::VisualSimulatorImpl</tt>
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1497
option), or via the waf option <tt>--visualizer</tt>, in addition to
3496cb66848e Update the pyviz API description
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6678
diff changeset
  1498
the usual <tt>--run</tt> option to run programs.
6678
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1499
</p></li>
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1500
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1501
<li><b>WaypointMobility attributes</b>
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1502
<p>Two attributes were added to WaypointMobility model:  LazyNotify and
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1503
InitialPositionIs Waypoint.  See RELEASE_NOTES for details.  </p> </li>
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1504
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1505
<li><b>802.11g rates for ERP-OFDM added</b>
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1506
<p>New WifiModes of the form ErpOfdmRatexxMbps, where xx is the rate
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1507
in Mbps (6, 9, 12, 18, 24, 36, 48, 54), are available for 802.11g.  
6735
8fda47c85df2 update release notes and changes.html
Tom Henderson <tomh@tomh.org>
parents: 6725
diff changeset
  1508
More details are in the RELEASE_NOTES.  </p> </li>
6678
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1509
6689
e2de571e920a Implement Socket::GetSocketType
Josh Pelkey <jpelkey@gatech.edu>
parents: 6679
diff changeset
  1510
<li><b>Socket::GetSocketType ()</b>
e2de571e920a Implement Socket::GetSocketType
Josh Pelkey <jpelkey@gatech.edu>
parents: 6679
diff changeset
  1511
<p>This is analogous to getsockopt(SO_TYPE). ipv4-raw-socket, ipv6-raw-socket,
6692
591fb1aa0ca4 Avoid enum name collision in socket
Josh Pelkey <jpelkey@gatech.edu>
parents: 6690
diff changeset
  1512
  and packet-socket return NS3_SOCK_RAW. tcp-socket and nsc-tcp-socket return
591fb1aa0ca4 Avoid enum name collision in socket
Josh Pelkey <jpelkey@gatech.edu>
parents: 6690
diff changeset
  1513
  NS3_SOCK_STREAM. udp-socket returns NS3_SOCK_DGRAM.</p></li>
6689
e2de571e920a Implement Socket::GetSocketType
Josh Pelkey <jpelkey@gatech.edu>
parents: 6679
diff changeset
  1514
6690
3fab9a03dacd Add BulkSendApplication
Josh Pelkey <jpelkey@gatech.edu>
parents: 6689
diff changeset
  1515
<li><b>BulkSendApplication</b>
3fab9a03dacd Add BulkSendApplication
Josh Pelkey <jpelkey@gatech.edu>
parents: 6689
diff changeset
  1516
<p>Sends data as fast as possible up to MaxBytes or unlimited if MaxBytes is 
3fab9a03dacd Add BulkSendApplication
Josh Pelkey <jpelkey@gatech.edu>
parents: 6689
diff changeset
  1517
zero.  Think OnOff, but without the "off" and without the variable data rate. 
6692
591fb1aa0ca4 Avoid enum name collision in socket
Josh Pelkey <jpelkey@gatech.edu>
parents: 6690
diff changeset
  1518
This application only works with NS3_SOCK_STREAM and NS3_SOCK_SEQPACKET sockets, 
6690
3fab9a03dacd Add BulkSendApplication
Josh Pelkey <jpelkey@gatech.edu>
parents: 6689
diff changeset
  1519
for example TCP sockets and not UDP sockets. A helper class exists to 
3fab9a03dacd Add BulkSendApplication
Josh Pelkey <jpelkey@gatech.edu>
parents: 6689
diff changeset
  1520
facilitate creating BulkSendApplications. The API for the helper class 
3fab9a03dacd Add BulkSendApplication
Josh Pelkey <jpelkey@gatech.edu>
parents: 6689
diff changeset
  1521
is similar to existing application helper classes, for example, OnOff.
6699
d8909a1fd0ff RV battery model and WiFi energy example
He Wu <mdzz@u.washington.edu>
parents: 6692
diff changeset
  1522
</p></li>
d8909a1fd0ff RV battery model and WiFi energy example
He Wu <mdzz@u.washington.edu>
parents: 6692
diff changeset
  1523
d8909a1fd0ff RV battery model and WiFi energy example
He Wu <mdzz@u.washington.edu>
parents: 6692
diff changeset
  1524
<li><b>Rakhmatov Vrudhula non-linear battery model</b>
d8909a1fd0ff RV battery model and WiFi energy example
He Wu <mdzz@u.washington.edu>
parents: 6692
diff changeset
  1525
<p>New class and helper for this battery model. </p></li>
6690
3fab9a03dacd Add BulkSendApplication
Josh Pelkey <jpelkey@gatech.edu>
parents: 6689
diff changeset
  1526
6703
1204fcdb71c2 Update release notes
Tom Henderson <tomh@tomh.org>
parents: 6699
diff changeset
  1527
<li><b>Print IPv4 routing tables</b>
1204fcdb71c2 Update release notes
Tom Henderson <tomh@tomh.org>
parents: 6699
diff changeset
  1528
<p>New class methods and helpers for printing IPv4 routing tables
1204fcdb71c2 Update release notes
Tom Henderson <tomh@tomh.org>
parents: 6699
diff changeset
  1529
to an output stream. </p></li>
1204fcdb71c2 Update release notes
Tom Henderson <tomh@tomh.org>
parents: 6699
diff changeset
  1530
6717
e041eb593928 DSDV routing protocol
Hemanth Narra <hemanth@ittc.ku.edu>
parents: 6703
diff changeset
  1531
<li><b>Destination-Sequenced Distance Vector (DSDV) routing protocol</b>
e041eb593928 DSDV routing protocol
Hemanth Narra <hemanth@ittc.ku.edu>
parents: 6703
diff changeset
  1532
<p>Derives from Ipv4RoutingProtocol and contains a DsdvHelper class. </p></li>
e041eb593928 DSDV routing protocol
Hemanth Narra <hemanth@ittc.ku.edu>
parents: 6703
diff changeset
  1533
6735
8fda47c85df2 update release notes and changes.html
Tom Henderson <tomh@tomh.org>
parents: 6725
diff changeset
  1534
<li><b>3GPP Long Term Evolution (LTE) models</b>
8fda47c85df2 update release notes and changes.html
Tom Henderson <tomh@tomh.org>
parents: 6725
diff changeset
  1535
<p>More details are in the RELEASE_NOTES. </p></li>
8fda47c85df2 update release notes and changes.html
Tom Henderson <tomh@tomh.org>
parents: 6725
diff changeset
  1536
6678
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1537
</ul>
6598
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1538
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1539
<h2>Changes to existing API:</h2>
6673
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1540
<ul>
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1541
<li><b>Consolidation of Wi-Fi MAC high functionality</b>
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1542
<p>Wi-Fi MAC high classes have been reorganised in attempt to
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1543
consolidate shared functionality into a single class. This new class
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1544
is RegularWifiMac, and it derives from the abstract WifiMac, and is
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1545
parent of AdhocWifiMac, StaWifiMac, ApWifiMac, and
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1546
MeshWifiInterfaceMac. The QoS and non-QoS class variants are no
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1547
longer, with a RegularWifiMac attribute "QosSupported" allowing
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1548
selection between these two modes of operation. QosWifiMacHelper and
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1549
NqosWifiMacHelper continue to work as previously, with a
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1550
behind-the-scenes manipulation of the 'afore-mentioned attribute.
6725
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1551
</p></li>
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1552
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1553
<li><b>New TCP architecture</b>
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1554
<p>TcpSocketImpl was replaced by a new base class TcpSocketBase and
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1555
several subclasses implementing different congestion control.  From 
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1556
a user-level API perspective, the main change is that a new attribute
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1557
"SocketType" is available in TcpL4Protocol, to which a TypeIdValue
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1558
of a specific Tcp variant can be passed.  In the same class, the attribute 
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1559
"RttEstimatorFactory" was also renamed "RttEstimatorType" since it now
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1560
takes a TypeIdValue instead of an ObjectFactoryValue.  In most cases, 
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1561
however, no change to existing user programs should be needed.
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1562
</p></li>
6673
ec22aa763e2d Bug 978: Consolidate Wi-Fi MAC high functionality
Dean Armstrong <deanarm@gmail.com>
parents: 6662
diff changeset
  1563
</ul>
6598
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1564
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1565
<h2>Changed behavior:</h2>
6662
04fb02cefe2a bug 984: change EmuNetDevice encapsulation default to DIX
Tom Henderson <tomh@tomh.org>
parents: 6652
diff changeset
  1566
<ul>
04fb02cefe2a bug 984: change EmuNetDevice encapsulation default to DIX
Tom Henderson <tomh@tomh.org>
parents: 6652
diff changeset
  1567
<li><b>EmuNetDevice uses DIX instead of LLC encapsulation by default</b>
04fb02cefe2a bug 984: change EmuNetDevice encapsulation default to DIX
Tom Henderson <tomh@tomh.org>
parents: 6652
diff changeset
  1568
<p>bug 984 in ns-3 tracker:  real devices don't usually understand LLC/SNAP
04fb02cefe2a bug 984: change EmuNetDevice encapsulation default to DIX
Tom Henderson <tomh@tomh.org>
parents: 6652
diff changeset
  1569
so the default of DIX makes more sense.
6725
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1570
</p></li>
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1571
<li><b>TCP defaults to NewReno congestion control</b>
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1572
<p>As part of the TCP socket refactoring, a new TCP implementation provides
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1573
slightly different behavior than the previous TcpSocketImpl that provided
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1574
only fast retransmit.  The default behavior now is NewReno which provides
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1575
fast retransmit and fast recovery with window inflation during recovery.
62511407485d Update release notes and changelog
Tom Henderson <tomh@tomh.org>
parents: 6717
diff changeset
  1576
</p></li>
6662
04fb02cefe2a bug 984: change EmuNetDevice encapsulation default to DIX
Tom Henderson <tomh@tomh.org>
parents: 6652
diff changeset
  1577
</ul>
6598
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1578
7459bc9f1a3b Start tracking ns-3.10 changes
Tom Henderson <tomh@tomh.org>
parents: 6557
diff changeset
  1579
<hr>
6300
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1580
<h1>Changes from ns-3.8 to ns-3.9</h1>
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1581
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1582
<h2>Changes to build system:</h2>
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1583
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1584
<h2>New API:</h2>
6306
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1585
<ul>
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1586
<li><b>Wifi set block ack threshold:</b> Two methods for setting block ack
6306
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1587
parameters for a specific access class: 
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1588
<pre>
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1589
void QosWifiMacHelper::SetBlockAckThresholdForAc (enum AccessClass accessClass, uint8_t threshold);
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1590
void QosWifiMacHelper::SetBlockAckInactivityTimeoutForAc (enum AccessClass accessClass, uint16_t timeout);
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1591
</pre>
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1592
</li>
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1593
<li><b>Receive List Error Model:</b>  Another basic error model that allows
6306
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1594
the user to specify a list of received packets that should be errored.  The
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1595
list corresponds not to the packet UID but to the sequence of received
283c83f1f7be Update RELEASE_NOTES and CHANGES.html since ns-3.8
Tom Henderson <tomh@tomh.org>
parents: 6300
diff changeset
  1596
packets as observed by the error model.   See src/common/error-model.h
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1597
</li>
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1598
<li><b>Respond to interface events:</b> New attribute for Ipv4GlobalRouting,
6317
e4a750adf12c bug 702: make global routing robust to link/device events
Tom Henderson <tomh@tomh.org>
parents: 6308
diff changeset
  1599
"RespondToInterfaceEvents", which when enabled, will cause global routes
e4a750adf12c bug 702: make global routing robust to link/device events
Tom Henderson <tomh@tomh.org>
parents: 6308
diff changeset
  1600
to be recomputed upon any interface or address notification event from IPv4.
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1601
</li>
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1602
<li><b>Generic sequence number:</b> New generic sequence number class to 
6529
dd982eaf6026 release notes and changes updates
Josh Pelkey <jpelkey@gatech.edu>
parents: 6459
diff changeset
  1603
easily handle comparison, subtraction, etc. for sequence numbers.  
dd982eaf6026 release notes and changes updates
Josh Pelkey <jpelkey@gatech.edu>
parents: 6459
diff changeset
  1604
To use it you need to supply two fundamental types as template parameters: 
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1605
NUMERIC_TYPE and SIGNED_TYPE.  For instance, <tt>SequenceNumber&lt;uint32_t, int32_t&gt;</tt> 
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1606
gives you a 32-bit sequence number, while <tt>SequenceNumber&lt;uint16_t, int16_t&gt;</tt> 
6529
dd982eaf6026 release notes and changes updates
Josh Pelkey <jpelkey@gatech.edu>
parents: 6459
diff changeset
  1607
is a 16-bit one.  For your convenience, these are typedef'ed as 
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1608
<tt>SequenceNumber32</tt> and <tt>SequenceNumber16</tt>, respectively.
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1609
</li>
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1610
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1611
<li><b>Broadcast socket option:</b> New Socket
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1612
methods <tt>SetAllowBroadcast</tt> and <tt>GetAllowBroadcast</tt> add
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1613
to NS-3 <tt>Socket</tt>'s the equivalent to the POSIX SO_BROADCAST
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1614
socket option (setsockopt/getsockopt).  Starting from this NS-3
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1615
version, IPv4 sockets do not allow us to send packets to broadcast
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1616
destinations by default; SetAllowBroadcast must be called beforehand
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1617
if we wish to send broadcast packets.
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1618
</li>
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1619
6557
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1620
<li><b>Deliver of packet ancillary information to sockets:</b> A method to deliver ancillary information 
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1621
to the socket interface (fixed in bug 671):  <pre>void Socket::SetRecvPktInfo (bool flag);</pre>
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1622
6529
dd982eaf6026 release notes and changes updates
Josh Pelkey <jpelkey@gatech.edu>
parents: 6459
diff changeset
  1623
</ul>
6300
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1624
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1625
<h2>Changes to existing API:</h2>
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1626
6360
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1627
<ul>
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1628
<li><b>Changes to construction and naming of Wi-Fi transmit rates:</b>
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1629
A reorganisation of the construction of Wi-Fi transmit rates has been
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1630
undertaken with the aim of simplifying the task of supporting further
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1631
IEEE 802.11 PHYs. This work has been completed under the auspices of
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1632
Bug 871.
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1633
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1634
From the viewpoint of simulation scripts not part of the ns-3
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1635
distribution, the key change is that WifiMode names of the form
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1636
wifi<em>x</em>-<em>n</em>mbs are now invalid. Names now take the
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1637
form <em>Cccc</em>Rate<em>n</em>Mbps[BW<em>b</em>MHz],
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1638
where <em>n</em> is the root bitrate in megabits-per-second as before
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1639
(with only significant figures included, and an underscore replacing
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1640
any decimal point), and <em>Cccc</em> is a representation of the
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1641
Modulation Class as defined in Table 9-2 of IEEE
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1642
Std. 802.11-2007. Currently-supported options for <em>Cccc</em>
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1643
are <em>Ofdm</em> and <em>Dsss</em>. For modulation classes where
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1644
optional reduced-bandwidth transmission is possible, this is captured
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1645
in the final part of the form above, with <em>b</em> specifying the
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1646
nominal signal bandwidth in megahertz. </li>
6383
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1647
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1648
<li><b>Consolidation of classes support Wi-Fi Information Elements:</b>
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1649
When the <em>mesh</em> module was introduced it added a class
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1650
hierarchy for modelling of the various Information Elements that were
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1651
required. In this release, this class hierarchy has extended by moving
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1652
the base classes (WifiInformationElement and
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1653
WifiInformationElementVector) into the <em>wifi</em> module. This
4dc3cdb53559 Bug 881: Update RELEASE_NOTES and CHANGES.html
Dean Armstrong <deanarm@gmail.com>
parents: 6360
diff changeset
  1654
change is intended to ease the addition of support for modelling of
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1655
further Wi-Fi functionality. </li>
6557
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1656
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1657
<li><b>Changed for {Ipv4,Ipv6}PacketInfoTag delivery:</b> In order to
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1658
deliver ancillary information to the socket interface (fixed in bug 671),
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1659
<em>Ipv4PacketInfoTag</em> and <em>Ipv6PacketInfoTag</em> are implemented. 
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1660
For the delivery of this information, the following changes are made into 
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1661
existing class.
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1662
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1663
In Ipv4EndPoint class,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1664
<pre>
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1665
-  void SetRxCallback (Callback&lt;void,Ptr&lt;Packet&gt;, Ipv4Address, Ipv4Address, uint16_t&gt; callback);
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1666
+  void SetRxCallback (Callback&lt;void,Ptr&lt;Packet&gt;, Ipv4Header, uint16_t, Ptr&lt;Ipv4Interface&gt; &gt; callback);
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1667
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1668
-  void ForwardUp (Ptr&lt;Packet&gt; p, Ipv4Address saddr, Ipv4Address daddr, uint16_t sport);
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1669
+  void ForwardUp (Ptr&lt;Packet&gt; p, const Ipv4Header& header, uint16_t sport, 
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1670
+                  Ptr&lt;Ipv4Interface&gt; incomingInterface);
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1671
</pre>
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1672
In Ipv4L4Protocol class,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1673
<pre>
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1674
   virtual enum RxStatus Receive(Ptr&lt;Packet&gt; p, 
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1675
-                                Ipv4Address const &source,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1676
-                                Ipv4Address const &destination,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1677
+                                Ipv4Header const &header,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1678
                                 Ptr&lt;Ipv4Interface&gt; incomingInterface) = 0;
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1679
</pre>
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1680
<pre>
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1681
-Ipv4RawSocketImpl::ForwardUp (Ptr&lt;const Packet&gt; p, Ipv4Header ipHeader, Ptr&lt;NetDevice&gt; device)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1682
+Ipv4RawSocketImpl::ForwardUp (Ptr&lt;const Packet&gt; p, Ipv4Header ipHeader, Ptr&lt;Ipv4Interface&gt; incomingInterface)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1683
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1684
-NscTcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t port)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1685
+NscTcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Header header, uint16_t port,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1686
+                             Ptr&lt;Ipv4Interface&gt; incomingInterface)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1687
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1688
-TcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t port)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1689
+TcpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Header header, uint16_t port,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1690
+                          Ptr&lt;Ipv4Interface&gt; incomingInterface)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1691
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1692
-UdpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Address saddr, Ipv4Address daddr, uint16_t port)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1693
+UdpSocketImpl::ForwardUp (Ptr&lt;Packet&gt; packet, Ipv4Header header, uint16_t port,
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1694
+                          Ptr&lt;Ipv4Interface&gt; incomingInterface)
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1695
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1696
</pre>
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1697
  
970e1627b308 update CHANGES.html for Bug 671
Hajime Tazaki <tazaki@sfc.wide.ad.jp>
parents: 6540
diff changeset
  1698
</li>
6678
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1699
<li>The method OutputStreamWrapper::SetStream (std::ostream *ostream) was removed.</li>
be3da7f1f82a Bring CHANGES.html and RELEASE_NOTES up to date
Tom Henderson <tomh@tomh.org>
parents: 6673
diff changeset
  1700
)
6360
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1701
</ul>
d8975477ff6a Bug 871: Rework construction of Wi-Fi rates
Dean Armstrong <deanarm@gmail.com>
parents: 6317
diff changeset
  1702
6300
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1703
<h2>Changed behavior:</h2>
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1704
<ul>
6308
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1705
<li><b>Queue trace behavior during Enqueue changed:</b> The behavior of the
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1706
Enqueue trace source has been changed to be more intuitive and to agree with
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1707
documentation.  Enqueue and Drop events in src/node/queue.cc are now mutually
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1708
exclusive.  In the past, the meaning of an Enqueue event was that the Queue
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1709
Enqueue operation was being attempted; and this could be followed by a Drop
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1710
event if the Queue was full.  The new behavior is such that a packet is either
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1711
Enqueue'd successfully or Drop'ped.
2ca5ef07be74 update CHANGES.html for Queue::Enqueue trace behavior change
Craig Dowell <craigdo@ee.washington.edu>
parents: 6306
diff changeset
  1712
6300
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1713
<li><b>Drop trace logged for Ipv4/6 forwarding failure:</b> Fixed bug 861; this 
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1714
will add ascii traces (drops) in Ipv4 and Ipv6 traces for forwarding failures
6459
d5cfe99001f0 Change default OFDM error rate model to NistErrorRateModel (issue 944)
Tom Henderson <tomh@tomh.org>
parents: 6383
diff changeset
  1715
d5cfe99001f0 Change default OFDM error rate model to NistErrorRateModel (issue 944)
Tom Henderson <tomh@tomh.org>
parents: 6383
diff changeset
  1716
<li><b>Changed default WiFi error rate model for OFDM modulation types:</b> 
d5cfe99001f0 Change default OFDM error rate model to NistErrorRateModel (issue 944)
Tom Henderson <tomh@tomh.org>
parents: 6383
diff changeset
  1717
Adopted more conservative ErrorRateModel for OFDM modulation types (a/g).
d5cfe99001f0 Change default OFDM error rate model to NistErrorRateModel (issue 944)
Tom Henderson <tomh@tomh.org>
parents: 6383
diff changeset
  1718
This will require 4 to 5 more dB of received power to get similar results
d5cfe99001f0 Change default OFDM error rate model to NistErrorRateModel (issue 944)
Tom Henderson <tomh@tomh.org>
parents: 6383
diff changeset
  1719
as before, so users may observe a reduced WiFi range when using the defaults.
6540
d2768932d6c3 Add SO_BROADCAST to CHANGES.html, fix the html a bit
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents: 6529
diff changeset
  1720
See tracker issue 944 for more details.
6300
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1721
</ul>
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1722
bd1da3a75496 bug 861: Log drop traces for forwarding failures into IPv4 and IPv6 ascii traces
Tom Henderson <tomh@tomh.org>
parents: 6273
diff changeset
  1723
<hr>
5933
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1724
<h1>Changes from ns-3.7 to ns-3.8</h1>
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1725
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1726
<h2>Changes to build system:</h2>
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1727
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1728
<h2>New API:</h2>
6113
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1729
6111
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1730
<ul>
6117
bf5e05fe051b Changes and release notes updated
Pavel Boyko <boyko@iitp.ru>
parents: 6113
diff changeset
  1731
<li><b>Matrix propagation loss model:</b> This radio propagation model uses a two-dimensional matrix
6165
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1732
of path loss indexed by source and destination nodes.
6117
bf5e05fe051b Changes and release notes updated
Pavel Boyko <boyko@iitp.ru>
parents: 6113
diff changeset
  1733
6111
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1734
<li><b>WiMAX net device</b>: The developed WiMAX model attempts to provide an accurate MAC and
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1735
PHY level implementation of the 802.16 specification with the Point-to-Multipoint (PMP) mode and the WirelessMAN-OFDM 
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1736
PHY layer. By adding WimaxNetDevice objects to ns-3 nodes, one can create models of
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1737
802.16-based networks. The source code for the WiMAX models lives in the directory src/devices/wimax.
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1738
The model is mainly composed of three layers:
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1739
<ul>
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1740
<li>The convergence sublayer (CS)
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1741
<li>The MAC Common Part Sublayer (MAC-CPS)
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1742
<li>The Physical layer
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1743
</ul>
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1744
The main way that users who write simulation scripts will typically
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1745
interact with the Wimax models is through the helper API and through
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1746
the publicly visible attributes of the model.
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1747
The helper API is defined in src/helper/wimax-helper.{cc,h}.
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1748
Three examples containing some code that shows how to setup a 802.16 network are located under examples/wimax/ 
6113
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1749
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1750
<li><b>MPI Interface for distributed simulation:</b> Enables access
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1751
to necessary MPI information such as MPI rank and size.
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1752
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1753
<li><b>Point-to-point remote channel:</b> Enables point-to-point 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1754
connection between net-devices on different simulators, for use 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1755
with distributed simulation.
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1756
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1757
<li><b>GetSystemId in simulator:</b> For use with distributed 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1758
simulation, GetSystemId returns zero by non-distributed 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1759
simulators.  For the distributed simulator, it returns the 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1760
MPI rank.
6165
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1761
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1762
<li><b>Enhancements to src/core/random-variable.cc/h:</b> New Zeta random variable generator. The Zeta random 
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1763
distribution is tightly related to the Zipf distribution (already in ns-3.7). See the documentation, 
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1764
especially because sometimes the Zeta distribution is called Zipf and viceversa. Here we conform to the 
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1765
Wikipedia naming convention, i.e., Zipf is bounded while Zeta isn't. 
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1766
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1767
<li><b>Two-ray ground propagation loss model:</b> Calculates the crossover distance under which Friis is used. The antenna 
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1768
height is set to the nodes z coordinate, but can be added to using the model parameter SetHeightAboveZ, which 
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1769
will affect ALL stations
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1770
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1771
<li><b>Pareto random variable</b> has two new constructors to specify scale and shape:
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1772
<pre>
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1773
ParetoVariable (std::pair<double, double> params);
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1774
ParetoVariable (std::pair<double, double> params, double b);
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1775
</pre>
6111
0b22ae082153 Merge WiMAX module
Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
parents: 6054
diff changeset
  1776
</ul>
6113
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1777
5933
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1778
<h2>Changes to existing API:</h2>
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1779
<ul>
6018
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1780
<li><b>Tracing Helpers</b>: The organization of helpers for both pcap and ascii
6032
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1781
tracing, in devices and protocols, has been reworked.  Instead of each device 
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1782
and protocol helper re-implementing trace enable methods, classes have been 
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1783
developed to implement user-level tracing in a consistent way; and device and 
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1784
protocol helpers use those classes to provide tracing functionality.<br>
6018
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1785
In addition to consistent operation across all helpers, the object name service
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1786
has been integrated into the trace file naming scheme.<br>
6032
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1787
The internet stack helper has been extensively massaged to make it easier to 
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1788
manage traces originating from protocols.  It used to be the case that there 
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1789
was essentially no opportunity to filter tracing on interfaces, and resulting
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1790
trace file names collided with those created by devices.  File names are now
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1791
disambiguated and one can enable traces on a protocol/interface basis analogously
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1792
to the node/device granularity of device-based helpers.<br>
6018
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1793
The primary user-visible results of this change are that trace-related functions
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1794
have been changed from static functions to method calls; and a new object has
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1795
been developed to hold streams for ascii traces.<br>
6032
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1796
New functionality is present for ascii traces.  It is now possible to create
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1797
multiple ascii trace files automatically just as was possible for pcap trace 
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1798
files.<br>
6018
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1799
The implementation of the helper code has been designed also to provide 
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1800
functionality to make it easier for sophisticated users to hook traces of 
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1801
various kinds and write results to (file) streams.
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1802
Before:
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1803
<pre>
6032
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1804
  CsmaHelper::EnablePcapAll ();
5933
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1805
6032
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1806
  std::ofstream ascii;
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1807
  ascii.open ("csma-one-subnet.tr", std::ios_base::binary | std::ios_base::out);
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1808
  CsmaHelper::EnableAsciiAll (ascii);
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1809
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1810
  InternetStackHelper::EnableAsciiAll (ascii);
6018
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1811
</pre>
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1812
After:
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1813
<pre>
6032
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1814
  CsmaHelper csmaHelper;
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1815
  InternetStackHelper stack;
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1816
  csmaHelper.EnablePcapAll ();
6018
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1817
6032
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1818
  AsciiTraceHelper ascii;
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1819
  csma.EnableAsciiAll (ascii.CreateFileStream ("csma-one-subnet.tr"));
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1820
a31949e0f1ed update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 6018
diff changeset
  1821
  stack.EnableAsciiIpv4All (stream);
6018
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1822
</pre>
92c388406dbe update CHANGES ns-3.7 to ns-3.8
Craig Dowell <craigdo@ee.washington.edu>
parents: 5868
diff changeset
  1823
5933
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1824
6113
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1825
<li><b>Serialization and Deserialization</b> in buffer, nix-vector, 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1826
packet-metadata, and packet has been modified to use raw character 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1827
buffers, rather than the Buffer class
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1828
<pre>
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1829
+ uint32_t Buffer::GetSerializedSize (void) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1830
+ uint32_t Buffer::Serialize (uint8_t* buffer, uint32_t maxSize) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1831
+ uint32_t Buffer::Deserialize (uint8_t* buffer, uint32_t size); 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1832
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1833
- void NixVector::Serialize (Buffer::Iterator i, uint32_t size) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1834
+ uint32_t NixVector::Serialize (uint32_t* buffer, uint32_t maxSize) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1835
- uint32_t NixVector::Deserialize (Buffer::Iterator i);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1836
+ uint32_t NixVector::Deserialize (uint32_t* buffer, uint32_t size);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1837
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1838
- void PacketMetadata::Serialize (Buffer::Iterator i, uint32_t size) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1839
+ uint32_t PacketMetadata::Serialize (uint8_t* buffer, uint32_t maxSize) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1840
- uint32_t PacketMetadata::Deserialize (Buffer::Iterator i);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1841
+ uint32_t PacketMetadata::Deserialize (uint8_t* buffer, uint32_t size);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1842
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1843
+ uint32_t Packet::GetSerializedSize (void) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1844
- Buffer Packet::Serialize (void) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1845
+ uint32_t Packet::Serialize (uint8_t* buffer, uint32_t maxSize) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1846
- void Packet::Deserialize (Buffer buffer);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1847
+ Packet::Packet (uint8_t const*buffer, uint32_t size, bool magic);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1848
</pre>
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1849
<li><b>PacketMetadata uid</b> has been changed to a 64-bit value. The 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1850
lower 32 bits give the uid, while the upper 32-bits give the MPI rank 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1851
for distributed simulations. For non-distributed simulations, the 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1852
upper 32 bits are simply zero.
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1853
<pre>
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1854
- inline PacketMetadata (uint32_t uid, uint32_t size);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1855
+ inline PacketMetadata (uint64_t uid, uint32_t size);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1856
- uint32_t GetUid (void) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1857
+ uint64_t GetUid (void) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1858
- PacketMetadata::PacketMetadata (uint32_t uid, uint32_t size);
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1859
+ PacketMetadata::PacketMetadata (uint64_t uid, uint32_t size); 
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1860
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1861
- uint32_t Packet::GetUid (void) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1862
+ uint64_t Packet::GetUid (void) const;
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1863
</pre>
6165
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1864
55762ca33a99 update CHANGES and RELEASE_NOTES
Josh Pelkey <jpelkey@gatech.edu>
parents: 6117
diff changeset
  1865
<li><b>Moved propagation models</b> from src/devices/wifi to src/common
6184
3bb39c179947 update CHANGES.html for Mtu move
Tom Henderson <tomh@tomh.org>
parents: 6165
diff changeset
  1866
3bb39c179947 update CHANGES.html for Mtu move
Tom Henderson <tomh@tomh.org>
parents: 6165
diff changeset
  1867
<li><b>Moved Mtu attribute from base class NetDevice</b> This attribute is
3bb39c179947 update CHANGES.html for Mtu move
Tom Henderson <tomh@tomh.org>
parents: 6165
diff changeset
  1868
now found in all NetDevice subclasses.  
6113
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1869
</ul>
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1870
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1871
<h2>Changed behavior:</h2>
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1872
<ul>
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1873
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1874
</ul>
0ce37bf4f1c1 Merge distributed simulation code
Josh Pelkey <jpelkey@gatech.edu>
parents: 6111
diff changeset
  1875
5933
2fc170de5400 Update release notes and changes for ns-3.8
Josh Pelkey <jpelkey@gatech.edu>
parents: 5868
diff changeset
  1876
<hr>
5497
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1877
<h1>Changes from ns-3.6 to ns-3.7</h1>
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1878
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1879
5497
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1880
<h2>Changes to build system:</h2>
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1881
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1882
<h2>New API:</h2>
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1883
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1884
<ul>
5858
afb51c7f34c2 bug 667: Add equal-cost multipath routing (ECMP) to IPv4 global routing
Wilson Thong <wilsonwk@ee.cityu.edu.hk>
parents: 5856
diff changeset
  1885
<li><b>Equal-cost multipath for global routing:</b> Enables quagga's
afb51c7f34c2 bug 667: Add equal-cost multipath routing (ECMP) to IPv4 global routing
Wilson Thong <wilsonwk@ee.cityu.edu.hk>
parents: 5856
diff changeset
  1886
equal cost multipath for Ipv4GlobalRouting, and adds an attribute that
afb51c7f34c2 bug 667: Add equal-cost multipath routing (ECMP) to IPv4 global routing
Wilson Thong <wilsonwk@ee.cityu.edu.hk>
parents: 5856
diff changeset
  1887
can enable it with random packet distribution policy across equal cost routes.
5856
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1888
<li><b>Binding sockets to devices:</b> A method analogous to a SO_BINDTODEVICE
5868
ed1e2ad4c0b9 Fix angle braces in CHANGES.html.
Andrey Mazo <mazo@iitp.ru>
parents: 5858
diff changeset
  1889
socket option has been introduced to class Socket:  <pre>virtual void Socket::BindToNetDevice (Ptr&lt;NetDevice&gt; netdevice);</pre>
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1890
<li><b>Simulator event contexts</b>: The Simulator API now keeps track of a per-event
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1891
'context' (a 32bit integer which, by convention identifies a node by its id). Simulator::GetContext
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1892
returns the context of the currently-executing event while Simulator::ScheduleWithContext creates an
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1893
event with a context different from the execution context of the caller. This API is used
5814
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1894
by the ns-3 logging system to report the execution context of each log line.
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1895
<li><b>Object::DoStart</b>: Users who need to complete their object setup at the start of a simulation
5814
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1896
can override this virtual method, perform their adhoc setup, and then, must chain up to their parent.
5990
20ee319e7e71 a couple of typos.
Andrey Mazo <mazo@iitp.ru>
parents: 5933
diff changeset
  1897
<li><b>Ad hoc On-Demand Distance Vector (AODV)</b> routing model, 
5742
19c79550b371 CHANGES.html, AUTHORS and RELEASE_NOTES updated after AODV merge
Pavel Boyko <boyko@iitp.ru>
parents: 5532
diff changeset
  1898
<a href=http://www.ietf.org/rfc/rfc3561.txt>RFC 3561</a> </li>
5814
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1899
<li><b>Ipv4::IsDestinationAddress (Ipv4Address address, uint32_t iif)</b> Method added to support checks of whether a destination address should be accepted 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1900
as one of the host's own addresses.  RFC 1122 Strong/Weak end system behavior can be changed with a new attribute (WeakEsModel) in class Ipv4.  </li>
5742
19c79550b371 CHANGES.html, AUTHORS and RELEASE_NOTES updated after AODV merge
Pavel Boyko <boyko@iitp.ru>
parents: 5532
diff changeset
  1901
5814
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1902
<li><b>Net-anim interface</b>: Provides an interface to net-anim, a network animator for point-to-point 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1903
links in ns-3.  The interface generates a custom trace file for use with the NetAnim program.</li>
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1904
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1905
<li><b>Topology Helpers</b>: New topology helpers have been introduced including PointToPointStarHelper, 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1906
PointToPointDumbbellHelper, PointToPointGridHelper, and CsmaStarHelper.</li>
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1907
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1908
<li><b>IPv6 extensions support</b>: Provides API to add IPv6 extensions and options. Two examples (fragmentation
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1909
and loose routing) are available.</li>
5497
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1910
</ul>
d8b1b591839b Document changes to YansWifiPhy defaults
Tom Henderson <tomh@tomh.org>
parents: 5407
diff changeset
  1911
5507
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1912
<h2>Changes to existing API:</h2>
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1913
<ul>
5856
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1914
<li><b>Ipv4RoutingProtocol::RouteOutput</b> no longer takes an outgoing 
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1915
interface index but instead takes an outgoing device pointer; this affects all
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1916
subclasses of Ipv4RoutingProtocol.
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1917
<pre>
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1918
-  virtual Ptr&lt;Ipv4Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv4Header &header, uint32_t oif, Socket::SocketErrno &sockerr) = 0;
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1919
+  virtual Ptr&lt;Ipv4Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv4Header &header, Ptr&lt;NetDevice&gt; oif, Socket::SocketErrno &sockerr) = 0;
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1920
</pre>
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1921
<li><b>Ipv6RoutingProtocol::RouteOutput</b> no longer takes an outgoing 
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1922
interface index but instead takes an outgoing device pointer; this affects all
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1923
subclasses of Ipv6RoutingProtocol.
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1924
<pre>
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1925
-  virtual Ptr&lt;Ipv6Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv6Header &header, uint32_t oif, Socket::SocketErrno &sockerr) = 0;
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1926
+  virtual Ptr&lt;Ipv6Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv6Header &header, Ptr&lt;NetDevice&gt; oif, Socket::SocketErrno &sockerr) = 0;
7fd20c798a7d bug 742: Implementation of SO_BINDTODEVICE
Antti Mäkelä <zarhan@cc.hut.fi>
parents: 5817
diff changeset
  1927
</pre>
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1928
<li><b>Application::Start</b> and <b>Application::Stop</b> have been renamed to
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1929
<b>Application::SetStartTime</b> and <b>Application::SetStopTime</b>.
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1930
<li><b>Channel::Send</b>: this method does not really exist but each subclass of the Channel
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1931
base class must implement a similar method which sends a packet from a node to another node.
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1932
Users must now use Simulator::ScheduleWithContext instead of Simulator::Schedule to schedule
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1933
the reception event on a remote node.<br>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1934
For example, before:
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1935
<pre>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1936
void
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1937
SimpleChannel::Send (Ptr&lt;Packet&gt; p, uint16_t protocol, 
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1938
         Mac48Address to, Mac48Address from,
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1939
         Ptr&lt;SimpleNetDevice&gt; sender)
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1940
{
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1941
  for (std::vector&lt;Ptr&lt;SimpleNetDevice&gt; &gt;::const_iterator i = m_devices.begin (); i != m_devices.end (); ++i)
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1942
    {
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1943
      Ptr&lt;SimpleNetDevice&gt; tmp = *i;
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1944
      if (tmp == sender)
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1945
  {
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1946
    continue;
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1947
  }
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1948
      Simulator::ScheduleNow (&SimpleNetDevice::Receive, tmp, p->Copy (), protocol, to, from);
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1949
    }
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1950
}
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1951
</pre>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1952
After:
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1953
<pre>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1954
void
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1955
SimpleChannel::Send (Ptr&lt;Packet&gt; p, uint16_t protocol, 
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1956
         Mac48Address to, Mac48Address from,
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1957
         Ptr&lt;SimpleNetDevice&gt; sender)
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1958
{
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1959
  for (std::vector&lt;Ptr&lt;SimpleNetDevice&gt; &gt;::const_iterator i = m_devices.begin (); i != m_devices.end (); ++i)
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1960
    {
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1961
      Ptr&lt;SimpleNetDevice&gt; tmp = *i;
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1962
      if (tmp == sender)
9751
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1963
  {
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1964
    continue;
2d9e9b0ae1b8 improve formatting
Tom Henderson <tomh@tomh.org>
parents: 9748
diff changeset
  1965
  }
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1966
      Simulator::ScheduleWithContext (tmp->GetNode ()->GetId (), Seconds (0),
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1967
                                      &SimpleNetDevice::Receive, tmp, p->Copy (), protocol, to, from);
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1968
    }
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1969
}
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1970
</pre>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  1971
5507
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1972
<li><b>Simulator::SetScheduler</b>: this method now takes an ObjectFactory
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1973
instead of an object pointer directly. Existing callers can trivially be
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1974
updated to use this new method.<br>
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1975
Before:
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1976
<pre>
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1977
Ptr&lt;Scheduler&gt; sched = CreateObject&lt;ListScheduler&gt; ();
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1978
Simulator::SetScheduler (sched);
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1979
</pre>
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1980
After:
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1981
<pre>
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1982
ObjectFactory sched;
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1983
sched.SetTypeId ("ns3::ListScheduler");
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1984
Simulator::SetScheduler (sched);
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1985
</pre>
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  1986
5742
19c79550b371 CHANGES.html, AUTHORS and RELEASE_NOTES updated after AODV merge
Pavel Boyko <boyko@iitp.ru>
parents: 5532
diff changeset
  1987
<li> Extensions to IPv4 <b>Ping</b> application: verbose output and the ability to configure different ping 
5814
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1988
sizes and time intervals (via new attributes)
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1989
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1990
<li><b>Topology Helpers</b>: Previously, topology helpers such as a point-to-point star existed in the 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1991
PointToPointHelper class in the form of a method (ex: PointToPointHelper::InstallStar).  These topology 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1992
helpers have been pulled out of the specific helper classes and created as separate classes.  Several 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1993
different topology helper classes now exist including PointToPointStarHelper, PointToPointGridHelper, 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1994
PointToPointDumbbellHelper, and CsmaStarHelper.  For example, a user wishes to create a 
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1995
point-to-point star network:<br>
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1996
Before:
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1997
<pre>
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1998
NodeContainer hubNode;
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  1999
NodeContainer spokeNodes;
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2000
hubNode.Create (1);
5868
ed1e2ad4c0b9 Fix angle braces in CHANGES.html.
Andrey Mazo <mazo@iitp.ru>
parents: 5858
diff changeset
  2001
Ptr&lt;Node&gt; hub = hubNode.Get (0);
5814
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2002
spokeNodes.Create (nNodes - 1);
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2003
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2004
PointToPointHelper pointToPoint;
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2005
pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2006
pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2007
NetDeviceContainer hubDevices, spokeDevices;
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2008
pointToPoint.InstallStar (hubNode.Get (0), spokeNodes, hubDevices, spokeDevices);
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2009
</pre>
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2010
After:
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2011
<pre>
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2012
PointToPointHelper pointToPoint;
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2013
pointToPoint.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2014
pointToPoint.SetChannelAttribute ("Delay", StringValue ("2ms"));
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2015
PointToPointStarHelper star (nSpokes, pointToPoint);
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2016
</pre>
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2017
5214623658f2 Update CHANGES.html.
Sebastien Vincent <sebastien.vincent@turnserver.org>
parents: 5812
diff changeset
  2018
</li>
5742
19c79550b371 CHANGES.html, AUTHORS and RELEASE_NOTES updated after AODV merge
Pavel Boyko <boyko@iitp.ru>
parents: 5532
diff changeset
  2019
5507
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  2020
</ul>
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  2021
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2022
<h2>Changed behavior:</h2>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2023
<ul>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2024
<li> Changed default value of YansWifiPhy::EnergyDetectionThreshold from
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2025
-140.0 dBm to -96.0 dBm.  Changed default value of 
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2026
YansWifiPhy::CcaModelThreshold from -140.0 dBm to -99.0 dBm.  Rationale
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2027
can be found <a href="http://www.nsnam.org/bugzilla/show_bug.cgi?id=689"> 
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2028
here</a>.
5817
87aaf687f869 updated CHANGES.html after fixing bug 695
Kirill Andreev <andreev@iitp.ru>
parents: 5814
diff changeset
  2029
</li>
87aaf687f869 updated CHANGES.html after fixing bug 695
Kirill Andreev <andreev@iitp.ru>
parents: 5814
diff changeset
  2030
<li> Default TTL of IPv4 broadcast datagrams changed from 1 to 64.</li>
87aaf687f869 updated CHANGES.html after fixing bug 695
Kirill Andreev <andreev@iitp.ru>
parents: 5814
diff changeset
  2031
<li> Changed DcfManager::UpdateBackoff (): using flooring instead of rounding in calculation of remaining slots. <a href="http://www.nsnam.org/bugzilla/show_bug.cgi?id=695">
87aaf687f869 updated CHANGES.html after fixing bug 695
Kirill Andreev <andreev@iitp.ru>
parents: 5814
diff changeset
  2032
  See bug 695.</a></li>
5526
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2033
</ul>
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2034
d70ac1951ae4 document API changes for release
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 5507
diff changeset
  2035
5507
915abd2b907b Simulator::SetScheduler now takes an ObjectFactory
Guillaume Seguin <guillaume@segu.in>
parents: 5497
diff changeset
  2036
<hr>
4681
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2037
<h1>Changes from ns-3.5 to ns-3.6</h1>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2038
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2039
<h2>Changes to build system:</h2>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2040
<ul>
5407
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2041
<li><b>A new test framework is provided with ns-3.6 that primarilay runs outside waf</b>
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2042
<p>"./waf check" now runs the new unit tests of the core part of ns-3.6.  
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2043
In order to run the complete test package, use "./test.py" which is 
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2044
documented in a new manual -- find it in ./doc/testing.  "./waf check"
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2045
no longer generates the introspected Doxygen.  Now use "./waf doxygen"
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2046
to do this and generate the Doxygen documentation in one step.
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2047
</p>
4681
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2048
</ul>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2049
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2050
<h2>New API:</h2>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2051
<ul>
4761
8c0b3a413f4b Add metric and longest prefix match support for IPv6.
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4747
diff changeset
  2052
<li><b>Longest prefix match, support for metrics, for Ipv4StaticRouting and Ipv6StaticRouting</b>
4747
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2053
<p>When performing route lookup, first match for longest prefix, and then
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2054
based on metrics (default metric = 0).  If metrics are equal, most recent
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2055
addition is picked.  Extends API for support of metrics but preserves
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2056
backward compatibility.  One small change is that the default route
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2057
is no longer stored as index 0 route in the host route table so 
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2058
GetDefaultRoute () must be used.
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2059
</p>
3dc675bb8b20 Static routing with support for metrics and longest prefix match
Antti Makela <zarhan@cc.hut.fi>
parents: 4745
diff changeset
  2060
</li>
4745
a0e27af57c8d Allow injection of routes to Ipv4GlobalRouting
Antti Makela <zarhan@cc.hut.fi>
parents: 4735
diff changeset
  2061
<li><b>Route injection for global routing</b>
a0e27af57c8d Allow injection of routes to Ipv4GlobalRouting
Antti Makela <zarhan@cc.hut.fi>
parents: 4735
diff changeset
  2062
<p>Add ability to inject and withdraw routes to Ipv4GlobalRouting.  This
a0e27af57c8d Allow injection of routes to Ipv4GlobalRouting
Antti Makela <zarhan@cc.hut.fi>
parents: 4735
diff changeset
  2063
allows a user to insert a route and have it redistributed like an OSPF
a0e27af57c8d Allow injection of routes to Ipv4GlobalRouting
Antti Makela <zarhan@cc.hut.fi>
parents: 4735
diff changeset
  2064
external LSA to the rest of the topology.
a0e27af57c8d Allow injection of routes to Ipv4GlobalRouting
Antti Makela <zarhan@cc.hut.fi>
parents: 4735
diff changeset
  2065
</p>
a0e27af57c8d Allow injection of routes to Ipv4GlobalRouting
Antti Makela <zarhan@cc.hut.fi>
parents: 4735
diff changeset
  2066
</li>
5184
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2067
4735
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2068
<li><b>Athstats</b>
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2069
<p>New classes AthstatsWifiTraceSink and AthstatsHelper.
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2070
</p>
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2071
</li>
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2072
<li><b>WifiRemoteStationManager </b>
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2073
<p>New trace sources exported by WifiRemoteStationManager: MacTxRtsFailed, MacTxDataFailed, MacTxFinalRtsFailed and MacTxFinalDataFailed.
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2074
</p>
f011cf863e07 updated release notes
Nicola Baldo <nbaldo@cttc.es>
parents: 4731
diff changeset
  2075
</li>
5184
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2076
4731
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2077
<li><b> IPv6 additions</b>
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2078
<p> Add an IPv6 protocol and ICMPv6 capability.
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2079
<ul>
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2080
<li> new classes Ipv6, Ipv6Interface, Ipv6L3Protocol, Ipv6L4Protocol
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2081
<li> Ipv6RawSocket (no UDP or TCP capability yet)
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2082
<li> a set of classes to implement Icmpv6, including neighbor discovery,
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2083
router solicitation, DAD
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2084
<li> new applications Ping6 and Radvd
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2085
<li> routing objects Ipv6Route and Ipv6MulticastRoute
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2086
<li> routing protocols Ipv6ListRouting and Ipv6StaticRouting
510db8599bfb second phase of IPv6 checkins from Univ. of Strasbourg team
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4681
diff changeset
  2087
<li> examples: icmpv6-redirect.cc, ping6.cc, radvd.cc, radvd-two-prefix.cc, simple-routing-ping6.cc
5184
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2088
</ul>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2089
</p>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2090
</li> 
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2091
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2092
<li><b>Wireless Mesh Networking models</b>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2093
<ul>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2094
<p>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2095
<li> General multi-interface mesh stack infrastructure (devices/mesh module).
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2096
<li> IEEE 802.11s (Draft 3.0) model including Peering Management Protocol and HWMP.
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2097
<li> Forwarding Layer for Meshing (FLAME) protocol.
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2098
</ul>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2099
</p>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2100
</li>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2101
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2102
<li><b>802.11 enhancements</b>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2103
<p>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2104
<ul>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2105
<li> 10MHz and 5MHz channel width supported by 802.11a model (Ramon Bauza and Kirill Andreev).
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2106
</ul>
5189
8fcdf87a790a Channel switching support for Wifi
Ramon Bauza
parents: 5184
diff changeset
  2107
<ul>
8fcdf87a790a Channel switching support for Wifi
Ramon Bauza
parents: 5184
diff changeset
  2108
<li> Channel switching support. YansWifiPhy can now switch among different channels (Ramon Bauza and Pavel Boyko).
8fcdf87a790a Channel switching support for Wifi
Ramon Bauza
parents: 5184
diff changeset
  2109
</ul>
5184
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2110
</p>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2111
</li>
a109c38131dd Cosmetics
Pavel Boyko <boyko@iitp.ru>
parents: 4764
diff changeset
  2112
5224
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2113
<li><b> Nix-vector Routing</b>
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2114
<p> Add nix-vector routing protocol
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2115
<ul>
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2116
<li> new helper class Ipv4NixVectorHelper
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2117
</ul>
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2118
<ul>
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2119
<li> examples: nix-simple.cc, nms-p2p-nix.cc
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2120
</ul> 
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2121
</p>
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2122
</li>
06f639d05b8f Merge NixVector Routing code
Josh Pelkey <jpelkey@gatech.edu>
parents: 5189
diff changeset
  2123
5407
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2124
<li><b>New Test Framework</b>
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2125
<p> Add TestCase, TestSuite classes
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2126
<ul>
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2127
<li> examples: src/core/names-test-suite.cc, src/core/random-number-test-suite.cc, src/test/ns3tcp/ns3tcp-cwnd-test-suite.cc
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2128
</ul> 
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2129
</p>
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2130
</li>
4ad0d23af431 update CHANGES.html and RELEASE_NOTES for release
Craig Dowell <craigdo@ee.washington.edu>
parents: 5224
diff changeset
  2131
4681
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2132
</ul>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2133
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2134
<h2>Changes to existing API:</h2>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2135
<ul>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2136
<li><b>InterferenceHelper</b>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2137
<p>The method InterferenceHelper::CalculateTxDuration (uint32_t size, WifiMode payloadMode, WifiPreamble preamble) has been made static, so that the frame duration depends only on the characteristics of the frame (i.e., the function parameters) and not on the particular standard which is used by the receiving PHY. This makes it now possible to correctly calculate the duration of incoming frames in scenarios in which devices using different PHY configurations coexist in the same channel (e.g., a BSS using short preamble and another BSS using long preamble). </p>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2138
<p> The following member methods have been added to InterferenceHelper:</p>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2139
<pre>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2140
  static WifiMode GetPlcpHeaderMode (WifiMode, WifiPreamble);
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2141
  static uint32_t GetPlcpHeaderDurationMicroSeconds (WifiMode, WifiPreamble);
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2142
  static uint32_t GetPlcpPreambleDurationMicroSeconds (WifiMode, WifiPreamble);
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2143
  static uint32_t GetPayloadDurationMicroSeconds (size, WifiMode); </pre>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2144
<p> The following member methods have been removed from InterferenceHelper:</p>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2145
<pre>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2146
  void Configure80211aParameters (void);
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2147
  void Configure80211bParameters (void);
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2148
  void Configure80211_10MhzParameters (void);
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2149
  void Configure80211_5MhzParameters (void);</pre>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2150
</li>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2151
<li><b>WifiMode</b>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2152
<p>WifiMode now has a WifiPhyStandard attribute which identifies the standard the WifiMode belongs to. To properly set this attribute when creating a new WifiMode, it is now required to explicitly pass a WifiPhyStandard parameter to all WifiModeFactory::CreateXXXX() methods. The WifiPhyStandard value of an existing WifiMode can be retrieved using the new method WifiMode::GetStandard().</p>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2153
</li>
4764
e90e1ef585b0 [Bug 653] NetDevice link change callback (SetLinkChangeCallback -> AddLinkChangeCallback).
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4761
diff changeset
  2154
<li><b>NetDevice</b>
e90e1ef585b0 [Bug 653] NetDevice link change callback (SetLinkChangeCallback -> AddLinkChangeCallback).
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4761
diff changeset
  2155
<p>In order to have multiple link change callback in NetDevice (i.e. to flush ARP and IPv6 neighbor discovery caches), the following member method has been renamed:</p>
e90e1ef585b0 [Bug 653] NetDevice link change callback (SetLinkChangeCallback -> AddLinkChangeCallback).
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4761
diff changeset
  2156
<pre>
e90e1ef585b0 [Bug 653] NetDevice link change callback (SetLinkChangeCallback -> AddLinkChangeCallback).
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4761
diff changeset
  2157
- virtual void SetLinkChangeCallback (Callback&lt;void&gt; callback);
e90e1ef585b0 [Bug 653] NetDevice link change callback (SetLinkChangeCallback -> AddLinkChangeCallback).
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4761
diff changeset
  2158
+ virtual void AddLinkChangeCallback (Callback&lt;void&gt; callback);</pre>
e90e1ef585b0 [Bug 653] NetDevice link change callback (SetLinkChangeCallback -> AddLinkChangeCallback).
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4761
diff changeset
  2159
Now each NetDevice subclasses have a TracedCallback&lt;&gt; object (list of callbacks) instead of Callback&lt;void&gt; ones.
e90e1ef585b0 [Bug 653] NetDevice link change callback (SetLinkChangeCallback -> AddLinkChangeCallback).
Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
parents: 4761
diff changeset
  2160
</li>
4681
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2161
</ul>
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2162
8558474b6149 made InterferenceHelper::CalculateTxDuration () static
Nicola Baldo <nbaldo@cttc.es>
parents: 4643
diff changeset
  2163
<hr>
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2164
<h1>Changes from ns-3.4 to ns-3.5</h1>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2165
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2166
<h2>Changes to build system:</h2>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2167
<ul>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2168
</ul>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2169
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2170
<h2>New API:</h2>
4492
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2171
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2172
<ul>
4492
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2173
<li><b>YansWifiPhyHelper supporting radiotap and prism PCAP output</b>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2174
<p>The newly supported pcap formats can be adopted by calling the following new method of YansWifiPhyHelper:</p>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2175
<pre>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2176
 +  void SetPcapFormat (enum PcapFormat format);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2177
</pre>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2178
where format is one of PCAP_FORMAT_80211_RADIOTAP, PCAP_FORMAT_80211_PRISM or  PCAP_FORMAT_80211. By default, PCAP_FORMAT_80211 is used, so the default PCAP format is the same as before.</p>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2179
</li>
4502
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2180
4475
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2181
<li> <b>attributes for class Ipv4</b>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2182
<p> class Ipv4 now contains attributes in ipv4.cc; the first one
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2183
is called "IpForward" that will enable/disable Ipv4 forwarding.  
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2184
</li>
4502
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2185
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2186
<li> <b>packet tags</b>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2187
<p>class Packet now contains AddPacketTag, RemovePacketTag and PeekPacketTag 
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2188
which can be used to attach a tag to a packet, as opposed to the old 
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2189
AddTag method which attached a tag to a set of bytes. The main 
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2190
semantic difference is in how these tags behave in the presence of 
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2191
fragmentation and reassembly.
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2192
</li>
4505
e865dbc1d157 merge with HEAD
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4492 4502
diff changeset
  2193
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2194
</ul>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2195
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2196
<h2>Changes to existing API:</h2>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2197
<ul>
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2198
4572
e5dcdf2868df Remove Ipv4Interface::GetMtu ()
Tom Henderson <tomh@tomh.org>
parents: 4568
diff changeset
  2199
<li><b>Ipv4Interface::GetMtu () deleted</b>
e5dcdf2868df Remove Ipv4Interface::GetMtu ()
Tom Henderson <tomh@tomh.org>
parents: 4568
diff changeset
  2200
  <p>The Ipv4Interface API is private to internet-stack module; this method
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2201
was just a pass-through to GetDevice ()-&gt;GetMtu ().
4572
e5dcdf2868df Remove Ipv4Interface::GetMtu ()
Tom Henderson <tomh@tomh.org>
parents: 4568
diff changeset
  2202
  </p>
e5dcdf2868df Remove Ipv4Interface::GetMtu ()
Tom Henderson <tomh@tomh.org>
parents: 4568
diff changeset
  2203
</li>
e5dcdf2868df Remove Ipv4Interface::GetMtu ()
Tom Henderson <tomh@tomh.org>
parents: 4568
diff changeset
  2204
4635
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2205
<li><b>GlobalRouteManager::PopulateRoutingTables () and RecomputeRoutingTables () are deprecated </b>
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2206
  <p>This API has been moved to the helper API and the above functions will
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2207
be removed in ns-3.6.  The new API is:
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2208
<pre>
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2209
Ipv4GlobalRoutingHelper::PopulateRoutingTables ();
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2210
Ipv4GlobalRoutingHelper::RecomputeRoutingTables ();
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2211
</pre>
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2212
Additionally, these low-level functions in GlobalRouteManager are now public,
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2213
allowing more API flexibility at the low level ns-3 API:
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2214
<pre>
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2215
GlobalRouteManager::DeleteGlobalRoutes ();
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2216
GlobalRouteManager::BuildGlobalRoutingDatabase ();
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2217
GlobalRouteManager::InitializeRoutes ();
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2218
</pre>
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2219
  </p>
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2220
</li>
b40170d32073 document global routing API changes
Tom Henderson <tomh@tomh.org>
parents: 4629
diff changeset
  2221
4568
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2222
<li><b>CalcChecksum attribute changes</b>
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2223
  <p>Four IPv4 CalcChecksum attributes (which enable the computation of 
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2224
checksums that are disabled by default) have been collapsed into one global 
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2225
value in class Node.  These four calls: 
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2226
<pre>
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2227
Config::SetDefault ("ns3::Ipv4L3Protocol::CalcChecksum", BooleanValue (true)); 
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2228
Config::SetDefault ("ns3::Icmpv4L4Protocol::CalcChecksum", BooleanValue (true));
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2229
Config::SetDefault ("ns3::TcpL4Protocol::CalcChecksum", BooleanValue (true));
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2230
Config::SetDefault ("ns3::UdpL4Protocol::CalcChecksum", BooleanValue (true));
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2231
</pre>
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2232
are replaced by one call to:
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2233
<pre>
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2234
GlobalValue::Bind ("ChecksumEnabled", BooleanValue (true));
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2235
</pre>
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2236
  </p>
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2237
</li>
8a9c81e59c92 fix examples and documentation for CalcChecksum changes
Tom Henderson <tomh@tomh.org>
parents: 4555
diff changeset
  2238
4555
e33c757f790c update for API changes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4505
diff changeset
  2239
<li><b>CreateObject changes</b>
e33c757f790c update for API changes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4505
diff changeset
  2240
  <p>CreateObject is now able to construct objects with a non-default constructor.
e33c757f790c update for API changes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4505
diff changeset
  2241
   If you used to pass attribute lists to CreateObject, you must now use CreateObjectWithAttributes.
e33c757f790c update for API changes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4505
diff changeset
  2242
  </p>
e33c757f790c update for API changes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4505
diff changeset
  2243
</li>
e33c757f790c update for API changes
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4505
diff changeset
  2244
4502
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2245
<li> <b>packet byte tags renaming</b>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2246
  <ul>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2247
  <li>Packet::AddTag to Packet::AddByteTag</li>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2248
  <li>Packet::FindFirstMatchingTag to Packet::FindFirstMatchingByteTag</li>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2249
  <li>Packet::RemoveAllTags to Packet::RemoveAllByteTags</li>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2250
  <li>Packet::PrintTags to Packet::PrintByteTags</li>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2251
  <li>Packet::GetTagIterator to Packet::GetByteTagIterator</li>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2252
  </ul>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2253
</li>
07d34c0d8d18 new tags
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4475
diff changeset
  2254
4505
e865dbc1d157 merge with HEAD
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4492 4502
diff changeset
  2255
<li><b>YansWifiPhyHelper::EnablePcap* methods not static any more</b>
4492
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2256
<p>To accommodate the possibility of configuring the PCAP format used for wifi promiscuous mode traces, several methods of YansWifiPhyHelper had to be made non-static:
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2257
<pre>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2258
-  static void EnablePcap (std::string filename, uint32_t nodeid, uint32_t deviceid);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2259
+         void EnablePcap (std::string filename, uint32_t nodeid, uint32_t deviceid);
5868
ed1e2ad4c0b9 Fix angle braces in CHANGES.html.
Andrey Mazo <mazo@iitp.ru>
parents: 5858
diff changeset
  2260
-  static void EnablePcap (std::string filename, Ptr&lt;NetDevice&gt; nd);
ed1e2ad4c0b9 Fix angle braces in CHANGES.html.
Andrey Mazo <mazo@iitp.ru>
parents: 5858
diff changeset
  2261
+         void EnablePcap (std::string filename, Ptr&lt;NetDevice&gt; nd);
4492
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2262
-  static void EnablePcap (std::string filename, std::string ndName);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2263
+         void EnablePcap (std::string filename, std::string ndName);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2264
-  static void EnablePcap (std::string filename, NetDeviceContainer d);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2265
+         void EnablePcap (std::string filename, NetDeviceContainer d);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2266
-  static void EnablePcap (std::string filename, NodeContainer n);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2267
+         void EnablePcap (std::string filename, NodeContainer n);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2268
-  static void EnablePcapAll (std::string filename);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2269
+         void EnablePcapAll (std::string filename);
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2270
</pre>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2271
</p>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2272
</li>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2273
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2274
<li><b>Wifi Promisc Sniff interface modified </b>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2275
<p> 
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2276
To accommodate support for the radiotap and prism headers in PCAP traces, the interface for promiscuos mode sniff in the wifi device was changed. The new implementation was heavily inspired by the way the madwifi driver handles monitor mode. A distinction between TX and RX events is introduced, to account for the fact that different information is to be put in the radiotap/prism header (e.g., RSSI and noise make sense only for RX packets). The following are the relevant modifications to the WifiPhy class:
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2277
<pre>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2278
-  void NotifyPromiscSniff (Ptr&lt;const Packet&gt; packet);
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2279
+  void NotifyPromiscSniffRx (Ptr&lt;const Packet&gt; packet, uint16_t channelFreqMhz, uint32_t rate, bool isShortPreamble, double signalDbm, double noiseDbm);
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2280
+  void NotifyPromiscSniffTx (Ptr&lt;const Packet&gt; packet, uint16_t channelFreqMhz, uint32_t rate, bool isShortPreamble);
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2281
-  TracedCallback&lt;Ptr&lt;const Packet&gt; &gt; m_phyPromiscSnifferTrace;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2282
+  TracedCallback&lt;Ptr&lt;const Packet&gt;, uint16_t, uint32_t, bool, double, double&gt; m_phyPromiscSniffRxTrace;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2283
+  TracedCallback&lt;Ptr&lt;const Packet&gt;, uint16_t, uint32_t, bool&gt; m_phyPromiscSniffTxTrace;
4492
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2284
</pre>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2285
The above mentioned callbacks are expected to be used to call the following method to write Wifi PCAP traces in promiscuous mode:
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2286
<pre>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2287
+  void WriteWifiMonitorPacket(Ptr&lt;const Packet&gt; packet, uint16_t channelFreqMhz, uint32_t rate, bool isShortPreamble, bool isTx, double signalDbm, double noiseDbm);
4492
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2288
</pre>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2289
In the above method, the isTx parameter is to be used to differentiate between TX and RX packets. For an example of how to implement these callbacks, see the implementation of PcapSniffTxEvent and PcapSniffRxEvent in src/helper/yans-wifi-helper.cc
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2290
</p>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2291
</li>
3ebeb7bf3c15 added support for radiotap and prism headers
Nicola Baldo <nbaldo@cttc.es>
parents: 4475
diff changeset
  2292
4475
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2293
<li><b> Routing decoupled from class Ipv4</b>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2294
<p> All calls of the form "Ipv4::AddHostRouteTo ()" etc. (i.e. to 
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2295
add static routes, both unicast and multicast) have been moved to a new 
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2296
class Ipv4StaticRouting.  In addition, class Ipv4 now holds only
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2297
one possible routing protocol; the previous way to add routing protocols
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2298
(by ordered list of priority) has been moved to a new class Ipv4ListRouting.
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2299
Class Ipv4 has a new minimal routing API (just to set and get the routing
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2300
protocol):
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2301
<pre>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2302
-  virtual void AddRoutingProtocol (Ptr&lt;Ipv4RoutingProtocol&gt; routingProtocol, int16_t priority) = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2303
+  virtual void SetRoutingProtocol (Ptr&lt;Ipv4RoutingProtocol&gt; routingProtocol) = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2304
+  virtual Ptr&lt;Ipv4RoutingProtocol&gt; GetRoutingProtocol (void) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2305
</pre>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2306
</li>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2307
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2308
<li><b> class Ipv4RoutingProtocol is refactored</b>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2309
<p> The abstract base class Ipv4RoutingProtocol has been refactored to
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2310
align with corresponding Linux Ipv4 routing architecture, and has been
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2311
moved from ipv4.h to a new file ipv4-routing-protocol.h.  The new
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2312
methods (RouteOutput () and RouteInput ()) are aligned with Linux 
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2313
ip_route_output() and ip_route_input().  However,
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2314
the general nature of these calls (synchronous routing lookup for
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2315
locally originated packets, and an asynchronous, callback-based lookup
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2316
for forwarded packets) is still the same.
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2317
<pre>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2318
-  typedef Callback&lt;void, bool, const Ipv4Route&amp;, Ptr&lt;Packet&gt;, const Ipv4Header&amp;&gt; RouteReplyCallback;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2319
+  typedef Callback&lt;void, Ptr&lt;Ipv4Route&gt;, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;&gt; UnicastForwardCallback;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2320
+  typedef Callback&lt;void, Ptr&lt;Ipv4MulticastRoute&gt;, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;&gt; MulticastForwardCallback;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2321
+  typedef Callback&lt;void, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;, uint32_t &gt; LocalDeliverCallback;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2322
+  typedef Callback&lt;void, Ptr&lt;const Packet&gt;, const Ipv4Header &amp;&gt; ErrorCallback;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2323
-  virtual bool RequestInterface (Ipv4Address destination, uint32_t&amp; interface) = 0;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2324
+  virtual Ptr&lt;Ipv4Route&gt; RouteOutput (Ptr&lt;Packet&gt; p, const Ipv4Header &amp;header, uint32_t oif, Socket::SocketErrno &amp;errno) = 0;
4475
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2325
-  virtual bool RequestRoute (uint32_t interface,
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2326
-                            const Ipv4Header &amp;ipHeader,
4475
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2327
-                            Ptr&lt;Packet&gt; packet,
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2328
-                            RouteReplyCallback routeReply) = 0;
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2329
+  virtual bool RouteInput  (Ptr&lt;const Packet&gt; p, const Ipv4Header &amp;header, Ptr&lt;const NetDevice&gt; idev,
4475
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2330
+                             UnicastForwardCallback ucb, MulticastForwardCallback mcb,
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2331
+                             LocalDeliverCallback lcb, ErrorCallback ecb) = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2332
</pre>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2333
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2334
</li>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2335
<li><b> previous class Ipv4Route, Ipv4MulticastRoute renamed; new classes with
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2336
those same names added</b>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2337
<p> The previous class Ipv4Route and Ipv4MulticastRoute are used by 
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2338
Ipv4StaticRouting and Ipv4GlobalRouting to record internal routing table
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2339
entries, so they were renamed to class Ipv4RoutingTableEntry and
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2340
Ipv4MulticastRoutingTableEntry, respectively.  In their place, new
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2341
class Ipv4Route and class Ipv4MulticastRoute have been added.  These
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2342
are reference-counted objects that are analogous to Linux struct
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2343
rtable and struct mfc_cache, respectively, to achieve better compatibility
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2344
with Linux routing architecture in the future.  
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2345
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2346
<li><b> class Ipv4 address-to-interface mapping functions changed</b>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2347
<p>  There was some general cleanup of functions that involve mappings
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2348
from Ipv4Address to either NetDevice or Ipv4 interface index.  
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2349
<pre>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2350
-  virtual uint32_t FindInterfaceForAddr (Ipv4Address addr) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2351
-  virtual uint32_t FindInterfaceForAddr (Ipv4Address addr, Ipv4Mask mask) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2352
+  virtual int32_t GetInterfaceForAddress (Ipv4Address address) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2353
+  virtual int32_t GetInterfaceForPrefix (Ipv4Address address, Ipv4Mask mask) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2354
-  virtual int32_t FindInterfaceForDevice(Ptr&lt;NetDevice&gt; nd) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2355
+  virtual int32_t GetInterfaceForDevice (Ptr&lt;const NetDevice&gt; device) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2356
-  virtual Ipv4Address GetSourceAddress (Ipv4Address destination) const = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2357
-  virtual bool GetInterfaceForDestination (Ipv4Address dest,
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2358
-  virtual uint32_t GetInterfaceByAddress (Ipv4Address addr, Ipv4Mask mask = Ipv4Mask("255.255.255.255"));
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2359
</pre>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2360
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2361
<li><b> class Ipv4 multicast join API deleted</b>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2362
<p> The following methods are not really used in present form since IGMP
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2363
is not being generated, so they have been removed (planned to be replaced
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2364
by multicast socket-based calls in the future):
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2365
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2366
<pre>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2367
- virtual void JoinMulticastGroup (Ipv4Address origin, Ipv4Address group) = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2368
- virtual void LeaveMulticastGroup (Ipv4Address origin, Ipv4Address group) = 0;
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2369
</pre>
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2370
a232dcbbe7a8 api changes and release notes for IPv4 routing rework
Tom Henderson <tomh@tomh.org>
parents: 4426
diff changeset
  2371
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2372
<li><b>Deconflict NetDevice::ifIndex and Ipv4::ifIndex (bug 85).</b>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2373
<p>All function parameters named "ifIndex" that refer 
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2374
to an Ipv4 interface are instead named "interface".
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2375
<pre>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2376
- static const uint32_t Ipv4RoutingProtocol::IF_INDEX_ANY = 0xffffffff;
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2377
+ static const uint32_t Ipv4RoutingProtocol::INTERFACE_ANY = 0xffffffff;
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2378
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2379
- bool Ipv4RoutingProtocol::RequestIfIndex (Ipv4Address destination, uint32_t&amp; ifIndex);
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2380
+ bool Ipv4RoutingProtocol::RequestInterface (Ipv4Address destination, uint32_t&amp; interface);
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2381
(N.B. this particular function is planned to be renamed to RouteOutput() in the
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2382
proposed IPv4 routing refactoring)
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2383
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2384
- uint32_t Ipv4::GetIfIndexByAddress (Ipv4Address addr, Ipv4Mask mask);
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2385
+ int_32t Ipv4::GetInterfaceForAddress (Ipv4Address address, Ipv4Mask mask) const;
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2386
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2387
- bool Ipv4::GetIfIndexForDestination (Ipv4Address dest, uint32_t &amp;ifIndex) const;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2388
+ bool Ipv4::GetInterfaceForDestination (Ipv4Address dest, uint32_t &amp;interface) const;
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2389
(N.B. this function is not needed in the proposed Ipv4 routing refactoring)
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2390
</pre>
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2391
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2392
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2393
<li><b>Allow multiple IPv4 addresses to be assigned to an interface (bug 188)</b>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2394
  <ul>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2395
  <li> Add class Ipv4InterfaceAddress:  
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2396
  This is a new class to resemble Linux's struct in_ifaddr.  It holds IP addressing information, including mask,
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2397
  broadcast address, scope, whether primary or secondary, etc.
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2398
  <pre>
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2399
+  virtual uint32_t AddAddress (uint32_t interface, Ipv4InterfaceAddress address) = 0;
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2400
+  virtual Ipv4InterfaceAddress GetAddress (uint32_t interface, uint32_t addressIndex) const = 0;
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2401
+  virtual uint32_t GetNAddresses (uint32_t interface) const = 0;
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2402
  </pre>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2403
  <li>Regarding legacy API usage, typically where you once did the following,
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2404
  using the public Ipv4 class interface (e.g.):
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2405
  <pre>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2406
  ipv4A-&gt;SetAddress (ifIndexA, Ipv4Address ("172.16.1.1"));
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2407
  ipv4A-&gt;SetNetworkMask (ifIndexA, Ipv4Mask ("255.255.255.255"));
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2408
  </pre>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2409
  you now do:
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2410
  <pre>
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2411
  Ipv4InterfaceAddress ipv4IfAddrA = Ipv4InterfaceAddress (Ipv4Address ("172.16.1.1"), Ipv4Mask ("255.255.255.255"));
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2412
  ipv4A-&gt;AddAddress (ifIndexA, ipv4IfAddrA);
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2413
  </pre>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2414
  <li> At the helper API level, one often gets an address from an interface
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2415
  container.  We preserve the legacy GetAddress (uint32_t i) but it
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2416
  is documented that this will return only the first (address index 0)
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2417
  address on the interface, if there are multiple such addresses. 
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2418
  We provide also an overloaded variant for the multi-address case: 
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2419
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2420
  <pre>
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2421
Ipv4Address Ipv4InterfaceContainer::GetAddress (uint32_t i)
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2422
+ Ipv4Address Ipv4InterfaceContainer::GetAddress (uint32_t i, uint32_t j)
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2423
  </pre>
4413
4726838efe7c Added API changes for wifi helpers
Mirko Banchi <mk.banchi@gmail.com>
parents: 4385
diff changeset
  2424
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2425
  </ul>
4413
4726838efe7c Added API changes for wifi helpers
Mirko Banchi <mk.banchi@gmail.com>
parents: 4385
diff changeset
  2426
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2427
<li><b>New WifiMacHelper objects</b>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2428
<p>The type of wifi MAC is now set by two new specific helpers, NqosWifiMacHelper for non QoS MACs and QosWifiMacHelper for Qos MACs. They are passed as argument to WifiHelper::Install methods.</li>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2429
  <pre>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2430
- void WifiHelper::SetMac (std::string type, std::string n0 = "", const AttributeValue &amp;v0 = EmptyAttributeValue (),...)
4413
4726838efe7c Added API changes for wifi helpers
Mirko Banchi <mk.banchi@gmail.com>
parents: 4385
diff changeset
  2431
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2432
- NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phyHelper, NodeContainer c) const
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2433
+ NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phyHelper, const WifiMacHelper &amp;macHelper, NodeContainer c) const
4413
4726838efe7c Added API changes for wifi helpers
Mirko Banchi <mk.banchi@gmail.com>
parents: 4385
diff changeset
  2434
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2435
- NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, Ptr&lt;Node&gt; node) const
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2436
+ NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, const WifiMacHelper &amp;mac, Ptr&lt;Node&gt; node) const
4413
4726838efe7c Added API changes for wifi helpers
Mirko Banchi <mk.banchi@gmail.com>
parents: 4385
diff changeset
  2437
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2438
- NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, std::string nodeName) const
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2439
+ NetDeviceContainer WifiHelper::Install (const WifiPhyHelper &amp;phy, const WifiMacHelper &amp;mac, std::string nodeName) const
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2440
  </pre>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2441
  See src/helper/nqos-wifi-mac-helper.h and src/helper/qos-wifi-mac-helper.h for more details.
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2442
  </p>
4413
4726838efe7c Added API changes for wifi helpers
Mirko Banchi <mk.banchi@gmail.com>
parents: 4385
diff changeset
  2443
4426
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2444
<li><b>Remove Mac48Address::IsMulticast</b>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2445
  <p>This method was considered buggy and unsafe to call. Its replacement is Mac48Address::IsGroup.
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2446
  </li>
c8dd5497e809 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 4413
diff changeset
  2447
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2448
</ul>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2449
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2450
<h2>Changed behavior:</h2>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2451
<ul>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2452
</ul>
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2453
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2454
<hr>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2455
<h1>Changes from ns-3.3 to ns-3.4</h1>
4260
29587ce02a57 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3982
diff changeset
  2456
4385
1114152c44dd update CHANGES.html
Tom Henderson <tomh@tomh.org>
parents: 4305
diff changeset
  2457
<h2>Changes to build system:</h2>
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2458
<ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2459
<li>A major option regarding the downloading and building of ns-3 has been
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2460
added for ns-3.4 -- the ns-3-allinone feature.  This allows a user to
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2461
get the most common options for ns-3 downloaded and built with a minimum
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2462
amount of trouble.  See the ns-3 tutorial for a detailed explanation of
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2463
how to use this new feature.</li>
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2464
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2465
<li>The build system now runs build items in parallel by default.  This includes
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2466
the regression tests.</li>
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2467
</ul>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2468
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2469
<h2>New API:</h2>
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2470
<ul>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2471
<li>XML support has been added to the ConfigStore in src/contrib/config-store.cc</li>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2472
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2473
<li>The ns-2 calendar queue scheduler option has been ported to src/simulator</li>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2474
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2475
<li>A ThreeLogDistancePropagationLossModel has been added to src/devices/wifi</li>
4260
29587ce02a57 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3982
diff changeset
  2476
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2477
<li>ConstantAccelerationMobilityModel in src/mobility/constant-acceleration-mobility-model.h</li>
4266
7b0c4017bc36 Update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 4260
diff changeset
  2478
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2479
<li>A new emulation mode is supported with the TapBridge net device (see
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2480
src/devices/tap-bridge)</li>
4266
7b0c4017bc36 Update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 4260
diff changeset
  2481
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2482
<li>A new facility for naming ns-3 Objects is included (see
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2483
src/core/names.{cc,h})</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2484
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2485
<li>Wifi multicast support has been added in src/devices/wifi</li>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2486
</ul>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2487
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2488
<h2>Changes to existing API:</h2>
4266
7b0c4017bc36 Update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 4260
diff changeset
  2489
7b0c4017bc36 Update CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 4260
diff changeset
  2490
<ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2491
<li>Some fairly significant changes have been made to the API of the
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2492
random variable code.  Please see the ns-3 manual and src/core/random-variable.cc
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2493
for details.</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2494
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2495
<li>The trace sources in the various NetDevice classes has been completely
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2496
reworked to allow for a consistent set of trace sources across the
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2497
devices.  The names of the trace sources have been changed to provide
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2498
some context with respect to the level at which the trace occurred.
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2499
A new set of trace sources has been added which emulates the behavior
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2500
of packet sniffers.  These sources have been used to implement tcpdump-
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2501
like functionality and are plumbed up into the helper classes.  The 
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2502
user-visible changes are the trace source name changes and the ability
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2503
to do promiscuous-mode pcap tracing via helpers.  For further information
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2504
regarding these changes, please see the ns-3 manual</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2505
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2506
<li>StaticMobilityModel has been renamed ConstantPositionMobilityModel
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2507
StaticSpeedMobilityModel has been renamed ConstantVelocityMobilityModel</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2508
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2509
<li>The Callback templates have been extended to support more parameters.
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2510
See src/core/callback.h</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2511
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2512
<li>Many helper API have been changed to allow passing Object-based parameters
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2513
as string names to ease working with the object name service.</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2514
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2515
<li>The Config APIs now accept path segments that are names defined by the
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2516
object name service.</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2517
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2518
<li>Minor changes were made to make the system build under the Intel C++ compiler.</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2519
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2520
<li>Trace hooks for association and deassociation to/from an access point were
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2521
added to src/devices/wifi/nqsta-wifi-mac.cc</li>
4260
29587ce02a57 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3982
diff changeset
  2522
</ul>
29587ce02a57 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3982
diff changeset
  2523
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2524
<h2>Changed behavior:</h2>
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2525
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2526
<ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2527
<li>The tracing system rework has introduced some significant changes in the
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2528
behavior of some trace sources, specifically in the positioning of trace sources
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2529
in the device code.  For example, there were cases where the packet transmit 
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2530
trace source was hit before the packet was enqueued on the device transmit quueue.
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2531
This now happens just before the packet is transmitted over the channel medium.
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2532
The scope of the changes is too large to be included here.  If you have concerns
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2533
regarding trace semantics, please consult the net device documentation for details.
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2534
As is usual, the ultimate source for documentation is the net device source code.</li>
4301
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2535
</ul>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log
Craig Dowell <craigdo@ee.washington.edu>
parents: 4266
diff changeset
  2536
4260
29587ce02a57 update CHANGES.html
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3982
diff changeset
  2537
<hr>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2538
<h1>Changes from ns-3.2 to ns-3.3</h1>
3865
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2539
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2540
<h2>New API:</h2>
3865
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2541
<ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2542
<li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2543
ns-3 ABORT macros in src/core/abort.h
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2544
Config::MatchContainer
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2545
ConstCast and DynamicCast helper functions for Ptr casting
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2546
StarTopology added to several topology helpers
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2547
NetDevice::IsBridge () 
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2548
</li>
3865
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2549
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2550
<li>17-11-2008; changeset 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2551
<a href="http://code.nsnam.org/ns-3-dev/rev/4c1c3f6bcd03">4c1c3f6bcd03</a></li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2552
<ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2553
<li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2554
The PppHeader previously defined in the point-to-point-net-device code has been 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2555
made public.
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2556
</li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2557
</ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2558
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2559
<li>17-11-2008; changeset 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2560
<a href="http://code.nsnam.org/ns-3-dev/rev/16c2970a0344">16c2970a0344</a></li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2561
<ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2562
<li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2563
An emulated net device has been added as enabling technology for ns-3 emulation
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2564
scenarios.  See src/devices/emu and examples/emu-udp-echo.cc for details.
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2565
</li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2566
</ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2567
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2568
<li>17-11-2008; changeset 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2569
<a href="http://code.nsnam.org/ns-3-dev/rev/4222173d1e6d">4222173d1e6d</a></li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2570
<ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2571
<li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2572
Added method InternetStackHelper::EnableAsciiChange to allow allow a user to 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2573
hook ascii trace to the drop trace events in Ipv4L3Protocol and ArpL3Protocol.
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2574
</li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2575
</ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2576
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2577
</ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2578
<h2>Changes to existing API:</h2>
3865
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2579
<ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2580
3982
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2581
<li> NetDevice::MakeMulticastAddress() was renamed to NetDevice::GetMulticast()
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2582
and the original GetMulticast() removed </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2583
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2584
<li> Socket API changes:
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2585
<ul>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2586
<li> return type of SetDataSentCallback () changed from bool to void </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2587
<li> Socket::Listen() no longer takes a queueLimit argument</li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2588
</ul>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2589
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2590
<li> As part of the Wifi Phy rework, there have been several API changes
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2591
at the low level and helper API level.  </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2592
<ul>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2593
<li>  At the helper API level, the WifiHelper was split to three classes: 
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2594
a WifiHelper, a YansWifiChannel helper, and a YansWifiPhy helper.  Some
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2595
functions like Ascii and Pcap tracing functions were moved from class
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2596
WifiHelper to class YansWifiPhyHelper. 
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2597
<li>  At the low-level API, there have been a number of changes to
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2598
make the Phy more modular:</li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2599
<ul>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2600
<li> composite-propagation-loss-model.h is removed</li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2601
<li> DcfManager::NotifyCcaBusyStartNow() has changed name</li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2602
<li> fragmentation related functions (e.g. DcaTxop::GetNFragments()) have
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2603
changed API to account for some implementation changes</li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2604
<li> Interference helper and error rate model added </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2605
<li> JakesPropagationLossModel::GetLoss() moved to PropagationLoss() class</li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2606
<li> base class WifiChannel made abstract </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2607
<li> WifiNetDevice::SetChannel() removed </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2608
<li> a WifiPhyState helper class added </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2609
<li> addition of the YansWifiChannel and YansWifiPhy classes </li>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2610
</ul>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2611
</ul>
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2612
3865
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2613
<li>17-11-2008; changeset 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2614
<a href="http://code.nsnam.org/ns-3-dev/rev/dacfd1f07538">dacfd1f07538</a></li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2615
<ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2616
<li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2617
Change attribute "RxErrorModel" to "ReceiveErrorModel" in CsmaNetDevice for 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2618
consistency between devices.
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2619
</li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2620
</ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2621
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2622
</ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2623
<h2>changed behavior:</h2>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2624
<ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2625
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2626
<li>17-11-2008; changeset 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2627
<a href="http://code.nsnam.org/ns-3-dev/rev/ed0dfce40459">ed0dfce40459</a></li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2628
<ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2629
<li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2630
Relax reasonableness testing in Ipv4AddressHelper::SetBase to allow the 
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2631
assignment of /32 addresses.
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2632
</li>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2633
</ul>
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2634
3949
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2635
<li>17-11-2008; changeset 
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2636
<a href="http://code.nsnam.org/ns-3-dev/rev/756887a9bbea">756887a9bbea</a></li>
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2637
<ul>
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2638
<li>
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2639
Global routing supports bridge devices.
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2640
</li>
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2641
</ul>
3982
4f370a1b637c add some things to release notes and changes.html; revise README
Tom Henderson <tomh@tomh.org>
parents: 3949
diff changeset
  2642
</ul>
3949
016c554c4f6d CHANGES.html for global routing supporting bridges
Craig Dowell <craigdo@ee.washington.edu>
parents: 3865
diff changeset
  2643
3865
6647bcafbf3f overdue changes to CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3686
diff changeset
  2644
<hr>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2645
<h1>Changes from ns-3.1 to ns-3.2</h1>
3593
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2646
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2647
<h2>New API:</h2>
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2648
<ul>
3593
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2649
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2650
<li>26-08-2008; changeset 
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2651
<a href="http://code.nsnam.org/ns-3-dev/rev/5aa65b1ea001">5aa65b1ea001</a></li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2652
<ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2653
<li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2654
Add multithreaded and real-time simulator implementation.  Allows for emulated
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2655
net devices running in threads other than the main simulation thread to schedule
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2656
events.  Allows for pacing the simulation clock at 1x real-time.
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2657
</li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2658
</ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2659
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2660
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2661
<li>26-08-2008; changeset 
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2662
<a href="http://code.nsnam.org/ns-3-dev/rev/c69779f5e51e">c69779f5e51e</a></li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2663
<ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2664
<li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2665
Add threading and synchronization primitives.  Enabling technology for 
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2666
multithreaded simulator implementation.
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2667
</li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2668
</ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3551
diff changeset
  2669
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2670
</ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2671
<h2>New API in existing classes:</h2>
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2672
<ul>
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2673
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2674
<li>01-08-2008; changeset 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2675
<a href="http://code.nsnam.org/ns-3-dev/rev/a18520551cdf">a18520551cdf</a></li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2676
<ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2677
<li>class ArpCache has two new attributes:  MaxRetries 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2678
and a Drop trace.  It also has some new public methods but these are 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2679
mostly for internal use.
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2680
</ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2681
</li>
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2682
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2683
</ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2684
<h2>Changes to existing API:</h2>
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2685
<ul>
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2686
3667
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2687
<li>05-09-2008; changeset 
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2688
<a href="http://code.nsnam.org/ns-3-dev/rev/aa1fb0f43571">aa1fb0f43571</a></li>
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2689
<ul>
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2690
<li>
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2691
Change naming of MTU and packet size attributes in CSMA and Point-to-Point devices<br>
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2692
After much discussion it was decided that the preferred way to think about 
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2693
the different senses of transmission units and encapsulations was to call the 
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2694
MAC MTU simply MTU and to use the overall packet size as the PHY-level attribute
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2695
of interest.  See the Doxygen of CsmaNetDevice::SetFrameSize and 
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2696
PointToPointNetDevice::SetFrameSize for a detailed description.
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2697
</li>
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2698
</ul>
ba90a28f8c59 prep for ns-3.2-RC2
Craig Dowell <craigdo@ee.washington.edu>
parents: 3645
diff changeset
  2699
3551
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2700
<li>25-08-2008; changeset 
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2701
<a href="http://code.nsnam.org/ns-3-dev/rev/e5ab96db540e">e5ab96db540e</a></li>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2702
<ul>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2703
<li>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2704
bug 273: constify packet pointers.<br>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2705
The normal and the promiscuous receive callbacks of the NetDevice API
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2706
have been changed from:
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2707
<pre>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2708
Callback&lt;bool,Ptr&lt;NetDevice&gt;,Ptr&lt;Packet&gt;,uint16_t,const Address &amp;&gt;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2709
Callback&lt;bool,Ptr&lt;NetDevice&gt;, Ptr&lt;Packet&gt;, uint16_t,
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2710
         const Address &amp;, const Address &amp;, enum PacketType &gt;
3551
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2711
</pre>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2712
to:
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2713
<pre>
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2714
Callback&lt;bool,Ptr&lt;NetDevice&gt;,Ptr&lt;const Packet&gt;,uint16_t,const Address &amp;&gt;
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2715
Callback&lt;bool,Ptr&lt;NetDevice&gt;, Ptr&lt;const Packet&gt;, uint16_t,
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2716
         const Address &amp;, const Address &amp;, enum PacketType &gt;
3551
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2717
</pre>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2718
to avoid the kind of bugs reported in 
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2719
<a href="http://www.nsnam.org/bugzilla/show_bug.cgi?id=273">bug 273</a>.
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2720
Users who implement a subclass of the NetDevice base class need to change the signature
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2721
of their SetReceiveCallback and SetPromiscReceiveCallback methods.
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2722
</li>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2723
</ul>
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2724
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2725
3508
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2726
<li>04-08-2008; changeset 
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2727
<a href="http://code.nsnam.org/ns-3-dev/rev/cba7b2b80fe8">cba7b2b80fe8</a></li>
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2728
<ul>
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2729
<li>
3551
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2730
Cleanup of MTU confusion and initialization in CsmaNetDevice<br>
3508
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2731
The MTU of the CsmaNetDevice defaulted to 65535.  This did not correspond with
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2732
the expected MTU found in Ethernet-like devices.  Also there was not clear 
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2733
documentation regarding which MTU was being set.  There are two MTU here, one
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2734
at the MAC level and one at the PHY level.  We split out the MTU setting to make
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2735
this more clear and set the default PHY level MTU to 1500 to be more like
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2736
Ethernet.  The encapsulation mode defaults to LLC/SNAP which then puts the
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2737
MAC level MTU at 1492 by default.  We allow users to now set the encapsulation
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2738
mode, MAC MTU and PHY MTU while keeping the three values consistent.  See the
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2739
Doxygen of CsmaNetDevice::SetMaxPayloadLength for a detailed description of the
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2740
issues and solution.
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2741
</li>
7a3c6148c22d actually use CHANGES.html
Craig Dowell <craigdo@ee.washington.edu>
parents: 3505
diff changeset
  2742
</ul>
3551
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2743
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2744
<li>21-07-2008; changeset 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2745
<a href="
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2746
http://code.nsnam.org/ns-3-dev/rev/99698bc858e8">99698bc858e8</a></li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2747
<ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2748
<li> class NetDevice has added a pure virtual method that
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2749
must be implemented by all subclasses:
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2750
<pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2751
virtual void SetPromiscReceiveCallback (PromiscReceiveCallback cb) = 0;
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2752
</pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2753
All NetDevices must support this method, and must call this callback
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2754
when processing packets in the receive direction (the appropriate place
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2755
to call this is device-dependent).  An approach to stub this out
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2756
temporarily, if you do not care about immediately enabling this
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2757
functionality, would be to add this to your device:
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2758
<pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2759
void
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2760
ExampleNetDevice::SetPromiscReceiveCallback
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2761
(NetDevice::PromiscReceiveCallback cb)
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2762
{ 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2763
  NS_ASSERT_MSG (false, "No implementation yet for
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2764
SetPromiscReceiveCallback");
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2765
}
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2766
</pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2767
To implement this properly, consult the CsmaNetDevice for examples of
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2768
when the m_promiscRxCallback is called.
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2769
</li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2770
</ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2771
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2772
<li>03-07-2008; changeset 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2773
<a href="http://code.nsnam.org/ns-3-dev/rev/d5f8e5fae1c6">d5f8e5fae1c6</a></li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2774
<ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2775
<li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2776
Miscellaneous cleanup of Udp Helper API, to fix bug 234
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2777
<pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2778
class UdpEchoServerHelper
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2779
{
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2780
public:
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2781
- UdpEchoServerHelper ();
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2782
- void SetPort (uint16_t port); 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2783
+ UdpEchoServerHelper (uint16_t port);
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2784
+ 
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2785
+ void SetAttribute (std::string name, const AttributeValue &amp;value);
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2786
ApplicationContainer Install (NodeContainer c);
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2787
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2788
class UdpEchoClientHelper
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2789
{
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2790
public:
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2791
- UdpEchoClientHelper ();
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2792
+ UdpEchoClientHelper (Ipv4Address ip, uint16_t port);
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2793
- void SetRemote (Ipv4Address ip, uint16_t port);
4639
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2794
- void SetAppAttribute (std::string name, const AttributeValue &amp;value);
34e6d141c227 escape html special characters
Andrey Hippo<ahippo@yandex.ru>
parents: 4629
diff changeset
  2795
+ void SetAttribute (std::string name, const AttributeValue &amp;value);
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2796
ApplicationContainer Install (NodeContainer c);
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2797
</pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2798
</li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2799
</ul>
3551
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2800
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2801
<li>03-07-2008; changeset 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2802
<a href="
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2803
http://code.nsnam.org/ns-3-dev/rev/3cdd9d60f7c7">3cdd9d60f7c7</a></li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2804
<ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2805
<li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2806
Rename all instances method names using "Set..Parameter" to "Set..Attribute"
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2807
(bug 232)
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2808
</li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2809
<li> How to fix your code:  Any use of helper API that was using a method
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2810
"Set...Parameter()" should be changed to read "Set...Attribute()".  e.g.
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2811
<pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2812
- csma.SetChannelParameter ("DataRate", DataRateValue (5000000));
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2813
- csma.SetChannelParameter ("Delay", TimeValue (MilliSeconds (2)));
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2814
+ csma.SetChannelAttribute ("DataRate", DataRateValue (5000000));
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2815
+ csma.SetChannelAttribute ("Delay", TimeValue (MilliSeconds (2)));
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2816
</pre>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2817
</li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2818
</ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2819
</li>
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2820
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2821
</ul>
4305
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4
Craig Dowell <craigdo@ee.washington.edu>
parents: 4301
diff changeset
  2822
<h2>Changed behavior:</h2>
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2823
<ul>
3645
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2824
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2825
<li>07-09-2008; changeset 
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2826
<a href="http://code.nsnam.org/ns-3-dev/rev/5d836ab1523b">5d836ab1523b</a></li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2827
<ul>
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2828
3645
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2829
<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2830
Implement a finite receive buffer for TCP<br>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2831
The native TCP model in TcpSocketImpl did not support a finite receive buffer.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2832
This changeset adds the following functionality in this regard:
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2833
<ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2834
<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2835
Being able to set the receiver buffer size through the attributes system.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2836
</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2837
<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2838
This receiver buffer size is now correctly exported in the TCP header as the
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2839
advertised window.  Prior to this changeset, the TCP header advertised window
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2840
was set to the maximum size of 2^16 bytes.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2841
window
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2842
</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2843
<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2844
The aforementioned window size is correctly used for flow control, i.e. the
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2845
sending TCP will not send more data than available space in the receiver's
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2846
buffer.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2847
</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2848
<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2849
In the case of a receiver window collapse, when a advertised zero-window
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2850
packet is received, the sender enters the persist probing state in which
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2851
it sends probe packets with one payload byte at exponentially backed-off
6273
8d70de29d514 spell check, mostly in comments.
Andrey Mazo <mazo@iitp.ru>
parents: 6184
diff changeset
  2852
intervals up to 60s.  The receiver will continue to send advertised 
3645
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2853
zero-window ACKs of the old data so long as the receiver buffer remains full.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2854
When the receiver window clears up due to an application read, the TCP
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2855
will finally ACK the probe byte, and update its advertised window appropriately.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2856
</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2857
</ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2858
See 
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2859
<a href="http://www.nsnam.org/bugzilla/show_bug.cgi?id=239"> bug 239 </a> for
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2860
more.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2861
</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2862
</ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2863
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2864
<li>07-09-2008; changeset 
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2865
<a href="http://code.nsnam.org/ns-3-dev/rev/7afa66c2b291">7afa66c2b291</a></li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2866
<ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2867
<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2868
Add correct FIN exchange behavior during TCP closedown<br>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2869
The behavior of the native TcpSocketImpl TCP model was such that the final
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2870
FIN exchange was not correct, i.e. calling Socket::Close didn't send a FIN
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2871
packet, and even if it had, the ACK never came back, and even if it had, the
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2872
ACK would have incorrect sequence number.  All these various problems have been
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2873
addressed by this changeset.  See 
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2874
<a href="http://www.nsnam.org/bugzilla/show_bug.cgi?id=242"> bug 242 </a> for
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2875
more.
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2876
</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2877
</ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets
Raj Bhattacharjea <raj.b@gatech.edu>
parents: 3593
diff changeset
  2878
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2879
<li> 28-07-2008; changeset 
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2880
<a href="http://code.nsnam.org/ns-3-dev/rev/6f68f1044df1">6f68f1044df1</a>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2881
<ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2882
<li>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2883
OLSR: HELLO messages hold time changed to 3*hello
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2884
interval from hello interval.  This is an important bug fix as
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2885
hold time == refresh time was never intentional, as it leads to
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2886
instability in neighbor detection.
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2887
</ul>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2888
</li>
3686
9e2dde61057c fix formatting
Tom Henderson <tomh@tomh.org>
parents: 3667
diff changeset
  2889
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2890
</ul>
3551
fbf628eb3ca6 document API change
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 3508
diff changeset
  2891
3505
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2892
</body>
16005bad2e0b Add CHANGES.html
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
  2893
</html>