Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(1214)

Unified Diff: CHANGES.html

Issue 196058: Redo ASCII and pcap Traces
Patch Set: Created 14 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: CHANGES.html
===================================================================
--- a/CHANGES.html
+++ b/CHANGES.html
@@ -44,6 +44,63 @@
us a note on ns-developers mailing list. </p>
<hr>
+<h1>Changes from ns-3.7 to ns-3.8</h1>
+
+<h2>Changes to build system:</h2>
+
+<h2>New API:</h2>
+
+<h2>Changes to existing API:</h2>
+<ul>
+</pre>
+<li><b>Tracing Helpers</b>: The organization of helpers for both pcap and ascii
+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 ();
+
+ 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;
+ InternetStackHelper stack;
+ csmaHelper.EnablePcapAll ();
+
+ 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>
« no previous file with comments | « no previous file | bindings/python/apidefs/gcc-ILP32/ns3_module_common.py » ('j') | bindings/python/ns3modulescan.py » ('J')

Powered by Google App Engine
RSS Feeds Recent Issues | This issue
This is Rietveld f62528b