initial commit (2.1b2)

Author: weston-nrl

.gitignore

@@ -0,0 +1,12 @@
+# build executables
+hcat
+trpr
+
+# OS generated files #
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db

Hcat.dsp

@@ -0,0 +1,28 @@
+/*********************************************************************
+ *
+ * AUTHORIZATION TO USE AND DISTRIBUTE
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that: 
+ *
+ * (1) source code distributions retain this paragraph in its entirety, 
+ *  
+ * (2) distributions including binary code include this paragraph in
+ *     its entirety in the documentation or other materials provided 
+ *     with the distribution.
+ * 
+ *      "This product includes software written and developed 
+ *       by Code 5520 of the Naval Research Laboratory (NRL)." 
+ *         
+ *  The name of NRL, the name(s) of NRL  employee(s), or any entity
+ *  of the United States Government may not be used to endorse or
+ *  promote  products derived from this software, nor does the 
+ *  inclusion of the NRL written and developed software  directly or
+ *  indirectly suggest NRL or United States  Government endorsement
+ *  of this product.
+ * 
+ * THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+ *
+ ********************************************************************/

LICENSE

@@ -0,0 +1,10 @@
+all:	trpr hcat
+
+trpr:	trpr.cpp
+	g++ -g -o trpr trpr.cpp -lm
+
+hcat:	hcat.cpp
+	g++ -g -o hcat hcat.cpp -lm
+
+clean:
+	rm -f trpr hcat

Makefile.linux

@@ -0,0 +1,79 @@
+         TRace Plot Realtime (trpr) Distribution (2.1b2)
+     
+OVERVIEW:
+
+This directory contains the source code and documentation
+for the "trpr" program which analyzes trace files, provides
+statistics and histograms and allows for graphical display of 
+analytical results.  Trpr supports trace (log) files produced 
+by the following programs:
+
+tcpdump (using tcpdump's hexadecimal (-x) output)
+
+mgen  (NRL's "Multi-generator" message generation program)
+
+ns-2 (The Berkeley/ISI network simulation tool.
+
+"Trpr" has filter options and can display plots for different 
+"flows" of data (defined by protocol type, source, and 
+destination).  "Trpr" provides built-in support for display
+of graphical data using the "gnuplot" plotting program, but 
+its output may also be plotted using other graphing tools.
+
+
+FILES:
+
+README.TXT  - this file.
+
+trpr.cpp    - C++ source code for the "trpr" program
+
+trpr.html   - "Trpr" User's Guide.
+
+hcat.cpp    - C++ source code for "hcat", the histogram
+              concatenation program.
+
+TO BUILD:
+
+g++ -o trpr trpr.cpp -lm
+
+g++ -o hcat hcat.cpp -lm
+
+OR: "make -f Makefile.linux"
+
+HCAT Usage:
+
+The Histogram Concatenator ("hcat") is useful for post-processing
+the histogram output produced by "trpr".  "hcat" can be used to 
+combine multiple histograms and to retrieve some summary statistics
+from the histogram data.  
+
+Usage: 
+
+hcat [normalize] [percent [<rangeMin>:]<rangeMax>] file1 [file2 file3 ...]
+
+Options:
+
+normalize  - The minimum bin is adjusted to correspond to zero.  Other
+             bins are correspondingly linearly adjusted.
+             
+percent [<rangeMin>:]<rangeMax> - Calculates the percentage of data
+                                  points lying in the specified range.
+                                  
+The <files> are expected to contain histogram data in pairs of data in  the
+order of minimum bin to maximum bin, with the first value of the pair
+specifying the bin and the second value specifying the number of data
+points for that histogram bin.  Lines beginning with '#' are ignored as
+comments.
+
+
+IPv6 NOTES:
+
+TRPR IPv6 support is still a bit "kludgy".  I plan to re-write TRPR to use my 
+"Protolib" stuff to leverage those address-independent classes and to better
+support TRPR cross-platform portability.  Meanwhile, some notes:
+
+1) For MGEN IPv6 flows, you can (and may have) to use abbreviated IPv6 addresses
+   in your flow descriptions provided on the command-line.
+   
+2) For tcpdump file analysis, note that full (non-abbreviated) IPv6 address
+   syntax MUST be used.

README.md

@@ -0,0 +1,41 @@
+Microsoft Developer Studio Workspace File, Format Version 6.00
+# WARNING: DO NOT EDIT OR DELETE THIS WORKSPACE FILE!
+
+###############################################################################
+
+Project: "Hcat"=.\Hcat.dsp - Package Owner=<4>
+
+Package=<5>
+{{{
+}}}
+
+Package=<4>
+{{{
+}}}
+
+###############################################################################
+
+Project: "Trpr"=.\Trpr.dsp - Package Owner=<4>
+
+Package=<5>
+{{{
+}}}
+
+Package=<4>
+{{{
+}}}
+
+###############################################################################
+
+Global:
+
+Package=<5>
+{{{
+}}}
+
+Package=<3>
+{{{
+}}}
+
+###############################################################################
+