∟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

 About This Book

 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 Runtime Data Areas

 JVM Stack, Frame and Stack Overflow

 Thread Testing Program and Result

 CPU Impact of Multi-Thread Applications

 I/O Impact of Multi-Thread Applications

 CDS (Class Data Sharing)

 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

 OpenJ9 by Eclipse Foundation

 JRockit JVM 28.2.7 by Oracle Corporation

 JVM Bytecode and Instruction Set

►JVM Assembler/Disassembler Tools

 What Is JVM Assembler

 What Is Jasmin

 Compare HelloWorld.j with "javap" Output

 Jasmin Assembly Statements

 Jasmin Example - Empty.j

 Jasmin Example - Calculator.j

 What Is JASM

 JASM Assembly Statements

 JASM Example - Calculator.jasm

 JASM Disassembler: "jasm -d"

 What Is AsmTools

 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"

 What Is Lilac

 Lilac Assembly Statements

 Lilac Macro Example - HelloWorldMacro.jasm

►Lilac Disassembler: "jdasm"

 Archived Tutorials

 References

 Index

 Full Version in PDF/EPUB