Skip to content

Commit 9b5f288

Browse files
[SYCL][ESIMD][DOC] Update on ESIMD_EMULATOR device selection (#7107)
Co-authored-by: kbobrovs <Konstantin.S.Bobrovsky@intel.com>
1 parent e526f3c commit 9b5f288

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

sycl/doc/extensions/experimental/sycl_ext_intel_esimd/esimd_emulator.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,14 @@ To compile using Intel(R) OneAPI Toolkit:
6666
To run under emulation through ESIMD_EMULATOR backend:
6767
> `$ SYCL_DEVICE_FILTER=ext_intel_esimd_emulator:gpu ./a.out`
6868
69+
Please note that ESIMD_EMULATOR backend cannot be picked up as default
70+
device automatically. To enable it, `ext_intel_esimd_emulator:gpu` device must
71+
be specified among other devices explicitly in `SYCL_DEVICE_FILTER` environment
72+
variable. The emulator device effectively replaces any Intel GPU device for SYCL runtime,
73+
so they can't be used simultaneously by a SYCL offload application process. On the other
74+
hand, it is OK to mix the emulator with non-Intel GPU devices or CPU device in
75+
`SYCL_DEVICE_FILTER`.
76+
6977
## Running ESIMD examples from [ESIMD test suite](https://github.com/intel/llvm-test-suite/tree/intel/SYCL/ESIMD) on github with ESIMD_EMULATOR backend
7078

7179
```

0 commit comments

Comments
 (0)