Adding pc sampling how to guide (#160)

* Adding pc sampling how to guide

* doc update

* Fixing indentation

* updating index

* udpating doc

* updating doc

* Added field information

* Fixing Formatting

* fix formatting error

* Added json format for pc sampling

* feedback resolved

* formatting for text

* PC Sampling API doc

* Reformatted

* Note for shared systems

* update docs

* correcting relative path for cross-referencing

---------

Co-authored-by: vlaindic_amdeng <vladimir.indic@amd.com>

source/docs/data/pc_sampling_host_trap.csv

@@ -0,0 +1,80 @@
+"Sample_Timestamp","Exec_Mask","Dispatch_Id","Instruction","Instruction_Comment","Correlation_Id"
+3464444413017201,65535,1,"s_endpgm","",1
+3464444413017201,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413018481,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413018481,65535,1,"s_endpgm","",1
+3464444413018481,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413018481,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413018481,65535,1,"s_endpgm","",1
+3464444413018481,65535,1,"s_endpgm","",1
+3464444413019601,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413019761,65535,1,"s_load_dword s8, s[4:5], 0x24","",1
+3464444413019761,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413019761,65535,1,"s_endpgm","",1
+3464444413019761,65535,1,"s_load_dword s8, s[4:5], 0x24","",1
+3464444413019761,65535,1,"s_endpgm","",1
+3464444413019761,65535,1,"s_endpgm","",1
+3464444413020881,65535,1,"s_endpgm","",1
+3464444413020881,65535,1,"s_endpgm","",1
+3464444413020881,65535,1,"s_endpgm","",1
+3464444413020881,65535,1,"s_waitcnt lgkmcnt(0)","",1
+3464444413020881,65535,1,"v_addc_co_u32_e32 v5, vcc, v1, v5, vcc","",1
+3464444413020881,65535,1,"s_endpgm","",1
+3464444413020881,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413020881,65535,1,"s_endpgm","",1
+3464444413020881,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413021041,65535,1,"s_endpgm","",1
+3464444413020881,65535,1,"v_bfe_u32 v0, v0, 10, 10","",1
+3464444413021041,65535,1,"s_endpgm","",1
+3464444413021041,65535,1,"s_endpgm","",1
+3464444413021041,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413021041,65535,1,"s_endpgm","",1
+3464444413021041,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413021041,65535,1,"s_endpgm","",1
+3464444413022001,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413022001,65535,1,"s_endpgm","",1
+3464444413022001,65535,1,"s_endpgm","",1
+3464444413022001,65535,1,"s_endpgm","",1
+3464444413022001,65535,1,"s_endpgm","",1
+3464444413022001,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413022001,65535,1,"s_endpgm","",1
+3464444413022001,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413022001,65535,1,"s_waitcnt lgkmcnt(0)","",1
+3464444413022161,65535,1,"s_endpgm","",1
+3464444413022161,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413022161,65535,1,"s_endpgm","",1
+3464444413022161,65535,1,"s_load_dword s8, s[4:5], 0x24","",1
+3464444413022161,65535,1,"global_store_dword v[0:1], v3, off","",1
+3464444413022161,65535,1,"s_endpgm","",1
+3464444413022161,65535,1,"s_endpgm","",1
+3464444413022161,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413022161,65535,1,"s_endpgm","",1
+3464444413022161,65535,1,"s_endpgm","",1
+3464444413022161,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413022161,65535,1,"s_endpgm","",1
+3464444413022321,65535,1,"s_load_dwordx4 s[0:3], s[4:5], 0x0","",1
+3464444413022161,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413022321,65535,1,"s_endpgm","",1
+3464444413022161,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413023281,65535,1,"s_endpgm","",1
+3464444413023281,65535,1,"s_endpgm","",1
+3464444413023281,65535,1,"v_ashrrev_i32_e32 v1, 31, v0","",1
+3464444413024561,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413023281,65535,1,"s_endpgm","",1
+3464444413024561,65535,1,"s_endpgm","",1
+3464444413023761,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413026321,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413024401,65535,1,"global_store_dword v[0:1], v3, off","",1
+3464444413027121,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413025041,65535,1,"v_add_co_u32_e32 v0, vcc, s0, v0","",1
+3464444413027761,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413025361,65535,1,"s_endpgm","",1
+3464444413027601,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413026321,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413028401,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413026481,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413028881,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413026641,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413028401,65535,1,"s_load_dword s8, s[4:5], 0x24","",1
+3464444413027281,65535,1,"s_waitcnt vmcnt(0)","",1
+3464444413029681,65535,1,"s_endpgm","",1

source/docs/data/pc_sampling_host_trap_debug.csv

@@ -0,0 +1,22 @@
+"Sample_Timestamp","Exec_Mask","Dispatch_Id","Instruction","Instruction_Comment","Correlation_Id"
+54155306462675,65535,1,"s_waitcnt lgkmcnt(0)","/opt/rocm/include/hip/amd_detail/amd_hip_runtime.h:275",1
+54155306462715,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306462755,65535,1,"s_endpgm","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:45",1
+54155306462755,65535,1,"s_endpgm","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:45",1
+54155306462955,65535,1,"s_endpgm","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:45",1
+54155306463035,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306463235,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306463315,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306463515,65535,1,"s_endpgm","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:45",1
+54155306463755,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306463875,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306464075,65535,1,"v_mov_b32_e32 v2, s4","/opt/rocm/include/hip/amd_detail/amd_hip_runtime.h:275",1
+54155306464155,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306464155,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306464275,65535,1,"s_endpgm","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:45",1
+54155306464395,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306464515,65535,1,"s_waitcnt lgkmcnt(0)","/opt/rocm/include/hip/amd_detail/amd_hip_runtime.h:275",1
+54155306464555,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306464595,65535,1,"s_waitcnt vmcnt(0)","/opt/rocm-6.4.0/share/hip/samples/2_Cookbook/0_MatrixTranspose/MatrixTranspose.cpp:44",1
+54155306464595,65535,1,"v_mov_b32_e32 v2, s6","/opt/rocm/include/hip/amd_detail/amd_hip_runtime.h:275",1
+54155306464595,65535,1,"s_waitcnt lgkmcnt(0)","/opt/rocm/include/hip/amd_detail/amd_hip_runtime.h:275",1