CLINFO(1)CLINFO(1)NAMEclinfo - show OpenCL platforms and devices
SYNOPSISclinfo [options ...]
DESCRIPTIONclinfo prints all available information about all OpenCL platforms
available on the system and the devices they expose.
OPTIONSclinfo accepts the following options:
--human
produce human-friendly output; this is the default (except as noted
below);
--raw
produce machine-friendly output; this is the default if clinfo is
invoked with a name that contains the string “raw”;
--offline
shows also offline devices for platforms that expose this feature;
-l, --list
list platforms and devices by name, with no (other) properties;
-h, -?
show usage;
--version, -v
show program version.
CONFORMING TO
OpenCL 1.1, OpenCL 1.2, OpenCL 2.0, OpenCL 2.1.
EXTENSIONS
Supported OpenCL extensions:
cl_khr_fp16, cl_khr_fp64, cl_amd_fp64, cl_APPLE_fp64_basic_ops
for information about support for half-precision and double-precision
floating-point data types;
cl_khr_image2d_from_buffer
for information about the base address and pitch alignment require‐
ments of buffers to be used as base for 2D images;
cl_khr_spir
for information about the supported SPIR (Standard Portable Interme‐
diate Representation) versions;
cl_khr_icd
for the suffix of vendor extensions functions;
cl_ext_device_fission
for device fission support in OpenCL 1.1 devices;
cl_ext_atomic_counters_32
cl_ext_atomic_counters_64
for the atomic counter extension;
cl_amd_device_attribute_query
for AMD-specific device attributes;
cl_amd_offline_devices
to show offline devices exposed by the platform, if requested (see
--offline option);
cl_amd_svm
for Shared Virtual Memory (SVM) capabilities in OpenCL 1.2 devices;
cl_nv_device_attribute_query
for NVIDIA-specific device attributes;
cl_intel_exec_by_local_thread
for the Intel extension allowing CPU devices to run kernels as part
of the current host thread;
cl_intel_advanced_motion_estimation
for the version of the Intel Motion Estimation accelerator version;
cl_intel_simultaneous_sharing
for simultaneous CL/GL/DirectX context sharing (only partial sup‐
port);
cl_altera_device_temperature
for the Altera extension to query the core temperature of the device;
cl_qcom_ext_host_ptr
for the QUALCOMM extension to query page size and required padding in
external memory allocation.
NOTES
Some information is duplicated when available from multiple sources.
Examples:
· supported device partition types and domains as obtained using the
cl_ext_device_fission extension typically match the ones obtained
using the core OpenCL 1.2 device partition feature;
· the preferred work-group size multiple matches the NVIDIA warp size
(on NVIDIA devices) or the AMD wavefront width (on AMD devices).
Some floating-point configuration flags may only be meaningful for spe‐
cific precisions and/or specific OpenCL versions. For example,
CL_FP_CORRECTLY_ROUNDED_DIVIDE_SQRT is only relevant for single preci‐
sion in OpenCL 1.2 devices.
The implementation-defined behavior for NULL platform or context prop‐
erties is tested for the following API calls:
clGetPlatformInfo()
by trying to show the platform name;
clGetDeviceIDs()
by trying to enumerate devices; the corresponding platform (if any)
is then detected by querying the device platform of the first device;
clCreateteContext()
by trying to create a context from a device from the previous list
(if any), and a context from a device from a different platform;
clCreateteContextFromType()
by trying to create contexts for each device type (except DEFAULT).
EXPERIMENTAL FEATURES
Support for OpenCL 2.0 and OpenCL 2.1 properties is not fully tested.
Raw (machine-parsable) output is considered experimental, the output
format might still undergo changes.
The properties of the ICD loader will also be queried if the clGetICD‐
LoaderInfoOCLICD extension function is found.
The highest OpenCL version supported by the ICD loader is detected with
some trivial heuristics (symbols found); a notice is output if this is
lower than the highest platform OpenCL version, or if the detected ver‐
sion doesn't match the one declared by the ICD loader itself.
BUGS
The CL_DEVICE_GLOBAL_FREE_MEMORY_AMD device information is documented
in v3 of the cl_amd_device_attribute_query extension specification as
being the global free memory in KBytes, but no explanation is given on
why there are two values.
The CL_DEVICE_AVAILABLE_ASYNC_QUEUES_AMD device information is docu‐
mented in v3 of the cl_amd_device_attribute_query extension specifica‐
tion, but not reported by current drivers, so it is currently disabled.
The CL_DEVICE_SIMULTANEOUS_INTEROPS_INTEL device information for the
cl_intel_simultaneous_sharing extension is not reported, due to lack of
knowledge on the possible values the list elements can have.
Please report any issues on the project tracker on GitHub
⟨http://github.com/Oblomov/clinfo⟩.
clinfo 2.1.16.01.12 2016-01-12 CLINFO(1)