1GIJ(1) GNU GIJ(1)
2
3
4
6 gij - GNU interpreter for Java bytecode
7
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
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
22 supported 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
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
109 compatibility with existing application launch scripts: "-client",
110 "-server", "-hotspot", "-jrockit", "-agentlib", "-agentpath", "-debug",
111 "-d32", "-d64", "-javaagent", "-noclassgc", "-verify", and
112 "-verifyremote".
113
115 gcc(1), gcj(1), gcjh(1), jcf-dump(1), gfdl(7), and the Info entries for
116 gcj and gcc.
117
119 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free
120 Software Foundation, 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 no
125 Invariant Sections, the Front-Cover Texts being (a) (see below), and
126 with the Back-Cover Texts being (b) (see below). A copy of the license
127 is included in the man page gfdl(7).
128
129 (a) The FSF's Front-Cover Text is:
130
131 A GNU Manual
132
133 (b) The FSF's Back-Cover Text is:
134
135 You have freedom to copy and modify this GNU Manual, like GNU
136 software. Copies published by the Free Software Foundation raise
137 funds for GNU development.
138
139
140
141gcc-4.4.7 2012-03-13 GIJ(1)