Mercurial > hg > CbC > CbC_gcc

comparison gcc/doc/gij.1 @ 0:a06113de4d67

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
first commit
author kent <kent@cr.ie.u-ryukyu.ac.jp>
date Fri, 17 Jul 2009 14:47:48 +0900
parents
children 58ad6c70ea60
comparison
equal deleted inserted replaced
-1:000000000000 0:a06113de4d67
1 .\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.07)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sh \" Subsection heading
6 .br
7 .if t .Sp
8 .ne 5
9 .PP
10 \fB\\$1\fR
11 .PP
12 ..
13 .de Sp \" Vertical space (when we can't use .PP)
14 .if t .sp .5v
15 .if n .sp
16 ..
17 .de Vb \" Begin verbatim text
18 .ft CW
19 .nf
20 .ne \\$1
21 ..
22 .de Ve \" End verbatim text
23 .ft R
24 .fi
25 ..
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
29 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
30 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
31 .\" nothing in troff, for use with C<>.
32 .tr \(*W-
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34 .ie n \{\
35 . ds -- \(*W-
36 . ds PI pi
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39 . ds L" ""
40 . ds R" ""
41 . ds C` ""
42 . ds C' ""
43 'br\}
44 .el\{\
45 . ds -- \|\(em\|
46 . ds PI \(*p
47 . ds L" ``
48 . ds R" ''
49 'br\}
50 .\"
51 .\" Escape single quotes in literal strings from groff's Unicode transform.
52 .ie \n(.g .ds Aq \(aq
53 .el .ds Aq '
54 .\"
55 .\" If the F register is turned on, we'll generate index entries on stderr for
56 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
57 .\" entries marked with X<> in POD. Of course, you'll have to process the
58 .\" output yourself in some meaningful fashion.
59 .ie \nF \{\
60 . de IX
61 . tm Index:\\$1\t\\n%\t"\\$2"
62 ..
63 . nr % 0
64 . rr F
65 .\}
66 .el \{\
67 . de IX
68 ..
69 .\}
70 .\"
71 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
72 .\" Fear. Run. Save yourself. No user-serviceable parts.
73 . \" fudge factors for nroff and troff
74 .if n \{\
75 . ds #H 0
76 . ds #V .8m
77 . ds #F .3m
78 . ds #[ \f1
79 . ds #] \fP
80 .\}
81 .if t \{\
82 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
83 . ds #V .6m
84 . ds #F 0
85 . ds #[ \&
86 . ds #] \&
87 .\}
88 . \" simple accents for nroff and troff
89 .if n \{\
90 . ds ' \&
91 . ds ` \&
92 . ds ^ \&
93 . ds , \&
94 . ds ~ ~
95 . ds /
96 .\}
97 .if t \{\
98 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
99 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
100 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
101 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
102 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
103 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
104 .\}
105 . \" troff and (daisy-wheel) nroff accents
106 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
107 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
108 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
109 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
110 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
111 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
112 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
113 .ds ae a\h'-(\w'a'u*4/10)'e
114 .ds Ae A\h'-(\w'A'u*4/10)'E
115 . \" corrections for vroff
116 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
117 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
118 . \" for low resolution devices (crt and lpr)
119 .if \n(.H>23 .if \n(.V>19 \
120 \{\
121 . ds : e
122 . ds 8 ss
123 . ds o a
124 . ds d- d\h'-1'\(ga
125 . ds D- D\h'-1'\(hy
126 . ds th \o'bp'
127 . ds Th \o'LP'
128 . ds ae ae
129 . ds Ae AE
130 .\}
131 .rm #[ #] #H #V #F C
132 .\" ========================================================================
133 .\"
134 .IX Title "GIJ 1"
135 .TH GIJ 1 "2009-04-21" "gcc-4.4.0" "GNU"
136 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
137 .\" way too many mistakes in technical documents.
138 .if n .ad l
139 .nh
140 .SH "NAME"
141 gij \- GNU interpreter for Java bytecode
142 .SH "SYNOPSIS"
143 .IX Header "SYNOPSIS"
144 gij [\fB\s-1OPTION\s0\fR] ... \fI\s-1JARFILE\s0\fR [\fI\s-1ARGS\s0\fR...]
145 .PP
146 gij [\fB\-jar\fR] [\fB\s-1OPTION\s0\fR] ... \fI\s-1CLASS\s0\fR [\fI\s-1ARGS\s0\fR...]
147 [\fB\-cp\fR \fIpath\fR] [\fB\-classpath\fR \fIpath\fR]
148 [\fB\-D\fR\fIname\fR[=\fIvalue\fR]...]
149 [\fB\-ms=\fR\fInumber\fR] [\fB\-mx=\fR\fInumber\fR]
150 [\fB\-X\fR\fIargument\fR] [\fB\-verbose\fR] [\fB\-verbose:class\fR]
151 [\fB\-\-showversion\fR] [\fB\-\-version\fR] [\fB\-\-help\fR][\fB\-?\fR]
152 .SH "DESCRIPTION"
153 .IX Header "DESCRIPTION"
154 \&\f(CW\*(C`gij\*(C'\fR is a Java bytecode interpreter included with \f(CW\*(C`libgcj\*(C'\fR.
155 \&\f(CW\*(C`gij\*(C'\fR is not available on every platform; porting it requires a
156 small amount of assembly programming which has not been done for all the
157 targets supported by \fBgcj\fR.
158 .PP
159 The primary argument to \f(CW\*(C`gij\*(C'\fR is the name of a class or, with
160 \&\f(CW\*(C`\-jar\*(C'\fR, a jar file. Options before this argument are interpreted
161 by \f(CW\*(C`gij\*(C'\fR; remaining options are passed to the interpreted program.
162 .PP
163 If a class name is specified and this class does not have a \f(CW\*(C`main\*(C'\fR
164 method with the appropriate signature (a \f(CW\*(C`static void\*(C'\fR method with
165 a \f(CW\*(C`String[]\*(C'\fR as its sole argument), then \f(CW\*(C`gij\*(C'\fR will print an
166 error and exit.
167 .PP
168 If a jar file is specified then \f(CW\*(C`gij\*(C'\fR will use information in it to
169 determine which class' \f(CW\*(C`main\*(C'\fR method will be invoked.
170 .PP
171 \&\f(CW\*(C`gij\*(C'\fR will invoke the \f(CW\*(C`main\*(C'\fR method with all the remaining
172 command-line options.
173 .PP
174 Note that \f(CW\*(C`gij\*(C'\fR is not limited to interpreting code. Because
175 \&\f(CW\*(C`libgcj\*(C'\fR includes a class loader which can dynamically load shared
176 objects, it is possible to give \f(CW\*(C`gij\*(C'\fR the name of a class which has
177 been compiled and put into a shared library on the class path.
178 .SH "OPTIONS"
179 .IX Header "OPTIONS"
180 .IP "\fB\-cp\fR \fIpath\fR" 4
181 .IX Item "-cp path"
182 .PD 0
183 .IP "\fB\-classpath\fR \fIpath\fR" 4
184 .IX Item "-classpath path"
185 .PD
186 Set the initial class path. The class path is used for finding
187 class and resource files. If specified, this option overrides the
188 \&\f(CW\*(C`CLASSPATH\*(C'\fR environment variable. Note that this option is
189 ignored if \f(CW\*(C`\-jar\*(C'\fR is used.
190 .IP "\fB\-D\fR\fIname\fR\fB[=\fR\fIvalue\fR\fB]\fR" 4
191 .IX Item "-Dname[=value]"
192 This defines a system property named \fIname\fR with value \fIvalue\fR.
193 If \fIvalue\fR is not specified then it defaults to the empty string.
194 These system properties are initialized at the program's startup and can
195 be retrieved at runtime using the \f(CW\*(C`java.lang.System.getProperty\*(C'\fR
196 method.
197 .IP "\fB\-ms=\fR\fInumber\fR" 4
198 .IX Item "-ms=number"
199 Equivalent to \f(CW\*(C`\-Xms\*(C'\fR.
200 .IP "\fB\-mx=\fR\fInumber\fR" 4
201 .IX Item "-mx=number"
202 Equivalent to \f(CW\*(C`\-Xmx\*(C'\fR.
203 .IP "\fB\-noverify\fR" 4
204 .IX Item "-noverify"
205 Do not verify compliance of bytecode with the \s-1VM\s0 specification. In addition,
206 this option disables type verification which is otherwise performed on BC-ABI
207 compiled code.
208 .IP "\fB\-X\fR" 4
209 .IX Item "-X"
210 .PD 0
211 .IP "\fB\-X\fR\fIargument\fR" 4
212 .IX Item "-Xargument"
213 .PD
214 Supplying \f(CW\*(C`\-X\*(C'\fR by itself will cause \f(CW\*(C`gij\*(C'\fR to list all the
215 supported \f(CW\*(C`\-X\*(C'\fR options. Currently these options are supported:
216 .RS 4
217 .IP "\fB\-Xms\fR\fIsize\fR" 4
218 .IX Item "-Xmssize"
219 Set the initial heap size.
220 .IP "\fB\-Xmx\fR\fIsize\fR" 4
221 .IX Item "-Xmxsize"
222 Set the maximum heap size.
223 .IP "\fB\-Xss\fR\fIsize\fR" 4
224 .IX Item "-Xsssize"
225 Set the thread stack size.
226 .RE
227 .RS 4
228 .Sp
229 Unrecognized \f(CW\*(C`\-X\*(C'\fR options are ignored, for compatibility with
230 other runtimes.
231 .RE
232 .IP "\fB\-jar\fR" 4
233 .IX Item "-jar"
234 This indicates that the name passed to \f(CW\*(C`gij\*(C'\fR should be interpreted
235 as the name of a jar file, not a class.
236 .IP "\fB\-\-help\fR" 4
237 .IX Item "--help"
238 .PD 0
239 .IP "\fB\-?\fR" 4
240 .IX Item "-?"
241 .PD
242 Print help, then exit.
243 .IP "\fB\-\-showversion\fR" 4
244 .IX Item "--showversion"
245 Print version number and continue.
246 .IP "\fB\-\-fullversion\fR" 4
247 .IX Item "--fullversion"
248 Print detailed version information, then exit.
249 .IP "\fB\-\-version\fR" 4
250 .IX Item "--version"
251 Print version number, then exit.
252 .IP "\fB\-verbose\fR" 4
253 .IX Item "-verbose"
254 .PD 0
255 .IP "\fB\-verbose:class\fR" 4
256 .IX Item "-verbose:class"
257 .PD
258 Each time a class is initialized, print a short message on standard error.
259 .PP
260 \&\f(CW\*(C`gij\*(C'\fR also recognizes and ignores the following options, for
261 compatibility with existing application launch scripts:
262 \&\f(CW\*(C`\-client\*(C'\fR, \f(CW\*(C`\-server\*(C'\fR, \f(CW\*(C`\-hotspot\*(C'\fR, \f(CW\*(C`\-jrockit\*(C'\fR,
263 \&\f(CW\*(C`\-agentlib\*(C'\fR, \f(CW\*(C`\-agentpath\*(C'\fR, \f(CW\*(C`\-debug\*(C'\fR, \f(CW\*(C`\-d32\*(C'\fR,
264 \&\f(CW\*(C`\-d64\*(C'\fR, \f(CW\*(C`\-javaagent\*(C'\fR, \f(CW\*(C`\-noclassgc\*(C'\fR, \f(CW\*(C`\-verify\*(C'\fR,
265 and \f(CW\*(C`\-verifyremote\*(C'\fR.
266 .SH "SEE ALSO"
267 .IX Header "SEE ALSO"
268 \&\fIgcc\fR\|(1), \fIgcj\fR\|(1), \fIgcjh\fR\|(1), \fIjcf\-dump\fR\|(1), \fIgfdl\fR\|(7),
269 and the Info entries for \fIgcj\fR and \fIgcc\fR.
270 .SH "COPYRIGHT"
271 .IX Header "COPYRIGHT"
272 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
273 .PP
274 Permission is granted to copy, distribute and/or modify this document
275 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.2 or
276 any later version published by the Free Software Foundation; with no
277 Invariant Sections, the Front-Cover Texts being (a) (see below), and
278 with the Back-Cover Texts being (b) (see below).
279 A copy of the license is included in the
280 man page \fIgfdl\fR\|(7).
281 .PP
282 (a) The \s-1FSF\s0's Front-Cover Text is:
283 .PP
284 .Vb 1
285 \& A GNU Manual
286 .Ve
287 .PP
288 (b) The \s-1FSF\s0's Back-Cover Text is:
289 .PP
290 .Vb 3
291 \& You have freedom to copy and modify this GNU Manual, like GNU
292 \& software. Copies published by the Free Software Foundation raise
293 \& funds for GNU development.
294 .Ve