[SYCL][COMPAT] Added device extension and manager (#10774)

This is the second PR implementation of SYCLcompat. SYCLcompat primary
goals and features are documented
[here](https://github.com/intel/llvm/tree/sycl/sycl/doc/syclcompat).

The PR includes the code that would implement the wrapper to expose the
management of the `sycl::device`, `sycl::queue`, and `sycl::context`.
The exposed functionalities include:
- Creation and destruction of queues, and providing the ability to wait
for submitted kernels.
- Any async errors will be output to stderr if
`print_on_async_exceptions`. Synchronous exceptions have to be managed
by users independently of what is set in this parameter.
- Management of multiple devices. The library uses the default SYCL
device (`sycl::default_selector_v`) as the default device, and exposes
all other devices available on the system through the
`syclcompat::select_device`member function.

We are open to any suggestions, concerns, or improvements you may have,
so please, let us know if you have any.

---------

Co-authored-by: Gordon Brown <[email protected]>
Co-authored-by: Joe Todd <[email protected]>
Co-authored-by: Pietro Ghiglio <[email protected]>
Co-authored-by: Ruyman Reyes <[email protected]>

Author: 5 people

sycl/CMakeLists.txt

@@ -257,7 +257,7 @@ install(DIRECTORY "${sycl_inc_dir}/sycl" DESTINATION ${SYCL_INCLUDE_DIR} COMPONE
 install(DIRECTORY "${sycl_inc_dir}/CL" DESTINATION ${SYCL_INCLUDE_DIR}/sycl COMPONENT sycl-headers)
 install(DIRECTORY "${sycl_inc_dir}/std" DESTINATION ${SYCL_INCLUDE_DIR} COMPONENT sycl-headers)
 install(DIRECTORY ${BOOST_MP11_DESTINATION_DIR} DESTINATION ${SYCL_INCLUDE_DIR}/sycl/detail COMPONENT boost_mp11-headers)
-install(DIRECTORY "${sycl_inc_dir}/syclcompat" DESTINATION ${SYCL_INCLUDE_DIR}/syclcompat COMPONENT sycl-headers)
+install(DIRECTORY "${sycl_inc_dir}/syclcompat" DESTINATION ${SYCL_INCLUDE_DIR} COMPONENT sycl-headers)
 install(FILES "${sycl_inc_dir}/syclcompat.hpp" DESTINATION ${SYCL_INCLUDE_DIR} COMPONENT sycl-headers)
 
 if (WIN32)

sycl/cmake/modules/AddSYCLLibraryUnitTest.cmake

@@ -50,7 +50,7 @@ through the main header, `syclcompat.hpp`. Note that `syclcompat.hpp` does not
 import the <sycl/sycl.hpp> header.
 
 ``` cpp
-#include <sycl/syclcompat.hpp>
+#include <syclcompat.hpp>
 ```
 
 This document presents the public API under the [Features](#features) section,
@@ -768,8 +768,8 @@ The exposed functionalities include creation and destruction of queues, through
 `syclcompat::create_queue` and `syclcompat::destroy_queue`, and providing the
 ability to wait for submitted kernels using `syclcompat::wait` or
 `syclcompat::wait_and_throw`. Any async errors will be output to `stderr` if
-`print_on_async_exceptions`. Synchronous exceptions have to be managed by users
-independently of what is set in this parameter.
+`print_on_async_exceptions`, and will have the default behavior otherwise, which calls `std:terminate`. Synchronous exceptions have to be managed
+by users independently of what is set in this parameter.
 
 Devices are managed through a helper class, `device_ext`. The `device_ext` class
 associates a vector of `sycl::queues` with its `sycl::device`. The `device_ext`
@@ -1159,7 +1159,7 @@ using this library:
 #include <cassert>
 #include <iostream>
 
-#include <sycl/syclcompat.hpp>
+#include <syclcompat.hpp>
 #include <sycl/sycl.hpp>
 
 /**