Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/helviojunior/shellcodetester
An application to test windows and linux shellcodes
https://github.com/helviojunior/shellcodetester
Last synced: 21 days ago
JSON representation
An application to test windows and linux shellcodes
- Host: GitHub
- URL: https://github.com/helviojunior/shellcodetester
- Owner: helviojunior
- License: gpl-3.0
- Created: 2019-06-11T04:39:58.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-06T00:28:24.000Z (about 1 month ago)
- Last Synced: 2024-11-06T00:29:28.131Z (about 1 month ago)
- Language: Python
- Homepage:
- Size: 24.9 MB
- Stars: 90
- Watchers: 4
- Forks: 30
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - helviojunior/shellcodetester - An application to test windows and linux shellcodes (Python)
README
# Shellcode Tester
[](https://github.com/helviojunior/shellcodetester/actions/workflows/build_and_publish.yml)
[](https://github.com/helviojunior/shellcodetester/actions/workflows/build_and_test.yml)
[](https://pepy.tech/project/shellcodetester)
[](https://pypi.org/project/shellcodetester)
[](https://github.com/helviojunior/shellcodetester/graphs/contributors)
[](https://pypi.org/project/shellcodetester/)
[](https://github.com/helviojunior/shellcodetester/blob/master/LICENSE)
ShellcodeTester officially supports Python 3.8+.
## Main features
* [x] Assembly ASM file (32 and 64 bits)
* [x] Assembly ASM file to Windows, Linux and MacOS
* [x] Check badchars
* [x] Output to several formats
* [x] NASM Shell
* [x] Other amazing features...
## Shellcode Tester - Getting stats
```bash
shellcodetester -asm file.asm
```
This command will assembly the ASM file and compile an ELF binary
```bash
ShellcodeTester v0.2.0 by Helvio Junior (M4v3r1ck)
ShellcodeTester is a tool to assembly, compile and test ASM shellcode.
https://github.com/helviojunior/shellcodetester
[+] Startup parameters
command line: shellcodetester -asm test_linux.asm
log level: NOTSET
transform format: RAW
bad chars: 0x00
[+] start time 2023-02-12 01:53:56
[+] Assembling x86 file teste_linux.asm to /home/shellcodetester/st_test_linux.o
[+] Compiling x86 binary to /home/shellcodetester/st_test_linux.elf32
[+] Payload size: 65 bytes
[+] Final size of RAW data: 160 bytes
31c0b00431dbb301eb1259ba00000000b220cd8031c0b00131dbcd80e8e9ffffff4c616220303120636f6d706c657461646f20636f6d207375636573736f210a00
[+] End time 2023-02-12 01:53:56
```
## Nasm Shell - Getting stats
### Assembling
```bash
$ nasm_shell
┌─[NASM Shell]─[x86 linux]─[ASM → Hex]
└──╼➤ push eax
[+] Payload size: 1 bytes
[+] Final size of RAW data: 2 bytes
50
[+] Disassembly
0: 50 push eax
┌─[NASM Shell]─[x86 linux]─[ASM → Hex]
└──╼➤ push eax ; retn 4
[+] Payload size: 4 bytes
[+] Final size of RAW data: 8 bytes
50c20400
[+] Disassembly
0: 50 push eax
1: c2 04 00 ret 0x4
```
### Disassembling
```bash
$ nasm_shell --mode dis
┌─[NASM Shell]─[x86 linux]─[Hex → ASM]
└──╼➤ 50ff501c
[+] Payload size: 4 bytes
[+] Final size of RAW data: 8 bytes
50ff501c
[+] Disassembly
0: 50 push eax
1: ff 50 1c call DWORD PTR [eax+0x1c]
```
### 64 bits (x86-64)
```bash
$ nasm_shell --arch x86_64
┌─[NASM Shell]─[x86_64 linux]─[ASM → Hex]
└──╼➤ push rax
[+] Payload size: 1 bytes
[+] Final size of RAW data: 2 bytes
50
[+] Disassembly
0: 50 push rax
┌─[NASM Shell]─[x86_64 linux]─[ASM → Hex]
└──╼➤ push rax ; push rbx
[+] Payload size: 2 bytes
[+] Final size of RAW data: 4 bytes
5053
[+] Disassembly
0: 50 push rax
1: 53 push rbx
```
## Installation
```bash
pip3 install --upgrade shellcodetester
```
# Help
## Shellcodetester
```bash
$ shellcodetester -h
ShellcodeTester v0.X.X by Helvio Junior (M4v3r1ck)
ShellcodeTester is a tool to assembly, compile and test ASM shellcode.
https://github.com/helviojunior/shellcodetester
options:
-h, --help show this help message and exit
General Setting:
-asm [ASM file name] Assembly file to be assembled
-o [output file] Save output to disk (default: none)
Custom Settings:
--break-point Set software breakpoint (INT3) before shellcode (default: false)
--bad-chars [bad char list] List of bad chars to highlight (ex: \x00\x0a, default: \0x00)
--remove Remove bad chars from final binary executable (EXE, ELF and Mach-O). (default: false)
--cave-size [size] Code cave size (default: 1024)
--fill-with-nop Fill entire page with NOP (default: false)
--list List all supported output format
-f [format], --format [format] Output format (use --list formats to list)
-v, --verbose Shows more options (-h -v). Prints commands and outputs. (default: quiet)
```
## Nasmshell
```bash
$ nasm_shell -h
options:
-h, --help show this help message and exit
General Setting:
--mode [mode] Operation mode. (default: assembly, permitted: assembly and disassembly)
--arch [architecture] Architecture to assembly/disassembly. (default: x86, permitted: x86_64 and x86)
--platform [platform] Platform. (permitted: linux, windows and darwin)
Custom Settings:
--bad-chars [bad char list] List of bad chars to highlight (ex: \x00\x0a, default: \0x00)
--list List all supported output format
-f [format], --format [format] Output format (use --list formats to list)
-v, --verbose Shows more options (-h -v). Prints commands and outputs. (default: quiet)
-q, --quiet Quiet mode, not show banners. (default: false)
```
# Windows Users
Check specific instructions by Windows Users
[Windows Instructions](https://github.com/helviojunior/shellcodetester/blob/master/WINDOWS.md)