1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
Copyright (c) 2008, 2020, Oracle and/or its affiliates. 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. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<html>
<head>
<meta http-equiv="content-type"
content="text/html; charset=ISO-8859-1">
<title>README - AsmTools - Version 7.0</title>
<style>
body, tr {
font-family: Arial, Helvetica, sans-serif;
font-size: 12px;
}
table { font-family: Arial, Helvetica, sans-serif;
background-color: #FFFFFF;
margin-top: 0px; padding-top: 0px;
border-top-width: 0px; border-right-width: 0px;
border-bottom-width: 0px; border-left-width: 0px;
margin-bottom: 10px; margin-left: 0px;
padding-bottom: 5px; padding-left: 5px
}
th
{ font-family: Arial, Helvetica, sans-serif;
text-align: left; vertical-align: bottom;
padding-top: 5px; padding-right: 10px;
padding-left: 10px; white-space: nowrap
border-top-width: 0px; border-right-width: 0px;
border-bottom-width: 0px; border-left-width: 0px;
padding-bottom: 5px; font-size: 12px;
}
td
{ font-family: Arial, Helvetica, sans-serif;
padding-right:10px; padding-left: 10px; padding-top: 7px;
padding-bottom: 7px; border-top-width: 0px;
border-bottom-width: 0px; border-left-width: 0px;
border-right-width: 0px; vertical-align: top;
font-size: 12px;
}
td p
{ font-family: Arial, Helvetica, sans-serif;
padding-right:10px; padding-left: 10px; padding-top: 10px
border-top-width: 0px; border-right-width: 0px;
border-bottom-width: 0px; border-left-width: 0px;
vertical-align: top; font-size: 12px;
}
td h1 { text-align: center
}
td h2 { text-align: center; padding-top: 0px
}
td h3 { text-align: center; padding-top: 0px
}
td h4 { text-align: center; padding-top: 0px
}
table.Code { margin-bottom: 0.5em; border: 0;
margin-top: 0.5em;
}
table.Screen { margin-top: 0.5em; margin-bottom: 0.5em;
border: 1px solid #1E475B;
}
.Untitled { margin-bottom: 1.0em; margin-top: 1.0em;
}
.NoBorder { margin-top: 1.0em; margin-bottom: 1.0em;
line-height: 2pt; }
.sun-darkblue { color: #FFFFFF; background-color: #1E475B }
.sun-lightblue { background-color: #638093 }
</style>
<meta http-equiv="content-type"
content="text/html; charset=ISO-8859-1">
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tbody>
<tr>
<td class="sun-lightblue"> </td>
</tr>
<tr>
<td class="sun-darkblue">
<center>
<h1>Release Notes</h1>
<h2>AsmTools</h2>
</h2>
<h2>April 2020</h2>
</center>
</td>
</tr>
<tr>
<td class="sun-lightblue"> </td>
</tr>
</tbody>
</table>
<p><a name="_top"></a><br>
[<a href="#_maincontent">Skip TOC</a>]</p>
<h2>Table of Contents</h2>
<dl>
<dt><a href="#introduction">Introduction</a></dt>
<dt><a href="#new_in_release">New in This Release</a> </dt>
<dt><a href="#system_requirements">System Requirements</a></dt>
<dt><a href="#release_contents">Release Contents</a></dt>
<dt><a href="#installation">Installation</a></dt>
<dt><a href="#using">Using AsmTools</a></dt>
<dt><a href="#known_bugs_and_issues">Known Bugs and Issues</a></dt>
<dt><a href="#source">Obtaining Sources</a></dt>
<dt><a href="#building">Building from Sources</a></dt>
<dt><a href="#contribute">Contribute</a></dt>
</dl>
<a name="introduction"></a><a name="_maincontent"></a>
<h2>Introduction</h2>
<p>
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.</p>
<p>
These
release notes contain information about the ASM Tools version 7.0.
See the (
<a href="https://wiki.openjdk.java.net/display/CodeTools/Main">CodeTools</a> project)
<a href="https://wiki.openjdk.java.net/display/CodeTools/AsmTools">AsmTools</a> OpenJDK project page for more information about AsmTools.
</p>
<p class="nav-link">[<a href="#_top">Top</a>]</p>
<a name="new_in_release" id="new_in_release"></a>
<h2>New in This Release</h2>
<h3>New Features</h3>
<p>
</p>
<table summary="This table is a summary of New Features for Asm Tools"
border="1" cellpadding="12">
<tbody>
<tr>
<th class="sun-darkblue" scope="col"><b>Bug ID </b></th>
<th class="sun-darkblue" scope="col"><b>Description</b></th>
</tr>
<tr>
<td>
<a href="https://bugs.openjdk.java.net/browse/CODETOOLS-7902525">CODETOOLS-7902525</a>
</td>
<td>
Asmtools support: JEP 360 Sealed Types(Preview)
</td>
</tr>
<tr>
<td>
<a href="https://bugs.openjdk.java.net/browse/CODETOOLS-7902524">CODETOOLS-7902524</a>
</td>
<td>
Asmtools support: JEP 359 Records(Preview)
</td>
</tr>
</tbody>
</table>
<p>
</p>
<h3>Fixed Bugs</h3>
<p>
</p>
<table summary="This table is a summary of bug fixes for Asm Tools"
border="1" cellpadding="12">
<tbody>
<tr>
<th class="sun-darkblue" scope="col"><b>Bug ID </b></th>
<th class="sun-darkblue" scope="col"><b>Description</b></th>
</tr>
<tr>
<td>
<a href="https://bugs.openjdk.java.net/browse/CODETOOLS-7902618">CODETOOLS-7902618</a>
</td>
<td>
Asmtools does not support jasm output/input for TypeAnnotations.
</td>
</tr>
<tr>
<td>
<a href="https://bugs.openjdk.java.net/browse/CODETOOLS-7902643">CODETOOLS-7902643</a>
</td>
<td>
Asmtools(jasm) does not support signature attributes in field_info, component_info
</td>
</tr>
<tr>
<td>
<a href="https://bugs.openjdk.java.net/browse/CODETOOLS-7902644">CODETOOLS-7902644</a>
</td>
<td>
Asmtools (jcoder) fails if an jcod file contains CONSTANT_Utf8_info with non-normative char sequences
</td>
</tr>
<tr>
<td>
<a href="https://bugs.openjdk.java.net/browse/CODETOOLS-7902648">CODETOOLS-7902648</a>
</td>
<td>
jasm has no clues about how to interpret CONSTANT_MethodHandle_info:reference_kind in an invokedynamic instruction
</td>
</tr>
</tbody>
</table>
<p class="nav-link">[<a href="#_top">Top</a>]</p>
<p><a name="system_requirements"></a></p>
<h2>System Requirements</h2>
<p>
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.
</p>
<p class="nav-link">[<a href="#_top">Top</a>]</p>
<a name="installation"></a>
<h2>Installation</h2>
To install the AsmTools, simply unzip the asmtools-7.0.zip
distribution file in the directory of your choice. Optionally, you may
wish to define an environment variable (ASMTOOLSHOME) to point to this
location for your convenience.
<p class="nav-link">[<a href="#_top">Top</a>]</p>
<a name="release_contents"></a>
<h2>Release Contents</h2>
<p>
This section lists the components under the base subdirectory structure
(<code>asmtools-7.0/</code>)
that is created when you unzip the AsmTools distribution archive during
installation.
</p>
<h3>Important Component Descriptions and Locations</h3>
<table style="width: 85%;"
summary="This table describes AsmTools's primary external components."
border="1" cellpadding="12">
<tbody>
<tr>
<th><b><u>Component</u></b></th>
<th><b><u>Description</u></b></th>
</tr>
<tr>
<td><a href="README.html"><tt>README.html</tt></a></td>
<td>The AsmTools release notes (this document). </td>
</tr>
<tr>
<td><tt>lib/asmtools.jar</tt></td>
<td>The AsmTools library.<br>
</td>
</tr>
</tbody>
</table>
<p class="nav-link"><span style="font-weight: bold;">Note*</span> If
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.
</p>
<p class="nav-link">[<a href="#_top">Top</a>]</p>
<a name="using" id="using"></a>
<h2>Using AsmTools</h2>
<p>AsmTools have the following synopsis:</p>
<div style="margin-left: 40px;">
<pre>java -jar ${ASMTOOLSHOME}/asmtools.jar TOOL FILE<br> [TOOL="jasm" | "jdis" | "jcoder" | jdec | jcdec]<br> [FILE=xxx.jasm (for jasm command) | xxx.jcod (for jcod command) | xxx.class for jdis, jdec, or jcdec command]<br><br></pre>
</div>
<p> Examples: </p>
<div style="margin-left: 40px;">
<br>
% java -jar ${ASMTOOLSHOME}/asmtools.jar jasm MyClass.jasm <br>
(produces MyClass.class)<br>
<br>
% java -jar ${ASMTOOLSHOME}/asmtools.jar jdis MyClass.class >
MyClass.jasm <br>
(produces MyClass.jasm)<br>
<br>
% java -jar ${ASMTOOLSHOME}/asmtools.jar jcoder MyClass.jcod <br>
(produces MyClass.class)<br>
<br>
% java -jar ${ASMTOOLSHOME}/asmtools.jar jdec MyClass.class >
MyClass.jcod <br>
(produces MyClass.jcod)
</div>
<p>
Assembler Syntax and tool usage is covered in the
<a href="https://wiki.openjdk.java.net/display/CodeTools/AsmTools">AsmTools project wiki</a>.
</p>
<br>
<h3>Operating Modes</h3>
<p>There are no operating modes.</p>
<p><span class="nav-link">[<a href="#_top">Top</a>]</span></p>
<p><a name="known_bugs_and_issues" id="known_bugs_and_issues"></a></p>
<h2>Known Bugs and Issues</h2>
<p>
Many attributes (in the class file, as specified by the
<a href="https://docs.oracle.com/javase/specs/jvms/se8/html/jvms-4.html">Java VM Specification, Chapter 4)</a>
are covered in the JASM syntax, but not all.
</p>
<p><span class="nav-link">[<a href="#_top">Top</a>]</span></p>
<p><a name="contribute" id="contribute"></a></p>
<h2>Contribute</h2><p>
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.
</p>
<p><span class="nav-link">[<a href="#_top">Top</a>]</span></p>
<p><a name="source" id="source"></a></p>
<h2>Obtaining the Sources</h2>
<p>
The sources for <a href="">ASM Tools</a> 7.0 and later is available via the community
<a href="http://www.openjdk.org/">OpenJDK</a> 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 <a href="http://openjdk.java.net/projects/">OpenJDK Projects</a> landing page.
</p>
<p>
The general form for obtaining a copy of the current source tree is:</p>
<pre>
% hg clone http://hg.openjdk.java.net/code-tools/asmtools asmtools-ro
</pre>
This places a copy of the entire source tree in the asmtools-ro 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.
<p>
At the time of writing, the current version of Mercurial (<code>hg</code>)
is 2.9.1. See the <a href="https://wiki.openjdk.java.net/display/CodeTools/ASM+Tools">
OpenJDK ASM Tools</a> main page for updated and more detailed information.
</p>
<p><span class="nav-link">[<a href="#_top">Top</a>]</span></p>
<p><a name="building" id="building"></a></p>
<h2>Building the Sources</h2>
<p>
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 <code>ant</code> with this
runtime, your chance of encountering an abnormal conditions due to your runtime
or compiler (or javadoc) version.
</p>
<p>
General requirements:
</p>
<ul>
<li>ant, version 1.8 or later
<li>Java 8 runtime and compiler (minimum and recommended)
<li>10MB free disk space (3MB for source tree, 7MB for build output)
</ul>
<p>
The general steps to do a build from source from the command line:
</p>
<ol>
<li><a href="#sources">Obtain Sources</a>
<li>Make your current directory <code><topdir>/build/</code>
<li>Invoke ant:<br><code>% ant</code>
<li>Output appears in a directory above (one above <topdir>),
such as: <code>../../asmtools-7.0-build/</code>
</ol>
<p>
A common variation of the build command to force <code>ant</code> to use a particular
installation of Java on your machine:
</p>
<pre>
# JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_144.jdk/Contents/Home ANTHOME=/usr/share/ant ant
</pre>
This example for common *nix shells (<code>zsh, bash, sh</code>), alter it as needed for your
command environment. You can test your invocation of <code>ant</code> by running it with
the <code>-diagnostics</code> flag, where it will indicate which Java it is
using.
<p>
The build file itself is <code>build/build.xml</code>, this is the file you can
specify in your IDE for building.
</p>
<!-- end of sections, footer matter follows -->
<p><br>
</p>
<p class="nav-link">[<a href="#_top">Top</a>]</p>
<hr>
<hr noshade="noshade">
<p><a href="legal/copyright.txt">Copyright</a> © 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 <A
HREF="http://openjdk.java.net/legal/gplv2+ce.html">GNU
General Public License Version 2 (GPLv2)</A></p>
</body>
</html>
|
