$ sudo pip install capstone

$ sudo pip install filebytes

$ sudo pip install keystone-engine

$ python setup.py install
$ ropper

$ pip install ropper

$ ./Ropper.py

$ git clone https://github.com/sashs/ropper.git
$ cd ropper
$ git submodule init
$ git submodule update
$ ./Ropper.py

$ ropper --file <afile> --semantic "<any constraint>"

$ sudo pip install pyvex

$ python scripts/mk_make.py
$ cd build
$ make
$ sudo make install

reg == reg     -  레지스터를 다른 레지스터에 할당
reg == number  -  레지스터에 숫자 할당
reg == [reg]   -  레지스터에 메모리 할당
reg += number/reg/[reg]
reg -= number/reg/[reg]
reg *= number/reg/[reg]
reg /= number/reg/[reg]

eax==1 !ebx    - eax를 1로 설정하고 ebx를 망가뜨리지 않는 가젯 검색

usage: Ropper.py [-h] [--help-examples] [-v] [--console]
             [-f <file> [<file> ...]] [-r] [-a <arch>]
             [--section <section>] [--string [<string>]] [--hex]
             [--asm [<asm> [H|S|R] ...]] [--disasm <opcode>]
             [--disassemble-address <address:length>] [-i] [-e]
             [--imagebase] [-c] [-s] [-S] [--imports] [--symbols]
             [--set <option>] [--unset <option>] [-I <imagebase>] [-p]
             [-j <reg>] [--stack-pivot] [--inst-count <n bytes>]
             [--search <regex>] [--quality <quality>] [--opcode <opcode>]
             [--instructions <instructions>] [--type <type>] [--detailed]
             [--all] [--cfg-only] [--chain <generator>] [-b <badbytes>]
             [--nocolor] [--clear-cache] [--no-load] [--analyse <quality>]
             [--semantic constraint]
             [--count-of-findings <count of gadgets>] [--single]

로퍼를 사용하여 바이너리 파일의 다양한 파일 형식에 대한 정보를 표시할 수 있으며,
    다양한 아키텍처에 대한 ROP 체인을 구축하기 위한 가젯을 검색할 수 있습니다.

지원되는 파일 형식:
  ELF
  PE
  Mach-O
  Raw

지원되는 아키텍처:
  x86 [x86]
  x86_64 [x86_64]
  MIPS [MIPS, MIPS64]
  ARM/Thumb [ARM, ARMTHUMB]
  ARM64 [ARM64]
  PowerPC [PPC, PPC64]
  SPARC [SPARC64]

사용 가능한 ROP 체인 생성기:
  execve (execve[=<cmd>], 기본값 /bin/sh) [Linux x86, x86_64]
  mprotect  (mprotect=<address>:<size>) [Linux x86, x86_64]
  virtualprotect (virtualprotect=<address iat vp>:<size>) [Windows x86]

옵션:
  -h, --help            이 도움말 메시지를 표시하고 종료
  --help-examples       예제 출력
  -v, --version         버전 출력
  --console             대화형 명령줄 시작
  -f <file> [<file> ...], --file <file> [<file> ...]
                        로드할 파일
  -r, --raw             파일을 원시(raw) 파일로 로드
  -a <arch>, --arch <arch>
                        로드된 파일의 아키텍처
  --section <section>   이 섹션의 데이터를 출력해야 함
  --string [<string>]   모든 데이터 섹션에서 문자열 <string>을 검색
  --hex                 선택한 섹션을 16진수 형식으로 출력
  --asm [<asm> [H|S|R] ...]
                        어셈블할 문자열과 출력 형식
                        (H=HEX, S=STRING, R=RAW, 기본값: H)
  --disasm <opcode>     디스어셈블할 opcode (예: ffe4, 89c8c3, ...)
  --disassemble-address <address:length>
                        주소 <address>에서 명령 디스어셈블
                        (0x12345678:L3). 디스어셈블할 명령 수를 지정할 수 있음
                        (0x....:L...)
  -i, --info            파일 헤더 표시 [ELF/PE/Mach-O]
  -e                    진입점(EntryPoint) 표시
  --imagebase           ImageBase 표시 [ELF/PE/Mach-O]
  -c, --dllcharacteristics
                        DllCharacteristics 표시 [PE]
  -s, --sections        파일 섹션 표시 [ELF/PE/Mach-O]
  -S, --segments        파일 세그먼트 표시 [ELF/Mach-O]
  --imports             임포트 표시 [ELF/PE]
  --symbols             심볼 표시 [ELF]
  --set <option>        옵션 설정. 사용 가능한 옵션: aslr nx
  --unset <option>      옵션 해제. 사용 가능한 옵션: aslr nx
  -I <imagebase>        가젯에 이 imagebase 사용
  -p, --ppr             'pop reg; pop reg; ret' 명령 검색
                        [x86/x86_64 전용]
  -j <reg>, --jmp <reg>
                        'jmp reg' 명령 검색 (-j reg[,reg...])
                        [x86/x86_64 전용]
  --stack-pivot         모든 스택 피벗 가젯 출력
  --inst-count <n bytes>
                        가젯 내 최대 명령 수 지정 (기본값: 6)
  --search <regex>      가젯 검색
  --quality <quality>   검색으로 찾은 가젯의 품질 (1 =
                        최고)
  --opcode <opcode>     opcode 검색 (예: ffe4 또는 ffe? 또는 ff??)
  --instructions <instructions>
                        명령 검색 (예: "jmp esp", "pop eax;
                        ret")
  --type <type>         가젯 유형 설정 [rop, jop, sys, all]
                        (기본값: all)
  --detailed            가젯을 더 자세히 출력
  --all                 중복 가젯 제거 안 함
  --cfg-only            Microsoft CFG 검사에 실패한 가젯 필터링
                        (CFG 검사가 활성화된 PE 파일만 해당) (DllCharachteristics 확인) [PE]
  --chain <generator>   ROP 체인 생성 [생성기 매개변수=값[
                        매개변수=값]]
  -b <badbytes>, --badbytes <badbytes>
                        가젯에 포함되지 않아야 하는 바이트 설정
  --nocolor             색상 출력 비활성화
  --clear-cache         캐시 지우기
  --no-load             콘솔 시작 시 가젯 자동 로드 안 함 (--console)
  --analyse <quality>   시멘틱 검색 구현에만 사용됨
  --semantic constraint
                        가젯에 대한 시멘틱 검색
  --count-of-findings <count of gadgets>
                        시멘틱 검색으로 출력할 최대 가젯 수
                        (0 = 정의되지 않음, 기본값: 5)
  --single              가젯 스캔에 다중 프로세스를 사용하지 않음

사용 예:
  [일반]
  ./Ropper.py
  ./Ropper.py --file /bin/ls --console

  [정보]
  ./Ropper.py --file /bin/ls --info
  ./Ropper.py --file /bin/ls --imports
  ./Ropper.py --file /bin/ls --sections
  ./Ropper.py --file /bin/ls --segments
  ./Ropper.py --file /bin/ls --set nx
  ./Ropper.py --file /bin/ls --unset nx
  ./Ropper.py --file /bin/ls --inst-count 5
  ./Ropper.py --file /bin/ls --search "sub eax" --badbytes 000a0d
  ./Ropper.py --file /bin/ls --search "sub eax" --detail
  ./Ropper.py --file /bin/ls --filter "sub eax"
  ./Ropper.py --file /bin/ls --inst-count 5 --filter "sub eax"
  ./Ropper.py --file /bin/ls --opcode ffe4
  ./Ropper.py --file /bin/ls --opcode ffe?
  ./Ropper.py --file /bin/ls --opcode ??e4
  ./Ropper.py --file /bin/ls --detailed
  ./Ropper.py --file /bin/ls --ppr --nocolor
  ./Ropper.py --file /bin/ls --jmp esp,eax
  ./Ropper.py --file /bin/ls --type jop
  ./Ropper.py --file /bin/ls --chain execve
  ./Ropper.py --file /bin/ls --chain "execve cmd=/bin/sh" --badbytes 000a0d
  ./Ropper.py --file /bin/ls --chain "mprotect address=0xbfdff000 size=0x21000"
  ./Ropper.py --file /bin/ls /lib/libc.so.6 --console

  [어셈블/디스어셈블]
  ./Ropper.py --asm "jmp esp"
  ./Ropper.py --asm "mov eax, ecx; ret"
  ./Ropper.py --disasm ffe4

  [검색]
  ./Ropper.py --file /bin/ls --search <검색 문자열>
  ?     모든 문자
  %     모든 문자열

  예시:

  ./Ropper.py --file /bin/ls --search "mov e?x"
  0x000067f1: mov edx, dword ptr [ebp + 0x14]; mov dword ptr [esp], edx; call eax
  0x00006d03: mov eax, esi; pop ebx; pop esi; pop edi; pop ebp; ret ;
  0x00006d6f: mov ebx, esi; mov esi, dword ptr [esp + 0x18]; add esp, 0x1c; ret ;
  0x000076f8: mov eax, dword ptr [eax]; mov byte ptr [eax + edx], 0; add esp, 0x18; pop ebx; ret ;

  ./Ropper.py --file /bin/ls --search "mov [%], edx"
  0x000067ed: mov dword ptr [esp + 4], edx; mov edx, dword ptr [ebp + 0x14]; mov dword ptr [esp], edx; call eax;
  0x00006f4e: mov dword ptr [ecx + 0x14], edx; add esp, 0x2c; pop ebx; pop esi; pop edi; pop ebp; ret ;
  0x000084b8: mov dword ptr [eax], edx; ret ;
  0x00008d9b: mov dword ptr [eax], edx; add esp, 0x18; pop ebx; ret ;

  ./Ropper.py --file /bin/ls --search "mov [%], edx" --quality 1
  0x000084b8: mov dword ptr [eax], edx; ret ;; ret ;

#!/usr/bin/env python
from ropper import RopperService

# 모든 옵션을 제공할 필요는 없습니다.
options = {'color' : False,     # 가젯 출력 시 색상 출력 사용: 기본값: False
            'badbytes': '00',   # 주소나 ROP 체인에 포함되지 않아야 하는 바이트; 기본값: ''
            'all' : False,      # 모든 가젯 표시 (중복 가젯 제거 안 함); 기본값: False
            'inst_count' : 6,   # 가젯 내 명령 수; 기본값: 6
            'type' : 'all',     # rop, jop, sys, all; 기본값: all
            'detailed' : False} # 가젯 출력 시 상세 출력 사용; 기본값: False

rs = RopperService(options)

##### 옵션 변경 ######
rs.options.color = True
rs.options.badbytes = '00'
rs.options.badbytes = ''
rs.options.all = True


##### 바이너리 열기 ######
# 여러 파일을 열 수 있습니다.
rs.addFile('test-binaries/ls-x86')
rs.addFile('ls', bytes=open('test-binaries/ls-x86','rb').read()) # 다른 방법
rs.addFile('ls_raw', bytes=open('test-binaries/ls-x86','rb').read(), raw=True, arch='x86')

##### 바이너리 닫기 ######
rs.removeFile('ls')
rs.removeFile('ls_raw')


# 바이너리의 아키텍처를 설정하여 다른 아키텍처에 대한 가젯을 검색할 수 있게 합니다.
# ARM에서 ARM 가젯이나 Thumb 가젯을 검색할 때 유용합니다.
# 또는 원시(raw) 파일을 열었을 때 유용합니다.
ls = 'test-binaries/ls-x86'
rs.setArchitectureFor(name=ls, arch='x86')
rs.setArchitectureFor(name=ls, arch='x86_64')
rs.setArchitectureFor(name=ls, arch='ARM')
rs.setArchitectureFor(name=ls, arch='ARMTHUMB')
rs.setArchitectureFor(name=ls, arch='ARM64')
rs.setArchitectureFor(name=ls, arch='MIPS')
rs.setArchitectureFor(name=ls, arch='MIPS64')
rs.setArchitectureFor(name=ls, arch='PPC')
rs.setArchitectureFor(name=ls, arch='PPC64')
rs.setArchitectureFor(name=ls, arch='SPARC64')
rs.setArchitectureFor(name=ls, arch='x86')


##### 가젯 로드 ######

# 열린 모든 파일에 대한 가젯 로드
rs.loadGadgetsFor() 

# 열린 파일 하나에 대해서만 가젯 로드
ls = 'test-binaries/ls-x86'
rs.loadGadgetsFor(name=ls)

# 가젯 유형 변경
rs.options.type = 'jop'
rs.loadGadgetsFor() 

rs.options.type = 'rop'
rs.loadGadgetsFor() 

# 명령 수 변경
rs.options.inst_count = 10
rs.loadGadgetsFor() 

##### 가젯 출력 #######
rs.printGadgetsFor() # 모든 가젯 출력
rs.printGadgetsFor(name=ls)

##### 가젯 가져오기 ######
gadgets = rs.getFileFor(name=ls).gadgets


##### pop pop ret 검색 ######
pprs = rs.searchPopPopRet(name=ls) # 'test-binaries/ls-x86'에서만 ppr 검색
pprs = rs.searchPopPopRet()        # 열린 모든 파일에서 ppr 검색
for file, ppr in pprs.items():
    for p in ppr:
        print p

##### jmp reg 로드 ######
jmp_regs = rs.searchJmpReg(name=ls, regs=['esp', 'eax']) # 'test-binaries/ls-x86'에서만 jmp reg 검색
jmp_regs = rs.searchJmpReg(regs=['esp', 'eax'])
jmp_regs = rs.searchJmpReg()                             # 열린 모든 파일에서 jmp esp 검색
for file, jmp_reg in jmp_regs.items():
    for j in jmp_reg:
        print j


##### opcode 검색 ######
ls = 'test-binaries/ls-x86'
gadgets_dict = rs.searchOpcode(opcode='ffe4', name=ls)
gadgets_dict = rs.searchOpcode(opcode='ffe?')
gadgets_dict = rs.searchOpcode(opcode='??e4')

for file, gadgets in gadgets_dict.items():
    for g in gadgets:
        print g

##### 명령 검색 ######
ls = 'test-binaries/ls-x86'
for file, gadget in rs.search(search='mov e?x', name=ls):
    print file, gadget

for file, gadget in rs.search(search='mov [e?x%]'):
    print file, gadget    

result_dict = rs.searchdict(search='mov eax')
for file, gadgets in result_dict.items():
    print file
    for gadget in gadgets:
        print gadget

##### 명령 어셈블 ######
hex_string = rs.asm('jmp esp')
print '"jmp esp" 어셈블된 16진수 문자열 =', hex_string
raw_bytes = rs.asm('jmp esp', format='raw')
print '"jmp esp" 어셈블된 원시 바이트 =', raw_bytes
string = rs.asm('jmp esp', format='string')
print '"jmp esp" 어셈블된 문자열 =',string
arm_bytes = rs.asm('bx sp', arch='ARM')
print '"bx sp" 어셈블된 16진수 문자열 =', arm_bytes

##### 바이트 디스어셈블 #######
arm_instructions = rs.disasm(arm_bytes, arch='ARM')
print arm_bytes, '디스어셈블되어 "%s"' % arm_instructions

# Imagebase 변경, 이 바이너리의 로드된 모든 가젯의 imagebase도 변경됩니다.
rs.setImageBaseFor(name=ls, imagebase=0x0)

# imagebase 재설정
rs.setImageBaseFor(name=ls, imagebase=None)

gadgets = rs.getFileFor(name=ls).gadgets

# 가젯 주소
print hex(gadgets[0].address)

# 가젯 명령 바이트 가져오기
print bytes(gadgets[0].bytes).encode('hex')

# 주소에 나쁜 바이트가 포함된 모든 가젯 제거
rs.options.badbytes = '000a0d'  # 가젯이 자동으로 필터링됩니다.