Release NotesAsmToolsSeptember 2023 |
[Skip TOC]
AsmTools is a software package containing a collection of tools that you can use to encode and decode a Java class file, without using a Javac compiler. You can use AsmTools to create class files which can not normally be produced by a compiler. These class files can be used during the development process to test the compliance of a Virtual Machine (VM) to its specification.
These release notes contain information about the ASM Tools version 8.0.
See the (
CodeTools project)
AsmTools OpenJDK project page for more information about AsmTools.
| Bug ID | Description |
|---|---|
| CODETOOLS-7903558 | jasm: Add support this_class, super_class value(s) |
| CODETOOLS-7903531 | jdis: Suppress printing comments by adding an option |
| CODETOOLS-7903549 | jdis: Add support to print instruction offsets while the output is not detailed |
| Bug ID | Description |
|---|---|
| CODETOOLS-7903546 | jdec,jdis: Enhance decompiler outputs flexibility and readability |
| CODETOOLS-7903555 | jdis: incorrectly prints the NameAndType pair in the ConstantPool for the -nc option |
| CODETOOLS-7903536 | jasm: the tool ignores options: -nowarn, -strict |
| CODETOOLS-7903141 | jasm/jdis: implement support of The LocalVariableTable Attribute |
| CODETOOLS-7903509 | jcoder, jasm: add option to override class file version in source file(s) |
| CODETOOLS-7903405 | compiler does not warn about instruction arguments that exceed allowed limits |
| CODETOOLS-7903402 | jdis: tool writes incorrect StackMapTable if the first same_frame has type 0 |
| CODETOOLS-7903401 | jtreg fails if set of jdk tests process jasm,jdis files with defects |
| CODETOOLS-7903259 | jasm: file names without extensions causes a tool crash |
| CODETOOLS-7903249 | asmtools build produces javadoc warning caused by invalid usage of tag & |
| CODETOOLS-7903248 | jasm: FieldData.ConstantValue holds undefined reference to CP while writing fields to a class |
Using ASM Tools requires a properly configured, certified ava Platform, Standard Edition version 17 or later
This section lists the components under the base subdirectory structure
(asmtools-8.0/)
that is created when you unzip the AsmTools distribution archive during
installation.
| Component | Description |
|---|---|
| README.html | The AsmTools release notes (this document). |
| lib/asmtools.jar | The AsmTools library. |
AsmTools have the following synopsis:
java -jar ${ASMTOOLS_HOME}/asmtools.jar TOOL FILE
[TOOL="jasm" | "jdis" | "jcoder" | "jdec"]
[FILE=FILENAME.jasm (for jasm command) | FILENAME.jcod (for jcod command) | FILENAME.class for jdis, jdec command]
Examples:
Assembler Syntax and tool usage is covered in the AsmTools project wiki.
There are no operating modes.
Many attributes (in the class file, as specified by the Java VM Specification, Chapter 4) are covered in the JASM syntax, but not all.
The AsmTools open source project was created in order to develop a community that will improve it, further the development of Java assembly tools, and use Java assemblers to develop test suites. We encourage you to browse, download, contribute, and get involved.
The sources for ASM Tools 8.0 and later is available via the community OpenJDK project. The sources are stored and accessed through a Mercurial repository, which the public may access in a read-only fashion. Committing to changes to the sources is accomplished by first contributing through a proxy developer to establish ones self, which can then lead to rights to contribute directly. More information can be found on the OpenJDK Projects landing page.
The general form for obtaining a copy of the current source tree is:
% git clone https://github.com/openjdk/asmtoolsThis places a copy of the entire source tree in the asmtools directory. From that directory, you can then view and build the sources, as described in the next section. Note that this copy is of the development version of the sources, you may need to extract a different revision if you want a copy from a specific period of time.
Building the sources requires Ant version 1.8 or later (1.10.13 is current at the
time of writing), and the built-in build is compatible with using an IDE.
The sources are designed for Java 17 and if you invoke ant with this
runtime, your chance of encountering an abnormal conditions due to your runtime
or compiler (or javadoc) version.
General requirements:
The general steps to do a build from source from the command line:
<topdir>/build/
% ant
../../asmtools-8.0-build/
A common variation of the build command to force ant to use a particular
installation of Java on your machine:
# JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home ANTHOME=/usr/share/ant antThis example for common *nix shells (
zsh, bash, sh), alter it as needed for your
command environment. You can test your invocation of ant by running it with
the -diagnostics flag, where it will indicate which Java it is
using.
The build file itself is build/build.xml, this is the file you can
specify in your IDE for building.
Copyright © 2008, 2023, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms.The majority of the Assember Tools project is released under the GNU General Public License Version 2 (GPLv2)