
Krakatau는 Java 바이트코드를 위한 어셈블러와 디스어셈블러를 제공하며, 이를 통해 바이너리 클래스 파일을 사람이 읽을 수 있는 텍스트 형식으로 변환하고, 수정한 뒤, 다시 클래스 파일로 변환할 수 있습니다. 난독화된 코드에 대해서도 가능합니다. 또한 바이트코드를 직접 작성하여 처음부터 자신만의 클래스 파일을 만들 수 있으며, Java 바이너리의 저수준 세부 사항을 검사하고 비교할 수 있습니다. javap와 달리 Krakatau 디스어셈블러는 고도로 난독화된 코드도 처리할 수 있으며, 디스어셈블된 출력을 클래스 파일로 다시 어셈블할 수 있습니다.
Krakatau는 또한 Java 바이너리를 읽을 수 있는 소스 코드로 변환하기 위한 디컴파일러를 제공합니다. 다른 디컴파일러와 달리 Krakatau 디컴파일러는 난독화된 코드를 다루기 위해 특별히 설계되었으며, 다른 디컴파일러를 깨뜨리는 트릭도 쉽게 처리할 수 있습니다. 그러나 Krakatau 디컴파일러는 람다와 같은 일부 Java 8+ 기능을 지원하지 않으므로 오래된 코드에서 가장 잘 작동합니다.
Krakatau의 어셈블러 구문은 사소한 비호환성이 있는 Jasmin 구문의 대부분의 상위 집합이지만, Jasmin과 달리 Krakatau는 Java 27 바이트코드 명세를 완전히 지원하며 구버전 JVM에서 발견되는 일부 문서화되지 않은 기능까지 지원합니다. 어셈블러 구문에 대한 개요는 튜토리얼 또는 전체 명세를 참조하십시오.
먼저 Rust와 Cargo를 설치해야 합니다. 그런 다음 이 저장소를 복제하고 cargo build --release를 실행하십시오. 그러면 target/release/krak2에 바이너리가 생성되며, 이를 직접 호출하거나, PATH에 추가하거나, 심볼릭 링크하는 등의 방식으로 사용할 수 있습니다.
디스어셈블러에는 기본 모드와 라운드트립 모드의 두 가지 모드가 있습니다. 기본 모드는 결과 어셈블리 파일의 가독성과 수정 용이성에 최적화되어 있습니다. 출력을 다시 어셈블하면 JVM 명세의 관점에서 원본과 동작이 동일한 클래스 파일이 생성되지만, 반드시 비트 단위로 동일하지는 않습니다(예를 들어 상수 풀 항목의 순서가 재배열될 수 있습니다). 라운드트립 모드는 원본과 비트 단위로 동일한 클래스 파일로 다시 어셈블되는 출력을 생성하지만, 이는 어셈블리 파일이 상수 풀 항목의 정확한 순서와 같이 읽기 어렵게 만드는 저수준 인코딩 정보를 보존한다는 것을 의미합니다. CLDC 코드나 Scala 코드와 같이 비표준 속성에 의존하는 코드를 다룰 때는 라운드트립 모드를 사용할 것을 권장합니다.
사용 예:
krak2 dis --out temp RecordTest.class
krak2 dis --out disassembled.zip --roundtrip r0lling-challenge.jar
개별 클래스 파일 또는 전체 jar 파일을 디스어셈블할 수 있습니다. 입력 파일 이름이 .jar 또는 .zip으로 끝나면 jar 파일로 처리되며, jar 내부의 모든 .class 파일이 디스어셈블됩니다.
--out 옵션은 출력 위치를 제어합니다. --out 값이 디렉터리이면 출력은 해당 디렉터리 아래의 개별 파일에 배치됩니다. 그렇지 않고 --out 값이 .jar 또는 .zip으로 끝나면 출력은 해당 위치의 단일 zip 파일에 배치됩니다. --out 값이 .j로 끝나면 출력은 해당 파일에 기록됩니다(단일 .j 파일에는 여러 클래스가 포함될 수 있으며, 모든 클래스가 디스어셈블되어 차례로 같은 파일에 기록됩니다). --out 옵션을 완전히 생략하면 디스어셈블된 클래스가 표준 출력에 기록됩니다.
위에서 설명한 대로 라운드트립 모드로 디스어셈블하려면 --roundtrip 옵션(또는 축약형 -r)을 전달하십시오.
Krakatau 어셈블러를 사용하면 Java 바이트코드를 사람에게 친숙한 텍스트 기반 형식으로 작성하고 이를 바이너리 Java 클래스 파일로 변환할 수 있습니다.
krak2 asm --out temp Krakatau/tests/data/asm/good/strictfp.j
개별 .j 파일 또는 전체 jar 파일을 어셈블할 수 있습니다. 입력 파일 이름이 .jar 또는 .zip으로 끝나면 zip 아카이브로 처리되며, 내부의 모든 .j 파일이 어셈블됩니다.
--out 옵션은 출력 위치를 제어합니다. --out 값이 디렉터리인 경우 출력은 해당 디렉터리 아래의 개별 파일에 배치됩니다. 그렇지 않고 --out 값이 .jar 또는 .zip으로 끝나는 경우 출력은 해당 위치의 단일 zipfile에 배치됩니다. --out 값이 .class로 끝나는 경우 단일 출력 classfile이 해당 파일에 기록됩니다(입력에 여러 클래스가 있는 경우 이 경우에는 오류가 발생합니다).
v2 디컴파일러는 아직 작업 중입니다. 디컴파일을 위해서는 현재 Krakatau v1을 사용해야 합니다.
현재 버전의 Krakatau는 MIT 또는 Apache 2 라이선스 중 선택한 라이선스에 따라 라이선스가 부여됩니다. Krakatau v1 및 커밋 baa5534ab29dbfb7b62018bed897f52073974f2f까지의 v2는 대신 GPL3 이상에 따라 라이선스가 부여되었습니다.