Go to file
grischka d242706f3b bitfields: one more hack and a "-Wgcc-compat" switch
bit_pos + bit_size > type_size * 8

must NEVER happen because the code generator can read/write
only the basic integral types.

Warn if tcc has to break GCC compatibility for that reason
and if -Wgcc-compat is given.

Example:
    struct __attribute__((packed)) _s
    {
        unsigned int x  : 12;
        unsigned char y :  7;
        unsigned int z  : 28;
    };

Expected (GCC) layout (sizeof struct = 6)
.xxxxxxxx.xxxxyyyy.yyyzzzzz.zzzzzzzz.zzzzzzzz.zzzzzzz0.

But we cannot read/write 'char y'from 2 bytes in memory.
So we have to adjust:
.xxxxxxxx.xxxx0000.yyyyyyyz.zzzzzzzz.zzzzzzzz.zzzzzzzz.zzz00000

Now 'int z' cannot be accessed from 5 bytes.  So we arrive
at this (sizeof struct = 7):
.xxxxxxxx.xxxx0000.yyyyyyy0.zzzzzzzz.zzzzzzzz.zzzzzzzz.zzzz0000

Otherwise the bitfield load/store generator needs to be
changed to allow byte-wise accesses.

Also we may touch memory past the struct in some cases
currently.  The patch adds a warning for that too.

   0:	55                   	push   %ebp
   1:	89 e5                	mov    %esp,%ebp
   3:	81 ec 04 00 00 00    	sub    $0x4,%esp
   9:	90                   	nop

    struct __attribute__((packed)) { unsigned x : 5; } b = {0} ;

   a:	8b 45 ff             	mov    -0x1(%ebp),%eax
   d:	83 e0 e0             	and    $0xffffffe0,%eax
  10:	89 45 ff             	mov    %eax,-0x1(%ebp)

This touches -0x1 ... +0x3(%ebp), hence 3 bytes beyond
stack space.  Since the data is not changed, nothing
else happens here.
2017-05-09 18:10:02 +02:00
examples makefile: unify cross with native builds 2017-02-25 12:51:04 +01:00
include Add support of musl-libc 2017-04-20 22:01:50 +02:00
lib more minor fixes 2017-05-07 12:41:29 +02:00
tests more minor fixes 2017-05-07 12:41:29 +02:00
win32 Add -static to be in sync with Windows bat. 2017-04-27 07:01:46 +02:00
.gitignore cross-compilers: allow individual configuration 2017-02-23 08:41:57 +01:00
COPYING changed license to LGPL 2003-05-24 14:18:56 +00:00
Changelog Add note about native Windows bootstrap using Cygwin. 2017-02-23 06:45:26 +01:00
CodingStyle CodingStyle: Remove reference to misaligned struct CString. 2016-01-06 19:09:28 +00:00
Makefile more minor fixes 2017-05-07 12:41:29 +02: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
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
arm-asm.c makefile: unify cross with native builds 2017-02-25 12:51:04 +01:00
arm-gen.c C string litteral is const, fix return type of default_elfinterp. Remove #ifndef TCC_IS_NATIVE in arm-gen.c as suggested by grischka. 2017-05-08 09:18:27 +02:00
arm-link.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
arm64-gen.c tccgen: factor out gfunc_return 2017-02-08 19:45:31 +01:00
arm64-link.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
c67-gen.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
c67-link.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
coff.h Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
configure Improve musl and uclibc detection 2017-05-08 16:14:35 +00:00
conftest.c tcctools.c: integrate tiny_libmaker/_impdef 2017-02-18 09:55:34 +01:00
elf.h Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
i386-asm.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
i386-asm.h x86-asm: Fix lar opcode operands 2016-12-15 17:47:08 +01:00
i386-gen.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
i386-link.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07: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 bitfields: one more hack and a "-Wgcc-compat" switch 2017-05-09 18:10:02 +02:00
libtcc.h tcctools.c: integrate tiny_libmaker/_impdef 2017-02-18 09:55:34 +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 tcc: re-enable correct option -r support 2017-02-20 18:58:08 +01:00
tcc.c Fix spelling in help message 2017-05-08 08:44:52 -07:00
tcc.h bitfields: one more hack and a "-Wgcc-compat" switch 2017-05-09 18:10:02 +02:00
tccasm.c Remove some unused arguments 2017-05-08 20:26:59 +02:00
tcccoff.c Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tccelf.c Remove some unused arguments 2017-05-08 20:26:59 +02:00
tccgen.c bitfields: one more hack and a "-Wgcc-compat" switch 2017-05-09 18:10:02 +02:00
tcclib.h Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04:00
tccpe.c Touch up previous "s"[i<2] patch 2017-05-09 07:08:43 -07:00
tccpp.c Remove some unused-parameter lint 2017-05-08 08:30:43 -07:00
tccrun.c win32: adjust new unicode support 2017-02-18 09:51:23 +01:00
tcctok.h Revert "partial revert of the commit 4ad186c5ef61" 2017-02-05 14:30:19 +01:00
tcctools.c Touch up previous "s"[i<2] patch 2017-05-09 07:08:43 -07:00
texi2pod.pl Revert all of my changes to directories & codingstyle. 2015-07-29 16:57:12 -04: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 Spelling fixes in C comments only 2017-05-07 21:38:09 -07:00
x86_64-link.c Spelling fixes in C comments only 2017-05-07 21:38:09 -07: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

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