citrun

watch C/C++ source code execute
Log | Files | Refs | LICENSE

index.html (2623B)


      1 <!DOCTYPE html>
      2 <html>
      3 <head>
      4 	<meta charset="utf-8" />
      5 	<meta name="viewport" content="width=device-width" />
      6 	<meta name="description" content="C It Run 0.0 Release." />
      7 
      8 	<title>C It Run 0.0 Announcement</title>
      9 	<link rel="stylesheet" type="text/css" href="../citrun.css" />
     10 </head>
     11 <body>
     12 	<h1>C It Run 0.0 RELEASED</h1>
     13 
     14 	<p>September 15, 2016.</p>
     15 
     16 	<p>I am pleased to announce the official release of C It Run 0.0.
     17 	This is the very first release available.
     18 	</p>
     19 
     20 	<p>This release includes tools and documentation that realize the goal of software
     21 	execution visualization:
     22 	</p>
     23 
     24 	<ul>
     25 	<li> Instrumentation tools, including:
     26 		<ul>
     27 		<li>New citrun_wrap(1) script that enables rewriting on an
     28 			existing build command
     29 		<li>New citrun_report(1) script that summarizes rewriting
     30 			activity
     31 		<li>New citrun_gl(1) utility that displays executing programs
     32 		<li>New citrun_inst(1) utility for C/C++ source code rewriting
     33 		</ul>
     34 	</li>
     35 	<li> Documentation, including:
     36 		<ul>
     37 		<li>New manuals for citrun_wrap, citrun_report, citrun_gl and
     38 			citrun_inst
     39 		</ul>
     40 	</li>
     41 	<li> Code reports, including:
     42 		<ul>
     43 		<li>Test coverage
     44 		<li>Static analysis
     45 		</ul>
     46 	</li>
     47 	<li> Pre-built binary packages for select operating systems, including:
     48 		<ul>
     49 		<li>Darwin 15
     50 		<li>Debian 9.0
     51      		<li>OpenBSD 6.0
     52 		</ul>
     53 	</li>
     54 	<li> Forward compatibility:
     55 		<ul>
     56 		<li> Minor release interoperability guarantee.
     57 		</ul>
     58 	</li>
     59 	</ul>
     60 
     61 	<h2>Code Reports</h2>
     62 
     63 	<p>High quality releases are ensured by:
     64 	</p>
     65 	<ul>
     66 	<li>Automated testing with <a href="e2e.txt">end-to-end reports</a>
     67 	<li>Test coverage of source:
     68 		<ul>
     69 		<li> <a href="cov/runtime.c.gcov">src/runtime.c</a>
     70 		<li> <a href="cov/inst_main.cc.gcov">src/inst_main.cc</a>
     71 		</ul>
     72 	</li>
     73 	<li> <a href="sa/index.html">Static analysis</a>
     74 	</ul>
     75 
     76 	<h2>Binary Packages</h2>
     77 	<p>Because C It Run has not been integrated into any system package
     78 	managers, there are binary packages for the following platforms
     79 	available:
     80 	</p>
     81 	<ul>
     82 	<li>Darwin 15/x86_64
     83 	<li>Debian 9.0/sparc64
     84 	<li>OpenBSD 6.0/amd64
     85 	<li>OpenBSD 6.0/sparc64
     86 	</ul>
     87 
     88 	<h2>Source</h2>
     89 
     90 	<p>The source code is available in this directory as
     91 	<a href="citrun_0.0.tar.gz">citrun_0.0.tar.gz.</a>
     92 	</p>
     93 
     94 	<h2>Forward Compatibility</h2>
     95 
     96 	<p>The runtime interface is guaranteed not to change in minor
     97 	version bumps when the major version stays the same.
     98 	</p>
     99 
    100 	<p>This means that existing instrumented code will work with newer
    101 	tools.
    102 	</p>
    103 
    104 	<h2>Bugs</h2>
    105 
    106 	<p>Instrumented code cannot be inserted or removed at runtime (via
    107 	dlopen() etc).  This may be fixed in a future release.
    108 	</p>
    109 </body>
    110 </html>