Skip to content

Latest commit

 

History

History
executable file
·
43 lines (30 loc) · 1.05 KB

README.md

File metadata and controls

executable file
·
43 lines (30 loc) · 1.05 KB
Raw

jmtrace

Trace memory access in Java programs.

Get started (Very Important!!!)

  • Make sure Java 8 (only in version 8) is installed. （请安装 Java 8，而不是其他任何版本）
  • Make sure Ubuntu 18.04 or higher version is your OS. （请使用 Ubuntu 18.04 或更高版本的操作系统）

Build

We use Gradle as our build tool. It is easy to build by

chmod +x ./gradlew
./gradlew package

Usage

The usage is the same as the java command. For example, if you have a JAR package Hello.jar and want to trace its memory accesses, you can type the following command:

chmod +x ./jmtrace
./jmtrace -jar Hello.jar

and memory access logs will be printed to stdout in the format:

R(ead)|W(rite) <threadId> <ObjectId> <ObjectType.fieldName|ClassName.staticFiledName|ArrayType[index]>

Test with JUnit

run:

chmod +x ./gradlew
./gradlew test

then you can see the report in build/reports/tests/test/classes/io.github.zhangt2333.jmtrace.Tests.html

Note that ./jmtrace is in fact a shell script.