src/share/tools/hsdis/README
Index Unified diffs Context diffs Sdiffs Wdiffs Patch New Old Previous File Next File 6879063 Sdiff src/share/tools/hsdis

src/share/tools/hsdis/README

Print this page




  21 
  22 ________________________________________________________________________
  23 
  24 'hsdis':  A HotSpot plugin for disassembling dynamically generated code.
  25 
  26 The files in this directory (Makefile, hsdis.[ch], hsdis-demo.c)
  27 are built independently of the HotSpot JVM.
  28 
  29 To use the plugin with a JVM, you need a new version that can load it.
  30 If the product mode of your JVM does not accept -XX:+PrintAssembly,
  31 you do not have a version that is new enough.
  32 
  33 * Building
  34 
  35 To build this project you a copy of GNU binutils to build against.  It
  36 is known to work with binutils 2.17 and binutils 2.19.1.  Download a
  37 copy of the software from http://directory.fsf.org/project/binutils or
  38 one of it's mirrors.  Builds targetting windows should use at least
  39 2.19 and currently requires the use of a cross compiler.
  40 






  41 The makefile looks for the sources in build/binutils or you can
  42 specify it's location to the makefile using BINTUILS=path.  It will
  43 configure binutils and build it first and then build and link the
  44 disasembly adapter.  Make all will build the default target for your
  45 platform.  If you platform support both 32 and 64 simultaneously then
  46 "make both" will build them both at once.  "make all64" will
  47 explicitly build the 64 bit version.  By default this will build the
  48 disassembler library only.  If you build demo it will build a demo
  49 program that attempts to exercise the library.
  50 
  51 Windows
  52 
  53 In theory this should be buildable on Windows but getting a working
  54 GNU build environment on Windows has proven difficult.  MINGW should
  55 be able to do it but at the time of this writing I was unable to get
  56 this working.  Instead you can use the mingw cross compiler on linux
  57 to produce the windows binaries.  For 32-bit windows you can install
  58 mingw32 using your package manager and it will be added to your path
  59 automatically.  For 64-bit you need to download the 64 bit mingw from
  60 http://sourceforge.net/projects/mingw-w64.  Grab a copy of the




  21 
  22 ________________________________________________________________________
  23 
  24 'hsdis':  A HotSpot plugin for disassembling dynamically generated code.
  25 
  26 The files in this directory (Makefile, hsdis.[ch], hsdis-demo.c)
  27 are built independently of the HotSpot JVM.
  28 
  29 To use the plugin with a JVM, you need a new version that can load it.
  30 If the product mode of your JVM does not accept -XX:+PrintAssembly,
  31 you do not have a version that is new enough.
  32 
  33 * Building
  34 
  35 To build this project you a copy of GNU binutils to build against.  It
  36 is known to work with binutils 2.17 and binutils 2.19.1.  Download a
  37 copy of the software from http://directory.fsf.org/project/binutils or
  38 one of it's mirrors.  Builds targetting windows should use at least
  39 2.19 and currently requires the use of a cross compiler.
  40 
  41 Binutils should be configured with the '--disable-nls' flag to disable
  42 Native Language Support, otherwise you might get an "undefined
  43 reference to `libintl_gettext'" if you try to load hsdis.so on systems
  44 which don't have NLS by default.  It also avoids build problems on
  45 other configurations that don't include the full NLS support.
  46 
  47 The makefile looks for the sources in build/binutils or you can
  48 specify it's location to the makefile using BINTUILS=path.  It will
  49 configure binutils and build it first and then build and link the
  50 disasembly adapter.  Make all will build the default target for your
  51 platform.  If you platform support both 32 and 64 simultaneously then
  52 "make both" will build them both at once.  "make all64" will
  53 explicitly build the 64 bit version.  By default this will build the
  54 disassembler library only.  If you build demo it will build a demo
  55 program that attempts to exercise the library.
  56 
  57 Windows
  58 
  59 In theory this should be buildable on Windows but getting a working
  60 GNU build environment on Windows has proven difficult.  MINGW should
  61 be able to do it but at the time of this writing I was unable to get
  62 this working.  Instead you can use the mingw cross compiler on linux
  63 to produce the windows binaries.  For 32-bit windows you can install
  64 mingw32 using your package manager and it will be added to your path
  65 automatically.  For 64-bit you need to download the 64 bit mingw from
  66 http://sourceforge.net/projects/mingw-w64.  Grab a copy of the


src/share/tools/hsdis/README
Index Unified diffs Context diffs Sdiffs Wdiffs Patch New Old Previous File Next File