Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Preface

This User's Guide describes how to use the Java Assembler Tools (AsmTools) in your projects. This guide also includes Assembler Tools implementation details and describes the syntax of the JASM and JCOD languages.

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.

...


Before You Read This Guide

Before reading this guide, familiarize yourself with the main concepts in the Java Class File (chapter 4) of the Java Virtual Machine Specification (2.0). This public spec is rather old, but updates to the class file format can be found described in JSR 202 final release specification from the Java Community Process (JCP).


How This Guide Is Organized

This guide consists of the following sections:

  • Chapter 1 describes the code assembly process in general, and introduces the Asm Tools.

  • Chapter 2 introduces the two types of assemblers/dissassemblers in Asm Tools (JASM, JCoder), and the strengths and applications of each.

  • Chapter 3 introduces the syntax of the JASM and JCoder formats.

  • Appendix A provides a detailed view of the JASM syntax

  • Appendix B provides a detailed view of JCoder syntax


Typographic Conventions


TypefaceMeaningExamples
AaBbCc123The names of commands, files, and directories; on‐screen computer outputEdit your .loginfile.

Use ls -a to list all files.

$ You have mail

AaBbCc123What you type, when contrasted with on-screen computer output% su

Password:

AaBbCc123Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.Read Chapter 6 in the User's Guide.

These are called class options.

To delete a file, type rm filename.

 


 

Note - Characters display differently depending on browser settings. If characters do not display correctly, change the character encoding in your browser to Unicode UTF-8.


 Chapter 1