User api updates (#32)

* Update invoke.hpp

* Update OMNITRACE_FUNCTION

* Update library debug messages

* ptl verbosity

* Update timemory submodule

* mpi_gotcha calls omnitrace_finalize_hidden

* omnitrace_{push,pop}_region returns error code

* omnitrace-user updates

- doxygen documentation
- omnitrace_get_user_callbacks
- omnitrace_user_error_string
- omnitrace-user functions return error codes

* Update user-api example

* Tweak to workflows and tests

* Fix for OMNITRACE_FUNCTION

- conditional impl if __GNUC__ < 9

* focal-external-rocm workflow update

[ROCm/rocprofiler-systems commit: f6241af5ee]

projects/rocprofiler-systems/source/lib/omnitrace/src/library/api.cpp

@@ -21,6 +21,10 @@
 // SOFTWARE.
 
 #include "library/api.hpp"
+#include "library/debug.hpp"
+
+#include <exception>
+#include <stdexcept>
 
 extern "C" void
 omnitrace_push_trace(const char* _name)
@@ -34,16 +38,32 @@ omnitrace_pop_trace(const char* _name)
     omnitrace_pop_trace_hidden(_name);
 }
 
-extern "C" void
+extern "C" int
 omnitrace_push_region(const char* _name)
 {
-    omnitrace_push_region_hidden(_name);
+    try
+    {
+        omnitrace_push_region_hidden(_name);
+    } catch(std::exception& _e)
+    {
+        OMNITRACE_VERBOSE_F(1, "Exception caught: %s\n", _e.what());
+        return -1;
+    }
+    return 0;
 }
 
-extern "C" void
+extern "C" int
 omnitrace_pop_region(const char* _name)
 {
-    omnitrace_pop_region_hidden(_name);
+    try
+    {
+        omnitrace_pop_region_hidden(_name);
+    } catch(std::exception& _e)
+    {
+        OMNITRACE_VERBOSE_F(1, "Exception caught: %s\n", _e.what());
+        return -1;
+    }
+    return 0;
 }
 
 extern "C" void