Jamaicah usage

To control the jamaicah tool, a variety of arguments can be provided. The arguments can be provided directly to jamaicah, or using the property file jamaicah.conf.

The syntax is as follows:

jamaicah [-help (--help, -h, -?)] [-Xhelp] [-jni]
         [-d=<directory>] [-o=<filename>]
         [-includeFilename=<filename>] [-version]
         [-callingStubs] [-showSettings]
         [-saveSettings=<filename>] [-configuration=<file>]
         [-classpath (-cp)=<path>] [-bootclasspath
         (-Xbootclasspath)=<path>]  class1 [... classn]

General

These are general options providing information about jamaicah itself.

-help (--help, -h, -?)

The help option displays the usage of the jamaicah tool and a short description of all possible standard command line options.

-Xhelp

The Xhelp option displays the usage of the jamaicah tool and a short description of all possible standard and extended command line options. Extended command line options are not needed for normal control of the jamaicah command. They are used to configure tools and options and to provide tools required internally for JamaicaVM development.

-jni

The jni option creates Java Native Interface header files for the native declarations in the provided Java class files. This option is the default and hence does not need to be specified explicitly.

-d=<directory>

The d option specifies output directory for created header files. The filenames are deduced from the full qualified Java class names where `.' are replaced by `_' and the extension .h is appended.

-o=<filename>

The o option specifies the name of the created header file. If not set the filename is deduced from the full qualified Java class name where `.' are replaced by `_' and the extension .h is appended.

-includeFilename=<filename>

The includeFilename option specifies the name of the include file to be included in stubs.

-version

The version option prints the version of the jamaicah tool and exits.

-callingStubs

The callingStubs option generates calling stubs needed on some archs for native methods that are dynamically linked.

-showSettings

Options of jamaicah currently in use are written to standard output in property file format. To make these the default settings, write the output into <JAMAICA_HOME>/etc/jamaicah.conf.

-saveSettings=<filename>

Options of jamaicah currently in use are written to the specified file in property file format.

-configuration=<file>

The set of options used to build the application are read from the provided file. The format used to define options must be identical to the default configuration file <JAMAICA>/etc/jamaica.conf. With this option given, the other default configuration files, i.e. <JAMAICA>/etc/jamaica.conf and <HOME>/.jamaica/jamaica.conf, are ignored.

Classes, files, and paths

-classpath (-cp)=<path>

The classpath option specifies default path used for loading classes.

-bootclasspath (-Xbootclasspath)=<path>

The bootclasspath option specifies default path used for loading system classes.