Lib.rs

Aragonite

Aragonite is a form of calcium-carbonate (CaCO3) commonly found in the materials for shell formation. In that spirit, aragonite is a set of tools necessary that makes generating position-independent shellcode in rust easy to do.

Supported targets

• Windows, x64
• Linux, x64

Usage

1. Currently, development is only supported on linux-x64 hosts with gnu-build chain (aka x86_64-unknown-linux-gnu). Ensure you have the required tooling/environment to compile code for this target
2. Install the cargo-aragonite build tool via cargo install cargo-aragonite. This is a thin-wrapper that sets up the correct environment, release profile, and build scripts to generate proper position-independent shellcode.
3. Annotate your main function with the aragonite_main attribute. This handles setting up the correct attributes for the linker script, and automatic clean exits if a target family is supplied. See the examples/src/bin folder for examples.
4. Build your shellcode with the build tool: cargo aragonite build. Any extra arguments are transparently passed to cargo.
5. The produced shellcode will be in targets/x86_64-unknown-linux-gnu/aragonite/[binaryname]

Detailed Information

#[aragonite_main] attributes

family

Can be set to the following values:

Example

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

arch

Can be set to the following values:

Example

#[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

This flag disables automatic cleanup code generation if a family is specified.

Example

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