[SDK] Release 1.0 Public API Modifications (#277)

* Make sure all structs/enums can be forward declared

* Updates to counter collection

- consistency updates and cleanup

* Conversion of dimension information to info struct

* Added deprecated folder

* Testing changes

* merge changes

* Fix shadowed variable

* Source code formatting

* Fix shadowed variable

* Update rocprofiler_counter_info_v1_t member names

* Split version.h into version.h and ext_version.h

- ext_version.h contains external version info, e.g. ROCPROFILER_HSA_API_TABLE_MAJOR_VERSION, ROCPROFILER_HSA_RUNTIME_VERSION
- this reduces amount of recompilation after a commit since version.h gets updated with the git revision

* profile_config -> counter_config

* EOF new line

* [Samples] Reduce header includes + reorg counter collection samples

* Misc compilation fixes

- shadowed variables
- use of [[deprecated("...")]] in C code
- unused variables

* Minor misc modifications

- use common:: instead of rocprofiler::common:: when inside rocprofiler namespace
- counters.cpp
  - move local anon namespace functions into rocprofiler::counters:: anon namespace
  - use std::string_view for get_static_string
  - const ref for get_static_ptr
  - misc namespace shortening

* [Public API] rocprofiler_get_version_triplet + rocprofiler_version_triplet_t

- struct rocprofiler_version_triplet_t containing fields for the major, minor, and patch version
- public API function: rocprofiler_get_version_triplet
- define C++ operators for rocprofiler_version_triplet_t
- C++ function compute_version_triplet

* [Tests] Improve async-copy-testing test

- relax constraints
- improve logging

* Update counter_config.h doxygen docs

* ROCPROFILER_SDK_BETA_COMPAT

- ppdef which helps with renaming when set to 1

* Remove spurious include

* Fix includes for cxx/version.hpp

* Doxygen fixes for rocprofiler_get_version and rocprofiler_get_version_triplet

* Public API Experimental Designation

- ROCPROFILER_SDK_EXPERIMENTAL added to experimental function
- "(experimental)" added to doxygen @brief entries

* Fix use of assert instead of static_assert in hip/stream.cpp

* Use typedef instead of define for rocprofiler_profile_config_id_t

* Use inline rocprofiler_{create,destroy}_profile_config instead of ppdef

- added <rocprofiler-sdk/deprecated/profile_config.h>

* Doxygen for rocprofiler_{create,destroy}_profile_config

* ROCPROFILER_SDK_DEPRECATED_WARNINGS

* Temporarily comment out ROCPROFILER_SDK_DEPRECATED_WARNINGS=1

* cmake formatting

* Misc variable renaming in samples and tests

* Fix declarations of types

* Fix hip stream tracing service struct name

- rocprofiler_callback_tracing_stream_handle_data_t renamed to rocprofiler_callback_tracing_hip_stream_api_data_t

* Rename "HIP_STREAM_API" to "HIP_STREAM"

---------

Co-authored-by: Jonathan R. Madsen <jonathanrmadsen@gmail.com>
Co-authored-by: Benjamin Welton <bewelton@amd.com>

source/lib/rocprofiler-sdk/counters/controller.cpp

@@ -46,12 +46,12 @@ CounterController::CounterController()
 // Note: these profiles can be used across multiple contexts
 //       and are independent of the context.
 uint64_t
-CounterController::add_profile(std::shared_ptr<profile_config>&& config)
+CounterController::add_profile(std::shared_ptr<counter_config>&& config)
 {
     static std::atomic<uint64_t> profile_val = 1;
     uint64_t                     ret         = 0;
     _configs.wlock([&](auto& data) {
-        config->id = rocprofiler_profile_config_id_t{.handle = profile_val};
+        config->id = rocprofiler_counter_config_id_t{.handle = profile_val};
         data.emplace(profile_val, std::move(config));
         ret = profile_val;
         profile_val++;
@@ -66,11 +66,11 @@ CounterController::destroy_profile(uint64_t id)
 }
 
 rocprofiler_status_t
-CounterController::configure_agent_collection(rocprofiler_context_id_t context_id,
-                                              rocprofiler_buffer_id_t  buffer_id,
-                                              rocprofiler_agent_id_t   agent_id,
-                                              rocprofiler_device_counting_service_callback_t cb,
-                                              void* user_data)
+CounterController::configure_agent_collection(rocprofiler_context_id_t                 context_id,
+                                              rocprofiler_buffer_id_t                  buffer_id,
+                                              rocprofiler_agent_id_t                   agent_id,
+                                              rocprofiler_device_counting_service_cb_t cb,
+                                              void*                                    user_data)
 {
     auto* ctx_p = rocprofiler::context::get_mutable_registered_context(context_id);
     if(!ctx_p) return ROCPROFILER_STATUS_ERROR_CONTEXT_INVALID;
@@ -127,13 +127,12 @@ CounterController::configure_agent_collection(rocprofiler_context_id_t context_i
 // the AQL packet generator for injecting packets. Note: the service is created
 // in the stop state.
 rocprofiler_status_t
-CounterController::configure_dispatch(
-    rocprofiler_context_id_t                         context_id,
-    rocprofiler_buffer_id_t                          buffer,
-    rocprofiler_dispatch_counting_service_callback_t callback,
-    void*                                            callback_args,
-    rocprofiler_profile_counting_record_callback_t   record_callback,
-    void*                                            record_callback_args)
+CounterController::configure_dispatch(rocprofiler_context_id_t                   context_id,
+                                      rocprofiler_buffer_id_t                    buffer,
+                                      rocprofiler_dispatch_counting_service_cb_t callback,
+                                      void*                                      callback_args,
+                                      rocprofiler_dispatch_counting_record_cb_t  record_callback,
+                                      void* record_callback_args)
 {
     auto* ctx_p = rocprofiler::context::get_mutable_registered_context(context_id);
     if(!ctx_p) return ROCPROFILER_STATUS_ERROR_CONTEXT_INVALID;
@@ -169,10 +168,10 @@ CounterController::configure_dispatch(
     return ROCPROFILER_STATUS_SUCCESS;
 }
 
-std::shared_ptr<profile_config>
-CounterController::get_profile_cfg(rocprofiler_profile_config_id_t id)
+std::shared_ptr<counter_config>
+CounterController::get_profile_cfg(rocprofiler_counter_config_id_t id)
 {
-    std::shared_ptr<profile_config> cfg;
+    std::shared_ptr<counter_config> cfg;
     _configs.rlock([&](const auto& map) { cfg = map.at(id.handle); });
     return cfg;
 }
@@ -185,10 +184,10 @@ get_controller()
 }
 
 rocprofiler_status_t
-create_counter_profile(std::shared_ptr<profile_config> config)
+create_counter_profile(std::shared_ptr<counter_config> config)
 {
     auto status = ROCPROFILER_STATUS_SUCCESS;
-    if(status = counters::counter_callback_info::setup_profile_config(config);
+    if(status = counters::counter_callback_info::setup_counter_config(config);
        status != ROCPROFILER_STATUS_SUCCESS)
     {
         return status;
@@ -210,8 +209,8 @@ destroy_counter_profile(uint64_t id)
     get_controller().destroy_profile(id);
 }
 
-std::shared_ptr<profile_config>
-get_profile_config(rocprofiler_profile_config_id_t id)
+std::shared_ptr<counter_config>
+get_counter_config(rocprofiler_counter_config_id_t id)
 {
     try
     {