Lib.rs

shellexec

Cross-platform shellcode executor in rwx memory

Usage: shellexec <binary>

Executes shellcode

Positional Arguments:
  binary            path to binary file

Options:
  --help            display usage information

Implementation

virtual-memory is used to execute shellcode. This helper crates allocates rwx memory using the system functions that is described here:

• Unix

  • mmap(NULL, len, PROT_READ | PROT_WRITE | PROT_EXEC, MAP_PRIVATE | MAP_ANON, -1, 0)
  • munmap(addr, len)

• Windows

  • VirtualAlloc(NULL, len, MEM_COMMIT | MEM_RESERVE, PAGE_EXECUTE_READWRITE)
  • VirtualFree(addr, 0, MEM_RELEASE)

Then the contents of the file are copied into this memory, the address of this memory is converted into a function and called

Installing from crates.io

cargo install shellexec

Building

cargo build --release

Usage

# linux
cargo run --release -- shellexec/test_input/linux

# windows
cargo run --release -- shellexec/test_input/windows

# output
hello from shellcode!