From 9b5f28846273a6188a68912d21a9a08fec33b842 Mon Sep 17 00:00:00 2001 From: dongkyunahn-intel Date: Thu, 20 Oct 2022 11:50:16 -0700 Subject: [PATCH] [SYCL][ESIMD][DOC] Update on ESIMD_EMULATOR device selection (#7107) Co-authored-by: kbobrovs --- .../experimental/sycl_ext_intel_esimd/esimd_emulator.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/sycl/doc/extensions/experimental/sycl_ext_intel_esimd/esimd_emulator.md b/sycl/doc/extensions/experimental/sycl_ext_intel_esimd/esimd_emulator.md index 62ae0a2a6ad9f..20c4b7814a4ad 100644 --- a/sycl/doc/extensions/experimental/sycl_ext_intel_esimd/esimd_emulator.md +++ b/sycl/doc/extensions/experimental/sycl_ext_intel_esimd/esimd_emulator.md @@ -66,6 +66,14 @@ To compile using Intel(R) OneAPI Toolkit: To run under emulation through ESIMD_EMULATOR backend: > `$ SYCL_DEVICE_FILTER=ext_intel_esimd_emulator:gpu ./a.out` +Please note that ESIMD_EMULATOR backend cannot be picked up as default +device automatically. To enable it, `ext_intel_esimd_emulator:gpu` device must +be specified among other devices explicitly in `SYCL_DEVICE_FILTER` environment +variable. The emulator device effectively replaces any Intel GPU device for SYCL runtime, +so they can't be used simultaneously by a SYCL offload application process. On the other +hand, it is OK to mix the emulator with non-Intel GPU devices or CPU device in +`SYCL_DEVICE_FILTER`. + ## Running ESIMD examples from [ESIMD test suite](https://github.com/intel/llvm-test-suite/tree/intel/SYCL/ESIMD) on github with ESIMD_EMULATOR backend ```