Mercurial > hg > truffle
view src/share/tools/hsdis/README @ 397:1bf7a2ce4895
Merge
author | dcubed |
---|---|
date | Thu, 16 Oct 2008 11:07:39 -0700 |
parents | c7c777385a15 |
children | 67a2f5ba5582 |
line wrap: on
line source
Copyright (c) 2008 Sun Microsystems, Inc. All Rights Reserved. DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. This code is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 only, as published by the Free Software Foundation. This code is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License version 2 for more details (a copy is included in the LICENSE file that accompanied this code). You should have received a copy of the GNU General Public License version 2 along with this work; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA or visit www.sun.com if you need additional information or have any questions. ________________________________________________________________________ 'hsdis': A HotSpot plugin for disassembling dynamically generated code. The files in this directory (Makefile, hsdis.[ch], hsdis-demo.c) are built independently of the HotSpot JVM. To use the plugin with a JVM, you need a new version that can load it. If the product mode of your JVM does not accept -XX:+PrintAssembly, you do not have a version that is new enough. * Building To build this project you need a build of Gnu binutils to link against. It is known to work with binutils 2.17. The makefile looks for this build in $BINUTILS, or (if that is not set), in .../binutils-2.17-$LIBARCH, where LIBARCH (as in HotSpot) is one of the jre subdirectory keywords i386, amd64, sparc, sparcv9, etc. To build Gnu binutils, first download a copy of the software: http://directory.fsf.org/project/binutils/ Unpack the binutils tarball into an empty directory: chdir ../../../../.. tar -xzf - < ../binutils-2.17.tar.gz mv binutils-2.17 binutils-2.17-i386 #or binutils-2.17-sparc cd binutils-2.17-i386 From inside that directory, run configure and make: ( export CFLAGS='-fPIC' ./configure i386-pc-elf ) gnumake (Leave out or change the argument to configure if not on an i386 system.) Next, untar again into another empty directory for the LP64 version: chdir .. tar -xzf - < ../binutils-2.17.tar.gz mv binutils-2.17 binutils-2.17-amd64 #or binutils-2.17-sparcv9 cd binutils-2.17-amd64 From inside that directory, run configure for LP64 and make: ( export ac_cv_c_bigendian=no CFLAGS='-m64 -fPIC' LDFLAGS=-m64 ./configure amd64-pc-elf ) gnumake The -fPIC option is needed because the generated code will be linked into the hsdid-$LIBARCH.so binary. If you miss the option, the JVM will fail to load the disassembler. You probably want two builds, one for 32 and one for 64 bits. To build the 64-bit variation of a platforn, add LP64=1 to the make command line for hsdis. So, go back to the hsdis project and build: chdir .../hsdis gnumake gnumake LP64=1 * Installing Products are named like bin/$OS/hsdis-$LIBARCH.so. You can install them on your LD_LIBRARY_PATH, or inside of your JRE next to $LIBARCH/libjvm.so. Now test: export LD_LIBRARY_PATH .../hsdis/bin/solaris:$LD_LIBRARY_PATH dargs='-XX:+UnlockDiagnosticVMOptions -XX:+PrintAssembly' dargs=$dargs' -XX:PrintAssemblyOptions=hsdis-print-bytes' java $dargs -Xbatch CompileCommand=print,*String.hashCode HelloWorld If the product mode of the JVM does not accept -XX:+PrintAssembly, you do not have a version new enough to use the hsdis plugin.