OpenCL 1.0 Specification阅读笔记（6）

1. Creating Program Objects

 

cl_program clCreateProgramWithSource( cl_context context, cl_uint count, const char **string, const size_t *lengths, cl_int *errcode_ret ); cl_program clCreateProgramWithBinary( cl_context context, cl_uint num_devices, const cl_device_id *device_list, const size_t *lengths, const unsigned char **binaries, cl_int *binary_status, cl_int *errcode_ret ); cl_int clRetainProgram(cl_program program); cl_int clReleaseProgram(cl_program program);

 

each string (char*) is a kernel, so many kernels would belong to one program object

 

each context can have many device (device list)

 

program binaries contain the bits that describe the program executable that will be run on the devices associated with context

 

(2) Building Program Executables

 

cl_int clBuildProgram( cl_program program, cl_uint num_devices, const cl_device_id *device_list, const char *options, void (*pfn_notify)(cl_program, void *user_data), void *user_data );

 

builds (compile & link) a program executable from the program source or binary for all the devices or a specific device in the OpenCL context associated with program.

 

clGetProgramInfo();

clGetProgramBuildInfo();

 

 

Kernel Object

A Kernel is a function declared in a program. A kernel is identified by the __kernel qualifier applied to any  functions in a program.

 

cl_kernel clCreateKernel( cl_program program, const char *kernel_name, cl_int *errcode_ret); cl_int clCreateKernelsInProgram( cl_program program, cl_uint num_kernels, cl_kernel *kernels, cl_uint *num_kernels_ret );

 

clRetainKernel();

clReleaseKernel();

 

 

Setting Kernel Arguments

 

cl_int clSetKernelArg( cl_kernel kernel, cl_uint arg_index, // start from 0 size_t arg_size, const void* arg_value );

 

clGetKernelInfo();

clGetKernelWorkGroupInfo();