CHANGES.html
changeset 6032 a31949e0f1ed
parent 6018 92c388406dbe
child 6038 f1926441567b
--- a/CHANGES.html	Thu Jan 28 17:34:20 2010 -0800
+++ b/CHANGES.html	Thu Jan 28 17:42:51 2010 -0800
@@ -54,35 +54,52 @@
 <ul>
 </pre>
 <li><b>Tracing Helpers</b>: The organization of helpers for both pcap and ascii
-tracing has been reworked.  Instead of each device and stack helper 
-re-implementing trace enable methods, classes have been developed to implement
-user-level tracing in a consistent way; and device and stack helpers use those
-classes to provide tracing functionality.<br>
+tracing, in devices and protocols, has been reworked.  Instead of each device 
+and protocol helper re-implementing trace enable methods, classes have been 
+developed to implement user-level tracing in a consistent way; and device and 
+protocol helpers use those classes to provide tracing functionality.<br>
 In addition to consistent operation across all helpers, the object name service
 has been integrated into the trace file naming scheme.<br>
+The internet stack helper has been extensively massaged to make it easier to 
+manage traces originating from protocols.  It used to be the case that there 
+was essentially no opportunity to filter tracing on interfaces, and resulting
+trace file names collided with those created by devices.  File names are now
+disambiguated and one can enable traces on a protocol/interface basis analogously
+to the node/device granularity of device-based helpers.<br>
 The primary user-visible results of this change are that trace-related functions
 have been changed from static functions to method calls; and a new object has
 been developed to hold streams for ascii traces.<br>
+New functionality is present for ascii traces.  It is now possible to create
+multiple ascii trace files automatically just as was possible for pcap trace 
+files.<br>
 The implementation of the helper code has been designed also to provide 
 functionality to make it easier for sophisticated users to hook traces of 
 various kinds and write results to (file) streams.
 Before:
 <pre>
-CsmaHelper::EnablePcapAll ();
+  CsmaHelper::EnablePcapAll ();
 
-std::ofstream ascii;
-ascii.open ("csma-one-subnet.tr", std::ios_base::binary | std::ios_base::out);
-CsmaHelper::EnableAsciiAll (ascii);
+  std::ofstream ascii;
+  ascii.open ("csma-one-subnet.tr", std::ios_base::binary | std::ios_base::out);
+  CsmaHelper::EnableAsciiAll (ascii);
+
+  InternetStackHelper::EnableAsciiAll (ascii);
 </pre>
 After:
 <pre>
-CsmaHelper csmaHelper;
-csmaHelper.EnablePcapAll ();
+  CsmaHelper csmaHelper;
+  InternetStackHelper stack;
+  csmaHelper.EnablePcapAll ();
 
-AsciiTraceHelper ascii;
-csma.EnableAsciiAll (ascii.CreateFileStream ("csma-one-subnet.tr"));
+  AsciiTraceHelper ascii;
+  csma.EnableAsciiAll (ascii.CreateFileStream ("csma-one-subnet.tr"));
+
+  stack.EnableAsciiIpv4All (stream);
+
 </pre>
 
+
+
 <hr>
 <h1>Changes from ns-3.6 to ns-3.7</h1>