This sample is a simple LD_PRELOAD based tool that allows to collect oneAPI Level Zero kernel sources, binaries and symbols to correlate them. This tool works for Intel(R) Processor Graphics only.
As a result, listing like the following will be printed for each kernel (once per kernel creation):
===== Kernel: GEMM =====
=== File: Unknown ===
[0x003B0] illegal
=== File: .//////////////////////////////////gemm.cl ===
[0x000D0] mul (16|M0) r118.0<1>:d r120.0<8;8,1>:d r8.6<0;1,0>:d {Compacted}
[0x000D8] mul (16|M16) r16.0<1>:d r14.0<8;8,1>:d r8.6<0;1,0>:d
[ 1] __kernel void GEMM(__global float* a, __global float* b,
[0x00000] (W) mov (8|M0) r5.0<1>:ud r0.0<1;1,0>:ud
[0x00010] (W) or (1|M0) cr0.0<1>:ud cr0.0<0;1,0>:ud 0x4C0:uw {Switch}
[0x00020] (W) mul (1|M0) r6.0<1>:d r9.3<0;1,0>:d r5.6<0;1,0>:d
[0x00030] (W) mul (1|M0) r126.0<1>:d r9.2<0;1,0>:d r5.1<0;1,0>:d
[ 2] __global float* c, int size) {
[ 3] int j = get_global_id(0);
[ 4] int i = get_global_id(1);
[ 5] float sum = 0.0f;
[ 6] for (int k = 0; k < size; ++k) {
[0x00040] (W) cmp (16|M0) (gt)f1.0 null<1>:d r8.6<0;1,0>:d 0:w
[0x00050] (W) cmp (16|M16) (gt)f1.0 null<1>:d r8.6<0;1,0>:d 0:w
[0x00060] add (16|M0) r120.0<1>:d r6.0<0;1,0>:d r3.0<16;16,1>:uw
[0x00070] add (16|M16) r14.0<1>:d r6.0<0;1,0>:d r4.0<16;16,1>:uw
[0x00080] add (16|M0) r10.0<1>:d r126.0<0;1,0>:d r1.0<16;16,1>:uw
[0x00090] add (16|M16) r124.0<1>:d r126.0<0;1,0>:d r2.0<16;16,1>:uw
[0x000A0] add (16|M0) r120.0<1>:d r120.0<8;8,1>:d r7.1<0;1,0>:d {Compacted}
[0x000A8] add (16|M16) r14.0<1>:d r14.0<8;8,1>:d r7.1<0;1,0>:d
[0x000B8] add (16|M0) r12.0<1>:d r10.0<8;8,1>:d r7.0<0;1,0>:d {Compacted}
[0x000C0] add (16|M16) r122.0<1>:d r124.0<8;8,1>:d r7.0<0;1,0>:d
[0x000E8] (W&f1.0) jmpi L296
[0x000F8] mov (16|M0) r116.0<1>:f 0.0:f
[0x00108] mov (16|M16) r18.0<1>:f 0.0:f
[0x00118] (W) jmpi L664
[0x00128] mov (16|M0) r116.0<1>:f 0.0:f
[0x00138] mov (16|M16) r18.0<1>:f 0.0:f
[0x00148] (W) mov (1|M0) r126.1<1>:d 0:w
[0x00180] (W) add (1|M0) r126.1<1>:d r126.1<0;1,0>:d 1:w
[0x00228] (W) cmp (16|M0) (lt)f0.0 null<1>:d r126.1<0;1,0>:d r8.6<0;1,0>:d
[0x00268] (W) cmp (16|M16) (lt)f0.0 null<1>:d r126.1<0;1,0>:d r8.6<0;1,0>:d
[0x00288] (W&f0.0) jmpi L344
[ 7] sum += a[i * size + k] * b[k * size + j];
[0x00158] (W) mul (1|M0) r126.2<1>:d r126.1<0;1,0>:d r8.6<0;1,0>:d
[0x00168] add (16|M0) r20.0<1>:d r118.0<8;8,1>:d r126.1<0;1,0>:d {Compacted}
[0x00170] add (16|M16) r114.0<1>:d r16.0<8;8,1>:d r126.1<0;1,0>:d
[0x00190] add (16|M0) r26.0<1>:d r126.2<0;1,0>:d r12.0<8;8,1>:d {Compacted}
[0x00198] add (16|M16) r112.0<1>:d r126.2<0;1,0>:d r122.0<8;8,1>:d
[0x001A8] shl (16|M0) r20.0<1>:d r20.0<8;8,1>:d 2:w
[0x001B8] shl (16|M16) r114.0<1>:d r114.0<8;8,1>:d 2:w
[0x001C8] shl (16|M0) r26.0<1>:d r26.0<8;8,1>:d 2:w
[0x001D8] shl (16|M16) r112.0<1>:d r112.0<8;8,1>:d 2:w
[0x001E8] add (16|M0) r20.0<1>:d r20.0<8;8,1>:d r8.7<0;1,0>:d {Compacted}
[0x001F0] add (16|M16) r114.0<1>:d r114.0<8;8,1>:d r8.7<0;1,0>:d
[0x00200] add (16|M0) r26.0<1>:d r26.0<8;8,1>:d r9.0<0;1,0>:d {Compacted}
[0x00208] add (16|M16) r112.0<1>:d r112.0<8;8,1>:d r9.0<0;1,0>:d
[0x00218] send (16|M0) r22:w r20 0xC 0x04205E00 // wr:2+0, rd:2; hdc.dc1; untyped surface read with x
[0x00238] send (16|M16) r24:w r114 0xC 0x04205E00 // wr:2+0, rd:2; hdc.dc1; untyped surface read with x
[0x00248] send (16|M0) r109:w r26 0xC 0x04205E01 // wr:2+0, rd:2; hdc.dc1; untyped surface read with x
[0x00258] send (16|M16) r107:w r112 0xC 0x04205E01 // wr:2+0, rd:2; hdc.dc1; untyped surface read with x
[0x00278] mad (16|M0) r116.0<1>:f r116.0<2;1>:f r22.0<2;1>:f r109.0<1>:f {Compacted}
[0x00280] mad (16|M16) r18.0<1>:f r18.0<2;1>:f r24.0<2;1>:f r107.0<1>:f {Compacted}
[ 8] }
[ 9] c[i * size + j] = sum;
[0x00298] add (16|M0) r28.0<1>:d r118.0<8;8,1>:d r12.0<8;8,1>:d {Compacted}
[0x002A0] add (16|M16) r105.0<1>:d r16.0<8;8,1>:d r122.0<8;8,1>:d
[0x002B8] shl (16|M0) r28.0<1>:d r28.0<8;8,1>:d 2:w
[0x002C8] shl (16|M16) r105.0<1>:d r105.0<8;8,1>:d 2:w
[0x002D8] add (16|M0) r28.0<1>:d r28.0<8;8,1>:d r9.1<0;1,0>:d {Compacted}
[0x002E0] add (16|M16) r105.0<1>:d r105.0<8;8,1>:d r9.1<0;1,0>:d
[0x002F0] sends (16|M0) null:w r28 r116 0x8C 0x04025E02 // wr:2+2, rd:0; hdc.dc1; untyped surface write with x
[0x00300] sends (16|M16) null:w r105 r18 0x8C 0x04025E02 // wr:2+2, rd:0; hdc.dc1; untyped surface write with x
[ 10] }
[0x002B0] (W) mov (8|M0) r127.0<1>:ud r5.0<8;8,1>:ud {Compacted}
[0x00310] (W) send (8|M0) null r127 0x27 0x02000010 {EOT} // wr:1+0, rd:0; spawner; end of thread
[0x00320] illegal
[0x00330] illegal
[0x00340] illegal
[0x00350] illegal
[0x00360] illegal
[0x00370] illegal
[0x00380] illegal
[0x00390] illegal
[0x003A0] illegal
Note: to collect debug information for DPC++ application one need to compile it with -gline-tables-only flag.
- Linux
- Windows (under development)
- CMake (version 3.12 and above)
- Git (version 1.8 and above)
- Python (version 2.7 and above)
- oneAPI Level Zero loader
- Intel(R) Graphics Compute Runtime for oneAPI Level Zero and OpenCL(TM) Driver
Note: This sample does not support IGC's latest binary format (ZEBinary).
To use this sample, run export IGC_EnableZEBinary=0 before running the sample.
Run the following commands to build the sample:
cd <pti>/samples/ze_debug_info
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
makeUse this command line to run the tool:
./ze_debug_info <target_application>One may use ze_gemm as target application:
./ze_debug_info ../../ze_gemm/build/ze_gemmUse Microsoft* Visual Studio x64 command prompt to run the following commands and build the sample:
cd <pti>\samples\ze_debug_info
mkdir build
cd build
cmake -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_LIBRARY_PATH=<level_zero_loader>\lib;<iga_lib_path> -DCMAKE_INCLUDE_PATH=<level_zero_loader>\include ..
nmakeUse this command line to run the tool:
ze_debug_info.exe <target_application>One may use ze_gemm as target application:
ze_debug_info.exe ..\..\ze_gemm\build\ze_gemm.exeNote: to build this sample one may need to generate *.lib file from IGA *.dll (see here for details) and provide the path to this *.lib to cmake with -DCMAKE_LIBRARY_PATH.
Also one may need to add an actual path to IGA *.dll into PATH before sample run, e.g.:
set PATH=%PATH%;<iga_dll_path>
ze_debug_info.exe ..\..\ze_gemm\build\ze_gemm.exe