LIBOPENCL - Online Linux Manual PageSection : 7
Updated : 2015−06−08
Source :  ​
Note :  ​

NAMElibOpenCL, libOpenCL.so − OCL−ICD implementation of OpenCL ICD loader

DESCRIPTIONlibOpenCL​.so is the library linked by OpenCL programs​. It does not contains any OpenCL implementation itself, but merely act as a dispatcher to real OpenCL implementations provided as OpenCL Installable Client Driver (ICD)​. An ICD loader should be able to load ICDs provided by any vendors​. According to OpenCL specifications from Khronos (see [Khronos]), the ICD Loader looks for files into /etc/OpenCL/vendors directory and, for each file whose name ends with ​.icd, the ICD Loader loads with dlopen(3) the shared library whose name is on the first line of the ​.icd file​. Each shared library name in "​.icd" files can have its path, or it can be a plain filename​. In the latter case, the ICD shared library will be looked for into the standard dynamic library loader paths​.

ENVIRONMENTSome environment variables can be used modify the default behavior of libOpenCL​. OPENCL_VENDOR_PATH This variable allows one to modify the default /etc/OpenCL/vendors path​. It is compatible with some other ICD loaders (but not all of them, as the variable is not part of the standard)​. Note that $OCL_ICD_VENDORS (see below) is used in priority if defined and not empty​. OCL_ICD_VENDORS This variable allows one to change the way ICD are searched on the system​. Several cases are considered: 1.  if $OCL_ICD_VENDORS is a directory path, then this path replaces the "/etc/OpenCL/vendors" path in the standard behavior: the loader will use the ​.icd files in this directory; 2.  else, if $OCL_ICD_VENDORS ends with ​.icd, libOpenCL​.so will only load the ICD whose shared library name is wrote into the specified "​.icd" file; If there is no slashes into $OCL_ICD_VENDORS, libOpenCL​.so will first try to use /etc/OpenCL/vendors/$OCL_ICD_VENDORS (or $OPENCL_VENDOR_PATH/$OCL_ICD_VENDORS if OPENCL_VENDOR_PATH is defined)​. If this fail or if there are shashes, it uses $OCL_ICD_VENDORS (as a relative or absolute file name path)​. 3.  else libOpenCL​.so will try to load $OCL_ICD_VENDORS as the ICD shared library itself (i​.e​. to load it directly with dlopen(3))​. OPENCL_LAYERS This variable allows one to specify a colon separated list of layers to load, specifying their path​. This support is experimental​. OCL_ICD_ASSUME_ICD_EXTENSION If set to an non−empty value, contrary the Khronos specification, the loader will not check that the loaded ICDs declare the cl_khr_icd extension​. It will also use the clGetPlatformInfo from the dispatch table if no such function is globally available​. You may need to define this environment variable if you are using not (fully) compliant ICD, or if you are using the Intel ICD together with optirun(1)​. In the latter case, a bug into the Intel ICD will make the application crash​. If set to the debug value, some additional messages will be printed in debug mode (see OCL_ICD_DEBUG below)​. OCL_ICD_PLATFORM_SORT Allows one to choose the way platforms are sorted when presented to programs through clGetPlatformIDs(3)​. Current provided algorithms are: •  devices: first, list platforms that support most GPU, then most CPU then most accelerators​. If OCL_ICD_PLATFORM_SORT is not set or set to an unknown value, this algorithm is used​. •  none: no sort is done and the order can change at each run​. OCL_ICD_DEFAULT_PLATFORM Number of the platform to choose as default platform​. Note that using this environment variable without ensuring the use of a sort algorithm for platforms is not really useful​. OCL_ICD_DEBUG If ocl−icd has been compiled with debug support, you can set this environment variable to a value where each bit display some kind of informations​. Defined values are: •  1: warnings (enabled by default if debug support is present and OCL_ICD_DEBUG is not set) •  2: informative messages •  4: entering/exiting for some OpenCL functions •  8: dump of the internal structure of loaded ICDs OCL_ICD_DEBUG is mainly useful for ocl−icd development itself and/or for ICD development​.

SEE ALSOKhronos OpenCL registry website

AUTHORVincent Danjean <​Vincent​.Danjean@ens−lyon​.org​> Author.
0
Johanes Gumabo
Data Size   :   17,106 byte
man-libOpenCL.7Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 179,780
Visitor ID   :     :  
Visitor IP   :   3.138.34.93   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.