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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
/*****************************************************************************\
Copyright (c) Intel Corporation (2009-2017).
INTEL MAKES NO WARRANTY OF ANY KIND REGARDING THE CODE. THIS CODE IS
LICENSED ON AN "AS IS" BASIS AND INTEL WILL NOT PROVIDE ANY SUPPORT,
ASSISTANCE, INSTALLATION, TRAINING OR OTHER SERVICES. INTEL DOES NOT
PROVIDE ANY UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY
DISCLAIMS ANY WARRANTY OF MERCHANTABILITY, NONINFRINGEMENT, FITNESS FOR ANY
PARTICULAR PURPOSE, OR ANY OTHER WARRANTY. Intel disclaims all liability,
including liability for infringement of any proprietary rights, relating to
use of the code. No license, express or implied, by estoppel or otherwise,
to any intellectual property rights is granted herein.
\file common_clang.h
\*****************************************************************************/
#pragma once
#include "assert.h"
#include "cstddef" // size_t
#if defined(_WIN32)
#if defined(COMMON_CLANG_EXPORTS)
#define CC_DLL_EXPORT _declspec(dllexport)
#else
#define CC_DLL_EXPORT _declspec(dllimport)
#endif
#else
#define CC_DLL_EXPORT
#endif
namespace Intel {
namespace OpenCL {
namespace ClangFE {
//
// Type of the binary returned after compilation and/or link
//
enum IR_TYPE {
IR_TYPE_UNKNOWN,
IR_TYPE_EXECUTABLE,
IR_TYPE_LIBRARY,
IR_TYPE_COMPILED_OBJECT
};
//
// Compilation results interface
// Returned by Compile method
//
struct IOCLFEBinaryResult {
// Returns the size in bytes of the IR buffer
virtual size_t GetIRSize() const = 0;
// Returns the pointer to the IR buffer or NULL if no IR buffer is present
virtual const void *GetIR() const = 0;
// Returns the name of the program
virtual const char *GetIRName() const = 0;
// Returns the type of the resulted binary
virtual IR_TYPE GetIRType() const = 0;
// Returns the pointer to the compilation log string or NULL if not log was
// created
virtual const char *GetErrorLog() const = 0;
// Releases the result object
virtual void Release() = 0;
protected:
virtual ~IOCLFEBinaryResult() {}
};
}
}
}
//
// Verifies the given OpenCL application supplied compilation options
// Params:
// pszOptions - compilation options string
// pszUnknownOptions - optional outbound pointer to the space separated
// unrecognized options
// uiUnknownOptionsSize - size of the pszUnknownOptions buffer
// Returns:
// true if the options verification was successful, false otherwise
//
extern "C" CC_DLL_EXPORT bool CheckCompileOptions(
// A string for compile options
const char *pszOptions,
// buffer to get the list of unknown options
char *pszUnknownOptions,
// size of the buffer for unknown options
size_t uiUnknownOptionsSize);
//
// Compiles the given OpenCL program to the LLVM IR
// Params:
// pProgramSource - OpenCL source program to compile
// pInputHeaders - array of the header buffers
// uiNumInputHeader - size of the pInputHeaders array
// pszInputHeadersNames - array of the headers names
// pPCHBuffer - optional pointer to the pch buffer
// uiPCHBufferSize - size of the pch buffer
// pszOptions - OpenCL application supplied options
// pszOptionsEx - optional extra options string usually supplied by runtime
// pszOpenCLVer - OpenCL version supported by the device, also defines
// __OPENCL_VERSION__ macro - "120" for OpenCL 1.2, "200" for OpenCL 2.0, ...
// pBinaryResult - optional outbound pointer to the compilation results
// Returns:
// Compilation Result as int: 0 - success, error otherwise.
//
extern "C" CC_DLL_EXPORT int Compile(
// A pointer to main program's source (null terminated string)
const char *pszProgramSource,
// array of additional input headers to be passed in memory (each null
// terminated)
const char **pInputHeaders,
// the number of input headers in pInputHeaders
unsigned int uiNumInputHeaders,
// array of input headers names corresponding to pInputHeaders
const char **pInputHeadersNames,
// optional pointer to the pch buffer
const char *pPCHBuffer,
// size of the pch buffer
size_t uiPCHBufferSize,
// OpenCL application supplied options
const char *pszOptions,
// optional extra options string usually supplied by runtime
const char *pszOptionsEx,
// OpenCL version string - "120" for OpenCL 1.2, "200" for OpenCL 2.0, ...
const char *pszOpenCLVer,
// optional outbound pointer to the compilation results
Intel::OpenCL::ClangFE::IOCLFEBinaryResult **pBinaryResult);
|
