ns-3.5: CHANGES.html@938c96b15fa7 (annotated)

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>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	26	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	27	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	28	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	29	or signature has changed, it should be stated what the new replacement
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	30	name is. </p>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	31	<p>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	32	Note that users who upgrade the simulator across versions, or who work
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	33	directly out of the development tree, may find that simulation output
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	34	changes even when the compilation doesn't break, such as when a
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	35	simulator default value is changed. Therefore, it is good practice for
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	36	_anyone_ using code across multiple ns-3 releases to consult this file,
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	37	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	38	</p>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	39	<p>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	40	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	41	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	42	the cracks, unfortunately. If you, as a user, can suggest improvements
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	43	to this file based on your experience, please contribute a patch or drop
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	44	us a note on ns-developers mailing list. </p>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	45
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	46	<hr>
4385 1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	47	<h1>Changes from ns-3.4 to ns-3.5</h1>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	48
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	49	<h2>Changes to build system:</h2>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	50	<ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	51	</ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	52
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	53	<h2>New API:</h2>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	54	<ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	55	</ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	56
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	57	<h2>Changes to existing API:</h2>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	58	<ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	59	<li> deconflict NetDevice::ifIndex and Ipv4::ifIndex (bug 85). All function parameters named "ifIndex" that refer
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	60	to an Ipv4 interface are instead named "interface".
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	61	<pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	62	- static const uint32_t Ipv4RoutingProtocol::IF_INDEX_ANY = 0xffffffff;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	63	+ static const uint32_t Ipv4RoutingProtocol::INTERFACE_ANY = 0xffffffff;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	64
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	65	- bool Ipv4RoutingProtocol::RequestIfIndex (Ipv4Address destination, uint32_t& ifIndex);
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	66	+ bool Ipv4RoutingProtocol::RequestInterface (Ipv4Address destination, uint32_t& interface);
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	67	(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	68	proposed IPv4 routing refactoring)
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	69
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	70	- uint32_t Ipv4::GetIfIndexByAddress (Ipv4Address addr, Ipv4Mask mask);
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	71	+ int_32t Ipv4::GetInterfaceForAddress (Ipv4Address address, Ipv4Mask mask) const;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	72
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	73	- bool Ipv4::GetIfIndexForDestination (Ipv4Address dest, uint32_t &ifIndex) const;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	74	+ bool Ipv4::GetInterfaceForDestination (Ipv4Address dest, uint32_t &interface) const;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	75	(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	76	</pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	77	<li> allow multiple IPv4 addresses to be assigned to an interface (bug 188).
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	78	<ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	79	<li> Add class Ipv4InterfaceAddress:
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	80	This is a new class to resemble Linux's struct in_ifaddr. It holds IP addressing information, including mask,
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	81	broadcast address, scope, whether primary or secondary, etc.
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	82	<pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	83	+ virtual uint32_t AddAddress (uint32_t interface, Ipv4InterfaceAddress address) = 0;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	84	+ virtual Ipv4InterfaceAddress GetAddress (uint32_t interface, uint32_t addressIndex) const = 0;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	85	+ virtual uint32_t GetNAddresses (uint32_t interface) const = 0;
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	86	</pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	87	<li>Regarding legacy API usage, typically where you once did the following,
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	88	using the public Ipv4 class interface (e.g.):
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	89	<pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	90	ipv4A->SetAddress (ifIndexA, Ipv4Address ("172.16.1.1"));
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	91	ipv4A->SetNetworkMask (ifIndexA, Ipv4Mask ("255.255.255.255"));
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	92	</pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	93	you now do:
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	94	<pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	95	Ipv4InterfaceAddress ipv4IfAddrA = Ipv4InterfaceAddress (Ipv4Address ("172.16.1.1"), Ipv4Mask ("255.255.255.255"));
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	96	ipv4A->AddAddress (ifIndexA, ipv4IfAddrA);
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	97	</pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	98	<li> At the helper API level, one often gets an address from an interface
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	99	container. We preserve the legacy GetAddress (uint32_t i) but it
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	100	is documented that this will return only the first (address index 0)
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	101	address on the interface, if there are multiple such addresses.
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	102	We provide also an overloaded variant for the multi-address case:
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	103
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	104	<pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	105	Ipv4Address Ipv4InterfaceContainer::GetAddress (uint32_t i)
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	106	+ Ipv4Address Ipv4InterfaceContainer::GetAddress (uint32_t i, uint32_t j)
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	107	</pre>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	108	</ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	109	</ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	110
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	111	<h2>Changed behavior:</h2>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	112	<ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	113	</ul>
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	114
1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	115	<hr>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	116	<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	117
4385 1114152c44dd update CHANGES.html Tom Henderson <tomh@tomh.org> parents: 4305 diff changeset	118	<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	119	<ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	120	<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	121	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	122	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	123	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	124	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	125
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	126	<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	127	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	128	</ul>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log Craig Dowell <craigdo@ee.washington.edu> parents: 4266 diff changeset	129
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	130	<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	131	<ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	132	<li>XML support has been added to the ConfigStore in /src/contrib/config-store.cc</li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	133
4301 f1c83e54e541 Update CHANGES for ns-3.4 from hg log Craig Dowell <craigdo@ee.washington.edu> parents: 4266 diff changeset	134	<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	135
f1c83e54e541 Update CHANGES for ns-3.4 from hg log Craig Dowell <craigdo@ee.washington.edu> parents: 4266 diff changeset	136	<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	137
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	138	<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	139
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	140	<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	141	src/devices/tap-bridge)</li>
4266 7b0c4017bc36 Update CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 4260 diff changeset	142
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	143	<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	144	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	145
4301 f1c83e54e541 Update CHANGES for ns-3.4 from hg log Craig Dowell <craigdo@ee.washington.edu> parents: 4266 diff changeset	146	<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	147	</ul>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log Craig Dowell <craigdo@ee.washington.edu> parents: 4266 diff changeset	148
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	149	<h2>Changes to existing API:</h2>
4266 7b0c4017bc36 Update CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 4260 diff changeset	150
7b0c4017bc36 Update CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 4260 diff changeset	151	<ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	152	<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	153	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	154	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	155
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	156	<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	157	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	158	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	159	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	160	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	161	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	162	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	163	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	164	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	165	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	166
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	167	<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	168	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	169
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	170	<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	171	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	172
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	173	<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	174	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	175
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	176	<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	177	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	178
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	179	<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	180
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	181	<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	182	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	183	</ul>
29587ce02a57 update CHANGES.html Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3982 diff changeset	184
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	185	<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	186
f1c83e54e541 Update CHANGES for ns-3.4 from hg log Craig Dowell <craigdo@ee.washington.edu> parents: 4266 diff changeset	187	<ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	188	<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	189	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	190	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	191	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	192	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	193	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	194	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	195	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	196	</ul>
f1c83e54e541 Update CHANGES for ns-3.4 from hg log Craig Dowell <craigdo@ee.washington.edu> parents: 4266 diff changeset	197
4260 29587ce02a57 update CHANGES.html Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3982 diff changeset	198	<hr>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	199	<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	200
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	201	<h2>New API:</h2>
3865 6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	202	<ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	203	<li>
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	204	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	205	Config::MatchContainer
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	206	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	207	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	208	NetDevice::IsBridge ()
9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	209	</li>
3865 6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	210
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	211	<li>17-11-2008; changeset
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	212	<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	213	<ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	214	<li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	215	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	216	made public.
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	217	</li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	218	</ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	219
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	220	<li>17-11-2008; changeset
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	221	<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	222	<ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	223	<li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	224	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	225	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	226	</li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	227	</ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	228
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	229	<li>17-11-2008; changeset
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	230	<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	231	<ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	232	<li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	233	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	234	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	235	</li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	236	</ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	237
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	238	</ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	239	<h2>Changes to existing API:</h2>
3865 6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	240	<ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	241
3982 4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	242	<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	243	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	244
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	245	<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	246	<ul>
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	247	<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	248	<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	249	</ul>
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	250
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	251	<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	252	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	253	<ul>
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	254	<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	255	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	256	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	257	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	258	<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	259	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	260	<ul>
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	261	<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	262	<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	263	<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	264	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	265	<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	266	<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	267	<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	268	<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	269	<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	270	<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	271	</ul>
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	272	</ul>
4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	273
3865 6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	274	<li>17-11-2008; changeset
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	275	<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	276	<ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	277	<li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	278	Change attribute "RxErrorModel" to "ReceiveErrorModel" in CsmaNetDevice for
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	279	consistency between devices.
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	280	</li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	281	</ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	282
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	283	</ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	284	<h2>changed behavior:</h2>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	285	<ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	286
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	287	<li>17-11-2008; changeset
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	288	<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	289	<ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	290	<li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	291	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	292	assignment of /32 addresses.
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	293	</li>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	294	</ul>
6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	295
3949 016c554c4f6d CHANGES.html for global routing supporting bridges Craig Dowell <craigdo@ee.washington.edu> parents: 3865 diff changeset	296	<li>17-11-2008; changeset
016c554c4f6d CHANGES.html for global routing supporting bridges Craig Dowell <craigdo@ee.washington.edu> parents: 3865 diff changeset	297	<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	298	<ul>
016c554c4f6d CHANGES.html for global routing supporting bridges Craig Dowell <craigdo@ee.washington.edu> parents: 3865 diff changeset	299	<li>
016c554c4f6d CHANGES.html for global routing supporting bridges Craig Dowell <craigdo@ee.washington.edu> parents: 3865 diff changeset	300	Global routing supports bridge devices.
016c554c4f6d CHANGES.html for global routing supporting bridges Craig Dowell <craigdo@ee.washington.edu> parents: 3865 diff changeset	301	</li>
016c554c4f6d CHANGES.html for global routing supporting bridges Craig Dowell <craigdo@ee.washington.edu> parents: 3865 diff changeset	302	</ul>
3982 4f370a1b637c add some things to release notes and changes.html; revise README Tom Henderson <tomh@tomh.org> parents: 3949 diff changeset	303	</ul>
3949 016c554c4f6d CHANGES.html for global routing supporting bridges Craig Dowell <craigdo@ee.washington.edu> parents: 3865 diff changeset	304
3865 6647bcafbf3f overdue changes to CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3686 diff changeset	305	<hr>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	306	<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	307
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	308	<h2>New API:</h2>
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	309	<ul>
3593 dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	310
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	311	<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	312	<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	313	<ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	314	<li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	315	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	316	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	317	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	318	</li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	319	</ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	320
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	321
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	322	<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	323	<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	324	<ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	325	<li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	326	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	327	multithreaded simulator implementation.
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	328	</li>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	329	</ul>
dfd634417b8d update AUTHORS, CHANGES, RELEASE_NOTES for ns-3.2 Craig Dowell <craigdo@ee.washington.edu> parents: 3551 diff changeset	330
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	331	</ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	332	<h2>New API in existing classes:</h2>
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	333	<ul>
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	334
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	335	<li>01-08-2008; changeset
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	336	<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	337	<ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	338	<li>class ArpCache has two new attributes: MaxRetries
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	339	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	340	mostly for internal use.
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	341	</ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	342	</li>
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	343
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	344	</ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	345	<h2>Changes to existing API:</h2>
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	346	<ul>
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	347
3667 ba90a28f8c59 prep for ns-3.2-RC2 Craig Dowell <craigdo@ee.washington.edu> parents: 3645 diff changeset	348	<li>05-09-2008; changeset
ba90a28f8c59 prep for ns-3.2-RC2 Craig Dowell <craigdo@ee.washington.edu> parents: 3645 diff changeset	349	<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	350	<ul>
ba90a28f8c59 prep for ns-3.2-RC2 Craig Dowell <craigdo@ee.washington.edu> parents: 3645 diff changeset	351	<li>
ba90a28f8c59 prep for ns-3.2-RC2 Craig Dowell <craigdo@ee.washington.edu> parents: 3645 diff changeset	352	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	353	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	354	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	355	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	356	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	357	PointToPointNetDevice::SetFrameSize for a detailed description.
ba90a28f8c59 prep for ns-3.2-RC2 Craig Dowell <craigdo@ee.washington.edu> parents: 3645 diff changeset	358	</li>
ba90a28f8c59 prep for ns-3.2-RC2 Craig Dowell <craigdo@ee.washington.edu> parents: 3645 diff changeset	359	</ul>
ba90a28f8c59 prep for ns-3.2-RC2 Craig Dowell <craigdo@ee.washington.edu> parents: 3645 diff changeset	360
3551 fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	361	<li>25-08-2008; changeset
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	362	<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	363	<ul>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	364	<li>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	365	bug 273: constify packet pointers.<br>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	366	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	367	have been changed from:
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	368	<pre>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	369	Callback<bool,Ptr<NetDevice>,Ptr<Packet>,uint16_t,const Address &>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	370	Callback<bool,Ptr<NetDevice>, Ptr<Packet>, uint16_t,
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	371	const Address &, const Address &, enum PacketType >
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	372	</pre>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	373	to:
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	374	<pre>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	375	Callback<bool,Ptr<NetDevice>,Ptr<const Packet>,uint16_t,const Address &>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	376	Callback<bool,Ptr<NetDevice>, Ptr<const Packet>, uint16_t,
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	377	const Address &, const Address &, enum PacketType >
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	378	</pre>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	379	to avoid the kind of bugs reported in
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	380	<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	381	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	382	of their SetReceiveCallback and SetPromiscReceiveCallback methods.
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	383	</li>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	384	</ul>
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	385
fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	386
3508 7a3c6148c22d actually use CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3505 diff changeset	387	<li>04-08-2008; changeset
7a3c6148c22d actually use CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3505 diff changeset	388	<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	389	<ul>
7a3c6148c22d actually use CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3505 diff changeset	390	<li>
3551 fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	391	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	392	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	393	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	394	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	395	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	396	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	397	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	398	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	399	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	400	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	401	issues and solution.
7a3c6148c22d actually use CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3505 diff changeset	402	</li>
7a3c6148c22d actually use CHANGES.html Craig Dowell <craigdo@ee.washington.edu> parents: 3505 diff changeset	403	</ul>
3551 fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	404
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	405	<li>21-07-2008; changeset
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	406	<a href="
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	407	http://code.nsnam.org/ns-3-dev/rev/99698bc858e8">99698bc858e8</a></li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	408	<ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	409	<li> class NetDevice has added a pure virtual method that
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	410	must be implemented by all subclasses:
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	411	<pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	412	virtual void SetPromiscReceiveCallback (PromiscReceiveCallback cb) = 0;
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	413	</pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	414	All NetDevices must support this method, and must call this callback
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	415	when processing packets in the receive direction (the appropriate place
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	416	to call this is device-dependent). An approach to stub this out
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	417	temporarily, if you do not care about immediately enabling this
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	418	functionality, would be to add this to your device:
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	419	<pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	420	void
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	421	ExampleNetDevice::SetPromiscReceiveCallback
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	422	(NetDevice::PromiscReceiveCallback cb)
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	423	{
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	424	NS_ASSERT_MSG (false, "No implementation yet for
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	425	SetPromiscReceiveCallback");
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	426	}
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	427	</pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	428	To implement this properly, consult the CsmaNetDevice for examples of
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	429	when the m_promiscRxCallback is called.
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	430	</li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	431	</ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	432
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	433	<li>03-07-2008; changeset
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	434	<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	435	<ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	436	<li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	437	Miscellaneous cleanup of Udp Helper API, to fix bug 234
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	438	<pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	439	class UdpEchoServerHelper
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	440	{
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	441	public:
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	442	- UdpEchoServerHelper ();
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	443	- void SetPort (uint16_t port);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	444	+ UdpEchoServerHelper (uint16_t port);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	445	+
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	446	+ void SetAttribute (std::string name, const AttributeValue &value);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	447	ApplicationContainer Install (NodeContainer c);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	448
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	449	class UdpEchoClientHelper
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	450	{
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	451	public:
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	452	- UdpEchoClientHelper ();
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	453	+ UdpEchoClientHelper (Ipv4Address ip, uint16_t port);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	454	- void SetRemote (Ipv4Address ip, uint16_t port);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	455	- void SetAppAttribute (std::string name, const AttributeValue &value);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	456	+ void SetAttribute (std::string name, const AttributeValue &value);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	457	ApplicationContainer Install (NodeContainer c);
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	458	</pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	459	</li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	460	</ul>
3551 fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	461
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	462	<li>03-07-2008; changeset
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	463	<a href="
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	464	http://code.nsnam.org/ns-3-dev/rev/3cdd9d60f7c7">3cdd9d60f7c7</a></li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	465	<ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	466	<li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	467	Rename all instances method names using "Set..Parameter" to "Set..Attribute"
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	468	(bug 232)
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	469	</li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	470	<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	471	"Set...Parameter()" should be changed to read "Set...Attribute()". e.g.
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	472	<pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	473	- csma.SetChannelParameter ("DataRate", DataRateValue (5000000));
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	474	- csma.SetChannelParameter ("Delay", TimeValue (MilliSeconds (2)));
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	475	+ csma.SetChannelAttribute ("DataRate", DataRateValue (5000000));
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	476	+ csma.SetChannelAttribute ("Delay", TimeValue (MilliSeconds (2)));
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	477	</pre>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	478	</li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	479	</ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	480	</li>
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	481
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	482	</ul>
4305 9ec113d84cc8 prettify CHANGES and add behavior changed section for ns-3.4 Craig Dowell <craigdo@ee.washington.edu> parents: 4301 diff changeset	483	<h2>Changed behavior:</h2>
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	484	<ul>
3645 5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	485
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	486	<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	487	<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	488	<ul>
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	489
3645 5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	490	<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	491	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	492	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	493	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	494	<ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	495	<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	496	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	497	</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	498	<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	499	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	500	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	501	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	502	window
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	503	</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	504	<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	505	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	506	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	507	buffer.
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	508	</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	509	<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	510	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	511	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	512	it sends probe packets with one payload byte at exponentially backed-off
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	513	intervals up to 60s. The reciever will continue to send advertised
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	514	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	515	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	516	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	517	</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	518	</ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	519	See
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	520	<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	521	more.
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	522	</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	523	</ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	524
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	525	<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	526	<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	527	<ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	528	<li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	529	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	530	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	531	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	532	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	533	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	534	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	535	<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	536	more.
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	537	</li>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	538	</ul>
5a0182408867 Update CHANGES.html to reflect the last two changesets Raj Bhattacharjea <raj.b@gatech.edu> parents: 3593 diff changeset	539
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	540	<li> 28-07-2008; changeset
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	541	<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	542	<ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	543	<li>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	544	OLSR: HELLO messages hold time changed to 3*hello
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	545	interval from hello interval. This is an important bug fix as
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	546	hold time == refresh time was never intentional, as it leads to
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	547	instability in neighbor detection.
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	548	</ul>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	549	</li>
3686 9e2dde61057c fix formatting Tom Henderson <tomh@tomh.org> parents: 3667 diff changeset	550
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	551	</ul>
3551 fbf628eb3ca6 document API change Mathieu Lacage <mathieu.lacage@sophia.inria.fr> parents: 3508 diff changeset	552
3505 16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	553	</body>
16005bad2e0b Add CHANGES.html Tom Henderson <tomh@tomh.org> parents: diff changeset	554	</html>

author	Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
	Fri, 24 Apr 2009 09:57:16 +0200
changeset 4405	938c96b15fa7
parent 4385	1114152c44dd
child 4413	4726838efe7c
permissions	-rw-r--r--