Menu
Home
People
Places
Arts
History
Plants & Animals
Science
Life & Culture
Technology
Reference.org
Tiny C Compiler
open-in-new
<h2 id="features">Features</h2> <p>TCC has a number of features that differentiate it from other current C compilers: </p> <ul><li>Its small file size (about 100 KB for the x86 TCC executable) and <a href="/facts/Memory_footprint/wnS6TgpY">memory footprint</a> allow it to be used directly from a single 1.44 M <a href="/facts/Floppy_disk/rShxfuxa">floppy disk</a>, such as a rescue disk.</li> <li>TCC is intended to produce native x86, x86-64 and ARM code very quickly; according to Bellard, it compiles, assembles and links about nine times faster than <a href="/facts/GNU_Compiler_Collection/t07jh01k">GCC</a> does.<a class="footnote-ref" id="fnref:3" href="#fn:3"><sup>3</sup></a> As of 2023, the "mob" development branch also includes support for <a href="/facts/RISC-V/pUSKDat1">RISC-V</a> and <a href="/facts/TMS320C67xx/ILsPTHCJ">TMS320C67xx</a> (a <a href="/facts/Digital_signal_processor/YuBXweos">DSP</a> chip).</li> <li>TCC has a number of compiler-specific language features intended to improve its practicality, such as an optional memory and bound checker, for improved code stability.</li> <li>TCC allows programs to be run automatically at compile time using a command-line switch. This allows programs to be run as a shell script under Unix-like systems that support the <a href="/facts/Shebang_(Unix)/brtu1F1o">shebang</a> <a href="/facts/Interpreter_directive/Mzge8JUW">interpreter directive</a> syntax.</li></ul> <h2 id="compiled-program-performance">Compiled program performance</h2> <p>In general, TCC's implementation emphasizes smallness instead of optimally-performing results. TCC generates code in a single pass, and does not perform most of the optimizations performed by other compilers. TCC compiles every statement on its own, and at the end of each statement <a href="/facts/Processor_register/32RvbUdz">register</a> values are written back to the <a href="/facts/Stack_(abstract_data_type)/bj7l94v1">stack</a> and must be re-read even if the next line uses the values in registers (creating extraneous save/load pairs between statements). TCC uses only some of the available registers (e.g., on x86 it never uses ebx, esi, or edi because they need to be preserved across function calls).<a class="footnote-ref" id="fnref:4" href="#fn:4"><sup>4</sup></a> </p><p>TCC performs a few <a href="/facts/Compiler_optimization/JXnv4LUd">optimizations</a>, such as <a href="/facts/Constant_folding/1NmVLgm1">constant propagation</a> for all operations, multiplications and divisions are optimized to <a href="/facts/Arithmetic_shift/xL4SXdpw">shifts</a> when appropriate, and comparison operators are specially optimized (by maintaining a special cache for the processor flags). It also does some simple <a href="/facts/Register_allocation/rB1vkhxU">register allocation</a>, which prevents many extraneous save/load pairs inside a single <a href="/facts/Statement_(computer_science)/bEkBufqX">statement</a>. </p><p>Here are two benchmark examples: </p> <ol><li>A recursive <a href="/facts/Fibonacci_sequence/mqxpAUQD">Fibonacci</a> algorithm on a 1.8 GHz <a href="/facts/Intel_Centrino/CLhRhzU5">Intel Centrino</a> laptop with 512 MB <a href="/facts/Random-access_memory/DuD4bxh6">RAM</a> yields a noticeable difference in results between <a href="/facts/Microsoft_Visual_C%252B%252B/RM3sbYw5">Microsoft Visual C++</a> compiler 13.10.3052 and TCC. To calculate the 49th Fibonacci number, it took a MS Visual C++ program approximately 18% longer than the TCC compiled program.</li> <li>A test compared different C compilers by using them to compile the <a href="/facts/GNU_C_Compiler/t07jh01k">GNU C Compiler</a> (GCC) itself, and then using the resulting compilers to compile GCC again. Compared to GCC 3.4.2, a TCC modified to compile GCC was able to compile the compiler ten times faster, but the resulting .exe it produced was 57% larger, and much slower, taking 2.2 times as long to compile GCC again.<a class="footnote-ref" id="fnref:5" href="#fn:5"><sup>5</sup></a><p>The results were: Running cc1 (the GCC C compiler) on itself required 518 seconds when compiled using GCC 3.4.2, 545 seconds using Microsoft C compiler, and 1145 seconds using TCC. To create these compilers in the first place, GCC (3.4.2) took 744 seconds to compile the GCC compiler, whereas TCC took only 73 seconds. The level of optimization in each compiler was -O1 or similar.</p></li></ol> <h2 id="uses">Uses</h2> <ul><li>TCCBOOT,<a class="footnote-ref" id="fnref:6" href="#fn:6"><sup>6</sup></a> a <a href="/facts/Hack_(technology_slang)/bhg519lj">hack</a> where TCC loads and boots a <a href="/facts/Linux_kernel/dlkduHuA">Linux kernel</a> from source in about 10 seconds. That is to say, it is a "<a href="/facts/Boot_loader/6sNpcLMK">boot loader</a>" that reads Linux kernel <a href="/facts/Source_code/o9J6Jv23">source code</a> from disk, writes executable instructions to memory, and begins running it. This did require changes to the Linux build process.</li> <li>TCC has been used to compile GCC, though various <a href="/facts/Patch_(computing)/sIHVBPls">patches</a> were required to make this work.<a class="footnote-ref" id="fnref:7" href="#fn:7"><sup>7</sup></a></li> <li>TCC was used to demonstrate a defense against the <a href="/facts/Backdoor_(computing)/4Vry8CKE">trust</a> attack.<a class="footnote-ref" id="fnref:8" href="#fn:8"><sup>8</sup></a> It is also used in <a href="/facts/GNU_Guix/2Lekf0ll">GNU Guix</a><a class="footnote-ref" id="fnref:9" href="#fn:9"><sup>9</sup></a> in an attempt to make the distribution <a href="/facts/Bootstrappable_builds/vFVmUND5">bootstrapable</a> without using any binary.<a class="footnote-ref" id="fnref:10" href="#fn:10"><sup>10</sup></a></li> <li>Cinpy<a class="footnote-ref" id="fnref:11" href="#fn:11"><sup>11</sup></a> is a <a href="/facts/Python_(programming_language)/YbuGqofa">Python</a> <a href="/facts/Library_(computing)/xRzL3P7q">library</a> that allows you to implement functions with C in Python modules. The functions are compiled with TCC at runtime. The results are made callable in Python through the <a href="/facts/C_character_classification/hyyHJpwS">ctypes</a> library.</li> <li>Comes installed on <a href="/facts/JavaScript/XhhIIEsl">JavaScript</a> Linux<a class="footnote-ref" id="fnref:12" href="#fn:12"><sup>12</sup></a> (also by Bellard).</li> <li>Has been used as a reference for the compiled version of the Super Micro-Max Chess program source.<a class="footnote-ref" id="fnref:13" href="#fn:13"><sup>13</sup></a></li> <li>Bun, the JavaScript runtime, uses TCC to expose an API which allows users to compile and run C programs from JavaScript.<a class="footnote-ref" id="fnref:14" href="#fn:14"><sup>14</sup></a></li></ul> <h2 id="history">History</h2> <p>TCC has its origins in the Obfuscated Tiny C Compiler (OTCC),<a class="footnote-ref" id="fnref:15" href="#fn:15"><sup>15</sup></a> a program Bellard wrote to win the <a href="/facts/International_Obfuscated_C_Code_Contest/R4zdjcXV">International Obfuscated C Code Contest</a> (IOCCC) in 2001. After that time, Bellard expanded and deobfuscated the program to produce tcc.<a class="footnote-ref" id="fnref:16" href="#fn:16"><sup>16</sup></a> </p><p>At some time prior to 4 February 2012 Fabrice Bellard updated the project's official web page to report that he was no longer working on TCC.<a class="footnote-ref" id="fnref:17" href="#fn:17"><sup>17</sup></a> </p><p>Since Bellard's departure from the project, various people and groups have distributed patches or maintained <a href="/facts/Fork_(software_development)/D6khxhpr">forks</a> of TCC to build upon or fix issues with TCC. This includes Dave Dodge's collection of unofficial tcc patches,<a class="footnote-ref" id="fnref:18" href="#fn:18"><sup>18</sup></a> <a href="/facts/Debian/cBd93qfJ">Debian</a> and kfreebsd <a href="/facts/Downstream_(software_development)/NQR6mAeY">downstream</a> patches,<a class="footnote-ref" id="fnref:19" href="#fn:19"><sup>19</sup></a> and grischka's gcc patches.<a class="footnote-ref" id="fnref:20" href="#fn:20"><sup>20</sup></a> Grischka also set up a public <a href="/facts/Git/U5Ty9QmQ">Git</a> <a href="/facts/Repository_(version_control)/PjE4Vkes">repository</a> for the project<a class="footnote-ref" id="fnref:21" href="#fn:21"><sup>21</sup></a> that contains a mob branch<a class="footnote-ref" id="fnref:22" href="#fn:22"><sup>22</sup></a> where numerous contributions, including a shared build, <a href="/facts/Cross-compiler/8hXgCWB9">cross-compilers</a>, and <a href="/facts/SELinux/YcTycMEN">SELinux</a> compatibility were added. Grischka's GIT repository later became the official TCC repository (linked to by Fabrice Bellard's Savannah project page <a class="footnote-ref" id="fnref:23" href="#fn:23"><sup>23</sup></a>). </p> <h2 id="current-status">Current status</h2> <p>As of December 2017 both the official TCC mailing list<a class="footnote-ref" id="fnref:24" href="#fn:24"><sup>24</sup></a> and the official Git repository (as linked to by Fabrice Bellard's Savannah project page<a class="footnote-ref" id="fnref:25" href="#fn:25"><sup>25</sup></a>) show active discussion and development by many developers and interested users. In December 2017, grischka announced on the mailing list that TCC version 0.9.27 was released.<a class="footnote-ref" id="fnref:26" href="#fn:26"><sup>26</sup></a> </p> <h2 id="see-also">See also</h2> <ul> <li>Free and open-source software portal</li></ul> <ul><li><a href="/facts/GNU_Compiler_Collection/t07jh01k">GNU Compiler Collection</a></li> <li><a href="/facts/Portable_C_Compiler/F1pVvjjt">Portable C Compiler</a> (PCC)</li> <li><a href="/facts/LCC_(compiler)/V0V3DLfJ">LCC (compiler)</a></li> <li><a href="/facts/Small-C/DGxqCKMy">Small-C</a></li> <li><a href="/facts/Small_Device_C_Compiler/ACXfgX7S">Small Device C Compiler</a> (SDCC)</li></ul> <h2 id="external-links">External links</h2> <ul><li><a href="https://bellard.org/tcc/">Official website</a></li> <li><a href="https://lists.nongnu.org/mailman/listinfo/tinycc-devel">TCC's active mailing list</a></li> <li><a href="https://repo.or.cz/w/tinycc.git">Source code repository</a></li> <li><a href="https://ptsource.github.io/Developer-Platform/">PTSource IDE</a>-<a href="/facts/Integrated_Development_Environment/jbEINSQf">Integrated Development Environment</a> includes TCC.</li></ul> <h2 id="references">References</h2> <ol> <li id="fn:1"><p>Tiny C Compiler Reference Documentation accessed on 2008-08-07 <a href="https://bellard.org/tcc/tcc-doc.html#SEC6" target="_blank">https://bellard.org/tcc/tcc-doc.html#SEC6</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li> <li id="fn:2"><p>According to the project's TODO list complex types are the only missing C99 feature. Variable Length Arrays have been added in TCC 0.9.26 <a href="https://repo.or.cz/w/tinycc.git/blob/HEAD:/TODO" target="_blank">https://repo.or.cz/w/tinycc.git/blob/HEAD:/TODO</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li> <li id="fn:3"><p>"TCC : Tiny C Compiler". bellard.org. Retrieved 27 March 2023. <a href="https://bellard.org/tcc/" target="_blank">https://bellard.org/tcc/</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li> <li id="fn:4"><p>Glöckner, Daniel. Re: Tinycc-devel (no subject), 8 September 2006. <a href="https://lists.gnu.org/archive/html/tinycc-devel/2006-09/msg00028.html" target="_blank">https://lists.gnu.org/archive/html/tinycc-devel/2006-09/msg00028.html</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li> <li id="fn:5"><p>grischka, GCC by TCC (some fixes), 29 September 2005 <a href="https://lists.gnu.org/archive/html/tinycc-devel/2005-09/msg00054.html" target="_blank">https://lists.gnu.org/archive/html/tinycc-devel/2005-09/msg00054.html</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li> <li id="fn:6"><p>"TCCBOOT: TinyCC Boot Loader". bellard.org. Retrieved 27 March 2023. <a href="https://bellard.org/tcc/tccboot.html" target="_blank">https://bellard.org/tcc/tccboot.html</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li> <li id="fn:7"><p>"tinycc-devel (thread)". lists.gnu.org. Retrieved 27 March 2023. <a href="https://lists.gnu.org/archive/html/tinycc-devel/2005-09/threads.html" target="_blank">https://lists.gnu.org/archive/html/tinycc-devel/2005-09/threads.html</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li> <li id="fn:8"><p>Wheeler, David A. Countering Trusting Trust through Diverse Double-Compiling. ACSAC. <a href="https://www.dwheeler.com/trusting-trust" target="_blank">https://www.dwheeler.com/trusting-trust</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></p></li> <li id="fn:9"><p>"Guix Further Reduces Bootstrap Seed to 25% — 2020 — Blog — GNU Guix". <a href="https://guix.gnu.org/en/blog/2020/guix-further-reduces-bootstrap-seed-to-25/" target="_blank">https://guix.gnu.org/en/blog/2020/guix-further-reduces-bootstrap-seed-to-25/</a> <a href="#fnref:9" class="footnote-back-ref">↩</a></p></li> <li id="fn:10"><p>"Bootstrappable builds". bootstrappable.org. Retrieved 29 March 2023. <a href="https://bootstrappable.org/" target="_blank">https://bootstrappable.org/</a> <a href="#fnref:10" class="footnote-back-ref">↩</a></p></li> <li id="fn:11"><p>"Cinpy". Archived from the original on 20 November 2008. Retrieved 27 March 2023. <a href="https://web.archive.org/web/20081120164629/http://www.cs.tut.fi/~ask/cinpy/" target="_blank">https://web.archive.org/web/20081120164629/http://www.cs.tut.fi/~ask/cinpy/</a> <a href="#fnref:11" class="footnote-back-ref">↩</a></p></li> <li id="fn:12"><p>"JSLinux". bellard.org. Retrieved 27 March 2023. <a href="https://bellard.org/jslinux/" target="_blank">https://bellard.org/jslinux/</a> <a href="#fnref:12" class="footnote-back-ref">↩</a></p></li> <li id="fn:13"><p>"Super Micro Chess". SourceForge. 18 April 2016. Retrieved 27 March 2023. <a href="https://sourceforge.net/projects/smmax/" target="_blank">https://sourceforge.net/projects/smmax/</a> <a href="#fnref:13" class="footnote-back-ref">↩</a></p></li> <li id="fn:14"><p>"C compiler". Bun. Retrieved 22 November 2024. <a href="https://bun.sh/docs/api/cc" target="_blank">https://bun.sh/docs/api/cc</a> <a href="#fnref:14" class="footnote-back-ref">↩</a></p></li> <li id="fn:15"><p>Bellard, Fabrice. Obfuscated Tiny C Compiler, winning entry of IOCCC 2001. https://bellard.org/otcc/ and at the Internet Archive at https://web.archive.org/web/20130721162702/http://www.ioccc.org/2001/ <a href="https://bellard.org/otcc/" target="_blank">https://bellard.org/otcc/</a> <a href="#fnref:15" class="footnote-back-ref">↩</a></p></li> <li id="fn:16"><p>Bellard, Fabrice. Obfuscated Tiny C Compiler, winning entry of IOCCC 2001. https://bellard.org/otcc/ and at the Internet Archive at https://web.archive.org/web/20130721162702/http://www.ioccc.org/2001/ <a href="https://bellard.org/otcc/" target="_blank">https://bellard.org/otcc/</a> <a href="#fnref:16" class="footnote-back-ref">↩</a></p></li> <li id="fn:17"><p>"TCC : Tiny C Compiler". 4 February 2012. Archived from the original on 4 February 2012. Retrieved 27 March 2023. <a href="https://web.archive.org/web/20120204081201/http://bellard.org/tcc/" target="_blank">https://web.archive.org/web/20120204081201/http://bellard.org/tcc/</a> <a href="#fnref:17" class="footnote-back-ref">↩</a></p></li> <li id="fn:18"><p>"Unofficial tcc Patches". www.dododge.net. Archived from the original on 31 March 2007. Retrieved 27 March 2023. <a href="https://web.archive.org/web/20070331221112/http://www.dododge.net/tcc/patches.html" target="_blank">https://web.archive.org/web/20070331221112/http://www.dododge.net/tcc/patches.html</a> <a href="#fnref:18" class="footnote-back-ref">↩</a></p></li> <li id="fn:19"><p>"Debian -- Details of package tcc in sid". packages.debian.org. Retrieved 27 March 2023. <a href="https://packages.debian.org/unstable/devel/tcc" target="_blank">https://packages.debian.org/unstable/devel/tcc</a> <a href="#fnref:19" class="footnote-back-ref">↩</a></p></li> <li id="fn:20"><p>grischka, GCC by TCC (some fixes), 29 September 2005 <a href="https://lists.gnu.org/archive/html/tinycc-devel/2005-09/msg00054.html" target="_blank">https://lists.gnu.org/archive/html/tinycc-devel/2005-09/msg00054.html</a> <a href="#fnref:20" class="footnote-back-ref">↩</a></p></li> <li id="fn:21"><p>grischka, Public Git Hosting for tcc <a href="https://repo.or.cz/w/tinycc.git" target="_blank">https://repo.or.cz/w/tinycc.git</a> <a href="#fnref:21" class="footnote-back-ref">↩</a></p></li> <li id="fn:22"><p>grischka, mob branch for tcc <a href="https://repo.or.cz/w/tinycc.git/shortlog/refs/heads/mob" target="_blank">https://repo.or.cz/w/tinycc.git/shortlog/refs/heads/mob</a> <a href="#fnref:22" class="footnote-back-ref">↩</a></p></li> <li id="fn:23"><p>"Tiny C Compiler - Summary [Savannah]". savannah.nongnu.org. Retrieved 27 March 2023. <a href="https://savannah.nongnu.org/projects/tinycc" target="_blank">https://savannah.nongnu.org/projects/tinycc</a> <a href="#fnref:23" class="footnote-back-ref">↩</a></p></li> <li id="fn:24"><p>"tinycc-devel Archives". lists.gnu.org. Retrieved 27 March 2023. <a href="https://lists.gnu.org/archive/html/tinycc-devel/" target="_blank">https://lists.gnu.org/archive/html/tinycc-devel/</a> <a href="#fnref:24" class="footnote-back-ref">↩</a></p></li> <li id="fn:25"><p>"Public Git Hosting - tinycc.git/summary". repo.or.cz. Retrieved 27 March 2023. <a href="https://repo.or.cz/w/tinycc.git/" target="_blank">https://repo.or.cz/w/tinycc.git/</a> <a href="#fnref:25" class="footnote-back-ref">↩</a></p></li> <li id="fn:26"><p>"[Tinycc-devel] TCC version 0.9.27 is out". lists.nongnu.org. Retrieved 27 March 2023. <a href="https://lists.nongnu.org/archive/html/tinycc-devel/2017-12/msg00015.html" target="_blank">https://lists.nongnu.org/archive/html/tinycc-devel/2017-12/msg00015.html</a> <a href="#fnref:26" class="footnote-back-ref">↩</a></p></li> </ol>