1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
|
// SPDX-FileCopyrightText: 2010 - 2012 Free Software Foundation, Inc.
// SPDX-FileContributor: Ken Werner <ken.werner@de.ibm.com>
//
// SPDX-License-Identifier: GPL-3.0-or-later
/* Utility macros and functions for OpenCL applications. */
#ifndef CL_UTIL_H
#define CL_UTIL_H
#ifdef __cplusplus
extern "C" {
#endif
#ifdef __APPLE__
#include <OpenCL/opencl.h>
#else
#include <CL/cl.h>
#endif
#include <stdio.h>
/* Executes the given OpenCL function and checks its return value.
In case of failure (rc != CL_SUCCESS) an error string will be
printed to stderr and the program will be terminated. This Macro
is only intended for OpenCL routines which return cl_int. */
#define CHK(func)\
{\
int rc = (func);\
CHK_ERR (#func, rc);\
}
/* Macro that checks an OpenCL error code. In case of failure
(err != CL_SUCCESS) an error string will be printed to stderr
including the prefix and the program will be terminated. This
Macro is only intended to use in conjunction with OpenCL routines
which take a pointer to a cl_int as an argument to place their
error code. */
#define CHK_ERR(prefix, err)\
if (err != CL_SUCCESS)\
{\
fprintf (stderr, "CHK_ERR (%s, %d)\n", prefix, err);\
fprintf (stderr, "%s:%d error: %s\n", __FILE__, __LINE__,\
get_clerror_string (err));\
exit (EXIT_FAILURE);\
};
/* Return a pointer to a string that describes the error code specified
by the errcode argument. */
extern const char *get_clerror_string (int errcode);
/* Prints OpenCL information to stdout. */
extern void print_clinfo ();
/* Reads a given file into the memory and returns a pointer to the data or NULL
if the file does not exist. FILENAME specifies the location of the file to
be read. SIZE is an output parameter that returns the size of the file in
bytes. */
extern const char *read_file (const char * const filename, size_t *size);
/* Saves all program binaries of the given OpenCL PROGRAM. The file
names are extracted from the devices. */
extern void save_program_binaries (cl_program program);
#ifdef __cplusplus
}
#endif
#endif /* CL_UTIL_H */
|