Metadata-Version: 1.0
Name: pyrasite
Version: 1.0dev
Summary: Inject code into a running Python process
Home-page: http://pyrasite.fedorahosted.org
Author: Luke Macken
Author-email: lmacken@redhat.com
License: GPLv3
Description: pyrasite
        ========
        
        Injects code into a running Python process.
        
        Requirements
        ~~~~~~~~~~~~
        
          - gdb (https://www.gnu.org/s/gdb)
        
        Example Payloads
        ~~~~~~~~~~~~~~~~
        
        Hello World
        -----------
        
        ::
        
            pyrasite <PID> payloads/helloworld.py
        
        This payload is used by the test suite, which can be run by doing:
        
        ::
        
            python setup.py test
        
        
        Reverse Python Shell
        --------------------
        
        ::
        
            $ python
            >>> x = 'foo'
        
        ::
        
            $ pyrasite <PID> payloads/reverse_python_shell.py
            $ nc -l localhost 9001
            Python 2.7.1 (r271:86832, Apr 12 2011, 16:15:16)
            [GCC 4.6.0 20110331 (Red Hat 4.6.0-2)]
            Type 'quit' to exit.
            >>> print x
            foo
            
            >>> globals()['x'] = 'bar'
        
        
        Reverse Shell
        --------------
        
        ::
        
            $ pyrasite <PID> payloads/reverse_shell.py
            $ nc -l localhost 9001
            Linux tomservo 2.6.40.3-0.fc15.x86_64 #1 SMP Tue Aug 16 04:10:59 UTC 2011 x86_64 x86_64 x86_64 GNU/Linux
            Type 'quit' to exit.
            % ls
        
        
        Dumping memory, modules, stacks
        -------------------------------
        
        ::
        
            payloads/dump_memory.py
            payloads/dump_modules.py
            payloads/dump_stacks.py
        
Keywords: debugging injection runtime
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Software Development :: Debuggers
