|bfu 9faf12f447 it needs it||1 week ago|
|build||1 week ago|
|src||1 year ago|
|.gitignore||1 week ago|
|LICENSE||6 years ago|
|README.html||1 week ago|
|README.md||1 week ago|
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
Asmtools support: JEP 360 Sealed Types(Preview)
Asmtools support: JEP 359 Records(Preview)
Asmtools does not support jasm output/input for TypeAnnotations.
Asmtools(jasm) does not support signature attributes in field_info, component_info
Asmtools (jcoder) fails if an jcod file contains CONSTANT_Utf8_info with non-normative char sequences
jasm has no clues about how to interpret CONSTANT_MethodHandle_info:reference_kind in an invokedynamic instruction
Using ASM Tools requires a properly configured, certified Java
Platform, Standard Edition (Java SE™ platform) runtime environment
version 1.8 or later, or a Java SE platform 8.0 runtime environment.
This section lists the components under the base subdirectory structure
that is created when you unzip the AsmTools distribution archive during
|README.html||The AsmTools release notes (this document).|
|lib/asmtools.jar||The AsmTools library.|
you are creating a local copy of AsmTools, you can not move the /lib
folder to a different location. AsmTools relies on the relative
location of this folder.
AsmTools have the following synopsis:
java -jar /asmtools.jar TOOL FILE
[TOOL="jasm" | "jdis" | "jcoder" | jdec | jcdec]
[FILE=xxx.jasm (for jasm command) | xxx.jcod (for jcod command) | xxx.class for jdis, jdec, or jcdec command]
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 7.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:
% hg clone http://hg.openjdk.java.net/code-tools/asmtools asmtools-ro
At the time of writing, the current version of Mercurial (
is 2.9.1. See the
OpenJDK ASM Tools main page for updated and more detailed information.
Building the sources requires Ant version 1.8 or later (1.10.1 is current at the
time of writing), and the built-in build is compatible with using an IDE.
The sources are designed for Java 8 and if you invoke
ant with this
runtime, your chance of encountering an abnormal conditions due to your runtime
or compiler (or javadoc) version.
The general steps to do a build from source from the command line:
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/jdk1.8.0_144.jdk/Contents/Home ANTHOME=/usr/share/ant ant
zsh, bash, sh), alter it as needed for your
antby running it with
-diagnosticsflag, where it will indicate which Java it is
The build file itself is
build/build.xml, this is the file you can
specify in your IDE for building.
Copyright © 2008, 2020, 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
General Public License Version 2 (GPLv2)