Code Coverage Support (#46)

* Code-coverage support

* Examples update

- code-coverage example
- tweak transpose and parallel-overhead

* Coverage output + testing

- config::get_setting value(...)
- REGULAR_EXPRESSION -> REGEX in cmake func args
- coverage.hpp header
- coverage JSON
- coverage tests

* cmake formatting

* Library instrumentation w/o main + more

- fixed library instrumentation w/o main
- use TIMEMORY_PROJECT_NAME in output messages
- removed '--driver' option from omnitrace exe
- support coverage in trace mode
- OMNITRACE_KOKKOS_KERNEL_LOGGER
- support multiple calls to omnitrace_set_env after init if already called
- support multiple calls to omnitrace_set_mpi after init if same args
- support multiple calls to omnitrace_init if same mode
- unique_ptr_t for thread_data which calls finalize when thread_data is destroyed
- tweaked openmp tests
- improved finalization

* Replace CI --output-on-failure with -V

* Fix to OMNITRACE_DL_INVOKE

* omnitrace-exe and testing updates

- omnitrace::omnitrace-timemory interface library
- support for configs in omnitrace exe
- print-{available,instrumented,...} opts no longer exit w/o --simulate
- all tests apply --print-instrumented functions
- tweaked coverage tests
- print-* options print instructions not address range

* Remove OMNITRACE_DEBUG_FINALIZE=ON from CI

* Python cmake tweaks

* Tweak test ordering

* Upload CI artifacts if fail or success

* CI Python tweaks

- Use OMNITRACE_PYTHON_PREFIX and OMNITRACE_PYTHON_ENVS

* CI ELFULTILS_DOWNLOAD_VERSION

* test tweaks

- labels and more coverage tests

* tweak to omnitrace --config handling

* Update module/function constraint handling + PP

- tweak pre-processor definition handling
- removed free-standing module_constraint
- remove free-standing routine_constraint
- remove module_name.find("omnitrace") module constraint
- fully handle the output path of omnitrace *-instr files
- get_use_code_coverage config option
- print-coverage option
- coverage_module_functions

* use github.job not github.name

* Re-enable HSA_ENABLE_INTERRUPT

- remove coverage address report

source/bin/omnitrace/module_function.hpp

@@ -46,12 +46,20 @@ struct module_function
 
     module_function(module_t* mod, procedure_t* proc);
 
+    // code coverage
+    void register_source(address_space_t* _addr_space, procedure_t* _entr_trace,
+                         const std::vector<point_t*>&) const;
+    std::pair<size_t, size_t> register_coverage(address_space_t* _addr_space,
+                                                procedure_t*     _entr_trace) const;
+
+    // instrumentation
     std::pair<size_t, size_t> operator()(address_space_t* _addr_space,
                                          procedure_t*     _entr_trace,
                                          procedure_t*     _exit_trace) const;
 
     // applies logic for all "is_*" and "can_*" checks below
     bool should_instrument() const;
+    bool should_coverage_instrument() const;
 
     // hard constraints
     bool is_instrumentable() const;       // checks whether can instrument
@@ -98,8 +106,10 @@ struct module_function
     bool is_overlapping() const;  // checks if func overlaps
 
 private:
+    bool is_loop_num_instructions_constrained() const;  // checks loop instr constraint
     bool is_loop_address_range_constrained() const;  // checks loop addr range constraint
     bool contains_dynamic_callsites() const;
+    bool should_instrument(bool _coverage) const;
 
 public:
     template <typename ArchiveT>
@@ -176,6 +186,7 @@ module_function::serialize(ArchiveT& ar, const unsigned)
         ar.setNextName("heuristics");
         ar.startNode();
         ar(cereal::make_nvp("should_instrument", should_instrument()),
+           cereal::make_nvp("should_coverage_instrument", should_coverage_instrument()),
            cereal::make_nvp("is_instrumentable", is_instrumentable()),
            cereal::make_nvp("can_instrument_entry", can_instrument_entry()),
            cereal::make_nvp("can_instrument_exit", can_instrument_exit()),