Generalized updates (#174)

- include/rocprofiler/agent.h
  - move rocprofiler_dim3_t
- include/rocprofiler/buffer_tracing.h
  - size fields
  - update kernel dispatch record
- include/rocprofiler/callback_tracing.h
  - remove rocprofiler_callback_tracing_code_object_unload_data_t
  - remove rocprofiler_callback_tracing_code_object_register_host_kernel_symbol_data_t
- include/rocprofiler/fwd.h
  - added ROCPROFILER_STATUS_ERROR_CONTEXT_CONFLICT
  - remove ROCPROFILER_CALLBACK_TRACING_CODE_OBJECT_UNLOAD
  - remove ROCPROFILER_CALLBACK_TRACING_CODE_OBJECT_DEVICE_KERNEL_SYMBOL_UNREGISTER
  - add rocprofiler_kernel_id_t typedef
  - add rocprofiler_dim3_t (moved from agent.h)
- lib/common/synchronized.hpp
  - rlock/wlock return decltype(auto)
  - separate prototype from definition
- lib/common/utility.{hpp,cpp}
  - timestamp functions replicating HSA implementation(s)
  - init_public_api_struct for setting size field and ensuring certain type traits
  - simplified static_cleanup_wrapper
  - separate prototype from definition in active_capacity_gate
- lib/rocprofiler/agent.cpp
  - tweak get_rocprofiler_agent impl
- lib/rocprofiler/buffer.cpp
  - fix buffer message log level
- lib/rocprofiler/context.cpp
  - use new paradigm for getting active contexts
- lib/rocprofiler/internal_threading.hpp
  - update to simplified static_cleanup_wrapper implementation
- lib/rocprofiler/registration.cpp
  - fix deactivating contexts
- lib/rocprofiler/rocprofiler.cpp
  - status string for context conflict
- lib/rocprofiler/context/context.*
  - correlation_id struct
  - new get_active_contexts paradigm
- lib/rocprofiler/counters/core.*
  - rocprofiler_packet union
  - tweak start/stop context to accept pointer instead of handle
- lib/rocprofiler/counters/dimensions.cpp
  - update to new get_rocp_agent() return type
- lib/rocprofiler/hsa/hsa.*
  - update to new get_active_contexts paradigm
  - update to new correlation id implementation
  - guard against hsa.def.cpp direct compilation
- lib/rocprofiler/hsa/queue_controller.*
  - update to change in get_rocp_agent return type
  - consistent aliases
  - lookup function for getting queue pointer from hsa queue id
- lib/rocprofiler/hsa/queue.*
  - rocprofiler_packet
  - extend queue_info_session_t
- lib/rocprofiler/tests/registration.cpp
  - improve diagnostic on perf check for rocprofiler_lib.callback_registration_lambda_with_result

source/lib/rocprofiler/context/context.hpp

@@ -46,12 +46,53 @@ using external_cid_cb_t = uint64_t (*)(rocprofiler_service_callback_tracing_kind
                                        uint32_t,
                                        uint64_t);
 
+constexpr auto null_user_data = rocprofiler_user_data_t{.value = 0};
+struct correlation_id
+{
+    // reference count starts at 5:
+    // - decrement after begin callback/buffer API
+    // - decrement after end callback/buffer API
+    // - decrement after kernel dispatch/HW counters
+    // - if PC sampling is not enabled, we can "retire" correlation id at ref count at 2
+    // - if PC sampling is enabled, we decrement after each HSA buffer flush once ref count hits 2
+    //   - after the kernel dispatch completes, we know no more PC samples will be generated and
+    //     thus, after two HSA buffer flushes, we will have received all the PC samples for
+    //     the
+    correlation_id(uint32_t _cnt, rocprofiler_thread_id_t _tid, uint64_t _internal) noexcept
+    : ref_count{_cnt}
+    , thread_idx{_tid}
+    , internal{_internal}
+    {}
+
+    correlation_id()                              = default;
+    ~correlation_id()                             = default;
+    correlation_id(correlation_id&& val) noexcept = delete;
+    correlation_id(const correlation_id&)         = delete;
+
+    correlation_id& operator=(const correlation_id&) = delete;
+    correlation_id& operator=(correlation_id&&) noexcept = delete;
+
+    std::atomic<uint32_t>   ref_count  = {};
+    rocprofiler_thread_id_t thread_idx = 0;
+    uint64_t                internal   = 0;
+};
+
+correlation_id*
+get_correlation_id(rocprofiler_thread_id_t tid, uint64_t internal_id);
+
+// latest correlation id for thread
+correlation_id*
+get_latest_correlation_id();
+
+void
+pop_latest_correlation_id(const correlation_id*);
+
 /// permits tools opportunity to modify the correlation id based on the domain, op, and
 /// the rocprofiler generated correlation id
 struct correlation_tracing_service
 {
     external_correlation::external_correlation external_correlator = {};
-    static uint64_t                            get_unique_internal_id();
+    static correlation_id*                     construct(uint32_t init_ref_count);
 };
 
 struct callback_tracing_service
@@ -139,8 +180,20 @@ using active_context_vec_t = common::container::stable_vector<std::atomic<const
 unique_context_vec_t&
 get_registered_contexts();
 
-active_context_vec_t&
-get_active_contexts();
+using context_filter_t = bool (*)(const context*);
+
+inline bool
+default_context_filter(const context* val)
+{
+    return (val != nullptr);
+}
+
+std::vector<const context*>&
+get_active_contexts(std::vector<const context*>& data,
+                    context_filter_t             filter = default_context_filter);
+
+std::vector<const context*>
+get_active_contexts(context_filter_t filter = default_context_filter);
 
 void deactivate_client_contexts(rocprofiler_client_id_t);