How project-nirmala/nircc works
Nirmala is a C compiler with a cc-style driver. The main workflow accepts C source, preprocesses and lexes it, parses a translation unit, then emits target assembly; the driver can additionally assemble and link. The README also documents optimization and a bootstrap milestone. The excerpts establish the compiler’s main calls and the driver’s tool invocations, but do not show all internal wiring—especially the optimizer’s invocation—so that relationship is marked unverified.
Main entry points: main.c nircc entry · driver.c cc driver · gen.c Code generator · pp.c Preprocessor
Components 17
Compiler frontend
- Preprocessor
src/pp.c - Lexer
src/lex.c - Parser
src/parse.c
Compiler core
- nircc entry
src/main.c - Code generator
src/gen.c - Assembly optimizer
src/peep.c
Driver and tools
- cc driver
driver/driver.c - Assembler
- System linker
Compiler support
- Type system
src/type.c - Target config
src/target.c - Compiler utilities
src/util.c - C headers
include
Other components
- C developer
- C source
- Assembly output
- Executable or object
Connections 18
- C developer → cc driver: invokes
driver/driver.c - C developer → nircc entry: invokes
src/main.c - cc driver → nircc entry: runs compiler
driver/driver.c - nircc entry → C source: reads
src/main.c - nircc entry → Target config: sets target
src/main.c - nircc entry → Type system: initializes types
src/main.c - nircc entry → Preprocessor: preprocesses
src/main.c - nircc entry → Lexer: tokenizes
src/main.c - nircc entry → Parser: parses tokens
src/main.c - nircc entry → Code generator: generates assembly
src/main.c - Code generator → Assembly output: emits
src/gen.c - Code generator → Assembly optimizer: may optimize
- cc driver → Assembler: runs assembler
driver/driver.c - cc driver → System linker: runs linker
driver/driver.c - cc driver → Assembly output: passes assembly
driver/driver.c - Assembler → Executable or object: produces object
- System linker → Executable or object: produces executable
- Preprocessor → C headers: includes headers
src/pp.c