∟What Is AsmTools

This section provides a quick introduction on AsmTools as a JVM assembler/disassembler tool with a tutorial on how to write a JASM assembly program, compile it into bytecode file and run it on JVM.

What Is AsmTools? AsmTools is a set of assembler/disassembler tools developed by the OpenJDK team. Main features of AsmTools are:

Here is what I did to download and install JasmTools on my home computer.

1. Go to mvnrepository.com/artifact/org.openjdk.asmtools.

2. Follow "asmtools-core > 7.0.b10-ea > jar" links to download the asmtools-core-7.0.b10-ea.jar (479014 bytes) file.

Now let's try to create a JASM program, compile and run it:

1. Enter the following assembly example program and save it in a file called HelloWorld.jasm.

public class HelloWorld  {
  public static Method main:"([Ljava/lang/String;)V" stack 2 locals 1 {
    getstatic Field java/lang/System.out:"Ljava/io/PrintStream;";
    ldc String "Hello, World from AsmTools!";
    invokevirtual Method java/io/PrintStream.println:"(Ljava/lang/String;)V";
    return;
  }
}

2. Compile HelloWorld.jasm into HelloWorld.class with the JASM compiler.

herong> java -jar asmtools-core-7.0.b10-ea.jar jasm HelloWorld.jasm

herong> ls -l
  -rw-r--r--  1 herong  staff     339 Nov 11 21:29 HelloWorld.class
  -rw-r--r--@ 1 herong  staff     307 Nov 11 21:29 HelloWorld.jasm

3. Run HelloWorld.class on JVM.

herong> java HelloWorld

Hello, World

Hello, World from AsmTools!

For more details on AsmTools, see wiki.openjdk.org/spaces/CodeTools/pages/21430404/AsmTools+User+Guide.

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