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 ```