JVM Tutorials - Herong's Tutorial Examples - v5.14, by Herong Yang
Lilac Disassembler: "jdasm"
This section provides a tutorial example on how to disassemble a JVM bytecode using the Lilac disassembler.
What Is Lilac Disassembler? Lilac disassembler is a tool provided in the Lilac package that allows you to disassemble JVM bytecode back into Lilac assembly code. Lilac disassembler can be invoked by the "jdasm.sh" script.
Let's try it with CalculatorMacro.class generated in the last tutorial.
1. Disassemble Calculator.class. Back up the original Calculator.jasm file. It may get overwritten by Lilac tools accidentally.
herong> mkdir dis herong> ./jasm/jdasm.sh -input cls -output dis Disassembled 1 class files in 0 secs herong> ls -l dis -rw-r--r-- 1 herong staff 5575 Nov 15 09:31 CalculatorMacro.jasm
2. Review the disassembled Lilac code.
herong> more dis/CalculatorMacro.jasm
public class {
version 45.0;
name ThisClass; // CalculatorMacro
extends Object; // java/lang/Object
//Constants
const utf8 source_file_name "CalculatorMacro.jasm";
const utf8 Code_utf8 "Code";
const utf8 utf8_2 "Error: Division by zero is not allowed.";
const string string_3 utf8_2; // "Error: Division by zero is not allowed."
const utf8 utf8_4 "Error: Please provide valid numeric values.";
const string string_5 utf8_4; // "Error: Please provide valid numeric values."
const utf8 utf8_6 "Error: Invalid operator. Use +, -, *, or /.";
const string string_7 utf8_6; // "Error: Invalid operator. Use +, -, *, or /."
const utf8 utf8_8 "Error: Invalid number of arguments.";
const string string_9 utf8_8; // "Error: Invalid number of arguments."
const utf8 utf8_10 "Usage: java CalculatorMacro <num> <op> <num>";
const string string_11 utf8_10; // "Usage: java CalculatorMacro ..."
const utf8 ThisClass_name "CalculatorMacro";
const classref ThisClass ThisClass_name; // CalculatorMacro
const utf8 Object_name "java/lang/Object";
const classref Object Object_name; // java/lang/Object
const utf8 Double_name "java/lang/Double";
const classref Double Double_name; // java/lang/Double
const utf8 String_name "java/lang/String";
const classref String String_name; // java/lang/String
const utf8 System_name "java/lang/System";
const classref System System_name; // java/lang/System
const utf8 PrintStream_name "java/io/PrintStream";
const classref PrintStream PrintStream_name; // java/io/PrintStream
const utf8 NumberFormatException_name "java/lang/NumberFormatException";
const classref NumberFormatException NumberFormatException_name;
const utf8 out_name "out";
const utf8 out_desc "Ljava/io/PrintStream;";
const nameandtype System.out_nat out_name, out_desc;
const fieldref System.out System, System.out_nat;
const utf8 parseDouble_name "parseDouble";
const utf8 parseDouble_desc "(Ljava/lang/String;)D";
const nameandtype Double.parseDouble_nat parseDouble_name, parseDouble_desc;
const methodref Double.parseDouble Double, Double.parseDouble_nat;
const utf8 charAt_name "charAt";
const utf8 charAt_desc "(I)C";
const nameandtype String.charAt_nat charAt_name, charAt_desc;
const methodref String.charAt String, String.charAt_nat;
const utf8 println_name "println";
const utf8 println_desc "(Ljava/lang/String;)V";
const nameandtype PrintStream.println_nat println_name, println_desc;
const methodref PrintStream.println PrintStream, PrintStream.println_nat;
const utf8 println_desc$0 "(D)V";
const nameandtype PrintStream.println$0_nat println_name, println_desc$0;
const methodref PrintStream.println$0 PrintStream, PrintStream.println$0_nat;
const utf8 SourceFile_utf8 "SourceFile";
const utf8 main_name "main";
const utf8 main_desc "([Ljava/lang/String;)V";
source file source_file_name; // CalculatorMacro.jasm
//Fields
//Methods
public static method {
name main_name; // main
descriptor main_desc; // ([Ljava/lang/String;)V
maxstack 4;
try ir25->ir48 catch NumberFormatException go to ir52; // java/lang/NumberFormatException
//Variables
var object a_0;
var double d_1;
var int i_3;
var double d_4;
var double d_6;
//Instructions
aload a_0;
arraylength;
bipush 3;
if_icmpeq ir24;
getstatic System.out;
ldc string_9; // "Error: Invalid number of arguments."
invokevirtual PrintStream.println;
getstatic System.out;
ldc string_11; // "Usage: java CalculatorMacro <num> <op> <num>"
invokevirtual PrintStream.println;
return;
ir24: nop;
ir25: aload a_0;
iconst_0;
aaload;
invokestatic Double.parseDouble;
dstore d_1;
aload a_0;
iconst_1;
aaload;
iconst_0;
invokevirtual String.charAt;
istore i_3;
aload a_0;
iconst_2;
aaload;
invokestatic Double.parseDouble;
dstore d_4;
ir48: nop;
goto ir62;
ir52: pop;
getstatic System.out;
ldc string_5; // "Error: Please provide valid numeric values."
invokevirtual PrintStream.println;
return;
ir62: iload i_3;
lookupswitch 42->ir122,43->ir104,45->ir113,47->ir131,default->ir156;
ir104: dload d_1;
dload d_4;
dadd;
dstore d_6;
goto ir147;
ir113: dload d_1;
dload d_4;
dsub;
dstore d_6;
goto ir147;
ir122: dload d_1;
dload d_4;
dmul;
dstore d_6;
goto ir147;
ir131: dload d_4;
dconst_0;
dcmpl;
ifeq ir165;
dload d_1;
dload d_4;
ddiv;
dstore d_6;
goto ir147;
ir147: getstatic System.out;
dload d_6;
invokevirtual PrintStream.println$0;
return;
ir156: getstatic System.out;
ldc string_7; // "Error: Invalid operator. Use +, -, *, or /."
invokevirtual PrintStream.println;
return;
ir165: getstatic System.out;
ldc string_3; // "Error: Division by zero is not allowed."
invokevirtual PrintStream.println;
return;
}
}
3. Re-compile the disassembled Lilac code.
herong> mkdir dis-cls herong> ./jasm/jasm.sh -input dis -output dis-cls \ -classpath ./java.base/classes warning: java runtime jar not found Created 1 class files in 0 secs herong> ls -l dis-cls -rw-r--r-- 1 herong staff 895 Nov 15 09:34 CalculatorMacro.class
3. Compare the compiled bytecode with the original bytecode.
herong> diff cls/CalculatorMacro.class dis-cls/CalculatorMacro.class (no differences)
Perfect. The re-compiled bytecode of the disassembled version matches exactly with the original bytecode.
Table of Contents
JVM (Java Virtual Machine) Specification
Java HotSpot VM - JVM by Oracle/Sun
java.lang.Runtime Class - The JVM Instance
java.lang.System Class - The Operating System
ClassLoader Class - Class Loaders
Class Class - Class Reflections
JVM Stack, Frame and Stack Overflow
Thread Testing Program and Result
CPU Impact of Multi-Thread Applications
I/O Impact of Multi-Thread Applications
Micro Benchmark Runner and JVM Options
Micro Benchmark Tests on "int" Operations
Micro Benchmark Tests on "long" Operations
Micro Benchmark Tests in JIT Compilation Mode
Micro Benchmark Tests on "float" and "double" Operations
JRockit JVM 28.2.7 by Oracle Corporation
JVM Bytecode and Instruction Set
►JVM Assembler/Disassembler Tools
Compare HelloWorld.j with "javap" Output
JASM Example - Calculator.jasm
AsmTools/JASM Assembly Statements
AsmTools/JASM Example - Calculator.jasm
AsmTools/JASM Disassembler: "jdis"
AsmTools/JCOD Assembly File Format
AsmTools/JCOD Example - HelloWorld.jcod
AsmTools/JCOD Disassembler: "jdec"