Lib.rs

方解石

方解石是碳酸钙（CaCO3）的一种，常见于壳体材料。在此精神下，方解石是一组在 Rust 中生成位置无关 shellcode 必要的工具。

支持的目标

• Windows, x64
• Linux, x64

使用方法

1. 目前，仅支持在具有 gnu-build 链（即 x86_64-unknown-linux-gnu）的 linux-x64 主机上开发。确保您拥有编译此目标代码所需的工具和环境
2. 通过 cargo install cargo-aragonite 命令安装 cargo-aragonite 构建工具。这是一个薄包装器，它设置了正确的环境、发布配置文件和构建脚本，以生成正确的位置无关 shellcode。
3. 使用 aragonite_main 属性注释您的 main 函数。这将处理设置链接器脚本的正确属性，并在提供目标家族时自动进行清理。请参阅 examples/src/bin 文件夹中的示例。
4. 使用构建工具构建您的 shellcode：cargo aragonite build。任何额外的参数都将透明地传递给 cargo。
5. 生成的 shellcode 将位于 targets/x86_64-unknown-linux-gnu/aragonite/[binaryname]

详细信息

#[aragonite_main] 属性

家族

可以设置为以下值

示例

#[aragonite_main(family = "win")]
fn main() {
    // my code here, will automatically call ExitProcess(0) at the end of the function
}

架构

可以设置为以下值

示例

#[aragonite_main(family = "win", arch = "x64")]
fn main() {
    // my code here, the code for ExitProcess(0) will assume it's running in a 64-bit process
}

no_cleanup

如果指定了family，则此标志将禁用自动清理代码生成。

示例

#[aragonite_main(no_cleanup, family = "win")]
fn main() {
    // my code here, no extra code will be added
}