Go to file
Kirill Smelkov a919a373da Add input files/libs and reloc_output switch to TCCState
files[0], and reloc_outpu will be needed for (upcoming in the next
patch) "compute default outfile name" refactored into libtcc function.

Also, since for symmetry and from libification point of view, it makes
some sense to also put all information about what was given as input to
compilation into TCCState, let's not only put files[0], but all
files and all libraries given explicitely by user.

One point: I've used bitfield for reloc_output & trimmed down
output_type to 8 bits so that TCCState stays the same in size, and also
access to output_type is (hopefully) is not slower.

By the way -- as of today, sizeof(TCCState) on i686-pc-linux-gnu is 2884
bytes...
2010-06-20 20:30:01 +04:00
examples weak function symbols 2010-02-27 17:37:59 +01:00
include win64: defined size_t and ptrdiff_t to unsigned long long 2010-01-14 20:59:43 +01:00
lib win32: enable bounds checker & exception handler 2009-12-19 22:22:43 +01:00
tests Fix bashims in configure and gcctestsuite.sh. 2010-05-26 14:08:29 +02:00
win32 win32: sys/timeb.h use _ftime instead of _ftime32 2010-04-12 20:56:13 +02:00
.gitignore .gitignore += *.o *.a 2010-06-12 18:26:37 +04:00
arm-gen.c ARM: use uint32_t for opcodes 2010-05-13 22:17:09 +02:00
c67-gen.c allow tcc be build from separate objects 2009-12-20 01:53:49 +01:00
Changelog ulibc: #define TCC_UCLIBC and load elf_interp 2009-05-16 22:29:40 +02:00
coff.h C67 COFF executable format support (TK) 2004-10-05 22:33:55 +00:00
configure Fix bashims in configure and gcctestsuite.sh. 2010-05-26 14:08:29 +02:00
COPYING changed license to LGPL 2003-05-24 14:18:56 +00:00
elf.h don't discard SHT_((PRE)INIT|FINI)_ARRAY sections 2010-05-15 01:26:56 +02:00
i386-asm.c win64: add tiny unwind data for setjmp/longjmp 2009-12-20 01:54:37 +01:00
i386-asm.h integrate x86_64-asm.c into i386-asm.c 2009-12-19 22:16:20 +01:00
i386-gen.c chmod a-x i386-gen.c 2010-06-16 14:37:30 +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 cleanup: constify some global data 2009-07-18 22:07:42 +02:00
il-opcodes.h added CIL target 2002-02-10 16:14:03 +00:00
libtcc.c Add input files/libs and reloc_output switch to TCCState 2010-06-20 20:30:01 +04:00
libtcc.h Add input files/libs and reloc_output switch to TCCState 2010-06-20 20:30:01 +04:00
Makefile Don't load libtcc1 on arch where it doesn't exist 2010-05-01 17:20:28 +02:00
README win32: readme.txt->tcc-win32.txt, update tcc-doc 2009-04-18 15:08:03 +02: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: add "-Wl,-rpath=path" option (library search path) 2009-12-19 22:16:20 +01:00
tcc.c Add input files/libs and reloc_output switch to TCCState 2010-06-20 20:30:01 +04:00
tcc.h Add input files/libs and reloc_output switch to TCCState 2010-06-20 20:30:01 +04:00
tccasm.c Revert "tccpp: Allow local labels to start with a dot" 2010-05-06 21:42:37 +02:00
tcccoff.c build from multiple objects: fix other targets 2009-12-20 20:33:41 +01:00
tccelf.c don't discard SHT_((PRE)INIT|FINI)_ARRAY sections 2010-05-15 01:26:56 +02:00
tccgen.c append ULL to big constants 2010-05-13 22:18:33 +02:00
tccpe.c WinCE PE subsystem 2010-04-19 16:34:59 +03:00
tccpp.c Revert "tccpp: Allow local labels to start with a dot" 2010-05-06 21:42:37 +02:00
tccrun.c ARM: implement rt_get_caller_pc 2010-05-14 14:22:32 +02:00
tcctok.h Add nan, snan and inf float constants 2010-05-06 02:20:35 +02:00
texi2pod.pl automatic man page generation from tcc-doc.texi 2003-05-18 18:11:06 +00:00
TODO Udated and cleaned up TODO. 2008-01-16 22:33:56 +00: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 tccpe: improve dllimport/export and use for tcc_add_symbol 2010-01-14 20:59:42 +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 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.