The JDK already comes with the sources for the Java runtime library (also known as “rt.jar”) and also the class files are compiled with “LineNumberTable” which makes it possible to set breakpoints on a specified line. However the class files are not compiled with “LocalVariableTable” which means that even when you’re stopped at a breakpoint, you can only look at the method parameters, not at the local variables (hint you can use javap to check if a certain class file contains LineNumberTable, LocalVariableTable, both or neither). Probably this was done to save space, which is understandable in the case of the JRE, but for the JDK it’s annoying.
Fortunately you can fix this! Just use the ant script at the end of this post (or get it here) to build rt_debug.jar. After having built it, you have multiple options to make use of it:
- Put it in your
jre/lib/endorseddirectory (create it if doesn’t exists) - Specify it using
-Xbootclasspath - Override
jre/lib/rt.jarwith it (after making a backup of course!)
I personally used the first method. The only downside is that classes appear twice in the Eclipse type explorer (once for rt.jar and once for rt_debug.jar. Perhaps in the future we will get the rt.jar for JDK compiled with full debug symbols by default.
Final note: the ant script relies on having the JAVA_HOME variable available, so you might need to specify it by hand in case it isn’t set. For example on Ubuntu 14.10 the full command to be run is:
JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64 ant -f debug_jdk.xml
Ant script:
Credits for inspiration:
- General: Recompile (Some of) The JDK to Ease Debugging
- Enabling debugging inside JRE classes
- A great SO answer
- General: Recompile (Some of) The JDK to Ease Debugging
- Almost perfect solution (needed to be updated, was for Java 1.4)
This post is part of the Java Advent Calendar and is licensed under the Creative Commons 3.0 Attribution license. If you like it, please spread the word by sharing, tweeting, FB, G+ and so on!
steinhauer.software
Alan Bateman December 13, 2014
Keep in mind that rt.jar does not exist in JDK 9. See JEP 220 (http://openjdk.java.net/jeps/220) for more details.
Naresh August 13, 2015
Thanks. It helped me. I re-compiled Src.zip with -g which allowed debugging classes of rt.jar with local variables.
Ishwarya Asokan September 8, 2015
This comment has been removed by the author.
Ishwarya Asokan September 8, 2015
I have the latest JDK jdk-8u66. When I used this script, I get some 100 errors of missing classes, packages and warnings.
Ex:
error: package sun.reflect.misc does not exist
[javac] import sun.reflect.misc.ReflectUtil;
: error: package sun.util.locale.provider does not exist
The same when I tried cmd
javac -Xdiags:verbose -g -d "F:JavaBuildJartmpout" -J-Xmx512m -cp "FJavaBuildJarrt.jar";"FJavaBuildJartools.jar" @list.txt
Ishwarya Asokan September 8, 2015
Never mind. Thanks a ton. I verified the built rt_debug.jar in JAD. The jar is valid inspite of throws errors.
Worked like charm. 🙂