eatshell

Summary • Requirements • Installation • Usage • License

Summary

eatshell is a simple command line tool to automate the process of shellcode extraction, loading and assembling. eatshell contains three commands extract, load, and assemble.

Note

Note: eatshell is meant for small-scale application and primarily created for personal use only.

Requirements

• Python 3.xx

Installation

There are two ways to install eatshell:

Install the tool directly with pip

pip install eatshell

Or, you can build from source. Download the latest release.

Usage

Use the --help switch to read the COMMANDS and OPTIONS available.

$ eatshell --help
Usage: eatshell.py [OPTIONS] COMMAND [ARGS]...

Options:
  --hush  Suppress Usage and Warning info.
  --help  Show this message and exit.

Commands:
  assemble
  extract
  load

There are three commands available for eatshell:

• assemble
• extract
• load

$ eatshell assemble --shellcode <hex string> --file <filename>
    
    Use this command to assemble given shellcode
    into an ELF file with +rwx permissions for
    the owner.

$ eatshell extract --file <filename> --hex <boolean>
        
    Use this command to extract shellcode
    from an existing ELF file.
    Turn --hex on for hex encoding.

$ eatshell load --shellcode <hex string>

    Use this command to run the provided
    shellcode interactively.
    Use with caution, might not work everytime.

Warning

Create an .env file with the following variables. Otherwise, the program might not work.

.env file structure example:

OS=linux
ARCH=amd64
LOG_LEVEL=error

License

Distributed under MIT License.