This project is a fork of the tinycc.git project. If you have that one already cloned locally, you can use
git clone --reference /path/to/your/tinycc.git/incarnation mirror_URL
to save bandwidth during cloning.
 
descriptionkirr's tinycc tree
ownerkirr@navytux.spb.ru
last changeThu, 14 Jan 2010 20:00:05 +0000 (14 21:00 +0100)
content tags
add:
readme
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

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 !

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.
shortlog
2010-01-14 grischkatccpp: signal missing #endif errormaster
2010-01-14 grischkatccpp: convert TOK_GET macro into function
2010-01-14 grischkatccpp: warn about #define redefinition
2010-01-14 grischkawin64: defined size_t and ptrdiff_t to unsigned long...
2010-01-14 grischkawin32: cleanup include
2010-01-14 grischkax86-64: use uplong for symbol values
2010-01-14 grischkatccpe: improve dllimport/export and use for tcc_add_symbol
2010-01-14 grischkawin32: readme: add libtcc_test example
2009-12-20 grischkaupdate Makefiles
2009-12-20 grischkabuild from multiple objects: fix other targets
2009-12-20 grischkax86-64: fix gtst, back to only 5 regs for now
2009-12-20 grischkax86-64: use r8/r9 as generic integer registers
2009-12-20 grischkax86-64: use r8,r9 as load/store registers
2009-12-20 grischkawin32: add size_t to _mingw.h
2009-12-20 grischkause vpushv in some places
2009-12-20 grischkawin64: add tiny unwind data for setjmp/longjmp
...
heads
2 years ago mob
3 years ago bcheck2
6 years ago tcc-MD
6 years ago x/elflink
6 years ago master
8 years ago rob