separate runtime(libcl.so) and compiler(libgbe.so)
authorGuo Yejun <yejun.guo@intel.com>
Mon, 26 May 2014 23:10:04 +0000 (07:10 +0800)
committerZhigang Gong <zhigang.gong@intel.com>
Wed, 28 May 2014 01:08:38 +0000 (09:08 +0800)
commit3d8ea972a4a825b12c2b7deb41edf87b6e338f5d
tree5a8c2d6cc2ae3ebbd18799e333a5aa1c7fe683f1
parent604c0ee37c031a902f28a3a181e1314c8bab46f3
separate runtime(libcl.so) and compiler(libgbe.so)

On embedded/handheld devices, storage and memory are scarce, it is
necessary to provide only the OpenCL runtime library with small size,
and only the executable binary kernel will be supported on such device.

At the beginning of process (before function main), OpenCL runtime
(libcl.so) will try to load the compiler (libgbe.so), the system's
behavior is the same as before if successfully loaded, otherwise,
the runtime assumes no OpenCL compiler in the system, and the device
info will be changed as CL_DEVICE_COMPILER_AVAILABLE=false and
CL_DEVICE_PROFILE="EMBEDDED_PROFILE", the clBuildProgram returns
CL_COMPILER_NOT_AVAILABLE if the program is created with
clCreateProgramWithSource, following the OpenCL spec.

To simulate the case without OpenCL compiler, just delete the file
libgbe.so, or export OCL_NON_COMPILER=1.

Some explanation of the binary kernel interpreter (libinterp.a):

libinterp.a is used to interpret the binary kernel inside runtime,
and the runtime library libcl.so is built against libinterp.a.

Since the code to interpret binary kernel is tightly integrated inside
the compiler, to avoid code duplicate, a new file gbe_bin_interpreter.cpp
is created to include some other .cpp files; to make libinterp.a small
(the purpose to make libcl.so small), the macro GBE_COMPILER_AVAILABLE
is used to make only the needed code active when build for libinterp.a.

V2: code base is changed to call function gbe_set_image_base_index in
gbe_bin_generater, while this function is modified in this patch as
gbe_set_image_base_index_compiler, fix it accordingly.

Signed-off-by: Guo Yejun <yejun.guo@intel.com>
Reviewed-by: "Yang, Rong R" <rong.r.yang@intel.com>
Tested-by: Zhigang Gong <zhigang.gong@linux.intel.com>
21 files changed:
backend/CMakeLists.txt
backend/src/CMakeLists.txt
backend/src/GBEConfig.h.in
backend/src/backend/gen_program.cpp
backend/src/backend/program.cpp
backend/src/backend/program.h
backend/src/backend/program.hpp
backend/src/gbe_bin_generater.cpp
backend/src/gbe_bin_interpreter.cpp [new file with mode: 0644]
backend/src/ir/image.cpp
backend/src/ir/sampler.cpp
backend/src/ocl_common_defines.h
src/CMakeLists.txt
src/cl_device_id.c
src/cl_gbe_loader.cpp [new file with mode: 0644]
src/cl_gbe_loader.h [new file with mode: 0644]
src/cl_kernel.h
src/cl_program.c
src/cl_program.h
src/intel/intel_driver.c
utests/setenv.sh.in