Commit a2a5e1dc authored by Sascha Schirra's avatar Sascha Schirra
Browse files

spelling correction

parent 53dd036e

README.md

+67 −66
Original line number Diff line number Diff line 
Ropper

================



With ropper you can show informations about files in different file formats

and you can search gadgets to build rop chains for different architectures. For disassembly ropper uses the

With ropper you can show information about files in different file formats

and you can search for gadgets to build rop chains for different architectures. For disassembly ropper uses the

awesome Capstone Framework.



Install
@@ -36,8 +36,8 @@ Usage 
                 [--depth <n bytes>] [--search <regex>] [--filter <regex>]

                 [--opcode <opcode>] [--type <type>]



    With ropper you can show informations about files in different file formats

    and you can search gadgets to build rop chains for different architectures.

        With ropper you can show information about files in different file formats

        and you can search for gadgets to build rop chains for different architectures.



        supported filetypes:

          ELF
@@ -66,15 +66,15 @@ Usage 
          --set <option>        Sets options. Available options: aslr nx

          --unset <option>      Unsets options. Available options: aslr nx

          -I <imagebase>        Uses this imagebase for gadgets

      -p, --ppr             Searchs 'pop reg; pop reg; ret' instructions [only

                            x86/x86_64]

          -p, --ppr             Searches for 'pop reg; pop reg; ret' instructions

                                [only x86/x86_64]

          -j <reg>, --jmp <reg>

                            Searchs 'jmp reg' instructions (-j reg[,reg...]) [only

                            x86/x86_64]

      --depth <n bytes>     Specify the depth of search (default: 10)

      --search <regex>      Searchs for gadgets

                                Searches for 'jmp reg' instructions (-j reg[,reg...])

                                [only x86/x86_64]

          --depth <n bytes>     Specifies the depth of search (default: 10)

          --search <regex>      Searches for gadgets

          --filter <regex>      Filters gadgets

      --opcode <opcode>     Searchs opcodes

          --opcode <opcode>     Searches for opcodes

          --type <type>         Sets the type of gadgets [rop, jop, all] (default:

                                all)
@@ -102,6 +102,7 @@ Usage 
          ropper.py --file /bin/ls --type jop







Planned features for future versions

------------------------------------

  Architectures:

ropperapp/options.py

+7 −7
Original line number Diff line number Diff line
@@ -35,8 +35,8 @@ class Options(object): 


    def _createArgParser(self):

        parser = argparse.ArgumentParser(formatter_class=argparse.RawDescriptionHelpFormatter,

description="""With ropper you can show informations about files in different file formats

and you can search gadgets to build rop chains for different architectures.

description="""With ropper you can show information about files in different file formats

and you can search for gadgets to build rop chains for different architectures.



supported filetypes:

  ELF
@@ -98,17 +98,17 @@ epilog="""example uses: 
            '--unset', help='Unsets options. Available options: aslr nx', metavar='<option>')

        parser.add_argument('-I', metavar='<imagebase>', help='Uses this imagebase for gadgets')

        parser.add_argument(

            '-p', '--ppr', help='Searchs \'pop reg; pop reg; ret\' instructions [only x86/x86_64]', action='store_true')

            '-p', '--ppr', help='Searches for \'pop reg; pop reg; ret\' instructions [only x86/x86_64]', action='store_true')

        parser.add_argument(

            '-j', '--jmp', help='Searchs \'jmp reg\' instructions (-j reg[,reg...]) [only x86/x86_64]', metavar='<reg>')

            '-j', '--jmp', help='Searches for \'jmp reg\' instructions (-j reg[,reg...]) [only x86/x86_64]', metavar='<reg>')

        parser.add_argument(

            '--depth', help='Specify the depth of search (default: 10)', metavar='<n bytes>', type=int)

            '--depth', help='Specifies the depth of search (default: 10)', metavar='<n bytes>', type=int)

        parser.add_argument(

            '--search', help='Searchs for gadgets', metavar='<regex>')

            '--search', help='Searches for gadgets', metavar='<regex>')

        parser.add_argument(

            '--filter', help='Filters gadgets', metavar='<regex>')

        parser.add_argument(

            '--opcode', help='Searchs opcodes', metavar='<opcode>')

            '--opcode', help='Searches for opcodes', metavar='<opcode>')

        parser.add_argument(

            '--type', help='Sets the type of gadgets [rop, jop, all] (default: all)', metavar='<type>')

        return parser