Go to file
Michael Matz 671dcace82 Implement function alignment via attributes
which requires being able to emit an arbitrary number of NOP
instructions, which is also implemented here.  For x86 we
could emit other sequences but these are the easiest.
2018-04-06 23:02:42 +02:00
examples makefile: unify cross with native builds 2017-02-25 12:51:04 +01:00
include various stuff 2017-10-11 18:13:43 +02:00
lib various stuff 2017-10-11 18:13:43 +02:00
tests Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
win32 various stuff 2017-10-11 18:13:43 +02:00
.gitignore final update for 0.9.27 2017-12-12 17:57:20 +01:00
arm64-gen.c Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
arm64-link.c final update for 0.9.27 2017-12-12 17:57:20 +01:00
arm-asm.c tccgen: nodata_wanted fix, default ONE_SOURCE, etc... 2017-07-23 21:24:11 +02:00
arm-gen.c Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
arm-link.c final update for 0.9.27 2017-12-12 17:57:20 +01:00
c67-gen.c Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
c67-link.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
Changelog 'long' review 2017-09-24 18:57:48 +02:00
CodingStyle CodingStyle: Remove reference to misaligned struct CString. 2016-01-06 19:09:28 +00:00
coff.h Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
configure Select VFP if triplet is arm-linux-gnueabihf 2018-03-15 23:05:25 +00:00
conftest.c tcctools.c: integrate tiny_libmaker/_impdef 2017-02-18 09:55:34 +01:00
COPYING changed license to LGPL 2003-05-24 14:18:56 +00:00
elf.h Spelling fixes 2017-09-24 18:03:26 -07:00
i386-asm.c tccasm: Accept suffixed cmovCC 2017-12-03 04:53:50 +01:00
i386-asm.h x86-asm: Fix lar opcode operands 2016-12-15 17:47:08 +01:00
i386-gen.c Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
i386-link.c final update for 0.9.27 2017-12-12 17:57:20 +01:00
i386-tok.h x86-64-asm: Support high registers %r8 - %r15 2016-12-15 17:47:09 +01:00
il-gen.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
il-opcodes.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
libtcc.c Revert "Fix -pthread option handling" 2017-12-23 14:46:27 +01:00
libtcc.h various stuff 2017-10-11 18:13:43 +02:00
Makefile Add make testspp.all/testspp.20 2018-01-05 02:19:26 +01:00
README tcc: re-enable correct option -r support 2017-02-20 18:58:08 +01:00
RELICENSING Add note about native Windows bootstrap using Cygwin. 2017-02-23 06:45:26 +01:00
stab.def Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
stab.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tcc-doc.texi Fix some spelling in documentation 2017-09-24 18:22:42 -07:00
tcc.c Fix -pthread in a different way 2017-12-23 14:49:07 +01:00
tcc.h Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
tccasm.c final update for 0.9.27 2017-12-12 17:57:20 +01:00
tcccoff.c Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tccelf.c Prevent dead code on !x86 in prepare_dynamic_rel 2018-02-24 19:35:15 +00:00
tccgen.c Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
tcclib.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tccpe.c final update for 0.9.27 2017-12-12 17:57:20 +01:00
tccpp.c tccasm: Unify C and asm symbol table 2017-11-27 04:59:29 +01:00
tccrun.c final update for 0.9.27 2017-12-12 17:57:20 +01:00
tcctok.h various stuff 2017-10-11 18:13:43 +02:00
tcctools.c final update for 0.9.27 2017-12-12 17:57:20 +01:00
texi2pod.pl Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
TODO Remove a bit-field TODO 2017-04-29 22:09:10 +02:00
VERSION update VERSION to 0.9.27 2017-02-08 19:56:15 +01:00
x86_64-asm.h x86-64-asm: Fix mov im64,rax encoding 2017-02-23 00:16:25 +01:00
x86_64-gen.c Implement function alignment via attributes 2018-04-06 23:02:42 +02:00
x86_64-link.c final update for 0.9.27 2017-12-12 17:57:20 +01: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/x86_64/arm Linux/OSX/FreeBSD host

   ./configure
   make
   make test
   make install

   Notes: For OSX and FreeBSD, gmake should be used instead of make.
   For Windows read tcc-win32.txt.

makeinfo must be installed to compile the doc.  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.