[TOC]

Compilation Instructions

System Environment

Operating System : Linux (ubuntu 18.04); Windows 10
Java Environment : Java 1.8 (e.g., java-1.8.0_221, java-1.8.0_144) (Including JDK version and JRE version)
Maven Environment : Maven 3 (maven-3.6.1)

Compilation Steps

Open the terminal and enter the source code root directory "jmtrace".

cd jmtrace

Execute mvn clean package.

mvn clean package

After step 2, you will get a jar under the Maven output directory "target" called "jmtrace-1.0.jar". You can also get a jar under the "target" directory called "jmtrace-1.0-jar-with-dependencies.jar". Execute java -javaagent:<jmtrace jar path> -jar <your jar> <your arg1> <your arg2> ... command to execute the ".jar" file to get the result. You can also enter directory "jmtrace" and execute ./jmtrace -jar <your jar> <your arg1> <your arg2> ....

step 3 example:

client jar

/* Hello.java */
public class Hello {
    public static double[] dd;
    public static void main(String[] args) {
        for (int i = 0; i < args.length; ++i) {
            System.out.println(args[i]);
        }
        Hello.dd = new double[3];
        dd[2] = 1.0;
    }
}

execute command

java -javaagent:"C:\Works\javaworks\ISER_PA2\jmtrace\target\jmtrace-1.0-jar-with-dependencies.jar" -jar C:\Works\javaworks\ISER_PA2\myTest\target\Hello.jar hello world
# In this case, Hello.jar is your jar and it should have a main class declared.

or enter folder "jmtrace" and execute (if your system is Linux)

./jmtrace -jar C:\Works\javaworks\ISER_PA2\myTest\target\Hello.jar hello world

if you get Permission denied error, please enter "jmtrace" folder and execute chmod +x jmtrace first.

output

R 1 0000000008efb846 java.lang.String[0]
Hello
R 1 0000000008efb846 java.lang.String[1]
World
W 1 0000000063961c42 Hello.dd
R 1 0000000063961c42 Hello.dd
W 1 0000000065b54208 double[2]

buriedpot/jmtrace

Compilation Instructions

System Environment

Compilation Steps