Danylo Lytovchenko
218 satır
12 KiB
C
218 satır
12 KiB
C
/* Copyright (c) 2012 - 2021 Advanced Micro Devices, Inc.
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE. */
|
|
|
|
#ifndef _ACL_0_8_H_
|
|
#define _ACL_0_8_H_
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
#include "aclTypes.h"
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with aclCompiler objects.
|
|
//!--------------------------------------------------------------------------!//
|
|
aclCompiler* ACL_API_ENTRY aclCompilerInit(aclCompilerOptions* opts,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
acl_error ACL_API_ENTRY aclCompilerFini(aclCompiler* cl) ACL_API_0_8;
|
|
aclCLVersion ACL_API_ENTRY aclCompilerVersion(aclCompiler* cl, acl_error* error_code) ACL_API_0_8;
|
|
uint32_t ACL_API_ENTRY aclVersionSize(aclCLVersion num, acl_error* error_code) ACL_API_0_8;
|
|
const char* ACL_API_ENTRY aclGetErrorString(acl_error error_code) ACL_API_0_8;
|
|
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with target specific information.
|
|
//!--------------------------------------------------------------------------!//
|
|
//! Returns in the names argument, if non-NULL, a pointer to each of the arch
|
|
// names that the compiler supports. If names is NULL and arch_size is
|
|
// non-NULL, returns the number of arch entries that are required.
|
|
acl_error ACL_API_ENTRY aclGetArchInfo(const char** arch_names, size_t* arch_size) ACL_API_0_8;
|
|
|
|
//! Returns in the arch argument, if non-NULL, a pointer to each device
|
|
// name that the compiler supports. If device_size is non-NULL,
|
|
// returns the number of device entries that are used.
|
|
acl_error ACL_API_ENTRY aclGetDeviceInfo(const char* arch, const char** names,
|
|
size_t* device_size) ACL_API_0_8;
|
|
|
|
//! Function that returns a correctly filled out aclTargetInfo structure based
|
|
// on the information passed into the kernel.
|
|
aclTargetInfo ACL_API_ENTRY aclGetTargetInfo(const char* arch, const char* device,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
|
|
//! Function that returns a correctly filled out aclTargetInfo structure based
|
|
// on the information passed into the kernel.
|
|
aclTargetInfo ACL_API_ENTRY aclGetTargetInfoFromChipID(const char* arch, const uint32_t chip_id,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
|
|
//! Function that returns a string representation of the target architecture.
|
|
const char* ACL_API_ENTRY aclGetArchitecture(const aclTargetInfo& target) ACL_API_0_8;
|
|
|
|
//! Function that returns a string representation of the target chip options.
|
|
const uint64_t ACL_API_ENTRY aclGetChipOptions(const aclTargetInfo& target) ACL_API_0_8;
|
|
|
|
//! Function that returns a string representation of the target family.
|
|
const char* ACL_API_ENTRY aclGetFamily(const aclTargetInfo& target) ACL_API_0_8;
|
|
|
|
//! Function that returns a string representation of the target chip.
|
|
const char* ACL_API_ENTRY aclGetChip(const aclTargetInfo& target) ACL_API_0_8;
|
|
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with aclBinary objects.
|
|
//!--------------------------------------------------------------------------!//
|
|
aclBinary* ACL_API_ENTRY aclBinaryInit(size_t struct_version, const aclTargetInfo* target,
|
|
const aclBinaryOptions* options,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclBinaryFini(aclBinary* bin) ACL_API_0_8;
|
|
|
|
aclBinary* ACL_API_ENTRY aclReadFromFile(const char* str, acl_error* error_code) ACL_API_0_8;
|
|
|
|
aclBinary* ACL_API_ENTRY aclReadFromMem(const void* mem, size_t size,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclWriteToFile(aclBinary* bin, const char* str) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclWriteToMem(aclBinary* bin, void** mem, size_t* size) ACL_API_0_8;
|
|
|
|
aclBinary* ACL_API_ENTRY aclCreateFromBinary(const aclBinary* binary,
|
|
aclBIFVersion version) ACL_API_0_8;
|
|
|
|
aclBIFVersion ACL_API_ENTRY aclBinaryVersion(const aclBinary* binary) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclInsertSection(aclCompiler* cl, aclBinary* binary, const void* data,
|
|
size_t data_size, aclSections id) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclInsertSymbol(aclCompiler* cl, aclBinary* binary, const void* data,
|
|
size_t data_size, aclSections id,
|
|
const char* symbol) ACL_API_0_8;
|
|
|
|
const void* ACL_API_ENTRY aclExtractSection(aclCompiler* cl, const aclBinary* binary, size_t* size,
|
|
aclSections id, acl_error* error_code) ACL_API_0_8;
|
|
|
|
const void* ACL_API_ENTRY aclExtractSymbol(aclCompiler* cl, const aclBinary* binary, size_t* size,
|
|
aclSections id, const char* symbol,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclRemoveSection(aclCompiler* cl, aclBinary* binary,
|
|
aclSections id) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclRemoveSymbol(aclCompiler* cl, aclBinary* binary, aclSections id,
|
|
const char* symbol) ACL_API_0_8;
|
|
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with debug/metdata.
|
|
//!--------------------------------------------------------------------------!//
|
|
acl_error ACL_API_ENTRY aclQueryInfo(aclCompiler* cl, const aclBinary* binary, aclQueryType query,
|
|
const char* kernel, void* data_ptr,
|
|
size_t* ptr_size) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclDbgAddArgument(aclCompiler* cl, aclBinary* binary, const char* kernel,
|
|
const char* name, bool byVal) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclDbgRemoveArgument(aclCompiler* cl, aclBinary* binary, const char* kernel,
|
|
const char* name) ACL_API_0_8;
|
|
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with various compilation phases.
|
|
//!--------------------------------------------------------------------------!//
|
|
acl_error ACL_API_ENTRY aclCompile(aclCompiler* cl, aclBinary* bin, const char* options,
|
|
aclType from, aclType to,
|
|
aclLogFunction compile_callback) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclLink(aclCompiler* cl, aclBinary* src_bin, unsigned int num_libs,
|
|
aclBinary** libs, aclType link_mode, const char* options,
|
|
aclLogFunction link_callback) ACL_API_0_8;
|
|
|
|
const char* ACL_API_ENTRY aclGetCompilerLog(aclCompiler* cl) ACL_API_0_8;
|
|
|
|
const void* ACL_API_ENTRY aclRetrieveType(aclCompiler* cl, const aclBinary* bin, const char* name,
|
|
size_t* data_size, aclType type,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclSetType(aclCompiler* cl, aclBinary* bin, const char* name, aclType type,
|
|
const void* data, size_t size) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclConvertType(aclCompiler* cl, aclBinary* bin, const char* name,
|
|
aclType type) ACL_API_0_8;
|
|
|
|
acl_error ACL_API_ENTRY aclDisassemble(aclCompiler* cl, aclBinary* bin, const char* kernel,
|
|
aclLogFunction disasm_callback) ACL_API_0_8;
|
|
|
|
const void* ACL_API_ENTRY aclGetDeviceBinary(aclCompiler* cl, const aclBinary* bin,
|
|
const char* kernel, size_t* size,
|
|
acl_error* error_code) ACL_API_0_8;
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with binary image.
|
|
//!--------------------------------------------------------------------------!//
|
|
bool ACL_API_ENTRY aclValidateBinaryImage(const void* binary, size_t length, unsigned) ACL_API_0_8;
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with aclJITObjectImage objects.
|
|
//!--------------------------------------------------------------------------!//
|
|
aclJITObjectImage ACL_API_ENTRY aclJITObjectImageCreate(aclCompiler* cl, const void* buffer,
|
|
size_t length, aclBinary* bin,
|
|
acl_error* error_code);
|
|
|
|
aclJITObjectImage ACL_API_ENTRY aclJITObjectImageCopy(aclCompiler* cl, const void* buffer,
|
|
size_t length, acl_error* error_code);
|
|
|
|
acl_error ACL_API_ENTRY aclJITObjectImageDestroy(aclCompiler* cl, aclJITObjectImage buffer);
|
|
|
|
acl_error ACL_API_ENTRY aclJITObjectImageFinalize(aclCompiler* cl, aclJITObjectImage image);
|
|
|
|
size_t ACL_API_ENTRY aclJITObjectImageSize(aclCompiler* cl, aclJITObjectImage image,
|
|
acl_error* error_code);
|
|
|
|
const char* ACL_API_ENTRY aclJITObjectImageData(aclCompiler* cl, aclJITObjectImage image,
|
|
acl_error* error_code);
|
|
|
|
size_t ACL_API_ENTRY aclJITObjectImageGetGlobalsSize(aclCompiler* cl, aclJITObjectImage image,
|
|
acl_error* error_code);
|
|
|
|
acl_error ACL_API_ENTRY aclJITObjectImageIterateSymbols(aclCompiler* cl, aclJITObjectImage image,
|
|
aclJITSymbolCallback callback, void* data);
|
|
|
|
#if defined(LEGACY_COMPLIB)
|
|
char* ACL_API_ENTRY aclJITObjectImageDisassembleKernel(aclCompiler* cl,
|
|
constAclJITObjectImage image,
|
|
const char* kernel, acl_error* error_code);
|
|
#endif
|
|
|
|
//!--------------------------------------------------------------------------!//
|
|
// Debug functionality
|
|
//!--------------------------------------------------------------------------!//
|
|
void aclDumpBinary(const aclBinary* bin);
|
|
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with kenel statistics.
|
|
//!--------------------------------------------------------------------------!//
|
|
void aclGetKstatsSI(const void* shader, aclKernelStats& kstats);
|
|
acl_error ACL_API_ENTRY aclInsertKernelStatistics(aclCompiler* cl, aclBinary* bin);
|
|
//! Define hardware info constants for SI and above devices
|
|
static constexpr unsigned SI_sgprs_avail = 102;
|
|
static constexpr unsigned SI_vgprs_avail = 256;
|
|
static constexpr unsigned SI_ldssize_avail = 32 * 1024;
|
|
|
|
//!--------------------------------------------------------------------------!//
|
|
// Functions that deal with memory.
|
|
// Free memory allocated by aclWriteToMem
|
|
//!--------------------------------------------------------------------------!//
|
|
acl_error ACL_API_ENTRY aclFreeMem(aclBinary* bin, void* mem);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif // _ACL_0_8_H_
|