1GIJ(1)                                GNU                               GIJ(1)
2
3
4

NAME

6       gij - GNU interpreter for Java bytecode
7

SYNOPSIS

9       gij [OPTION] ... JARFILE [ARGS...]
10
11       gij [-jar] [OPTION] ... CLASS [ARGS...]
12         [-cp path] [-classpath path]
13         [-Dname[=value]...]
14         [-ms=number] [-mx=number]
15         [-Xargument] [-verbose] [-verbose:class]
16         [--showversion] [--version] [--help][-?]
17

DESCRIPTION

19       "gij" is a Java bytecode interpreter included with "libgcj".  "gij" is
20       not available on every platform; porting it requires a small amount of
21       assembly programming which has not been done for all the targets sup‐
22       ported by gcj.
23
24       The primary argument to "gij" is the name of a class or, with "-jar", a
25       jar file.  Options before this argument are interpreted by "gij";
26       remaining options are passed to the interpreted program.
27
28       If a class name is specified and this class does not have a "main"
29       method with the appropriate signature (a "static void" method with a
30       "String[]" as its sole argument), then "gij" will print an error and
31       exit.
32
33       If a jar file is specified then "gij" will use information in it to
34       determine which class' "main" method will be invoked.
35
36       "gij" will invoke the "main" method with all the remaining command-line
37       options.
38
39       Note that "gij" is not limited to interpreting code.  Because "libgcj"
40       includes a class loader which can dynamically load shared objects, it
41       is possible to give "gij" the name of a class which has been compiled
42       and put into a shared library on the class path.
43

OPTIONS

45       -cp path
46       -classpath path
47           Set the initial class path.  The class path is used for finding
48           class and resource files.  If specified, this option overrides the
49           "CLASSPATH" environment variable.  Note that this option is ignored
50           if "-jar" is used.
51
52       -Dname[=value]
53           This defines a system property named name with value value.  If
54           value is not specified then it defaults to the empty string.  These
55           system properties are initialized at the program's startup and can
56           be retrieved at runtime using the "java.lang.System.getProperty"
57           method.
58
59       -ms=number
60           Equivalent to "-Xms".
61
62       -mx=number
63           Equivalent to "-Xmx".
64
65       -noverify
66           Do not verify compliance of bytecode with the VM specification. In
67           addition, this option disables type verification which is otherwise
68           performed on BC-ABI compiled code.
69
70       -X
71       -Xargument
72           Supplying "-X" by itself will cause "gij" to list all the supported
73           "-X" options.  Currently these options are supported:
74
75           -Xmssize
76               Set the initial heap size.
77
78           -Xmxsize
79               Set the maximum heap size.
80
81           -Xsssize
82               Set the thread stack size.
83
84           Unrecognized "-X" options are ignored, for compatibility with other
85           runtimes.
86
87       -jar
88           This indicates that the name passed to "gij" should be interpreted
89           as the name of a jar file, not a class.
90
91       --help
92       -?  Print help, then exit.
93
94       --showversion
95           Print version number and continue.
96
97       --fullversion
98           Print detailed version information, then exit.
99
100       --version
101           Print version number, then exit.
102
103       -verbose
104       -verbose:class
105           Each time a class is initialized, print a short message on standard
106           error.
107
108       "gij" also recognizes and ignores the following options, for compati‐
109       bility with existing application launch scripts: "-client", "-server",
110       "-hotspot", "-jrockit", "-agentlib", "-agentpath", "-debug", "-d32",
111       "-d64", "-javaagent", "-noclassgc", "-verify", and "-verifyremote".
112

SEE ALSO

114       gcc(1), gcj(1), gcjh(1), jcf-dump(1), gfdl(7), and the Info entries for
115       gcj and gcc.  gcc(1), gcj(1), gcjh(1), jcf-dump(1), gfdl(7), and the
116       Info entries for gcj and gcc.
117

119       Copyright (c) 2001, 2002, 2003, 2004, 2005 Free Software Foundation,
120       Inc.
121
122       Permission is granted to copy, distribute and/or modify this document
123       under the terms of the GNU Free Documentation License, Version 1.2 or
124       any later version published by the Free Software Foundation; with the
125       Invariant Sections being "GNU General Public License", the Front-Cover
126       texts being (a) (see below), and with the Back-Cover Texts being (b)
127       (see below).  A copy of the license is included in the man page
128       gfdl(7).
129
130       (a) The FSF's Front-Cover Text is:
131
132            A GNU Manual
133
134       (b) The FSF's Back-Cover Text is:
135
136            You have freedom to copy and modify this GNU Manual, like GNU
137            software.  Copies published by the Free Software Foundation raise
138            funds for GNU development.
139
140
141
142gcc-4.1.2                         2007-09-25                            GIJ(1)
Impressum