Split ROCTx API tables and update intercept table API (#421)

* Update include/rocprofiler-sdk

- buffer_tracing.h
  - fix doxygen for rocprofiler_buffer_tracing_hip_api_record_t
  - update doxygen for rocprofiler_buffer_tracing_marker_api_record_t
    - remove unused marker_id field
- fwd.h
  - Split ROCPROFILER_CALLBACK_TRACING_MARKER_API into ROCPROFILER_CALLBACK_TRACING_MARKER_{CORE,CONTROL,NAME}_API
  - Split ROCPROFILER_BUFFER_TRACING_MARKER_API into ROCPROFILER_BUFFER_TRACING_MARKER_{CORE,CONTROL,NAME}_API
  - split rocprofiler_runtime_library_t into rocprofiler_runtime_library_t and rocprofiler_intercept_table_t
    - after split of ROCTx into 3 tables, specifying rocprofiler_at_internal_thread_create became confusing

* Update include/rocprofiler-sdk-roctx/api_trace.h

- Split into three tables: core, control, and name
  - core: what it sounds like
  - control: functions for controling the profiler
  - name: functions for giving resources names

* Update lib/rocprofiler-sdk-roctx/roctx.cpp

- modifications following split into multiple tables

* Update lib/rocprofiler-sdk/marker/*

- modifications following split of ROCTx API into multiple intercept tables

* Update lib/rocprofiler-sdk/tests

- common.hpp
  - add enums to get_callback_tracing_names() and get_buffer_tracing_names()
- intercept_table.cpp
  - update test to use rocprofiler_intercept_table_t (and enums) instead of rocproifler_runtime_library_t
  - update OR combos tested
- roctx.cpp
  - updates following split of ROCTx API table into multiple tables
  - use simplified specification of control API

* Update lib/rocprofiler-sdk

- buffer_tracing.cpp
  - Updates for ROCPROFILER_BUFFER_TRACING_MARKER_{CORE,CONTROL,NAME}_API enum values
- callback_tracing.cpp
  - Updates for ROCPROFILER_CALLBACK_TRACING_MARKER_{CORE,CONTROL,NAME}_API enum values
- intercept_table.hpp
  - notify_runtime_api_registration -> notify_intercept_table_registration
- intercept_table.cpp
  - updates for new rocprofiler_intercept_table_t enum and new ROCTx tables
- registration.cpp
  - updates for new rocprofiler_intercept_table_t enum and new ROCTx tables
  - updates for notify_runtime_api_registration -> notify_intercept_table_registration

* Update lib/rocprofiler-sdk-tool

- helper.cpp
  - Updates for new enums in get_callback_id_names() and get_buffer_id_names()
- tool.cpp
  - migrate to new enums for split ROCTx tables
  - use simplified split for control table vs. core+name tables

* Update samples/{api_callback_tracing,intercept_table}

- intercept_table/client.cpp
  - rocprofiler_runtime_library_t -> rocprofiler_intercept_table_t
- api_callback_tracing/client.cpp
  - Updates for new enums in get_callback_id_names()
  - use simplified split for control table vs. core+name tables
  - migrate to new enums for split ROCTx tables

* Update tests

- rocprofv3/tracing/validate.py
  - handle new marker domain names
- tools/json-tool.cpp
  - Updates for new enums in get_callback_id_names() and get_buffer_id_names()
  - use simplified split for control table vs. core+name tables
  - migrate to new enums for split ROCTx tables

* Update tests/rocprofv3/tracing/CMakeLists.txt

- fix FAIL_REGULAR_EXPRESSION for rocprofv3-test-trace-execute

* Update lib/rocprofiler-sdk-tool/{output_file,tool}.*

- logging in output_file dtor
- support stdout/stderr

* Update lib/common/container/record_header_buffer.hpp

- reduce probability of is_empty() returning true while emplace is happening

* Update lib/rocprofiler-sdk-tool/tool.cpp

- logging for buffered_tracing_callback
- counter collection uses CSV encoder

* Update bin/rocprofv3

- remove -i flag from help menu

source/lib/rocprofiler-sdk/registration.cpp

@@ -657,8 +657,8 @@ rocprofiler_set_api_table(const char* name,
         // install rocprofiler API wrappers
         rocprofiler::hip::update_table(hip_runtime_api_table);
 
-        rocprofiler::intercept_table::notify_runtime_api_registration(
-            ROCPROFILER_HIP_RUNTIME_LIBRARY,
+        rocprofiler::intercept_table::notify_intercept_table_registration(
+            ROCPROFILER_HIP_RUNTIME_TABLE,
             lib_version,
             lib_instance,
             std::make_tuple(hip_runtime_api_table));
@@ -680,8 +680,8 @@ rocprofiler_set_api_table(const char* name,
         // install rocprofiler API wrappers
         rocprofiler::hip::update_table(hip_compiler_api_table);
 
-        rocprofiler::intercept_table::notify_runtime_api_registration(
-            ROCPROFILER_HIP_COMPILER_LIBRARY,
+        rocprofiler::intercept_table::notify_intercept_table_registration(
+            ROCPROFILER_HIP_COMPILER_TABLE,
             lib_version,
             lib_instance,
             std::make_tuple(hip_compiler_api_table));
@@ -715,30 +715,42 @@ rocprofiler_set_api_table(const char* name,
         rocprofiler::hsa::update_table(hsa_api_table);
 
         // allow tools to install API wrappers
-        rocprofiler::intercept_table::notify_runtime_api_registration(
-            ROCPROFILER_HSA_LIBRARY, lib_version, lib_instance, std::make_tuple(hsa_api_table));
+        rocprofiler::intercept_table::notify_intercept_table_registration(
+            ROCPROFILER_HSA_TABLE, lib_version, lib_instance, std::make_tuple(hsa_api_table));
     }
     else if(std::string_view{name} == "roctx")
     {
         // pass to roctx init
-        LOG_IF(ERROR, num_tables > 1)
+        LOG_IF(ERROR, num_tables >= 3)
             << " rocprofiler expected ROCTX library to pass 1 API table, not " << num_tables;
 
-        auto* roctx_api_table = static_cast<roctxApiTable_t*>(*tables);
+        auto* roctx_core = static_cast<roctxCoreApiTable_t*>(tables[0]);
+        auto* roctx_ctrl = static_cast<roctxControlApiTable_t*>(tables[1]);
+        auto* roctx_name = static_cast<roctxNameApiTable_t*>(tables[2]);
 
         // any internal modifications to the roctxApiTable_t need to be done before we make
         // the copy or else those modifications will be lost when ROCTx tracing is enabled because
         // the ROCTx tracing invokes the function pointers from the copy below
-        rocprofiler::marker::copy_table(roctx_api_table);
+        rocprofiler::marker::copy_table(roctx_core);
+        rocprofiler::marker::copy_table(roctx_ctrl);
+        rocprofiler::marker::copy_table(roctx_name);
 
         // install rocprofiler API wrappers
-        rocprofiler::marker::update_table(roctx_api_table);
+        rocprofiler::marker::update_table(roctx_core);
+        rocprofiler::marker::update_table(roctx_ctrl);
+        rocprofiler::marker::update_table(roctx_name);
 
-        rocprofiler::intercept_table::notify_runtime_api_registration(
-            ROCPROFILER_MARKER_LIBRARY,
+        rocprofiler::intercept_table::notify_intercept_table_registration(
+            ROCPROFILER_MARKER_CORE_TABLE, lib_version, lib_instance, std::make_tuple(roctx_core));
+
+        rocprofiler::intercept_table::notify_intercept_table_registration(
+            ROCPROFILER_MARKER_CONTROL_TABLE,
             lib_version,
             lib_instance,
-            std::make_tuple(roctx_api_table));
+            std::make_tuple(roctx_ctrl));
+
+        rocprofiler::intercept_table::notify_intercept_table_registration(
+            ROCPROFILER_MARKER_NAME_TABLE, lib_version, lib_instance, std::make_tuple(roctx_name));
     }
     else
     {