Separate agent cache from queue controller (#145)

* Update lib/rocprofiler/agent.{hpp,cpp}

- get_agents() function for internal access to agent pointers

* Update AgentCache

- make member variables and member functions distinguish b/t hsa agent and rocprofiler agent clear

* Change ctor of AgentCache

* Update lib/rocprofiler/hsa/queue_controller.cpp

- QueueController::init uses agent::get_agent_cache

* Update lib/rocprofiler/hsa/agent_cache.*

- member function to get index
- operator== for rocprofiler_agent_t and hsa_agent_t
- removed hsa_iterate_agents from ctor (now in agent.cpp)

* Update lib/rocprofiler/agent.*

- construct_agent_cache function
- functions for rocprofiler agent <-> HSA agent
- functions for getting agent cache

* Update lib/rocprofiler/registration.cpp

- invoke construct_agent_cache when HSA table is receieved

* Update lib/rocprofiler/agent.cpp

- loosen failure conditions
- handle spurious duplicate entry warning

* Update lib/rocprofiler/agent.cpp

- improve read_map diagnostics

* Update lib/rocprofiler/agent.cpp

- avoid infinite loop in read_map

* Update lib/rocprofiler/agent.cpp

- handle empty kfd node properties file

* Update lib/rocprofiler/agent.cpp

- check for permissions to read a node properties file

* Update lib/rocprofiler/agent.cpp

- more checks on file readability

* Update lib/rocprofiler/tests/agent.cpp

- print virtual kfd topology

* Update lib/rocprofiler/tests/agent.cpp

- verify id.handle == hsa_agent internal node id

* Update lib/rocprofiler/tests/agent.cpp

- check node_id
- check location id
- check device id
- update abi test

* Update include/rocprofiler/agent.h

- add node_id field
- add reserved0 field to ensure new field increases struct size

* Update lib/rocprofiler/agent.cpp

- node_id instead of id.handle

* Update lib/rocprofiler/agent_cache.cpp

- node_id instead of id.handle

* Update samples/pc_sampling

- node_id for agent instead of id.handle

* Update lib/rocprofiler/buffer.cpp

- remove debug prints

[ROCm/rocprofiler-sdk commit: 7f631de401]

projects/rocprofiler-sdk/source/lib/rocprofiler/aql/tests/aql_test.cpp

@@ -60,7 +60,7 @@ TEST(aql_profile, construct_packets)
         auto agents = rocprofiler::hsa::get_queue_controller().get_supported_agents();
         for(const auto& [_, agent] : agents)
         {
-            LOG(WARNING) << fmt::format("Found Agent: {}", agent.get_agent().handle);
+            LOG(WARNING) << fmt::format("Found Agent: {}", agent.get_hsa_agent().handle);
             auto metrics = rocprofiler::findDeviceMetrics(agent, {"SQ_WAVES"});
             ASSERT_EQ(metrics.size(), 1);
             AQLPacketConstruct(agent, metrics);
@@ -82,7 +82,7 @@ TEST(aql_profile, too_many_counters)
 
         for(const auto& [_, agent] : agents)
         {
-            LOG(WARNING) << fmt::format("Found Agent: {}", agent.get_agent().handle);
+            LOG(WARNING) << fmt::format("Found Agent: {}", agent.get_hsa_agent().handle);
 
             auto metrics = rocprofiler::findDeviceMetrics(agent, {});
             EXPECT_THROW(