WEBCL_system_info
WebCL working group (public_webcl 'at' khronos.org)
Tomi Aarnio, Nokia Research,
Steven Eliuk, Samsung Electronics,
Members of the WebCL working group.
Last modified date: December 11, 2013
Revision: 4
WebCL extension #6
Written against the WebCL API 1.0 specification.
This extension allows applications, at the discretion of the browser and preferably of the end user, to gain access to OpenCL system details that are otherwise masked. Access would typically not be granted to regular web content, but only to development tools and other privileged content.
WebCL implementations may choose to mask certain details of the underlying OpenCL system in order to prevent end users from getting identified and tracked without their consent; see also W3C Permissions for Device API Access. On the other hand, unrestricted access to system information is sometimes important while developing a WebCL application.
The system details exposed by this extension consist of an implementation-specific subset of the WebCLPlatform and WebCLDevice `getInfo` query results. The set of query enums given in the IDL fragment below is therefore not normative, but merely indicative of which attributes might be masked by a typical implementation.
Note that the numerical values of the `UNMASKED` enums below are the same as their masked counterparts in the WebCL specification. This implies that a query for `PLATFORM_NAME` will produce the same result as if `UNMASKED_PLATFORM_NAME` were used, and also that the result is determined by whether this extension is enabled or not.
When this extension is enabled:
partial interface WebCL {
// Platform Properties (exemplary, non-normative)
CLenum UNMASKED_PLATFORM_PROFILE = 0x0900;
CLenum UNMASKED_PLATFORM_VERSION = 0x0901;
CLenum UNMASKED_PLATFORM_NAME = 0x0902;
CLenum UNMASKED_PLATFORM_VENDOR = 0x0903;
CLenum UNMASKED_PLATFORM_EXTENSIONS = 0x0904;
// Device Properties (exemplary, non-normative)
CLenum UNMASKED_DEVICE_TYPE = 0x1000;
CLenum UNMASKED_DEVICE_VENDOR_ID = 0x1001;
CLenum UNMASKED_DEVICE_MAX_COMPUTE_UNITS = 0x1002;
CLenum UNMASKED_DEVICE_MAX_WORK_ITEM_DIMENSIONS = 0x1003;
CLenum UNMASKED_DEVICE_MAX_WORK_GROUP_SIZE = 0x1004;
CLenum UNMASKED_DEVICE_MAX_WORK_ITEM_SIZES = 0x1005;
CLenum UNMASKED_DEVICE_PREFERRED_VECTOR_WIDTH_CHAR = 0x1006;
CLenum UNMASKED_DEVICE_PREFERRED_VECTOR_WIDTH_SHORT = 0x1007;
CLenum UNMASKED_DEVICE_PREFERRED_VECTOR_WIDTH_INT = 0x1008;
CLenum UNMASKED_DEVICE_PREFERRED_VECTOR_WIDTH_LONG = 0x1009;
CLenum UNMASKED_DEVICE_PREFERRED_VECTOR_WIDTH_FLOAT = 0x100A;
CLenum UNMASKED_DEVICE_PREFERRED_VECTOR_WIDTH_DOUBLE = 0x100B; // moved to extension
CLenum UNMASKED_DEVICE_MAX_CLOCK_FREQUENCY = 0x100C;
CLenum UNMASKED_DEVICE_ADDRESS_BITS = 0x100D;
CLenum UNMASKED_DEVICE_MAX_READ_IMAGE_ARGS = 0x100E;
CLenum UNMASKED_DEVICE_MAX_WRITE_IMAGE_ARGS = 0x100F;
CLenum UNMASKED_DEVICE_MAX_MEM_ALLOC_SIZE = 0x1010;
CLenum UNMASKED_DEVICE_IMAGE2D_MAX_WIDTH = 0x1011;
CLenum UNMASKED_DEVICE_IMAGE2D_MAX_HEIGHT = 0x1012;
CLenum UNMASKED_DEVICE_IMAGE3D_MAX_WIDTH = 0x1013;
CLenum UNMASKED_DEVICE_IMAGE3D_MAX_HEIGHT = 0x1014;
CLenum UNMASKED_DEVICE_IMAGE3D_MAX_DEPTH = 0x1015;
CLenum UNMASKED_DEVICE_IMAGE_SUPPORT = 0x1016;
CLenum UNMASKED_DEVICE_MAX_PARAMETER_SIZE = 0x1017;
CLenum UNMASKED_DEVICE_MAX_SAMPLERS = 0x1018;
CLenum UNMASKED_DEVICE_MEM_BASE_ADDR_ALIGN = 0x1019;
//CLenum UNMASKED_DEVICE_MIN_DATA_TYPE_ALIGN_SIZE = 0x101A; // removed; deprecated in OpenCL 1.2
CLenum UNMASKED_DEVICE_SINGLE_FP_CONFIG = 0x101B;
CLenum UNMASKED_DEVICE_GLOBAL_MEM_CACHE_TYPE = 0x101C;
CLenum UNMASKED_DEVICE_GLOBAL_MEM_CACHELINE_SIZE = 0x101D;
CLenum UNMASKED_DEVICE_GLOBAL_MEM_CACHE_SIZE = 0x101E;
CLenum UNMASKED_DEVICE_GLOBAL_MEM_SIZE = 0x101F;
CLenum UNMASKED_DEVICE_MAX_CONSTANT_BUFFER_SIZE = 0x1020;
CLenum UNMASKED_DEVICE_MAX_CONSTANT_ARGS = 0x1021;
CLenum UNMASKED_DEVICE_LOCAL_MEM_TYPE = 0x1022;
CLenum UNMASKED_DEVICE_LOCAL_MEM_SIZE = 0x1023;
CLenum UNMASKED_DEVICE_ERROR_CORRECTION_SUPPORT = 0x1024;
CLenum UNMASKED_DEVICE_PROFILING_TIMER_RESOLUTION = 0x1025;
CLenum UNMASKED_DEVICE_ENDIAN_LITTLE = 0x1026;
CLenum UNMASKED_DEVICE_AVAILABLE = 0x1027;
CLenum UNMASKED_DEVICE_COMPILER_AVAILABLE = 0x1028;
CLenum UNMASKED_DEVICE_EXECUTION_CAPABILITIES = 0x1029;
CLenum UNMASKED_DEVICE_QUEUE_PROPERTIES = 0x102A;
CLenum UNMASKED_DEVICE_NAME = 0x102B;
CLenum UNMASKED_DEVICE_VENDOR = 0x102C;
CLenum DRIVER_VERSION = 0x102D;
CLenum UNMASKED_DEVICE_PROFILE = 0x102E;
CLenum UNMASKED_DEVICE_VERSION = 0x102F;
CLenum UNMASKED_DEVICE_EXTENSIONS = 0x1030;
CLenum UNMASKED_DEVICE_PLATFORM = 0x1031;
CLenum UNMASKED_DEVICE_DOUBLE_FP_CONFIG = 0x1032; // moved to extension
CLenum UNMASKED_DEVICE_HALF_FP_CONFIG = 0x1033; // moved to extension
CLenum UNMASKED_DEVICE_PREFERRED_VECTOR_WIDTH_HALF = 0x1034; // moved to extension
CLenum UNMASKED_DEVICE_HOST_UNIFIED_MEMORY = 0x1035;
CLenum UNMASKED_DEVICE_NATIVE_VECTOR_WIDTH_CHAR = 0x1036;
CLenum UNMASKED_DEVICE_NATIVE_VECTOR_WIDTH_SHORT = 0x1037;
CLenum UNMASKED_DEVICE_NATIVE_VECTOR_WIDTH_INT = 0x1038;
CLenum UNMASKED_DEVICE_NATIVE_VECTOR_WIDTH_LONG = 0x1039;
CLenum UNMASKED_DEVICE_NATIVE_VECTOR_WIDTH_FLOAT = 0x103A;
CLenum UNMASKED_DEVICE_NATIVE_VECTOR_WIDTH_DOUBLE = 0x103B; // moved to extension
CLenum UNMASKED_DEVICE_NATIVE_VECTOR_WIDTH_HALF = 0x103C; // moved to extension
CLenum UNMASKED_DEVICE_OPENCL_C_VERSION = 0x103D;
};
// Returns a JavaScript object containing all 'UNMASKED' device
// info items that are available for the given WebCLDevice.
function getRealDeviceInfo(device)
{
var deviceInfo = {};
if (device.enableExtension("WEBCL_system_info")) {
for (var e in WebCL) {
if (e.indexOf("UNMASKED_DEVICE") !== -1) {
deviceInfo[e] = device.getInfo(WebCL[e]);
}
}
}
return deviceInfo;
}
Yes. Assigning different values could create conflicts with OpenCL later on.
Yes. There is no way to conformance-test whether something has been masked or not.
Revision 1, 2013/11/15
Revision 2, 2013/11/26
Revision 3, 2013/11/27
Revision 4, 2013/12/11