Support Tool Intercept API Tables (#165)

* Update include/rocprofiler

- intercept_table.h header
- generic rocprofiler_runtime_library_t
- rocprofiler_internal_thread_library_t is not typedef for rocprofiler_runtime_library_t
- rocprofiler_at_runtime_api_registration

* Update lib/rocprofiler

- minor tweaks to context.cpp
  - check if none context early
  - disallow stop_context when finalizing
- add intercept_table.hpp and intercept_table.cpp
  - implement rocprofiler_at_runtime_api_registration
  - implement notify_runtime_api_registration
- update registration.cpp
  - invoke notify_runtime_api_registration
  - tweak to fini status when invoking client finalizer

* Update lib/rocprofiler/tests

- add tests for intercept table

* Add samples/intercept_table

- demonstrate how to install custom API function wrappers instead of relying on HSA callback tracing

* Update lib/rocprofiler/tests/intercept_table.cpp

- remove _SERVICE from ROCPROFILER_SERVICE_

* Update include/rocprofiler/intercept_table.h

- Update doxygen comments

* Update lib/rocprofiler/intercept_table.cpp

- return error config locked if already initialized

* Update lib/rocprofiler/intercept_table.cpp

- remove unnecessary alias

* Apply suggestions from code review

Co-authored-by: Tony Tye <Tony.Tye@amd.com>

* Update doxygen comments

- clarify when rocprofiler_at_runtime_api_registration can be invoked

* Use rocprofiler_runtime_library_t for intercept table and internal threading

- remove rocprofiler_intercept_library_t alias to rocprofiler_runtime_library_t
- remove rocprofiler_internal_thread_library_t alias to rocprofiler_runtime_library_t
- move around documentation with regard to rocprofiler_runtime_library_t enumeration
- added some extra doxygen documentation to internal threading functions

---------

Co-authored-by: Tony Tye <Tony.Tye@amd.com>

source/lib/rocprofiler/context.cpp

@@ -21,6 +21,7 @@
 // SOFTWARE.
 
 #include <rocprofiler/context.h>
+#include <rocprofiler/fwd.h>
 #include <rocprofiler/rocprofiler.h>
 
 #include "lib/rocprofiler/context/context.hpp"
@@ -31,12 +32,17 @@
 #include <atomic>
 #include <vector>
 
+namespace
+{
+constexpr auto rocprofiler_context_none = ROCPROFILER_CONTEXT_NONE;
+}
+
 extern "C" {
 rocprofiler_status_t
 rocprofiler_create_context(rocprofiler_context_id_t* context_id)
 {
     // always set to none first
-    *context_id = ROCPROFILER_CONTEXT_NONE;
+    *context_id = rocprofiler_context_none;
 
     if(rocprofiler::registration::get_init_status() > -1)
         return ROCPROFILER_STATUS_ERROR_CONFIGURATION_LOCKED;
@@ -50,12 +56,22 @@ rocprofiler_create_context(rocprofiler_context_id_t* context_id)
 rocprofiler_status_t
 rocprofiler_start_context(rocprofiler_context_id_t context_id)
 {
+    if(context_id.handle == rocprofiler_context_none.handle)
+        return ROCPROFILER_STATUS_ERROR_CONTEXT_NOT_FOUND;
+
+    // if currently finalizing or finalized, don't allow starting a context
+    if(rocprofiler::registration::get_fini_status() != 0)
+        return ROCPROFILER_STATUS_ERROR_CONFIGURATION_LOCKED;
+
     return rocprofiler::context::start_context(context_id);
 }
 
 rocprofiler_status_t
 rocprofiler_stop_context(rocprofiler_context_id_t context_id)
 {
+    if(context_id.handle == rocprofiler_context_none.handle)
+        return ROCPROFILER_STATUS_ERROR_CONTEXT_NOT_FOUND;
+
     return rocprofiler::context::stop_context(context_id);
 }
 
@@ -63,6 +79,10 @@ rocprofiler_status_t
 rocprofiler_context_is_active(rocprofiler_context_id_t context_id, int* status)
 {
     *status = 0;
+
+    if(context_id.handle == rocprofiler_context_none.handle)
+        return ROCPROFILER_STATUS_ERROR_CONTEXT_NOT_FOUND;
+
     for(const auto& itr : rocprofiler::context::get_active_contexts())
     {
         const auto* cfg = itr.load(std::memory_order_relaxed);
@@ -79,6 +99,10 @@ rocprofiler_status_t
 rocprofiler_context_is_valid(rocprofiler_context_id_t context_id, int* status)
 {
     *status = 0;
+
+    if(context_id.handle == rocprofiler_context_none.handle)
+        return ROCPROFILER_STATUS_ERROR_CONTEXT_NOT_FOUND;
+
     for(const auto& itr : rocprofiler::context::get_registered_contexts())
     {
         if(itr && itr->context_idx == context_id.handle)