mirror of
https://github.com/frida/tinycc
synced 2024-11-24 00:29:38 +03:00
ec4fb94d7d
Useful for resolving symbols dynamically.
122 lines
3.9 KiB
C
122 lines
3.9 KiB
C
#ifndef LIBTCC_H
|
|
#define LIBTCC_H
|
|
|
|
#ifndef LIBTCCAPI
|
|
# define LIBTCCAPI
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct TCCState;
|
|
|
|
typedef struct TCCState TCCState;
|
|
typedef struct TCCSymbolDetails TCCSymbolDetails;
|
|
|
|
typedef int (*TCCEnumerateSymbolsFunc)(void *opaque,
|
|
const TCCSymbolDetails *details);
|
|
|
|
struct TCCSymbolDetails {
|
|
const char *name;
|
|
void *value;
|
|
};
|
|
|
|
/* create a new TCC compilation context */
|
|
LIBTCCAPI TCCState *tcc_new(void);
|
|
|
|
/* free a TCC compilation context */
|
|
LIBTCCAPI void tcc_delete(TCCState *s);
|
|
|
|
/* set CONFIG_TCCDIR at runtime */
|
|
LIBTCCAPI void tcc_set_lib_path(TCCState *s, const char *path);
|
|
|
|
/* set error/warning display callback */
|
|
LIBTCCAPI void tcc_set_error_func(TCCState *s, void *error_opaque,
|
|
void (*error_func)(void *opaque, const char *msg));
|
|
|
|
/* set preprocessor loader callback */
|
|
LIBTCCAPI void tcc_set_cpp_load_func(TCCState *s, void *cpp_load_opaque,
|
|
const char *(*cpp_load_func)(void *opaque, const char *path, int *len));
|
|
|
|
/* set linker resolver callback */
|
|
LIBTCCAPI void tcc_set_linker_resolve_func(TCCState *s, void *resolve_opaque,
|
|
void *(*resolve_func)(void *opaque, const char *name));
|
|
|
|
/* set options as from command line (multiple supported) */
|
|
LIBTCCAPI void tcc_set_options(TCCState *s, const char *str);
|
|
|
|
/*****************************/
|
|
/* preprocessor */
|
|
|
|
/* add include path */
|
|
LIBTCCAPI int tcc_add_include_path(TCCState *s, const char *pathname);
|
|
|
|
/* add in system include path */
|
|
LIBTCCAPI int tcc_add_sysinclude_path(TCCState *s, const char *pathname);
|
|
|
|
/* define preprocessor symbol 'sym'. Can put optional value */
|
|
LIBTCCAPI void tcc_define_symbol(TCCState *s, const char *sym, const char *value);
|
|
|
|
/* undefine preprocess symbol 'sym' */
|
|
LIBTCCAPI void tcc_undefine_symbol(TCCState *s, const char *sym);
|
|
|
|
/*****************************/
|
|
/* compiling */
|
|
|
|
/* add a file (C file, dll, object, library, ld script). Return -1 if error. */
|
|
LIBTCCAPI int tcc_add_file(TCCState *s, const char *filename);
|
|
|
|
/* compile a string containing a C source. Return -1 if error. */
|
|
LIBTCCAPI int tcc_compile_string(TCCState *s, const char *buf);
|
|
|
|
/*****************************/
|
|
/* linking commands */
|
|
|
|
/* set output type. MUST BE CALLED before any compilation */
|
|
LIBTCCAPI int tcc_set_output_type(TCCState *s, int output_type);
|
|
#define TCC_OUTPUT_MEMORY 1 /* output will be run in memory (default) */
|
|
#define TCC_OUTPUT_EXE 2 /* executable file */
|
|
#define TCC_OUTPUT_DLL 3 /* dynamic library */
|
|
#define TCC_OUTPUT_OBJ 4 /* object file */
|
|
#define TCC_OUTPUT_PREPROCESS 5 /* only preprocess (used internally) */
|
|
|
|
/* equivalent to -Lpath option */
|
|
LIBTCCAPI int tcc_add_library_path(TCCState *s, const char *pathname);
|
|
|
|
/* the library name is the same as the argument of the '-l' option */
|
|
LIBTCCAPI int tcc_add_library(TCCState *s, const char *libraryname);
|
|
|
|
/* add a symbol to the compiled program */
|
|
LIBTCCAPI int tcc_add_symbol(TCCState *s, const char *name, const void *val);
|
|
|
|
/* output an executable, library or object file. DO NOT call
|
|
tcc_relocate() before. */
|
|
LIBTCCAPI int tcc_output_file(TCCState *s, const char *filename);
|
|
|
|
/* link and run main() function and return its value. DO NOT call
|
|
tcc_relocate() before. */
|
|
LIBTCCAPI int tcc_run(TCCState *s, int argc, char **argv);
|
|
|
|
/* do all relocations (needed before using tcc_get_symbol()) */
|
|
LIBTCCAPI int tcc_relocate(TCCState *s1, void *ptr);
|
|
/* possible values for 'ptr':
|
|
- TCC_RELOCATE_AUTO : Allocate and manage memory internally
|
|
- NULL : return required memory size for the step below
|
|
- memory address : copy code to memory passed by the caller
|
|
returns -1 if error. */
|
|
#define TCC_RELOCATE_AUTO (void*)1
|
|
|
|
/* enumerate symbols, stop early if enumerate_func returns a nonzero value */
|
|
LIBTCCAPI int tcc_enumerate_symbols(TCCState *s, void *enumerate_opaque,
|
|
TCCEnumerateSymbolsFunc enumerate_func);
|
|
|
|
/* return symbol value or NULL if not found */
|
|
LIBTCCAPI void *tcc_get_symbol(TCCState *s, const char *name);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|