Struct ShellcodeBuilder 

pub struct ShellcodeBuilder { /* private fields */ }

Builder for configuring and loading shellcode

Implementations

impl ShellcodeBuilder

pub fn new(shellcode: &[u8]) -> Self

Creates a new shellcode builder from raw bytes

Arguments

• shellcode - The raw machine code bytes

pub fn from_instructions(instructions: &[u32]) -> Self

Creates a shellcode builder from ARM64 instructions (u32 array)

Arguments

• instructions - Slice of 32-bit ARM64 instructions

pub fn with_symbol(self, offset: usize, symbol_name: &str) -> Self

Adds a symbol relocation for dynamic linking

The loader will resolve the symbol address and write it at the specified offset.

Arguments

• offset - Byte offset in the shellcode
• symbol_name - Name of the symbol to resolve

pub fn no_auto_free(self) -> Self

Disables automatic cleanup (shellcode won’t be freed on drop)

Use this if you want the shellcode to persist for the lifetime of the process.

pub fn near_address(self, target: usize) -> Self

Tries to load shellcode near a specific address (within branch range)

Use this if your shellcode contains relative branches to nearby code.

pub fn load(self) -> Result<LoadedShellcode, LoaderError>

Loads the shellcode into memory with all configured options

This will:

1. Allocate a code cave (optionally near a target)
2. Resolve and apply symbol relocations
3. Write the code to memory
4. Flush the instruction cache

Returns

• Result<LoadedShellcode, LoaderError> - The loaded shellcode handle or an error