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

[ROCm/rocprofiler-sdk commit: 9efafc4d23]

projects/rocprofiler-sdk/source/include/rocprofiler-sdk-roctx/api_trace.h

@@ -35,6 +35,15 @@ ROCTX_EXTERN_C_INIT
 #define ROCTX_API_TABLE_VERSION_MAJOR 0
 #define ROCTX_API_TABLE_VERSION_STEP  0
 
+#define ROCTX_CORE_API_TABLE_VERSION_MAJOR 0
+#define ROCTX_CORE_API_TABLE_VERSION_STEP  0
+
+#define ROCTX_CONTROL_API_TABLE_VERSION_MAJOR 0
+#define ROCTX_CONTROL_API_TABLE_VERSION_STEP  0
+
+#define ROCTX_RESOURCE_API_TABLE_VERSION_MAJOR 0
+#define ROCTX_RESOURCE_API_TABLE_VERSION_STEP  0
+
 typedef uint64_t roctx_range_id_t;
 typedef void (*roctxMarkA_fn_t)(const char* message);
 typedef int (*roctxRangePushA_fn_t)(const char* message);
@@ -49,21 +58,31 @@ typedef int (*roctxNameHipDevice_fn_t)(const char* name, int device_id);
 typedef int (*roctxNameHipStream_fn_t)(const char* name, const struct ihipStream_t* stream);
 typedef int (*roctxGetThreadId_fn_t)(roctx_thread_id_t* tid);
 
-typedef struct roctxApiTable_t
+typedef struct roctxCoreApiTable_t
+{
+    uint64_t              size;
+    roctxMarkA_fn_t       roctxMarkA_fn;
+    roctxRangePushA_fn_t  roctxRangePushA_fn;
+    roctxRangePop_fn_t    roctxRangePop_fn;
+    roctxRangeStartA_fn_t roctxRangeStartA_fn;
+    roctxRangeStop_fn_t   roctxRangeStop_fn;
+    roctxGetThreadId_fn_t roctxGetThreadId_fn;
+} roctxCoreApiTable_t;
+
+typedef struct roctxControlApiTable_t
 {
     uint64_t                 size;
-    roctxMarkA_fn_t          roctxMarkA_fn;
-    roctxRangePushA_fn_t     roctxRangePushA_fn;
-    roctxRangePop_fn_t       roctxRangePop_fn;
-    roctxRangeStartA_fn_t    roctxRangeStartA_fn;
-    roctxRangeStop_fn_t      roctxRangeStop_fn;
     roctxProfilerPause_fn_t  roctxProfilerPause_fn;
     roctxProfilerResume_fn_t roctxProfilerResume_fn;
-    roctxNameOsThread_fn_t   roctxNameOsThread_fn;
-    roctxNameHsaAgent_fn_t   roctxNameHsaAgent_fn;
-    roctxNameHipDevice_fn_t  roctxNameHipDevice_fn;
-    roctxNameHipStream_fn_t  roctxNameHipStream_fn;
-    roctxGetThreadId_fn_t    roctxGetThreadId_fn;
-} roctxApiTable_t;
+} roctxControlApiTable_t;
+
+typedef struct roctxNameApiTable_t
+{
+    uint64_t                size;
+    roctxNameOsThread_fn_t  roctxNameOsThread_fn;
+    roctxNameHsaAgent_fn_t  roctxNameHsaAgent_fn;
+    roctxNameHipDevice_fn_t roctxNameHipDevice_fn;
+    roctxNameHipStream_fn_t roctxNameHipStream_fn;
+} roctxNameApiTable_t;
 
 ROCTX_EXTERN_C_FINI