[SYCL] Rename variable SYCL_DEVICE_WHITE_LIST. (#1088)

 Rename variable SYCL_DEVICE_WHITE_LIST to SYCL_DEVICE_ALLOW_LIST and
 add description to the SYCLEnvironmentVariables.md doc.

Signed-off-by: amochalo <anastasiya.mochalova@intel.com>

Author: MochalovaAn

sycl/doc/SYCLEnvironmentVariables.md

@@ -20,7 +20,7 @@ subject to change. Do not rely on these variables in production code.
 | SYCL_PRINT_EXECUTION_GRAPH | Described [below](#sycl_print_execution_graph-options) | Print execution graph to DOT text file. |
 | SYCL_THROW_ON_BLOCK | Any(*) | Throw an exception on attempt to wait for a blocked command.  |
 | SYCL_DEVICELIB_INHIBIT_NATIVE | String of device library extensions (separated by a whitespace) | Do not rely on device native support for devicelib extensions listed in this option. |
-
+| SYCL_DEVICE_ALLOWLIST | A list of devices and their minimum driver version following the pattern: DeviceName:{{XXX}},DriverVersion:{{X.Y.Z.W}}. Also may contain PlatformName and PlatformVersion | Filter out devices that do not match the pattern specified. Regular expression can be passed and the SYCL RT will select only those devices which satisfy the regex. |
 `(*) Note: Any means this environment variable is effective when set to any non-null value.`
 
 ## SYCL_PRINT_EXECUTION_GRAPH Options

sycl/source/detail/config.def

@@ -11,5 +11,5 @@
 // underscore(__).
 
 CONFIG(SYCL_PRINT_EXECUTION_GRAPH, 32, __SYCL_PRINT_EXECUTION_GRAPH)
-CONFIG(SYCL_DEVICE_WHITE_LIST, 1024, __SYCL_DEVICE_WHITE_LIST)
+CONFIG(SYCL_DEVICE_ALLOWLIST, 1024, __SYCL_DEVICE_ALLOWLIST)
 

sycl/source/detail/platform_impl.cpp

@@ -62,7 +62,7 @@ struct DevDescT {
 };
 
 static std::vector<DevDescT> getWhiteListDesc() {
-  const char *str = SYCLConfig<SYCL_DEVICE_WHITE_LIST>::get();
+  const char *str = SYCLConfig<SYCL_DEVICE_ALLOWLIST>::get();
   if (!str)
     return {};
 
@@ -217,7 +217,7 @@ platform_impl::get_devices(info::device_type DeviceType) const {
                         NumDevices, PiDevices.data(), nullptr);
 
   // Filter out devices that are not present in the white list
-  if (SYCLConfig<SYCL_DEVICE_WHITE_LIST>::get())
+  if (SYCLConfig<SYCL_DEVICE_ALLOWLIST>::get())
     filterWhiteList(PiDevices, MPlatform);
 
   std::transform(PiDevices.begin(), PiDevices.end(), std::back_inserter(Res),

sycl/test/config/white_list.cpp renamed to sycl/test/config/allowlist.cpp

@@ -7,7 +7,7 @@
 // RUN: env PRINT_PLATFORM_INFO=1 %t.out > %t2.conf
 // RUN: env TEST_DEVICE_AVAILABLE=1 env SYCL_CONFIG_FILE_NAME=%t2.conf %t.out
 //
-// RUN: env TEST_DEVICE_IS_NOT_AVAILABLE=1 env SYCL_DEVICE_WHITE_LIST="PlatformName:{{SUCH NAME DOESN'T EXIST}}" %t.out
+// RUN: env TEST_DEVICE_IS_NOT_AVAILABLE=1 env SYCL_DEVICE_ALLOWLIST="PlatformName:{{SUCH NAME DOESN'T EXIST}}" %t.out
 
 #include <CL/sycl.hpp>
 #include <iostream>
@@ -25,7 +25,7 @@ static void replaceSpecialCharacters(std::string &Str) {
 
 int main() {
 
-  // Expected that white list filter is not set
+  // Expected that the allowlist filter is not set
   if (getenv("PRINT_PLATFORM_INFO")) {
     for (const sycl::platform &Platform : sycl::platform::get_platforms())
       if (!Platform.is_host()) {
@@ -37,15 +37,15 @@ int main() {
         replaceSpecialCharacters(Name);
         replaceSpecialCharacters(Ver);
 
-        std::cout << "SYCL_DEVICE_WHITE_LIST=PlatformName:{{" << Name
+        std::cout << "SYCL_DEVICE_ALLOWLIST=PlatformName:{{" << Name
                   << "}},PlatformVersion:{{" << Ver << "}}";
 
         return 0;
       }
     throw std::runtime_error("Non host device is not found");
   }
 
-  // Expected that white list filter is not set
+  // Expected that the allowlist filter is not set
   if (getenv("PRINT_DEVICE_INFO")) {
     for (const sycl::platform &Platform : sycl::platform::get_platforms())
       if (!Platform.is_host()) {
@@ -58,15 +58,15 @@ int main() {
         replaceSpecialCharacters(Name);
         replaceSpecialCharacters(Ver);
 
-        std::cout << "SYCL_DEVICE_WHITE_LIST=DeviceName:{{" << Name
+        std::cout << "SYCL_DEVICE_ALLOWLIST=DeviceName:{{" << Name
                   << "}},DriverVersion:{{" << Ver << "}}";
 
         return 0;
       }
     throw std::runtime_error("Non host device is not found");
   }
 
-  // Expected white list to be set with result from "PRINT_DEVICE_INFO" run
+  // Expected the allowlist to be set with the "PRINT_DEVICE_INFO" run result
   if (getenv("TEST_DEVICE_AVAILABLE")) {
     for (const sycl::platform &Platform : sycl::platform::get_platforms())
       if (!Platform.is_host()) {
@@ -78,7 +78,7 @@ int main() {
     throw std::runtime_error("Non host device is not found");
   }
 
-  // Expected white list to be set but empty
+  // Expected the allowlist to be set but empty
   if (getenv("TEST_DEVICE_IS_NOT_AVAILABLE")) {
     for (const sycl::platform &Platform : sycl::platform::get_platforms())
       if (!Platform.is_host())