Commit 6f49810a authored by Luke Macken's avatar Luke Macken

Some documentation tweaks

parent ae1adbf2
......@@ -5,7 +5,8 @@ pyrasite
Pyrasite lets you to inject arbitrary code into running Python processes.
:documentation: http://pyrasite.com
:homepage: http://pyrasite.com
:documentation: http://pyrasite.rtfd.org
:download: http://pypi.python.org/pypi/pyrasite
:source: http://github.com/lmacken/pyrasite
:screenshots: http://readthedocs.org/docs/pyrasite/en/latest/GUI.html
......@@ -16,7 +17,7 @@ Pyrasite lets you to inject arbitrary code into running Python processes.
Requirements
~~~~~~~~~~~~
* `gdb <https://www.gnu.org/s/gdb>`_ (version 7.3+)
* `gdb <https://www.gnu.org/s/gdb>`_ (version 7.3+ (or RHEL5+))
Compatiblity
~~~~~~~~~~~~
......
Payloads
========
Reverse Python Shell
--------------------
.. deprecated:: 2.0
Use the `pyrasite-shell <http://readthedocs.org/docs/pyrasite/en/latest/Shell.html>`_ instead
This lets you easily introspect or alter any objects in your running process.
.. literalinclude:: ../pyrasite/payloads/reverse_python_shell.py
:language: python
:start-after: Copyright
::
$ python
>>> x = 'foo'
::
$ pyrasite <PID> pyrasite/payloads/reverse_python_shell.py
::
$ nc -l 9001
Python 2.7.1 (r271:86832, Apr 12 2011, 16:15:16)
[GCC 4.6.0 20110331 (Red Hat 4.6.0-2)]
>>> print x
foo
>>> globals()['x'] = 'bar'
Viewing the largest objects in your process
-------------------------------------------
......@@ -64,25 +34,6 @@ installed.
.. image:: http://lewk.org/img/pyrasite-memory-viewer.png
Reverse Subprocess Shell
------------------------
.. literalinclude:: ../pyrasite/payloads/reverse_shell.py
:language: python
:start-after: Copyright
::
$ pyrasite <PID> pyrasite/payloads/reverse_shell.py
::
$ nc -l 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
% ls
Call Graph
----------
......@@ -92,7 +43,6 @@ graph using `pycallgraph <http://pycallgraph.slowchop.com>`_.
.. literalinclude:: ../pyrasite/payloads/start_callgraph.py
:language: python
:start-after: http
.. literalinclude:: ../pyrasite/payloads/stop_callgraph.py
:language: python
:start-after: http
......@@ -135,3 +85,51 @@ Forcing garbage collection
::
$ pyrasite <PID> pyrasite/payloads/force_garbage_collection.py
Reverse Subprocess Shell
------------------------
.. literalinclude:: ../pyrasite/payloads/reverse_shell.py
:language: python
:start-after: Copyright
::
$ pyrasite <PID> pyrasite/payloads/reverse_shell.py
::
$ nc -l 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
% ls
Reverse Python Shell
--------------------
.. deprecated:: 2.0
Use the `pyrasite-shell <http://readthedocs.org/docs/pyrasite/en/latest/Shell.html>`_ instead
This lets you easily introspect or alter any objects in your running process.
.. literalinclude:: ../pyrasite/payloads/reverse_python_shell.py
:language: python
:start-after: Copyright
::
$ python
>>> x = 'foo'
::
$ pyrasite <PID> pyrasite/payloads/reverse_python_shell.py
::
$ nc -l 9001
Python 2.7.1 (r271:86832, Apr 12 2011, 16:15:16)
[GCC 4.6.0 20110331 (Red Hat 4.6.0-2)]
>>> print x
foo
>>> globals()['x'] = 'bar'
......@@ -43,7 +43,7 @@ master_doc = 'index'
# General information about the project.
project = u'pyrasite'
copyright = u'2011, 2012, Luke Macken'
copyright = u'2011-2012, Red Hat, Inc., Luke Macken'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment