Go to file
Edmund Grimley Evans aa812e8745 Convert some lines from ISO-8859-1 to UTF-8.
perl -i -pe 'use Text::Iconv;
$c1 = Text::Iconv->new("utf-8", "utf-8");
$c2 = Text::Iconv->new("iso-8859-1", "utf-8");
if (!$c1->convert($_)) { $_ = $c2->convert($_); }' \
`find * -type f`
2015-03-11 07:30:03 +00:00
examples Revert "Make ex1.c and ex4.c be executable on any systems" 2012-06-12 15:45:13 +02:00
include Add arm64 (AArch64) as a target architecture. 2015-02-23 22:51:03 +00:00
lib lib/Makefile: Partial revert of 896a0c881a. 2015-03-10 14:08:42 +00:00
tests Add some missing nocode_wanted guard 2015-03-10 23:27:14 +08:00
win32 correct a DllMain() declaration in dllcrt1.c and dllmain.c 2015-03-03 22:51:13 +03:00
.gitignore .gitignore: Add lib/arm64. 2015-03-10 22:38:26 +00:00
CMakeLists.txt Use GNU triplet prefix for cross tcc compilers 2014-01-08 21:07:59 +08:00
COPYING changed license to LGPL 2003-05-24 14:18:56 +00:00
Changelog Convert some lines from ISO-8859-1 to UTF-8. 2015-03-11 07:30:03 +00:00
Makefile A native tcc for MSYS (Windows) must be i386-win-tcc.exe and not i386-tcc.exe 2015-03-10 13:39:26 +03:00
README Fix building instruction wrt make/gmake 2013-04-08 23:26:27 +02:00
RELICENSING Convert some lines from ISO-8859-1 to UTF-8. 2015-03-11 07:30:03 +00:00
TODO remove doubled prototype 2013-02-18 15:44:18 +01:00
VERSION Release TinyCC 0.9.26 2013-02-15 14:23:58 +01:00
arm-gen.c Convert some lines from ISO-8859-1 to UTF-8. 2015-03-11 07:30:03 +00:00
arm64-gen.c Fix stack overwrite on structure return 2015-03-09 00:19:59 +01:00
c67-gen.c Fix stack overwrite on structure return 2015-03-09 00:19:59 +01:00
coff.h add version number to manpage 2013-02-17 00:48:51 +01:00
config.h.in Improved variable length array support. 2013-04-27 22:58:52 +01:00
config.texi.in Added cross compilation to CMake build system. 2013-04-25 01:08:18 +01:00
configure A native tcc for MSYS (Windows) must be i386-win-tcc.exe and not i386-tcc.exe 2015-03-10 13:39:26 +03:00
conftest.c Add arm64 (AArch64) as a target architecture. 2015-02-23 22:51:03 +00:00
elf.h Add arm64 (AArch64) as a target architecture. 2015-02-23 22:51:03 +00:00
i386-asm.c Convert some lines from ISO-8859-1 to UTF-8. 2015-03-11 07:30:03 +00:00
i386-asm.h Allow tcc to understand a setob,... opcodes as alias to seto,... 2015-01-06 22:59:19 +03:00
i386-gen.c Fix stack overwrite on structure return 2015-03-09 00:19:59 +01:00
i386-tok.h Allow tcc to understand a setob,... opcodes as alias to seto,... 2015-01-06 22:59:19 +03:00
il-gen.c A partial reverse for commit eda2c756ed 2015-03-03 15:51:09 +03:00
il-opcodes.h added CIL target 2002-02-10 16:14:03 +00:00
libtcc.c Turn on a implicit-function-declaration warning by default. 2015-03-03 16:32:25 +03:00
libtcc.h Warn about a conflicting compile options spectified on the command line. 2015-01-06 22:19:45 +03: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 tcc-doc.texi: Explain VT_LLOCAL a bit better. 2015-02-20 23:29:21 +00:00
tcc.c Report a mingw as a execution environment instead of the 2015-03-03 22:30:24 +03:00
tcc.h Fix stack overwrite on structure return 2015-03-09 00:19:59 +01:00
tccasm.c Add support for .p2align asm directive. 2015-01-20 08:49:49 +01:00
tcccoff.c portability: fix void* <-> target address conversion confusion 2013-02-04 16:24:59 +01:00
tccelf.c A correction for the commit: revert a grischka patch: gdb refused to know "main" 2015-03-10 14:21:14 +03:00
tccgen.c tccgen.c: (!nocode_wanted) -> (nocode_wanted) in arm64 part. 2015-03-10 22:37:36 +00:00
tcclib.h Sorted out CMake on x86-64 and fixed silly XMM# bug introduced when working on Win64 stdargs. 2013-04-25 22:30:53 +01:00
tccpe.c win64: fix resource file support 2014-08-01 10:51:28 +02:00
tccpp.c tcc_free(table_ident) in preprocess_new() if table_ident != NULL 2015-03-03 14:54:46 +03:00
tccrun.c aarch64: Fix -run. 2015-02-23 22:51:10 +00:00
tcctok.h arm64: Implement __clear_cache. 2015-03-08 00:10:44 +00:00
texi2pod.pl automatic man page generation from tcc-doc.texi 2003-05-18 18:11:06 +00:00
x86_64-asm.h Allow tcc to understand a setob,... opcodes as alias to seto,... 2015-01-06 22:59:19 +03:00
x86_64-gen.c Fix stack overwrite on structure return 2015-03-09 00:19:59 +01: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.