add tutorial scripts and example c code.

Author: simotin13

00_setup.sh

@@ -0,0 +1,18 @@
+# download and extract intel pin
+pushd .
+cd ..
+wget https://software.intel.com/sites/landingpage/pintool/downloads/pin-3.27-98718-gbeaa5d51e-gcc-linux.tar.gz
+tar xf pin-3.27-98718-gbeaa5d51e-gcc-linux.tar.gz
+popd
+
+# build CodeCoverage(this repository code)
+./build.sh
+
+# build code coverage target example
+pushd .
+cd examples/c_function_call
+make
+popd
+
+# run code coverage tool
+

01_run_example.sh

@@ -0,0 +1 @@
+../pin-3.27-98718-gbeaa5d51e-gcc-linux/pin -t ./obj-intel64/CodeCoverage.so -- examples/c_function_call/cov_sample 1 2

build.sh

@@ -0,0 +1,2 @@
+make PIN_ROOT=../pin-3.27-98718-gbeaa5d51e-gcc-linux
+

examples/c_function_call/Makefile

@@ -0,0 +1,6 @@
+all:
+	${CC} -g -gdwarf-4 main.c calc.c -o cov_sample
+
+clean:
+	rm -f cov_sample
+

examples/c_function_call/calc.c

@@ -0,0 +1,4 @@
+int add(int a, int b) 
+{
+    return a+b;
+}

examples/c_function_call/main.c

@@ -0,0 +1,34 @@
+#include <stdio.h>
+#include <stdlib.h>
+
+extern int add(int, int);
+
+int main(int argc, char **argv)
+{
+    /*
+    * With command line arg example, call function implemented in onother file(calc.c)
+    * Comment lines are not count as executable lines.
+    */
+    int a, b;
+    int result = 0;
+
+    if (argc < 3) {
+        // must input 2 number args
+        fprintf(stderr, "input 2 numbers for calc add.\n");
+        fprintf(stderr, "Usage) ./a.out 1 2\n");
+        return -1;
+    }
+
+    a = atoi(argv[1]);
+    b = atoi(argv[2]);
+
+    result = add(a, b);
+
+    if (result < 10) {
+        printf("a + b = %d, the answer is smaller than 10!\n", result);
+    } else {
+        printf("a + b = %d, the answer is greater than or equal to 10!\n", result);
+    }
+
+    return 0;
+}