mirror of
https://github.com/frida/tinycc
synced 2024-11-28 10:33:07 +03:00
0c928da96d
In build systems, this is used to automatically collect target
dependencies, e.g.
---- 8< (hello.c) ----
#include "hello.h"
#include <stdio.h>
int main()
{
printf("Hello World!\n");
return 0;
}
$ tcc -MD -c hello.c # -> hello.o, hello.d
$ cat hello.d
hello.o : \
hello.c \
hello.h \
/usr/include/stdio.h \
/usr/include/features.h \
/usr/include/bits/predefs.h \
/usr/include/sys/cdefs.h \
/usr/include/bits/wordsize.h \
/usr/include/gnu/stubs.h \
/usr/include/bits/wordsize.h \
/usr/include/gnu/stubs-32.h \
/home/kirr/local/tcc/lib/tcc/include/stddef.h \
/usr/include/bits/types.h \
/usr/include/bits/wordsize.h \
/usr/include/bits/typesizes.h \
/usr/include/libio.h \
/usr/include/_G_config.h \
/usr/include/wchar.h \
/home/kirr/local/tcc/lib/tcc/include/stdarg.h \
/usr/include/bits/stdio_lim.h \
/usr/include/bits/sys_errlist.h \
NOTE: gcc supports -MD only for .c -> .o, but in tcc, we generate
dependencies for whatever action is being taken. E.g. for .c -> exe, the
result will be:
$ tcc -MD -o hello hello.c # -> hello, hello.d
hello: \
/usr/lib/crt1.o \
/usr/lib/crti.o \
hello.c \
hello.h \
/usr/include/stdio.h \
/usr/include/features.h \
/usr/include/bits/predefs.h \
/usr/include/sys/cdefs.h \
/usr/include/bits/wordsize.h \
/usr/include/gnu/stubs.h \
/usr/include/bits/wordsize.h \
/usr/include/gnu/stubs-32.h \
/home/kirr/local/tcc/lib/tcc/include/stddef.h \
/usr/include/bits/types.h \
/usr/include/bits/wordsize.h \
/usr/include/bits/typesizes.h \
/usr/include/libio.h \
/usr/include/_G_config.h \
/usr/include/wchar.h \
/home/kirr/local/tcc/lib/tcc/include/stdarg.h \
/usr/include/bits/stdio_lim.h \
/usr/include/bits/sys_errlist.h \
/usr/lib/libc.so \
/lib/libc.so.6 \
/usr/lib/ld-linux.so.2 \
/lib/ld-linux.so.2 \
/usr/lib/libc_nonshared.a \
/lib/libc.so.6 \
/usr/lib/libc_nonshared.a \
/home/kirr/local/tcc/lib/tcc/libtcc1.a \
/usr/lib/crtn.o \
So tcc dependency generator is a bit more clever than one used in gcc :)
Also, I've updated TODO and Changelog (in not-yet-released section).
v2:
(Taking inputs from grischka and me myself)
- put code to generate deps file into a function.
- used tcc_fileextension() instead of open-coding
- generate deps only when compilation/preprocessing was successful
v3:
- use pstrcpy instead of snprintf(buf, sizeof(buf), "%s", ...)
125 lines
3.8 KiB
C
125 lines
3.8 KiB
C
#ifndef LIBTCC_H
|
|
#define LIBTCC_H
|
|
|
|
#ifdef LIBTCC_AS_DLL
|
|
#define LIBTCCAPI __declspec(dllexport)
|
|
#else
|
|
#define LIBTCCAPI
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct TCCState;
|
|
|
|
typedef struct TCCState TCCState;
|
|
|
|
/* create a new TCC compilation context */
|
|
LIBTCCAPI TCCState *tcc_new(void);
|
|
|
|
/* free a TCC compilation context */
|
|
LIBTCCAPI void tcc_delete(TCCState *s);
|
|
|
|
/* add debug information in the generated code */
|
|
LIBTCCAPI void tcc_enable_debug(TCCState *s);
|
|
|
|
/* 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/reset a warning */
|
|
LIBTCCAPI int tcc_set_warning(TCCState *s, const char *warning_name, int value);
|
|
|
|
/* set linker option */
|
|
LIBTCCAPI const char * tcc_set_linker(TCCState *s, char *option, int multi);
|
|
|
|
/*****************************/
|
|
/* 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 (either a C file, dll, an object, a library or an ld
|
|
script). Return -1 if error. */
|
|
LIBTCCAPI int tcc_add_file(TCCState *s, const char *filename);
|
|
|
|
/* compile a string containing a C source. Return non zero if
|
|
error. */
|
|
LIBTCCAPI int tcc_compile_string(TCCState *s, const char *buf);
|
|
|
|
/*****************************/
|
|
/* linking commands */
|
|
|
|
/* set output type. MUST BE CALLED before any compilation */
|
|
#define TCC_OUTPUT_MEMORY 0 /* output will be ran in memory (no
|
|
output file) (default) */
|
|
#define TCC_OUTPUT_EXE 1 /* executable file */
|
|
#define TCC_OUTPUT_DLL 2 /* dynamic library */
|
|
#define TCC_OUTPUT_OBJ 3 /* object file */
|
|
#define TCC_OUTPUT_PREPROCESS 4 /* preprocessed file (used internally) */
|
|
LIBTCCAPI int tcc_set_output_type(TCCState *s, int output_type);
|
|
|
|
#define TCC_OUTPUT_FORMAT_ELF 0 /* default output format: ELF */
|
|
#define TCC_OUTPUT_FORMAT_BINARY 1 /* binary image output */
|
|
#define TCC_OUTPUT_FORMAT_COFF 2 /* COFF */
|
|
|
|
/* 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())
|
|
Returns -1 on error. */
|
|
LIBTCCAPI int tcc_relocate(TCCState *s1);
|
|
|
|
/* return symbol value or NULL if not found */
|
|
LIBTCCAPI void *tcc_get_symbol(TCCState *s, const char *name);
|
|
|
|
/* set CONFIG_TCCDIR at runtime */
|
|
LIBTCCAPI void tcc_set_lib_path(TCCState *s, const char *path);
|
|
|
|
|
|
/*****************************/
|
|
/* Miscellaneous */
|
|
|
|
/* Get default target filename for this compilation */
|
|
LIBTCCAPI const char *tcc_default_target(TCCState *s);
|
|
|
|
/* Generate make dependencies for target and store them into file
|
|
*
|
|
* !target - use default target name
|
|
* !filename - use (target.o -> target.d)
|
|
*/
|
|
LIBTCCAPI void tcc_gen_makedeps(TCCState *s, const char *target, const char *filename);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|