Hotspot_evil is a project mainly written in JAVA and RUBY, based on the View license.
Some evil utilities that runs only on HotSpot
= hotspot_evil
== DESCRIPTION:
This is a library that exposes the internals of Oracle (Sun)'s HotSpot VM.
It uses unverifiable bytecode sequences to do some really evil stuff, like reinterpret_cast<>, memory address/dereference, accessing non-visible symbols, and the like.
Most functionalities are only known to work on Oracle HotSpot VM.
== SYNOPSIS:
In Java:
import hotspot.evil.; import hotspot.evil.util.;
public class Test { public static void main(String[] args) { Integer i = new Integer(123456); long a = Address.of(i); int intValue = Dereference.int32(a + Unsafes.getObjectHeaderSize()); assert intValue == i.intValue() : "should be the same value"; assert ReinterpretCast.toLong(2.0) == 0x4000000000000000L; } }
== REQUIREMENTS:
Make sure the "jruby" and "javac" commands are in $PATH or otherwise available in shell.
Uses JRuby 1.5.0/BiteScript 0.0.5 to generate .class files from .java files. The *.java files in src/ruby directory are actually JRuby source files. See doc/design_notes for more details.
== DOWNLOAD SOURCES:
git clone git://github.com/rednaxelafx/hotspot_evil.git
== BUILD:
cd hotspot_evil rake
If all goes well, the command line output should be like the following:
$ rake (in hotspot_evil) jruby 1.4.0 (ruby 1.8.7 patchlevel 174) (2009-11-02 69fbfa3) (Java HotSpot(TM) Client VM 1.6.0_23) [x86-java] mkdir -p D:/temp/hotspot_evil/bin cd D:/temp/hotspot_evil/src/java rm D:/temp/hotspot_evil/bin/compile.log cd D:/temp/hotspot_evil/src/ruby compiled Address.java compiled Dereference.java compiled MarkWord.java compiled ReinterpretCast.java
The *.class files will be generated in the bin directory. To use this library, add the this bin directory to the classpath of the target Java program.
== KNOWN ISSUES:
There are problems building on Windows, namely JRuby 1.4.0's launcher .bat files have bugs with paths, where as JRuby 1.5.3's "system" method have bugs so that it doesn't execute the command given. A workaround is to install both versions of JRuby, copy the "jruby." files from 1.5.3's bin directory to 1.4.0's, and then put 1.4.0's bin on %PATH% to make it the current JRuby on command line.
== LICENSE:
3-clause BSD license
== AUTHOR:
Kris "RednaxelaFX" Mok http://rednaxelafx.javaeye.com