Global

oneAPI Level Zero Specification - Version 1.18.31

Global Functions

zesInit

Added in version 1.5

ZE_APIEXPORT ze_result_t ZE_APICALL zesInit(zes_init_flags_t flags)

Initialize ‘oneAPI’ System Resource Management (sysman)

• The application must call zesInit() before calling any other sysman function.

• The ZES_ENABLE_SYSMAN environment variable method of initialization is deprecated. Applications should use zesInit() instead.

• If this function is not called then all other sysman functions will return ZE_RESULT_ERROR_UNINITIALIZED.

• This function will only initialize sysman. To initialize other functions, call zeInit.

• There is no requirement to call this function before or after zeInit.

• Only one instance of sysman will be initialized per process.

• The application must call this function after forking new processes. Each forked process must call this function.

• The application may call this function from simultaneous threads.

• The implementation of this function must be thread-safe for scenarios where multiple libraries may initialize sysman simultaneously.

Parameters:

flags – [in] initialization flags. This should be 0 or a combination of zes_init_flags_t values.

Returns:

• ZE_RESULT_SUCCESS

• ZE_RESULT_ERROR_UNINITIALIZED

• ZE_RESULT_ERROR_DEVICE_LOST

• ZE_RESULT_ERROR_OUT_OF_DEVICE_MEMORY

• ZE_RESULT_ERROR_INVALID_ARGUMENT

• ZE_RESULT_ERROR_UNSUPPORTED_FEATURE

• ZE_RESULT_ERROR_DEPENDENCY_UNAVAILABLE

• ZE_RESULT_ERROR_INSUFFICIENT_PERMISSIONS

• ZE_RESULT_ERROR_NOT_AVAILABLE

• ZE_RESULT_ERROR_DEVICE_REQUIRES_RESET

• ZE_RESULT_ERROR_DEVICE_IN_LOW_POWER_STATE

• ZE_RESULT_ERROR_UNKNOWN

• ZE_RESULT_ERROR_INVALID_ENUMERATION

  • 0x7 < flags

• ZE_RESULT_ERROR_UNSUPPORTED_ENUMERATION

• ZE_RESULT_ERROR_OUT_OF_HOST_MEMORY

Global Enums

zes_init_flags_t

Added in version 1.5

enum zes_init_flag_t

Values:

enumerator ZES_INIT_FLAG_GPU_ONLY

Initialize sysman for GPU devices only. (since v1.18)

enumerator ZES_INIT_FLAG_VPU_ONLY

Initialize sysman for VPU devices only. (since v1.18)

enumerator ZES_INIT_FLAG_NO_DEVICES

Allows zesInit() to succeed when no devices are discovered. Device discovery is deferred until the first call to zesDeviceGet(), in case no devices can be discovered when zesInit() is called. (since v1.18)

enumerator ZES_INIT_FLAG_FORCE_UINT32

Value marking end of ZES_INIT_FLAG_* ENUMs.