[279] | 1 | Tiny C Compiler - C Scripting Everywhere - The Smallest ANSI C compiler
|
---|
| 2 | -----------------------------------------------------------------------
|
---|
| 3 |
|
---|
| 4 | Features:
|
---|
| 5 | --------
|
---|
| 6 |
|
---|
| 7 | - SMALL! You can compile and execute C code everywhere, for example on
|
---|
| 8 | rescue disks.
|
---|
| 9 |
|
---|
| 10 | - FAST! tcc generates optimized x86 code. No byte code
|
---|
| 11 | overhead. Compile, assemble and link about 7 times faster than 'gcc
|
---|
| 12 | -O0'.
|
---|
| 13 |
|
---|
| 14 | - UNLIMITED! Any C dynamic library can be used directly. TCC is
|
---|
| 15 | heading torward full ISOC99 compliance. TCC can of course compile
|
---|
| 16 | itself.
|
---|
| 17 |
|
---|
| 18 | - SAFE! tcc includes an optional memory and bound checker. Bound
|
---|
| 19 | checked code can be mixed freely with standard code.
|
---|
| 20 |
|
---|
| 21 | - Compile and execute C source directly. No linking or assembly
|
---|
| 22 | necessary. Full C preprocessor included.
|
---|
| 23 |
|
---|
| 24 | - C script supported : just add '#!/usr/local/bin/tcc -run' at the first
|
---|
| 25 | line of your C source, and execute it directly from the command
|
---|
| 26 | line.
|
---|
| 27 |
|
---|
| 28 | Documentation:
|
---|
| 29 | -------------
|
---|
| 30 |
|
---|
[331] | 31 | 1) Installation on a i386/x86_64/arm Linux/OSX/FreeBSD host
|
---|
[279] | 32 |
|
---|
| 33 | ./configure
|
---|
| 34 | make
|
---|
| 35 | make test
|
---|
| 36 | make install
|
---|
| 37 |
|
---|
[331] | 38 | Notes: For OSX and FreeBSD, gmake should be used instead of make.
|
---|
| 39 | For Windows read tcc-win32.txt.
|
---|
[279] | 40 |
|
---|
[331] | 41 | makeinfo must be installed to compile the doc. By default, tcc is
|
---|
| 42 | installed in /usr/local/bin. ./configure --help shows configuration
|
---|
| 43 | options.
|
---|
[279] | 44 |
|
---|
| 45 |
|
---|
| 46 | 2) Introduction
|
---|
| 47 |
|
---|
| 48 | We assume here that you know ANSI C. Look at the example ex1.c to know
|
---|
| 49 | what the programs look like.
|
---|
| 50 |
|
---|
| 51 | The include file <tcclib.h> can be used if you want a small basic libc
|
---|
| 52 | include support (especially useful for floppy disks). Of course, you
|
---|
| 53 | can also use standard headers, although they are slower to compile.
|
---|
| 54 |
|
---|
| 55 | You can begin your C script with '#!/usr/local/bin/tcc -run' on the first
|
---|
| 56 | line and set its execute bits (chmod a+x your_script). Then, you can
|
---|
| 57 | launch the C code as a shell or perl script :-) The command line
|
---|
| 58 | arguments are put in 'argc' and 'argv' of the main functions, as in
|
---|
| 59 | ANSI C.
|
---|
| 60 |
|
---|
| 61 | 3) Examples
|
---|
| 62 |
|
---|
| 63 | ex1.c: simplest example (hello world). Can also be launched directly
|
---|
| 64 | as a script: './ex1.c'.
|
---|
| 65 |
|
---|
| 66 | ex2.c: more complicated example: find a number with the four
|
---|
| 67 | operations given a list of numbers (benchmark).
|
---|
| 68 |
|
---|
| 69 | ex3.c: compute fibonacci numbers (benchmark).
|
---|
| 70 |
|
---|
| 71 | ex4.c: more complicated: X11 program. Very complicated test in fact
|
---|
| 72 | because standard headers are being used ! As for ex1.c, can also be launched
|
---|
| 73 | directly as a script: './ex4.c'.
|
---|
| 74 |
|
---|
| 75 | ex5.c: 'hello world' with standard glibc headers.
|
---|
| 76 |
|
---|
| 77 | tcc.c: TCC can of course compile itself. Used to check the code
|
---|
| 78 | generator.
|
---|
| 79 |
|
---|
| 80 | tcctest.c: auto test for TCC which tests many subtle possible bugs. Used
|
---|
| 81 | when doing 'make test'.
|
---|
| 82 |
|
---|
| 83 | 4) Full Documentation
|
---|
| 84 |
|
---|
| 85 | Please read tcc-doc.html to have all the features of TCC.
|
---|
| 86 |
|
---|
| 87 | Additional information is available for the Windows port in tcc-win32.txt.
|
---|
| 88 |
|
---|
| 89 | License:
|
---|
| 90 | -------
|
---|
| 91 |
|
---|
| 92 | TCC is distributed under the GNU Lesser General Public License (see
|
---|
| 93 | COPYING file).
|
---|
| 94 |
|
---|
| 95 | Fabrice Bellard.
|
---|