CLINFO(1)							     CLINFO(1)

NAME
       clinfo - show OpenCL platforms and devices

SYNOPSIS
       clinfo [options ...]

DESCRIPTION
       clinfo  prints  all  available  information  about all OpenCL platforms
       available on the system and the devices they expose.

OPTIONS
       clinfo 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)

Vote for polarhome