shecc

shecc

开源自编译C语言优化编译器

shecc是一个开源的自编译C语言优化编译器,支持32位Arm和RISC-V架构。它能生成Linux ELF可执行文件,提供基本C标准库,采用两遍编译过程。该项目实现了静态单赋值(SSA)中间表示、寄存器分配和基本优化策略,展示了编译器的核心概念和实现方法,适合学习和教育用途。

sheccC编译器自编译优化跨平台Github开源项目

shecc : 自托管教育型C语言优化编译器

<p align="center"><img src="https://yellow-cdn.veclightyear.com/835a84d5/b002d3af-1045-4e7e-a1c3-1a5b035b1e65.png" alt="logo image" width=40%></p>

简介

shecc是从零开始构建的,针对32位Arm和RISC-V架构,作为C语言子集的自编译编译器。尽管设计简单,但它作为独立的优化编译器能够执行基本的优化策略。

特性

  • 为ARMv7-A和RV32IM生成可执行的Linux ELF二进制文件。
  • 提供最小的C标准库,用于GNU/Linux上的基本I/O操作。
  • 交叉编译器使用ANSI C编写,与大多数平台兼容。
  • 包含一个自包含的C前端,集成了机器代码生成器;无需外部汇编器或链接器。
  • 采用两遍编译过程:第一遍检查语法并将复杂语句分解为基本操作,第二遍将这些操作转换为Arm/RISC-V机器代码。
  • 开发了一个适用于RISC风格架构的寄存器分配系统。
  • 实现了一个与架构无关的、基于静态单赋值 (SSA)的中间端,以增强优化。

兼容性

shecc能够编译使用以下语法编写的C源文件:

  • 数据类型:char、int、struct和指针
  • 条件语句:if、while、for、switch、case、break、return和一般表达式
  • 复合赋值:+=-=*=
  • 支持的数据类型的全局/局部变量初始化
    • 例如 int i = [expr]
  • 对预处理器指令的有限支持:#define#ifdef#elif#endif#undef#error
  • 带有__VA_ARGS__标识符的非嵌套可变参数宏

后端针对带有Linux ABI的armv7hf,在树莓派3上验证,并且还支持RISC-V 32位架构,通过QEMU验证。

自举

验证shecc自举的步骤:

  1. stage0shecc源代码最初使用普通编译器编译,生成本机可执行文件。生成的编译器可用作交叉编译器。
  2. stage1:构建的二进制文件读取自身的源代码作为输入,并生成ARMv7-A/RV32IM二进制文件。
  3. stage2:生成的ARMv7-A/RV32IM二进制文件(通过QEMU或在Arm和RISC-V设备上运行)以自身源代码为输入,生成另一个ARMv7-A/RV32IM二进制文件。
  4. bootstrap:构建stage1stage2编译器,并验证它们是否逐字节相同。如果相同,则shecc可以编译自身的源代码并生成该程序的新版本。

先决条件

shecc中的代码生成器不依赖外部工具。你只需要普通的C编译器,如gccclang。然而,shecc会自举,因此需要Arm/RISC-V ISA模拟。在GNU/Linux上安装QEMU以进行Arm/RISC-V用户模拟:

$ sudo apt-get install qemu-user

在macOS或Microsoft Windows上构建shecc仍然可行。但由于缺少qemu-arm,第二阶段自举将失败。

要执行快照测试,请安装以下软件包:

$ sudo apt-get install graphviz jq

构建和验证

配置你想要的后端,shecc支持ARMv7-A和RV32IM后端:

$ make config ARCH=arm
# 目标机器代码切换到Arm

$ make config ARCH=riscv
# 目标机器代码切换到RISC-V

运行make,你应该看到这样的输出:

  CC+LD	out/inliner
  GEN	out/libc.inc
  CC	out/src/main.o
  LD	out/shecc
  SHECC	out/shecc-stage1.elf
  SHECC	out/shecc-stage2.elf

文件out/shecc是第一阶段编译器。其用法:

$ shecc [-o output] [+m] [--no-libc] [--dump-ir] <infile.c>

编译器选项:

  • -o : 指定输出文件名(默认:out.elf
  • +m : 使用硬件乘除法指令(默认:禁用)
  • --no-libc : 排除嵌入式C库(默认:嵌入)
  • --dump-ir : 转储中间表示(IR)

示例:

$ out/shecc -o fib tests/fib.c $ chmod +x fib $ qemu-arm fib

通过在调用make时指定check-snapshots目标来验证发出的IR是否与快照相同:

$ make check-snapshots

shecc附带单元测试。要运行测试,给出check作为参数:

$ make check

参考输出:

...
int main(int argc, int argv) { exit(sizeof(char)); } => 1
int main(int argc, int argv) { int a; a = 0; switch (3) { case 0: return 2; case 3: a = 10; break; case 1: return 0; } exit(a); } => 10
int main(int argc, int argv) { int a; a = 0; switch (3) { case 0: return 2; default: a = 10; break; } exit(a); } => 10
OK

要清理生成的编译器文件,执行命令 make clean。 要重置架构配置,使用命令 make distclean

中间表示

当向 shecc 传递 --dump-ir 选项时,将生成中间表示(IR)。以文件 tests/fib.c 为例。它包含一个递归的斐波那契数列函数。

int fib(int n) { if (n == 0) return 0; else if (n == 1) return 1; return fib(n - 1) + fib(n - 2); }

执行以下命令生成IR:

$ out/shecc --dump-ir -o fib tests/fib.c

C源代码和IR的逐行解释:

C源代码 IR 解释 ------------------+---------------------------------------+---------------------------------------------------------------------------------- int fib(int n) def int @fib(int %n) 表示函数定义 { { if (n == 0) const %.t1001, $0 将常量0加载到临时变量".t1001" %.t1002 = eq %n, %.t1001 测试"n"是否等于".t1001",并将结果写入临时变量".t1002" br %.t1002, .label.1177, .label.1178 如果".t1002"等于零,跳转到假标签".label.1178",否则 跳转到真标签".label.1177" .label.1177 return 0; const %.t1003, $0 将常量0加载到临时变量".t1003" ret %.t1003 返回".t1003" j .label.1184 跳转到endif标签".label.1184" .label.1178 else if (n == 1) const %.t1004, $1 将常量1加载到临时变量".t1004" %.t1005 = eq %n, %.t1004 测试"n"是否等于".t1004",并将结果写入临时变量".t1005" br %.t1005, .label.1183, .label.1184 如果".t1005"等于零,跳转到假标签".label.1184"。否则, 跳转到真标签".label.1183" .label.1183 return 1; const %.t1006, $1 将常量1加载到临时变量".t1006" ret %.t1006 返回".t1006" .label.1184 return fib(n - 1) const %.t1007, $1 将常量1加载到临时变量".t1007" %.t1008 = sub %n, %.t1007 从"n"中减去".t1007",并将结果存储在临时变量".t1008" push %.t1008 为函数调用准备参数 call @fib, 1 调用函数"fib",带一个参数 + retval %.t1009 将返回值存储在临时变量".t1009" fib(n - 2); const %.t1010, $2 将常量2加载到临时变量".t1010" %.t1011 = sub %n, %.t1010 从"n"中减去".t1010",并将结果存储在临时变量".t1011" push %.t1011 为函数调用准备参数 call @fib, 1 调用函数"fib",带一个参数 retval %.t1012 将返回值存储在临时变量".t1012" %.t1013 = add %.t1009, %.t1012 将".t1009"".t1012"相加,并将结果存储在临时变量".t1013" ret %.t1013 返回".t1013" } }

已知问题

  1. 生成的ELF缺少.bss和.rodata段
  2. 对变参函数的支持不完整。无法使用<stdarg.h>。 或者,可以查看源文件lib/c.cprintf的实现,了解var_arg的使用。
  3. C前端有些混乱,因为没有有效的AST。

许可证

shecc 可在BSD 2条款许可证下自由重新分发。 本源代码的使用受BSD风格许可证的约束,可以在LICENSE文件中找到。

编辑推荐精选

讯飞智文

讯飞智文

一键生成PPT和Word,让学习生活更轻松

讯飞智文是一个利用 AI 技术的项目,能够帮助用户生成 PPT 以及各类文档。无论是商业领域的市场分析报告、年度目标制定,还是学生群体的职业生涯规划、实习避坑指南,亦或是活动策划、旅游攻略等内容,它都能提供支持,帮助用户精准表达,轻松呈现各种信息。

AI办公办公工具AI工具讯飞智文AI在线生成PPTAI撰写助手多语种文档生成AI自动配图热门
讯飞星火

讯飞星火

深度推理能力全新升级,全面对标OpenAI o1

科大讯飞的星火大模型,支持语言理解、知识问答和文本创作等多功能,适用于多种文件和业务场景,提升办公和日常生活的效率。讯飞星火是一个提供丰富智能服务的平台,涵盖科技资讯、图像创作、写作辅助、编程解答、科研文献解读等功能,能为不同需求的用户提供便捷高效的帮助,助力用户轻松获取信息、解决问题,满足多样化使用场景。

热门AI开发模型训练AI工具讯飞星火大模型智能问答内容创作多语种支持智慧生活
Spark-TTS

Spark-TTS

一种基于大语言模型的高效单流解耦语音令牌文本到语音合成模型

Spark-TTS 是一个基于 PyTorch 的开源文本到语音合成项目,由多个知名机构联合参与。该项目提供了高效的 LLM(大语言模型)驱动的语音合成方案,支持语音克隆和语音创建功能,可通过命令行界面(CLI)和 Web UI 两种方式使用。用户可以根据需求调整语音的性别、音高、速度等参数,生成高质量的语音。该项目适用于多种场景,如有声读物制作、智能语音助手开发等。

Trae

Trae

字节跳动发布的AI编程神器IDE

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

AI工具TraeAI IDE协作生产力转型热门
咔片PPT

咔片PPT

AI助力,做PPT更简单!

咔片是一款轻量化在线演示设计工具,借助 AI 技术,实现从内容生成到智能设计的一站式 PPT 制作服务。支持多种文档格式导入生成 PPT,提供海量模板、智能美化、素材替换等功能,适用于销售、教师、学生等各类人群,能高效制作出高品质 PPT,满足不同场景演示需求。

讯飞绘文

讯飞绘文

选题、配图、成文,一站式创作,让内容运营更高效

讯飞绘文,一个AI集成平台,支持写作、选题、配图、排版和发布。高效生成适用于各类媒体的定制内容,加速品牌传播,提升内容营销效果。

热门AI辅助写作AI工具讯飞绘文内容运营AI创作个性化文章多平台分发AI助手
材料星

材料星

专业的AI公文写作平台,公文写作神器

AI 材料星,专业的 AI 公文写作辅助平台,为体制内工作人员提供高效的公文写作解决方案。拥有海量公文文库、9 大核心 AI 功能,支持 30 + 文稿类型生成,助力快速完成领导讲话、工作总结、述职报告等材料,提升办公效率,是体制打工人的得力写作神器。

openai-agents-python

openai-agents-python

OpenAI Agents SDK,助力开发者便捷使用 OpenAI 相关功能。

openai-agents-python 是 OpenAI 推出的一款强大 Python SDK,它为开发者提供了与 OpenAI 模型交互的高效工具,支持工具调用、结果处理、追踪等功能,涵盖多种应用场景,如研究助手、财务研究等,能显著提升开发效率,让开发者更轻松地利用 OpenAI 的技术优势。

Hunyuan3D-2

Hunyuan3D-2

高分辨率纹理 3D 资产生成

Hunyuan3D-2 是腾讯开发的用于 3D 资产生成的强大工具,支持从文本描述、单张图片或多视角图片生成 3D 模型,具备快速形状生成能力,可生成带纹理的高质量 3D 模型,适用于多个领域,为 3D 创作提供了高效解决方案。

3FS

3FS

一个具备存储、管理和客户端操作等多种功能的分布式文件系统相关项目。

3FS 是一个功能强大的分布式文件系统项目,涵盖了存储引擎、元数据管理、客户端工具等多个模块。它支持多种文件操作,如创建文件和目录、设置布局等,同时具备高效的事件循环、节点选择和协程池管理等特性。适用于需要大规模数据存储和管理的场景,能够提高系统的性能和可靠性,是分布式存储领域的优质解决方案。

下拉加载更多