Go to file
grischka 263dc93cfa c67: remove global #define's for TRUE/FALSE/BOOL
Also use uppercase TRUE/FALSE instead of true/false
2013-02-04 16:24:56 +01:00
examples Revert "Make ex1.c and ex4.c be executable on any systems" 2012-06-12 15:45:13 +02:00
include win32: _mingw.h: do not undef NULL 2013-01-24 19:49:58 +01:00
lib configure: use relative paths for in-tree build 2013-01-30 18:39:09 +01:00
tests Don't do builtin_frame_address test with ARM gcc 2013-01-26 20:31:14 +01:00
tests2 Fix [f]getc return value usage in 40_stdio test 2013-01-24 10:55:18 +01:00
win32 win32: _mingw.h: do not undef NULL 2013-01-24 19:49:58 +01:00
.gitignore tests: Add tests for compile/run tcc.c with tcc -b then compile tcc.c again, then run tcctest.c 2012-12-09 19:43:40 +04:00
arm-gen.c arm-gen.c: fix var initialization in gfunc_call 2013-02-04 11:01:58 +01:00
c67-gen.c c67: remove global #define's for TRUE/FALSE/BOOL 2013-02-04 16:24:56 +01:00
Changelog Changelog: cleanup 2013-01-30 18:50:02 +01:00
coff.h C67 COFF executable format support (TK) 2004-10-05 22:33:55 +00:00
configure configure: use relative paths for in-tree build 2013-01-30 18:39:09 +01:00
COPYING changed license to LGPL 2003-05-24 14:18:56 +00:00
elf.h Add support for R_ARM_THM_{JUMP24,CALL} relocs 2012-10-28 19:55:12 +01:00
i386-asm.c rename error/warning -> tcc_(error/warning) 2011-08-11 17:07:56 +02:00
i386-asm.h i386-asm: support "pause" opcode 2011-02-24 09:38:13 -08:00
i386-gen.c i386: We can change 'lea 0(%ebp),r' to 'mov %ebp,r' 2012-11-16 10:22:45 +04:00
i386-tok.h integrate x86_64-asm.c into i386-asm.c 2009-12-19 22:16:20 +01:00
il-gen.c rename error/warning -> tcc_(error/warning) 2011-08-11 17:07:56 +02:00
il-opcodes.h added CIL target 2002-02-10 16:14:03 +00:00
libtcc.c c67: remove global #define's for TRUE/FALSE/BOOL 2013-02-04 16:24:56 +01:00
libtcc.h Revert "Added what I call virtual io to tinycc this way we can make a monolitic executable or library that contains all needed to compile programs, truly tinycc portable." 2013-01-14 17:34:07 +01:00
Makefile Fix cross-compilation out-of-tree build 2013-01-30 19:39:29 +01:00
README configure: support absolete out-of-tree builds 2012-12-21 13:57:22 +01:00
stab.def added 2002-12-08 14:36:36 +00:00
stab.h added 2002-12-08 14:36:36 +00:00
tcc-doc.texi Inform user that -b only exists on i386. 2012-03-13 19:43:43 +01:00
tcc.c c67: remove global #define's for TRUE/FALSE/BOOL 2013-02-04 16:24:56 +01:00
tcc.h c67: remove global #define's for TRUE/FALSE/BOOL 2013-02-04 16:24:56 +01:00
tccasm.c Compile tccasm.c conditionally (TCC_CONFIG_ASM) 2012-01-06 18:34:21 +01:00
tcccoff.c c67: remove global #define's for TRUE/FALSE/BOOL 2013-02-04 16:24:56 +01:00
tccelf.c Revert "Don't call elf_hash on NULL value" 2013-01-31 13:43:04 +01:00
tccgen.c Revert "Add predictability in CType initialization." 2013-01-31 13:43:04 +01:00
tccpe.c safety: replace occurrences of strcpy by pstrcpy 2013-01-31 13:23:19 +01:00
tccpp.c Revert "Added what I call virtual io to tinycc this way we can make a monolitic executable or library that contains all needed to compile programs, truly tinycc portable." 2013-01-14 17:34:07 +01:00
tccrun.c tccrun: another incompatible change to the tcc_relocate API 2012-09-01 11:33:34 +02:00
tcctok.h tcctok.h: fix ifdef target/host confusion 2011-04-12 00:11:47 -07:00
texi2pod.pl automatic man page generation from tcc-doc.texi 2003-05-18 18:11:06 +00:00
TODO re-apply VLA by Thomas Preud'homme 2011-04-06 09:17:03 -07:00
VERSION update Changelog, bump version: 0.9.25 2009-05-11 19:01:26 +02:00
x86_64-asm.h x86-64: fix udiv, add cqto instruction 2009-12-19 22:16:19 +01:00
x86_64-gen.c x86-64: Fix call saved register restore 2012-06-10 09:01:26 +02:00

Tiny C Compiler - C Scripting Everywhere - The Smallest ANSI C compiler
-----------------------------------------------------------------------

Features:
--------

- SMALL! You can compile and execute C code everywhere, for example on
  rescue disks.

- FAST! tcc generates optimized x86 code. No byte code
  overhead. Compile, assemble and link about 7 times faster than 'gcc
  -O0'.

- UNLIMITED! Any C dynamic library can be used directly. TCC is
  heading torward full ISOC99 compliance. TCC can of course compile
  itself.

- SAFE! tcc includes an optional memory and bound checker. Bound
  checked code can be mixed freely with standard code.

- Compile and execute C source directly. No linking or assembly
  necessary. Full C preprocessor included. 

- C script supported : just add '#!/usr/local/bin/tcc -run' at the first
  line of your C source, and execute it directly from the command
  line.

Documentation:
-------------

1) Installation on a i386 Linux host (for Windows read tcc-win32.txt)

   ./configure
   make
   make test
   make install

Alternatively, out-of-tree builds are supported: you may use different
directories to hold build objects, kept separate from your source tree:

   mkdir _build
   cd _build
   ../configure
   make
   make test
   make install

By default, tcc is installed in /usr/local/bin.
./configure --help  shows configuration options.


2) Introduction

We assume here that you know ANSI C. Look at the example ex1.c to know
what the programs look like.

The include file <tcclib.h> can be used if you want a small basic libc
include support (especially useful for floppy disks). Of course, you
can also use standard headers, although they are slower to compile.

You can begin your C script with '#!/usr/local/bin/tcc -run' on the first
line and set its execute bits (chmod a+x your_script). Then, you can
launch the C code as a shell or perl script :-) The command line
arguments are put in 'argc' and 'argv' of the main functions, as in
ANSI C.

3) Examples

ex1.c: simplest example (hello world). Can also be launched directly
as a script: './ex1.c'.

ex2.c: more complicated example: find a number with the four
operations given a list of numbers (benchmark).

ex3.c: compute fibonacci numbers (benchmark).

ex4.c: more complicated: X11 program. Very complicated test in fact
because standard headers are being used ! As for ex1.c, can also be launched
directly as a script: './ex4.c'.

ex5.c: 'hello world' with standard glibc headers.

tcc.c: TCC can of course compile itself. Used to check the code
generator.

tcctest.c: auto test for TCC which tests many subtle possible bugs. Used
when doing 'make test'.

4) Full Documentation

Please read tcc-doc.html to have all the features of TCC.

Additional information is available for the Windows port in tcc-win32.txt.

License:
-------

TCC is distributed under the GNU Lesser General Public License (see
COPYING file).

Fabrice Bellard.