Go to file
Michael Matz f15c0a9333 x86-64: fix shared libs
The introduction of read32le everywhere created a subtle issue, going
from
   x = *(int*)p;
to
   x = read32le(p);
is not equivalent if x is a larger than 32bit quantity, like an
address on x86_64, because read32le returns an unsigned int.  The first
sign extends, the latter zero extends.  This broke shared library
creation for gawk.  It's enough to amend the case of the above
situation, cases like "write32le(p, read32le(p) +- something)" are okay,
no extensions happen or matter.
2015-12-17 19:41:20 +01:00
examples Revert "Make ex1.c and ex4.c be executable on any systems" 2012-06-12 15:45:13 +02:00
include include/stddef.h: define NULL only if undefined 2015-10-25 00:19:12 +03:00
lib lib/Makefile: filter-out -b flag from XFLAGS 2015-11-08 12:26:17 +03:00
tests tccgen.c: Try to make sizeof(!x) work. 2015-11-22 00:00:36 +00:00
win32 win: libm: add implementation for round/fmin/fmax and variants 2015-11-07 22:31:57 +02:00
.gitignore Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
CMakeLists.txt Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
COPYING changed license to LGPL 2003-05-24 14:18:56 +00:00
Changelog Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
CodingStyle CodingStyle: Add notes on language and testing. 2015-11-20 23:41:01 +00:00
Makefile Fixed a dependency (error with make -j8). 2015-12-15 13:47:07 +01:00
README Fix building instruction wrt make/gmake 2013-04-08 23:26:27 +02:00
RELICENSING Adding two more people to the RELICENSING file. 2015-07-31 16:56:23 -04:00
TODO Change the way struct CStrings are handled. 2015-11-26 12:40:50 +00:00
VERSION Release TinyCC 0.9.26 2013-02-15 14:23:58 +01:00
arm-gen.c Merge the integer members of union CValue into "uint64_t i". 2015-11-17 19:09:35 +00:00
arm64-gen.c Replace pointer casts with calls to (read|write)(16|32|64)le. 2015-11-19 18:21:14 +00:00
c67-gen.c Merge the integer members of union CValue into "uint64_t i". 2015-11-17 19:09:35 +00:00
coff.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
config.h.in Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
config.texi.in Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
configure Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
conftest.c Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
elf.h x86-64: Define symbol constant for new relocs 2015-12-17 07:30:35 +01:00
i386-asm.c Change the way struct CStrings are handled. 2015-11-26 12:40:50 +00:00
i386-asm.h SSE opcodes to TCC assembler (i386, x86_64) 2015-09-23 14:58:06 +03:00
i386-gen.c Bug fix for commit 553242c18a. 2015-11-20 23:17:24 +00:00
i386-tok.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
il-gen.c Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
il-opcodes.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
libtcc.c tccpp: cleanup #include_next 2015-11-20 12:05:55 +01:00
libtcc.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04: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 Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tcc.c tcc help output for the -xc -xa - options 2015-10-24 23:39:17 +03:00
tcc.h Change the way struct CStrings are handled. 2015-11-26 12:40:50 +00:00
tccasm.c Change the way struct CStrings are handled. 2015-11-26 12:40:50 +00:00
tcccoff.c Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tccelf.c x86-64: fix shared libs 2015-12-17 19:41:20 +01:00
tccgen.c Change the way struct CStrings are handled. 2015-11-26 12:40:50 +00:00
tcclib.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tccpe.c Merge the integer members of union CValue into "uint64_t i". 2015-11-17 19:09:35 +00:00
tccpp.c Change the way struct CStrings are handled. 2015-11-26 12:40:50 +00:00
tccrun.c Trivial changes to avoid some compiler warnings. 2015-11-19 18:26:47 +00:00
tcctok.h tcctok.h: Put TOK_memmove in the correct places (I hope). 2015-11-05 19:37:04 +00:00
texi2pod.pl Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
x86_64-asm.h SSE opcodes to TCC assembler (i386, x86_64) 2015-09-23 14:58:06 +03:00
x86_64-gen.c Bug fix for commit 553242c18a. 2015-11-20 23:17:24 +00:00

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/x86_64/arm Linux/OSX/FreeBSD host (for Windows read tcc-win32.txt)

Note: For OSX and FreeBSD, gmake should be used instead of make.

   ./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

Texi2html 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.