Skip to content

Commit eedf0a4

Browse files
authored
update the FAQ with additional troubleshooting steps (#385)
1 parent f744665 commit eedf0a4

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/FAQ.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,16 @@ If the Intercept Layer for OpenCL Applications is properly installed but is stil
3939
Do you see any errors or unexpected output in the log file?
4040
Are all of the controls you set listed in the log file?
4141

42+
If everything looks fine, here are a few things uncommon things to check:
43+
44+
* Because the Intercept Layer for OpenCL Applications is a DLL or shared library, it will only work for applications that dynamically link with the OpenCL ICD loader or an OpenCL implementation.
45+
The Intercept Layer for OpenCL Applications does not currently support applications that statically link with OpenCL.
46+
* Applications that dynamically load OpenCL (via `LoadLibrary` or `dlopen`) may bypass the Intercept Layer for OpenCL Applications, especially when used through `cliloader`, and especially on Windows.
47+
In some cases, switching to the "local install" method is sufficient begin intercepting OpenCL commands.
48+
In other cases though, switching to the "global install" method is required, see the [install](install.md) directions for more detail.
49+
* Applications that dynamically load other DLLs or shared libraries that make OpenCL calls may also bypass the Intercept Layer for OpenCL Applications, especially when used through `cliloader`, and especially on Windows.
50+
In these cases, switching to a "global install" or "local install" method is also usually sufficient to begin intercepting OpenCL commands.
51+
4252
## It crashed!
4353

4454
If your application is running correctly without the Intercept Layer for OpenCL Applications, but crashing with it, then it is very likely that the Intercept Layer for OpenCL Applications was unable to find the "real" OpenCL library (usually an OpenCL ICD loader) to load and pass calls to.

0 commit comments

Comments
 (0)