MAN page from OpenSuSE tcc-0.9.27-6.83.i586.rpm

TCC-DOC

Section: Tiny C Compiler (1)
Updated: 2024-10-11
Index

NAME

tcc - Tiny C Compiler

SYNOPSIS

usage: tcc [options] [infile1 infile2...] [-run infile args...]

DESCRIPTION

TCC options are a very much like gcc options. The main difference is that TCCcan also execute directly the resulting program and give it runtimearguments.

Here are some examples to understand the logic:

"tcc -run a.c": Compile a.c and execute it directly
"tcc -run a.c arg1": Compile a.c and execute it directly. arg1 is given as first argument tothe main() of a.c.
"tcc a.c -run b.c arg1": Compile a.c and b.c, link them together and execute them. arg1 is givenas first argument to the main() of the resulting program.
"tcc -o myprog a.c b.c": Compile a.c and b.c, link them and generate the executable myprog.
"tcc -o myprog a.o b.o": link a.o and b.o together and generate the executable myprog.
"tcc -c a.c": Compile a.c and generate object file a.o.
"tcc -c asmfile.S": Preprocess with C preprocess and assemble asmfile.S and generateobject file asmfile.o.
"tcc -c asmfile.s": Assemble (but not preprocess) asmfile.s and generate object fileasmfile.o.
"tcc -r -o ab.o a.c b.c": Compile a.c and b.c, link them together and generate the object file ab.o.

Scripting:

TCC can be invoked from scripts, just as shell scripts. You justneed to add "#!/usr/local/bin/tcc -run" at the start of your C source:

        #!/usr/local/bin/tcc -run        #include <stdio.h>                int main()         {            printf("Hello World\n");            return 0;        }

TCC can read C source code from standard input when - is used in place of infile. Example:

        echo 'main(){puts("hello");}' | tcc -run -

OPTIONS

-c

Generate an object file.

-o outfile

Put object file, executable, or dll into output file outfile.

-run source [args...]

Compile file source and run it with the command line argumentsargs. In order to be able to give more than one argument to ascript, several TCC options can be given after the-run option, separated by spaces:

        tcc "-run -L/usr/X11R6/lib -lX11" ex4.c

In a script, it gives the following header:

        #!/usr/local/bin/tcc -run -L/usr/X11R6/lib -lX11

-v

Display TCC version.

-vv

Show included files. As sole argument, print search dirs. -vvv shows tries too.

-bench

Display compilation statistics.

Preprocessor options:

-Idir: Specify an additional include path. Include paths are searched in theorder they are specified.
System include paths are always searched after. The default systeminclude paths are: /usr/local/include, /usr/includeand PREFIX/lib/tcc/include. (PREFIX is usually/usr or /usr/local).
-Dsym[=val]: Define preprocessor symbol sym toval. If val is not present, its value is 1. Function-like macros canalso be defined: -DF(a)=a+1
-Usym: Undefine preprocessor symbol sym.
-E: Preprocess only, to stdout or file (with -o).

Compilation flags:

Note: each of the following options has a negative form beginning with-fno-.

-funsigned-char: Let the "char" type be unsigned.
-fsigned-char: Let the "char" type be signed.
-fno-common: Do not generate common symbols for uninitialized data.
-fleading-underscore: Add a leading underscore at the beginning of each C symbol.
-fms-extensions: Allow a MS C compiler extensions to the language. Currently thisassumes a nested named structure declaration without an identifierbehaves like an unnamed one.
-fdollars-in-identifiers: Allow dollar signs in identifiers
-ftest-coverage: Create code coverage code. After running the resulting code an executable.tcovor sofile.tcov file is generated with code coverage.

Warning options:

-w: Disable all warnings.

Note: each of the following warning options has a negative form beginning with-Wno-.

-Wimplicit-function-declaration: Warn about implicit function declaration.
-Wunsupported: Warn about unsupported GCC features that are ignored by TCC.
-Wwrite-strings: Make string constants be of type "const char *" instead of "char*".
-Werror: Abort compilation if a warning is issued. Can be given an option to enablethe specified warning and turn it into an error, for example-Werror=unsupported.
-Wall: Activate some useful warnings.

Linker options:

-Ldir

Specify an additional static library path for the -l option. Thedefault library paths are /usr/local/lib, /usr/lib and /lib.

-lxxx

Link your program with dynamic library libxxx.so or static librarylibxxx.a. The library is searched in the paths specified by the-L option and LIBRARY_PATH variable.

-Bdir

Set the path where the tcc internal libraries (and include files) can befound (default is PREFIX/lib/tcc).

-shared

Generate a shared library instead of an executable.

-soname name

set name for shared library to be used at runtime

-static

Generate a statically linked executable (default is a shared linkedexecutable).

-rdynamic

Export global symbols to the dynamic linker. It is useful when a libraryopened with dlopen() needs to access executable symbols.

-r

Generate an object file combining all input files.

-Wl,-rpath=path

Put custom search path for dynamic libraries into executable.

-Wl,--enable-new-dtags

When putting a custom search path for dynamic libraries into the executable,create the new ELF dynamic tag DT_RUNPATH instead of the old legacy DT_RPATH.

-Wl,--oformat=fmt

Use fmt as output format. The supported output formats are:

"elf32-i386": ELF output format (default)
"binary": Binary image (only for executable output)
"coff": COFF output format (only for executable output for TMS320C67xx target)

-Wl,--export-all-symbols

-Wl,--export-dynamic

Export global symbols to the dynamic linker. It is useful when a libraryopened with dlopen() needs to access executable symbols.

-Wl,-subsystem=console/gui/wince/...

Set type for PE (Windows) executables.

-Wl,-[Ttext=# | section-alignment=# | file-alignment=# | image-base=# | stack=#]

Modify executable layout.

-Wl,-Bsymbolic

Set DT_SYMBOLIC tag.

-Wl,-(no-)whole-archive

Turn on/off linking of all objects in archives.

Debugger options:

-g: Generate run time debug information so that you get clear run timeerror messages: " test.c:68: in function 'test5()': dereferencinginvalid pointer" instead of the laconic "Segmentationfault".
-b: Generate additional support code to check memory allocations and array/pointerbounds. -g is implied.
-bt[N]: Display N callers in stack traces. This is useful with -g or -b.With executables, additional support for stack traces is included.
A function " int tcc_backtrace(const char *fmt, ...); " is providedto trigger a stack trace with a message on demand.

Misc options:

-M: Just output makefile fragment with dependencies
-MM: Like -M except mention only user header files, not system header files.
-MD: Generate makefile fragment with dependencies.
-MMD: Like -MD except mention only user header files, not system header files.
-MF depfile: Use depfile as output for -MD.
-print-search-dirs: Print the configured installation directory and a list of libraryand include directories tcc will search.
-dumpversion: Print version.

Target specific options:

-mms-bitfields: Use an algorithm for bitfield alignment consistent with MSVC. Default isgcc's algorithm.
-mfloat-abi (ARM only): Select the float ABI. Possible values: "softfp" and "hard"
-mno-sse: Do not use sse registers on x86_64
-m32, -m64: Pass command line to the i386/x86_64 cross compiler.

Note: GCC options -Ox, -fx and -mx areignored.

ENVIRONMENT

Environment variables that affect how tcc operates.

CPATH
C_INCLUDE_PATH: A colon-separated list of directories searched for include files,directories given with -I are searched first.
LIBRARY_PATH: A colon-separated list of directories searched for libraries for the-l option, directories given with -L are searched first.

AUTHOR

Fabrice Bellard

This document was created byman2html,using the manual pages.