carp：实践指南

准备试用carp之前，先别急着安装；这个项目提供的是C 语言中的“有趣”VM，看看这是如何进行的。这类日常自动化工具真正难在输入边界、依赖和失败处理如果不清楚就很难稳定复用，仓库说明只能作为第一层证据。落地前可以用一项范围明确的真实任务完成最小试跑，用配置时间、输出质量、异常信息和维护痕迹判断它是否真的省事。我的判断是，它更适合愿意先做小范围验证并复查原始文档的团队；若眼下没有这类需求，先保留观察即可。

THIS PROJECT IS UNSTABLE AND DEPRECATED

从那时起，我开始缓慢地致力于一个更稳定、更经过深思熟虑的项目 称为 RabbitVM。它并不完全具备 相同级别的文档，但它应该工作得更好。

CarpVM

这是我花了大约半年时间慢慢进行的一个项目。我的目标是尝试从头开始构建一个小型（且相当可靠）的 VM，同时学习越来越多的 C 语言。

现在有指令、寄存器、堆栈、数据存储器和调用。不确定递归是否有效......理论上应该如此。没有测试过。

CONSIDER THIS PRE-ALPHA SOFTWARE。事情的变化比 Rust 中的变化更多！

安装

获得鲤鱼

如果您已经有本地副本（在添加子模块之前克隆）

• git fetch
• git rebase
• git submodule init
• git submodule update

如果您还没有本地副本

• git clone --recursive

NOTE：如果 git submodule status 未返回 SHA1 哈希值和存储库名称，则表示有问题。 NOTE：递归克隆用于测试库。如果不包含在内，则不会构建测试。

建筑鲤鱼

1. make
2. make test（可选）
3. make install
4. make clean（可选）

测试机器

使用

NOTE：请参阅 carp -h 以获取有关命令行选项的帮助。

口译员

1. 编写 Carp 文件 - 请参阅 SYNTAX.md。更正式的规格即将推出。
2. 运行./carp.out -f your_file.carp。

API

1. 在您的程序中包含 carp/carp_machine.h。
2. 运行gcc program.c /usr/local/lib/libcarp.a -o program.out。

指令集

寄存器