2946cd7010
to reflect the new license. We understand that people may be surprised that we're moving the header entirely to discuss the new license. We checked this carefully with the Foundation's lawyer and we believe this is the correct approach. Essentially, all code in the project is now made available by the LLVM project under our new license, so you will see that the license headers include that license only. Some of our contributors have contributed code under our old license, and accordingly, we have retained a copy of our old license notice in the top-level files in each project and repository. llvm-svn: 351636
157 lines
5.3 KiB
C
157 lines
5.3 KiB
C
/*==-- clang-c/BuildSystem.h - Utilities for use by build systems -*- C -*-===*\
|
|
|* *|
|
|
|* Part of the LLVM Project, under the Apache License v2.0 with LLVM *|
|
|
|* Exceptions. *|
|
|
|* See https://llvm.org/LICENSE.txt for license information. *|
|
|
|* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception *|
|
|
|* *|
|
|
|*===----------------------------------------------------------------------===*|
|
|
|* *|
|
|
|* This header provides various utilities for use by build systems. *|
|
|
|* *|
|
|
\*===----------------------------------------------------------------------===*/
|
|
|
|
#ifndef LLVM_CLANG_C_BUILDSYSTEM_H
|
|
#define LLVM_CLANG_C_BUILDSYSTEM_H
|
|
|
|
#include "clang-c/Platform.h"
|
|
#include "clang-c/CXErrorCode.h"
|
|
#include "clang-c/CXString.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* \defgroup BUILD_SYSTEM Build system utilities
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Return the timestamp for use with Clang's
|
|
* \c -fbuild-session-timestamp= option.
|
|
*/
|
|
CINDEX_LINKAGE unsigned long long clang_getBuildSessionTimestamp(void);
|
|
|
|
/**
|
|
* Object encapsulating information about overlaying virtual
|
|
* file/directories over the real file system.
|
|
*/
|
|
typedef struct CXVirtualFileOverlayImpl *CXVirtualFileOverlay;
|
|
|
|
/**
|
|
* Create a \c CXVirtualFileOverlay object.
|
|
* Must be disposed with \c clang_VirtualFileOverlay_dispose().
|
|
*
|
|
* \param options is reserved, always pass 0.
|
|
*/
|
|
CINDEX_LINKAGE CXVirtualFileOverlay
|
|
clang_VirtualFileOverlay_create(unsigned options);
|
|
|
|
/**
|
|
* Map an absolute virtual file path to an absolute real one.
|
|
* The virtual path must be canonicalized (not contain "."/"..").
|
|
* \returns 0 for success, non-zero to indicate an error.
|
|
*/
|
|
CINDEX_LINKAGE enum CXErrorCode
|
|
clang_VirtualFileOverlay_addFileMapping(CXVirtualFileOverlay,
|
|
const char *virtualPath,
|
|
const char *realPath);
|
|
|
|
/**
|
|
* Set the case sensitivity for the \c CXVirtualFileOverlay object.
|
|
* The \c CXVirtualFileOverlay object is case-sensitive by default, this
|
|
* option can be used to override the default.
|
|
* \returns 0 for success, non-zero to indicate an error.
|
|
*/
|
|
CINDEX_LINKAGE enum CXErrorCode
|
|
clang_VirtualFileOverlay_setCaseSensitivity(CXVirtualFileOverlay,
|
|
int caseSensitive);
|
|
|
|
/**
|
|
* Write out the \c CXVirtualFileOverlay object to a char buffer.
|
|
*
|
|
* \param options is reserved, always pass 0.
|
|
* \param out_buffer_ptr pointer to receive the buffer pointer, which should be
|
|
* disposed using \c clang_free().
|
|
* \param out_buffer_size pointer to receive the buffer size.
|
|
* \returns 0 for success, non-zero to indicate an error.
|
|
*/
|
|
CINDEX_LINKAGE enum CXErrorCode
|
|
clang_VirtualFileOverlay_writeToBuffer(CXVirtualFileOverlay, unsigned options,
|
|
char **out_buffer_ptr,
|
|
unsigned *out_buffer_size);
|
|
|
|
/**
|
|
* free memory allocated by libclang, such as the buffer returned by
|
|
* \c CXVirtualFileOverlay() or \c clang_ModuleMapDescriptor_writeToBuffer().
|
|
*
|
|
* \param buffer memory pointer to free.
|
|
*/
|
|
CINDEX_LINKAGE void clang_free(void *buffer);
|
|
|
|
/**
|
|
* Dispose a \c CXVirtualFileOverlay object.
|
|
*/
|
|
CINDEX_LINKAGE void clang_VirtualFileOverlay_dispose(CXVirtualFileOverlay);
|
|
|
|
/**
|
|
* Object encapsulating information about a module.map file.
|
|
*/
|
|
typedef struct CXModuleMapDescriptorImpl *CXModuleMapDescriptor;
|
|
|
|
/**
|
|
* Create a \c CXModuleMapDescriptor object.
|
|
* Must be disposed with \c clang_ModuleMapDescriptor_dispose().
|
|
*
|
|
* \param options is reserved, always pass 0.
|
|
*/
|
|
CINDEX_LINKAGE CXModuleMapDescriptor
|
|
clang_ModuleMapDescriptor_create(unsigned options);
|
|
|
|
/**
|
|
* Sets the framework module name that the module.map describes.
|
|
* \returns 0 for success, non-zero to indicate an error.
|
|
*/
|
|
CINDEX_LINKAGE enum CXErrorCode
|
|
clang_ModuleMapDescriptor_setFrameworkModuleName(CXModuleMapDescriptor,
|
|
const char *name);
|
|
|
|
/**
|
|
* Sets the umbrealla header name that the module.map describes.
|
|
* \returns 0 for success, non-zero to indicate an error.
|
|
*/
|
|
CINDEX_LINKAGE enum CXErrorCode
|
|
clang_ModuleMapDescriptor_setUmbrellaHeader(CXModuleMapDescriptor,
|
|
const char *name);
|
|
|
|
/**
|
|
* Write out the \c CXModuleMapDescriptor object to a char buffer.
|
|
*
|
|
* \param options is reserved, always pass 0.
|
|
* \param out_buffer_ptr pointer to receive the buffer pointer, which should be
|
|
* disposed using \c clang_free().
|
|
* \param out_buffer_size pointer to receive the buffer size.
|
|
* \returns 0 for success, non-zero to indicate an error.
|
|
*/
|
|
CINDEX_LINKAGE enum CXErrorCode
|
|
clang_ModuleMapDescriptor_writeToBuffer(CXModuleMapDescriptor, unsigned options,
|
|
char **out_buffer_ptr,
|
|
unsigned *out_buffer_size);
|
|
|
|
/**
|
|
* Dispose a \c CXModuleMapDescriptor object.
|
|
*/
|
|
CINDEX_LINKAGE void clang_ModuleMapDescriptor_dispose(CXModuleMapDescriptor);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* CLANG_C_BUILD_SYSTEM_H */
|
|
|