# jcc JCC is designed to be a pure C11 (no dependencies) C11/C18/C23 compiler. ^{_{No dependencies = no dependencies outside of libc and some basic OS calls needed to e.g read directories}} * For the work-in-progress rustc backend, see [rustc_codegen_jcc](https://github.com/john-h-k/rustc_codegen_jcc) ## CI Status | OS | AArch64 (Arm64) | x64 | RISC-V (32) | |--------|--------------------------------------------------------------------------------------------------------- |--------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | Ubuntu |  |  |  | | macOS |  |  | | ^{_{If tests are failing, ignore it! Development is very active (and pushes sometimes break things)}} Aims: * To be a complete C11/C18/C23 compiler with full functionality (WIP) * To use zero third-party dependencies or helper tools (no parser generators, assemblers, lexers, etc) other than system linker * To follow best practices and have sensible compiler architecture * Building the "smallest" C compiler is an explicit non-goal * To be useful for learning about compilers * Uses proper IRs rather than AST -> ASM * Generates machine code, not assembly * Builds SSA form and puts values in registers rather than spilling everything * Builds object files and invokes system linker manually (rather than via a compiler or an assembler) * Doesn't use hacks (mostly...) ## Is it sound? No, it is text based ## Why? I just wanted to write a C compiler. It happens to be an easily buildable, easily runnable compiler that is still a grokkable size, It is probably too large to be considered a toy compiler, but the core architecture is much more accessible than the the shoggoth of Clang/GCC. ## Support Compiler can fully bootstrap itself and passes the full C std test suite (which is not as large as it sounds). AArch64, x64, and RISC-V 32 are supported, although some of the x64 ABI is not yet fully implemented and RISC-V 32 64 bit integers are WIP. Working with RISC-V requires installing a RISC-V linker. #### Things that don't work yet 1. `va_arg` outside of macOS arm64 2. Atomics (`stdatomic.h`) 3. Linking on musl-based distros. This is relatively simple and should work soon 4. Digraphs (plan to add) and trigraphs (plan to add but only with an explicit argument, as with most compilers) 5. `setjmp`/`longjmp` 6. Some small C23 features (`nullptr_t`, which I will get round to soon, `static` in compound literals, `u8` strings, and the inbuilt attributes) ## Requirements