Mercurial > hg > CbC > CbC_gcc

comparison gcc/doc/gcj-dbtool.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 "GCJ-DBTOOL 1"
135 .TH GCJ-DBTOOL 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 gcj\-dbtool \- Manipulate class file mapping databases for libgcj
142 .SH "SYNOPSIS"
143 .IX Header "SYNOPSIS"
144 gcj-dbtool \fB\s-1OPTION\s0\fR \fI\s-1DBFILE\s0\fR [\fB\s-1MORE\s0\fR] ...
145 .PP
146 gcj-dbtool [\fB\-0\fR] [\fB\-\fR] [\fB\-n\fR] [\fB\-a\fR] [\fB\-f\fR]
147 [\fB\-t\fR] [\fB\-l\fR] [\fB\-p\fR [\fI\s-1LIBDIR\s0\fR]]
148 [\fB\-v\fR] [\fB\-m\fR] [\fB\-\-version\fR] [\fB\-\-help\fR]
149 .SH "DESCRIPTION"
150 .IX Header "DESCRIPTION"
151 \&\f(CW\*(C`gcj\-dbtool\*(C'\fR is a tool for creating and manipulating class file
152 mapping databases. \f(CW\*(C`libgcj\*(C'\fR can use these databases to find a
153 shared library corresponding to the bytecode representation of a
154 class. This functionality is useful for ahead-of-time compilation of
155 a program that has no knowledge of \f(CW\*(C`gcj\*(C'\fR.
156 .PP
157 \&\f(CW\*(C`gcj\-dbtool\*(C'\fR works best if all the jar files added to it are
158 compiled using \f(CW\*(C`\-findirect\-dispatch\*(C'\fR.
159 .PP
160 Note that \f(CW\*(C`gcj\-dbtool\*(C'\fR is currently available as \*(L"preview
161 technology\*(R". We believe it is a reasonable way to allow
162 application-transparent ahead-of-time compilation, but this is an
163 unexplored area. We welcome your comments.
164 .SH "OPTIONS"
165 .IX Header "OPTIONS"
166 .IP "\fB\-n\fR \fI\s-1DBFILE\s0\fR \fB[\fR\fI\s-1SIZE\s0\fR\fB]\fR" 4
167 .IX Item "-n DBFILE [SIZE]"
168 This creates a new database. Currently, databases cannot be resized;
169 you can choose a larger initial size if desired. The default size is
170 32,749.
171 .IP "\fB\-a\fR \fI\s-1DBFILE\s0\fR\fB \fR\fI\s-1JARFILE\s0\fR\fB \fR\fI\s-1LIB\s0\fR" 4
172 .IX Item "-a DBFILE JARFILE LIB"
173 .PD 0
174 .IP "\fB\-f\fR \fI\s-1DBFILE\s0\fR\fB \fR\fI\s-1JARFILE\s0\fR\fB \fR\fI\s-1LIB\s0\fR" 4
175 .IX Item "-f DBFILE JARFILE LIB"
176 .PD
177 This adds a jar file to the database. For each class file in the jar,
178 a cryptographic signature of the bytecode representation of the class
179 is recorded in the database. At runtime, a class is looked up by its
180 signature and the compiled form of the class is looked for in the
181 corresponding shared library. The \fB\-a\fR option will verify
182 that \fI\s-1LIB\s0\fR exists before adding it to the database; \fB\-f\fR
183 skips this check.
184 .IP "\fB[\fR\fB\-\fR\fB][\fR\fB\-0\fR\fB] \-m\fR \fI\s-1DBFILE\s0\fR\fB \fR\fI\s-1DBFILE\s0\fR\fB,[\fR\fI\s-1DBFILE\s0\fR\fB]\fR" 4
185 .IX Item "[-][-0] -m DBFILE DBFILE,[DBFILE]"
186 Merge a number of databases. The output database overwrites any
187 existing database. To add databases into an existing database,
188 include the destination in the list of sources.
189 .Sp
190 If \fB\-\fR or \fB\-0\fR are used, the list of files to read is
191 taken from standard input instead of the command line. For
192 \&\fB\-0\fR, Input filenames are terminated by a null character
193 instead of by whitespace. Useful when arguments might contain white
194 space. The \s-1GNU\s0 find \-print0 option produces input suitable for this
195 mode.
196 .IP "\fB\-t\fR \fI\s-1DBFILE\s0\fR" 4
197 .IX Item "-t DBFILE"
198 Test a database.
199 .IP "\fB\-l\fR \fI\s-1DBFILE\s0\fR" 4
200 .IX Item "-l DBFILE"
201 List the contents of a database.
202 .IP "\fB\-p\fR" 4
203 .IX Item "-p"
204 Print the name of the default database. If there is no default
205 database, this prints a blank line. If \fI\s-1LIBDIR\s0\fR is specified, use
206 it instead of the default library directory component of the database
207 name.
208 .IP "\fB\-\-help\fR" 4
209 .IX Item "--help"
210 Print a help message, then exit.
211 .IP "\fB\-\-version\fR" 4
212 .IX Item "--version"
213 .PD 0
214 .IP "\fB\-v\fR" 4
215 .IX Item "-v"
216 .PD
217 Print version information, then exit.
218 .SH "SEE ALSO"
219 .IX Header "SEE ALSO"
220 \&\fIgcc\fR\|(1), \fIgcj\fR\|(1), \fIgcjh\fR\|(1), \fIjcf\-dump\fR\|(1), \fIgfdl\fR\|(7),
221 and the Info entries for \fIgcj\fR and \fIgcc\fR.
222 .SH "COPYRIGHT"
223 .IX Header "COPYRIGHT"
224 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
225 .PP
226 Permission is granted to copy, distribute and/or modify this document
227 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.2 or
228 any later version published by the Free Software Foundation; with no
229 Invariant Sections, the Front-Cover Texts being (a) (see below), and
230 with the Back-Cover Texts being (b) (see below).
231 A copy of the license is included in the
232 man page \fIgfdl\fR\|(7).
233 .PP
234 (a) The \s-1FSF\s0's Front-Cover Text is:
235 .PP
236 .Vb 1
237 \& A GNU Manual
238 .Ve
239 .PP
240 (b) The \s-1FSF\s0's Back-Cover Text is:
241 .PP
242 .Vb 3
243 \& You have freedom to copy and modify this GNU Manual, like GNU
244 \& software. Copies published by the Free Software Foundation raise
245 \& funds for GNU development.
246 .Ve