[SYCL][E2E] Add a test to track UNSUPPORTED tests

sycl/test-e2e/Assert/assert_in_kernels.cpp

@@ -1,7 +1,7 @@
 // REQUIRES: linux
 
-// https://github.com/intel/llvm/issues/7634
 // UNSUPPORTED: hip
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/7634
 //
 // XFAIL: (opencl && gpu)
 // XFAIL-TRACKER: https://github.com/intel/llvm/issues/11364

sycl/test-e2e/Assert/assert_in_multiple_tus.cpp

@@ -1,16 +1,16 @@
 // REQUIRES: linux
 
-// https://github.com/intel/llvm/issues/7634
 // UNSUPPORTED: hip
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/7634
 //
-// https://github.com/intel/llvm/issues/8832
 // UNSUPPORTED: cuda
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/8832
 //
 // XFAIL: (opencl && gpu)
 // XFAIL-TRACKER: https://github.com/intel/llvm/issues/11364
 
-// https://github.com/intel/llvm/issues/15029
 // UNSUPPORTED: gpu-intel-dg2
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/15029
 
 // RUN: %{build} -DSYCL_FALLBACK_ASSERT=1 -I %S/Inputs %S/Inputs/kernels_in_file2.cpp -o %t.out
 // RUN: %{run} %t.out &> %t.txt ; FileCheck %s --input-file %t.txt %if fpga %{ --check-prefix=CHECK-ACC %}

sycl/test-e2e/Assert/assert_in_multiple_tus_one_ndebug.cpp

@@ -1,10 +1,10 @@
 // REQUIRES: linux
 
-// https://github.com/intel/llvm/issues/7634
 // UNSUPPORTED: hip
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/7634
 //
-// https://github.com/intel/llvm/issues/8832
 // UNSUPPORTED: cuda
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/8832
 //
 // XFAIL: (opencl && gpu)
 // XFAIL-TRACKER: https://github.com/intel/llvm/issues/11364

sycl/test-e2e/Assert/assert_in_one_kernel.cpp

@@ -1,7 +1,7 @@
 // REQUIRES: linux
 
-// https://github.com/intel/llvm/issues/7634
 // UNSUPPORTED: hip
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/7634
 //
 // XFAIL: (opencl && gpu)
 // XFAIL-TRACKER: https://github.com/intel/llvm/issues/11364

sycl/test-e2e/Assert/assert_in_simultaneously_multiple_tus_one_ndebug.cpp

@@ -1,6 +1,6 @@
 // FIXME flaky fail on CUDA
-// FIXME HIP: https://github.com/intel/llvm/issues/7634
 // UNSUPPORTED: cuda, hip
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/7634
 //
 // XFAIL: (opencl && gpu)
 // XFAIL-TRACKER: https://github.com/intel/llvm/issues/11364

sycl/test-e2e/Basic/kernel_max_wg_size.cpp

@@ -5,6 +5,7 @@
 // https://github.com/intel/llvm/blob/sycl/sycl/doc/extensions/experimental/sycl_ext_intel_grf_size.asciidoc
 // REQUIRES: arch-intel_gpu_pvc || gpu-intel-dg2
 // UNSUPPORTED: cuda || hip
+// UNSUPPORTED-TRACKER: INTENDED - This extension is currently implemented in DPC++ only for Intel GPU devices and only when using the Level Zero backend or OpenCL backend.
 
 // clang-format off
 #include <sycl/detail/core.hpp>

sycl/test-e2e/README.md

@@ -344,3 +344,38 @@ Once the issue is created, you can update the test by adding `XFAIL` and
 
 If you add `XFAIL` without `XFAIL-TRACKER` directive,
 `no-xfail-without-tracker.cpp` test will fail, notifying you about that.
+
+## Marking tests as unsupported
+
+Some tests may be considered unsupported, e.g.:
+* the test checks the feature that is not supported by some
+  backend / device / OS / etc.
+* the test is flaky or hangs, so it can't be marked with `XFAIL`.
+
+In these cases the test can be marked with `UNSUPPORTED`. This mark should be
+followed by `UNSUPPORTED-TRACKER`. There are two options:
+```
+UNSUPPORTED-TRACKER: INTENDED - <Free-text with reason why it's not intended to be supported on the given feature.>
+UNSUPPORTED-TRACKER: <github issue link / internal number>
+```
+
+In the first case it should look like:
+```
+// UNSUPPORTED: cuda, hip
+// UNSUPPORTED-TRACKER: INTENDED - only supported by backends with SPIR-V IR
+
+// UNSUPPORTED: gpu
+// UNSUPPORTED-TRACKER: INTENDED - the feature works only on CPU & FPGA
+```
+
+For the second case the tracker should be provided:
+```
+// Sporadically fails on DG2.
+// UNSUPPORTED: gpu-intel-dg2
+// UNSUPPORTED-TRACKER: https://github.com/intel/llvm/issues/DDDDD
+// *OR*
+// UNSUPPORTED-TRACKER: PRJ-1234
+```
+
+If you add `UNSUPPORTED` without `UNSUPPORTED-TRACKER` directive,
+`no-unsupported-without-tracker.cpp` test will fail, notifying you about that.