src/utils/hsdis/README
changeset 51273 5064f30ac015
parent 51271 b6e0bfe4a6ec
child 53109 b99b41325d89
equal deleted inserted replaced
51272:9d92ff04a29c 51273:5064f30ac015
     1 Copyright (c) 2008, 2013, Oracle and/or its affiliates. All rights reserved.
     1 Copyright (c) 2008, 2018, Oracle and/or its affiliates. All rights reserved.
     2 DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     2 DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3   
     3   
     4 The Universal Permissive License (UPL), Version 1.0
     4 The Universal Permissive License (UPL), Version 1.0
     5 
     5 
     6 Subject to the condition set forth below, permission is hereby granted to
     6 Subject to the condition set forth below, permission is hereby granted to
    52 If the product mode of your JVM does not accept -XX:+PrintAssembly,
    52 If the product mode of your JVM does not accept -XX:+PrintAssembly,
    53 you do not have a version that is new enough.
    53 you do not have a version that is new enough.
    54 
    54 
    55 * Building
    55 * Building
    56 
    56 
    57 To build this project you a copy of GNU binutils to build against.  It
    57 To build this project you need a copy of GNU binutils to build against.
    58 is known to work with binutils 2.17 and binutils 2.19.1.  Download a
    58 It is known to work with binutils 2.29.1, 2.30, and 2.31.1. Building
       
    59 against versions older than 2.29 is no longer supported. Download a
    59 copy of the software from http://directory.fsf.org/project/binutils or
    60 copy of the software from http://directory.fsf.org/project/binutils or
    60 one of it's mirrors.  Builds targetting windows should use at least
    61 one of its mirrors.  Builds targetting windows currently require the
    61 2.19 and currently requires the use of a cross compiler.
    62 use of a cross compiler.
    62 
    63 
    63 Binutils should be configured with the '--disable-nls' flag to disable
    64 Binutils should be configured with the '--disable-nls' flag to disable
    64 Native Language Support, otherwise you might get an "undefined
    65 Native Language Support, otherwise you might get an "undefined
    65 reference to `libintl_gettext'" if you try to load hsdis.so on systems
    66 reference to `libintl_gettext'" if you try to load hsdis.so on systems
    66 which don't have NLS by default.  It also avoids build problems on
    67 which don't have NLS by default.  It also avoids build problems on
   105 which on you are targetting and there should be a version of gcc in
   106 which on you are targetting and there should be a version of gcc in
   106 your path named i586-mingw32msvc-gcc or x86_64-pc-mingw32-gcc.  Tell
   107 your path named i586-mingw32msvc-gcc or x86_64-pc-mingw32-gcc.  Tell
   107 the makefile what prefix to use to find the mingw tools by using
   108 the makefile what prefix to use to find the mingw tools by using
   108 MINGW=.  For example:
   109 MINGW=.  For example:
   109 
   110 
   110 make MINGW=i586-mingw32msvc BINTUILS=build/binutils-2.19.1
   111 make MINGW=i586-mingw32msvc BINUTILS=build/binutils-2.31.1
   111 
   112 
   112 will build the Win32 cross compiled version of hsdis based on 2.19.1.
   113 will build the Win32 cross compiled version of hsdis based on 2.31.1.
   113 
   114 
   114 * Installing
   115 * Installing
   115 
   116 
   116 Products are named like build/$OS-$LIBARCH/hsdis-$LIBARCH.so.  You can
   117 Products are named like build/$OS-$LIBARCH/hsdis-$LIBARCH.so.  You can
   117 install them on your LD_LIBRARY_PATH, or inside of your JRE/JDK.  The
   118 install them on your LD_LIBRARY_PATH, or inside of your JRE/JDK.  The